Skip to content

Commit 5f9f88e

Browse files
committed
feat: declare pinned local identity without runtime readiness claims
1 parent 746729d commit 5f9f88e

22 files changed

Lines changed: 390 additions & 54 deletions

‎README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,8 @@ npm run model:start
5959

6060
Downloads pinned llama.cpp and Qwen2.5-Coder 7B Q4_K_M. Keep that terminal running.
6161
No paid API key needed. Create a project/task in **Agent workspace**. [Setup details](docs/LANGUAGE-LAB.md#start-on-windows).
62+
Use `npm run model:inspect -- --hash` to verify the installed weight file without
63+
starting inference. File identity and provider/runtime readiness are separate checks.
6264

6365
## Language lab
6466

‎docs/AGENT-CATALOG.md‎

Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,19 +16,21 @@ it starts no model, tool, task or account write.
1616

1717
## Evidence vocabulary
1818

19-
- **Documented**: an exact API ID appears in the linked provider's own catalog.
19+
- **Documented**: an exact API ID appears in the linked provider's own catalog,
20+
or a local candidate has a pinned repository revision, file and digest.
2021
This does not show account access, adapter behavior, or suitability for the role.
2122
- **Unresolved model ID**: no exact API ID or chosen local artifact has been
2223
verified. `cz-local-coder` on Qwen roles is the existing application's local
23-
alias, not a Qwen upstream model ID.
24+
alias, separate from their upstream repository/file identity.
2425
- **Contract tested**: `node --test tests/agent-catalog.test.mjs` checks unique,
2526
disabled definitions and rejects mismatched, stale, oversized, or fabricated
2627
output envelopes. This is deterministic host validation, not model evaluation.
2728
- **Configured / runtime verified**: neither applies to the new catalog. The
2829
existing saved local agent path is separate and retains its earlier evidence.
2930

30-
As of 2026-10-19, 12 entries reference documented API IDs and six need exact
31-
model selection. All 18 remain disabled. No access to Anthropic, OpenAI, Google,
31+
As of 2026-10-19, 12 entries reference documented API IDs, two Qwen roles share
32+
one pinned local artifact, and four need exact model selection. All 18 remain
33+
disabled. No access to Anthropic, OpenAI, Google,
3234
Mistral, Moonshot, or open-model inference was tested in this mission.
3335

3436
## Sources and decisions
@@ -39,11 +41,27 @@ Mistral, Moonshot, or open-model inference was tested in this mission.
3941
| [OpenAI API models](https://developers.openai.com/api/docs/models) | Luna, Sol, and Astra IDs. Record them as documented only; no API credential or availability is inferred. |
4042
| [Gemini API models](https://ai.google.dev/gemini-api/docs/models) | Gemini 3.8 Flash endpoint for Explorer. The role remains disabled until adapter and evaluation work. |
4143
| [Mistral Small 4](https://docs.mistral.ai/models/mistral-small-4-0-26-03) | Current `mistral-small-2603` ID for Editor. Earlier `mistral-small-2503` was rejected because it appears under deprecated models. |
44+
| [Pinned Qwen GGUF](https://huggingface.co/Qwen/Qwen2.5-Coder-7B-Instruct-GGUF/blob/13fb94bfda8c8cf22497dc57b78f391a9acb426a/qwen2.5-coder-7b-instruct-q4_k_m.gguf) and [model card/license](https://huggingface.co/Qwen/Qwen2.5-Coder-7B-Instruct-GGUF) | Explicitly choose the application's existing Qwen2.5-Coder 7B Q4_K_M candidate for both local roles. Record the official revision, file SHA-256 and Apache-2.0 license. Reuse the established pin; do not download or substitute new weights. File identity is independent of role or runtime qualification. |
4245

43-
Local Qwen, Llama, Gemma, and DeepSeek roles need an explicitly selected model
46+
Local Llama, Gemma, and DeepSeek roles still need an explicitly selected model
4447
artifact, license, hardware check, and qualified adapter. Kimi needs a verified
4548
Moonshot API ID and account access. No silent substitute is allowed.
4649

50+
The two Qwen roles declare repository `Qwen/Qwen2.5-Coder-7B-Instruct-GGUF`,
51+
revision `13fb94bfda8c8cf22497dc57b78f391a9acb426a`, file
52+
`qwen2.5-coder-7b-instruct-q4_k_m.gguf` and digest
53+
`509287f78cb4d4cf6b3843734733b914b2c158e43e22a7f4bf5e963800894d3c`.
54+
The file is 4,683,073,536 bytes; runtime assets and KV-cache/compute overhead are
55+
additional. Actual RAM/VRAM fit remains unqualified. The starter's 4,096-token
56+
window motivates a planned 2,496-token complete-input / 1,600-token output budget
57+
and a 6,000-character outer input ceiling. Character count does not prove token
58+
fit: a later host must tokenize the entire formatted prompt before activation.
59+
The catalog shows declared identity only and never inspects the user's files.
60+
`npm run model:inspect -- --hash` performs the separate read-only byte check;
61+
it does not read credentials, launch the provider, or qualify either role.
62+
The selected candidate is versioned; changing an installer pin requires an
63+
explicit role/fixture review and does not silently replace this identity.
64+
4765
## Contracts and activation
4866

4967
Every candidate receives a bounded task, project/run ID, source revision and
@@ -114,6 +132,10 @@ shows the source-controlled catalog in a disposable scenario fixture. The
114132
scenario badge is part of the deterministic example; none of the proposed roles
115133
ran to produce this image.
116134

135+
The [narrow Qwen details capture](media/qwen-identity-2026-10-19.png) is an actual
136+
Chrome element capture of declared artifact, alias, license and planned limits.
137+
It reports no local file availability or runtime qualification.
138+
117139
The [fixture-section capture](media/agent-fixture-2026-10-19.png) is a real Chrome
118140
element capture from Fable Architect's read-only details. It shows authored input,
119141
unscored future criteria and the local JSON download; it is not model output.

‎docs/CONTEXT.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ and external AI CLIs require a direct user request. Never merge old work implici
8282
- Existing Commons run 49092854-f9bd-4b7a-8d12-4ac5ea0e5f70 retains the approved,
8383
unmerged safe-timer change from job 811bdb98-bcbb-4b65-80b9-f19693aef6b4.
8484
Preserve it. 29 earlier lab experiments were verified before this release work.
85-
- Public source: antropos17/commit-zero at b80d561 (06:58 UTC), CI green; use clean .cache/publication and preserve histories.
85+
- Public source: antropos17/commit-zero at 746729d (07:12 UTC), CI green; use clean .cache/publication and preserve histories.
8686
README GIF is a 15.8s condensed walkthrough of retained Sequence Kit work,
8787
not a continuous live recording. Static fallback included; desktop/mobile and all
8888
three CI jobs passed. Evidence: runtime/verification/github-readme-gif-2026-10-19.json.

‎docs/DEVELOPMENT.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,11 @@ Review the actual images before copying them into source; see [distribution](DIS
4040
`npm run agents:fixtures` checks authored host envelopes for all disabled roles;
4141
`-- --profile <stable-id>` selects one. It performs no inference and reports no
4242
model-quality score. [Fixture and holdout scope](AGENT-CATALOG.md#reproduce-host-contracts).
43+
The [ecosystem decisions](ECOSYSTEM-DECISIONS.md) connect adopted/deferred tools
44+
and provider choices to primary sources, tests and exact activation blockers.
45+
`npm run model:inspect` checks declared local artifact metadata; `-- --hash`
46+
streams its bytes without starting a provider or reading a token. Metadata-only,
47+
digest identity and runtime readiness remain distinct. [Local setup](LANGUAGE-LAB.md#start-on-windows).
4348
Focused suites are explicitly labeled feedback, not full acceptance. Select an area
4449
deliberately: changed-file inference is unreliable in this dirty checkout and can
4550
miss integration dependencies. The full gate remains serial to bound PGlite memory.

‎docs/DISTRIBUTION.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -94,13 +94,13 @@ announcement posted elsewhere.
9494
Before publishing a release, replace the candidate version with an actual tag,
9595
link its exact commit and CI run, re-run the documented gates, and record real
9696
browser/model/sandbox coverage separately. No release was created by this note.
97-
Current implemented-code checkpoint: public `b80d561`, [CI run 39212997304](https://github.com/antropos17/commit-zero/actions/runs/39212997304)
97+
Current implemented-code checkpoint: public `746729d`, [CI run 39214513591](https://github.com/antropos17/commit-zero/actions/runs/39214513591)
9898
passed full gate, Chromium and runtime dependency audit. Local frozen gate at
99-
`85cacbd` passed 69/69 Node tests, DOM/axe 2/2, build and serving with source
100-
hash `f5cc6a6ad8bd461de2f856741a01eabaeb3e9333e9e00d46777e870b45ceb8b5`;
101-
separate Chrome coverage passed 11/11. This draft and capture tooling will require
102-
their own final source check before publication. The checked capture set is
103-
already published at `98389bd`; the current startup-recovery unit is pending its gate.
99+
`3282f75` passed 69/69 Node tests, DOM/axe 2/2, build and serving with source
100+
hash `de390f9b71d4801c7726de1bf5926225e977849626817ad52a6498079848234c`;
101+
separate Chrome coverage passed 12/12. Verify the final candidate revision before
102+
creating a release. The checked capture set is already published at `98389bd`;
103+
the current artifact-identity addition is pending its gate.
104104

105105
## Show HN fact sheet for a human author
106106

‎docs/ECOSYSTEM-DECISIONS.md‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# Ecosystem decisions from the 2026-10-19 mission
2+
3+
Research is bounded by the local product and the no-inference mission. Sources
4+
below were checked or attempted on 2026-10-19; documentation does not establish installed
5+
capabilities or provider entitlement. The [mission log](MISSION-2026-10-19.md)
6+
records implementation and verification timestamps.
7+
8+
## Reuse a declared local artifact
9+
10+
The official [Qwen model card](https://huggingface.co/Qwen/Qwen2.5-Coder-7B-Instruct-GGUF)
11+
and [pinned file page](https://huggingface.co/Qwen/Qwen2.5-Coder-7B-Instruct-GGUF/blob/13fb94bfda8c8cf22497dc57b78f391a9acb426a/qwen2.5-coder-7b-instruct-q4_k_m.gguf)
12+
provide the repository, Apache-2.0 license, revision and digest for the already
13+
used Q4_K_M candidate. Decision: bind the two disabled Qwen roles explicitly to
14+
that candidate and provide a read-only byte inspector. Expected benefit: another
15+
operator can distinguish an installed file's identity from an application alias
16+
and runtime readiness. No weights were downloaded or replaced. Metadata/digest,
17+
failure and cancellation fixtures verify the host tool; model quality and
18+
hardware/token fit remain unqualified. [Identity and limits](AGENT-CATALOG.md).
19+
20+
The role pin is versioned. A later installer update must review the role identity
21+
and fixtures explicitly; it must not silently substitute new weights into a
22+
previously described role.
23+
24+
## Defer an MCP transport until tool permissions are qualified
25+
26+
The primary [MCP architecture reference](https://modelcontextprotocol.io/docs/2026-07-28/learn/architecture)
27+
separates the host/client/server, protocol features and transport. The current
28+
documentation resolved to version 2026-07-28, so a future integration must check
29+
that version's discovery and authorization requirements rather than assume an
30+
older handshake. Decision: retain Commit Zero's existing `ai-git/1` API and
31+
source-tested proposed grants; add no MCP server, SDK or transport in this pass.
32+
Expected benefit: avoid exposing executable tools before permission, cancellation
33+
and receipt handling are qualified. Current host fixtures check exact context
34+
and supplied evidence IDs; they are not MCP compatibility tests. Activation
35+
requires a concrete needed tool, reviewed executable/dependency provenance,
36+
capability discovery, narrow grants and real denial/cancellation fixtures.
37+
38+
## Keep unresolved provider choices explicit
39+
40+
Opening the official [Moonshot getting-started page](https://platform.moonshot.ai/docs/guide/getting-started)
41+
returned “not accessible via this tool.” No exact Kimi API ID or account access
42+
was verified. Decision: retain Kimi Navigator as unresolved and disabled. The
43+
smallest next action is to obtain an accessible current primary model-ID source,
44+
then qualify the selected adapter and account separately. Local Llama, Gemma
45+
and DeepSeek entries likewise need an explicit artifact/license/hardware choice.
46+
No substitute model is inferred from a familiar display name.
47+
48+
## Other adopted decisions and their evidence
49+
50+
| Question | Decision and verification |
51+
| --- | --- |
52+
| Hosted request/response patterns | Four disconnected text contracts share host context and evidence validation. [Primary sources, offline fixtures and activation gaps](PROVIDER-DRAFTS.md). |
53+
| Generated-code execution | Docker daemon remains unavailable. Keep the digest/mount/resource plan source-tested and the product blocked. [Setup path and unverified properties](SANDBOX-ADAPTER.md). |
54+
| Collaboration failure/recovery | Seeded actors exercise actual HTTP contracts in disposable stores. [Commands, seeds and limits](SIMULATIONS.md). |
55+
| Browser/workflow feedback | Use real Chrome, scoped fixtures and frozen full gates; preserve the production limiter. [Comparable measurements and limits](WORKFLOW-MEASUREMENTS.md). |
56+
| Open-source distribution | Prepare real captures and channel-specific material, respect channel restrictions, and publish only source/docs. [Rules, drafts and assets](DISTRIBUTION.md). |

0 commit comments

Comments
 (0)