Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions deploy/release-checklists/archctx-0.4.2.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,12 @@

Scope: exclude the exact Claude runtime trace files from architecture projection worktree identity so a CodeGraph-backed projection can remain stable while repo-harness records its active session. This patch keeps `.claude` configuration authoritative and does not change protocol identifiers, renderer/layout versions, or the Node engine range.

- [ ] `bun run verify` passes under Node `>=24 <26`.
- [ ] `archctx` and `archctx-contracts` package versions are exactly `0.4.2`.
- [ ] Focused architecture-domain tests prove runtime traces are ignored and `.claude/settings.json` remains digest-significant.
- [ ] A real repo-harness projection apply completes while `.claude/.session-id` and `.claude/.trace.jsonl` are active.
- [ ] Pull request is merged to `main`; Claude review is waived by the user's explicit instruction.
- [ ] Publish `archctx-contracts@0.4.2` and read back version, integrity, and shasum.
- [ ] Publish `archctx@0.4.2` and read back version, integrity, shasum, Node engine, and exact CodeGraph dependency.
- [ ] Clean-room Node 24 smoke returns the `0.4.2` capabilities handshake.
- [x] `bun run verify` passes under Node `>=24 <26`.
- [x] `archctx` and `archctx-contracts` package versions are exactly `0.4.2`.
- [x] Focused architecture-domain tests prove runtime traces are ignored and `.claude/settings.json` remains digest-significant.
- [x] A real repo-harness projection apply completes while `.claude/.session-id` and `.claude/.trace.jsonl` are active.
- [x] Pull request is merged to `main`; Claude review is waived by the user's explicit instruction.
- [x] Publish `archctx-contracts@0.4.2` and read back version, integrity, and shasum.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Persist the contracts readback before closing the gate

A repo-wide search for archctx-contracts@0.4.2 finds only this checklist, while the dedicated docs/verification/archcontext-contracts-npm-scope-readback.md still records 0.3.0; consequently, the claimed 0.4.2 registry version, integrity, and shasum are not preserved anywhere in the repository. This leaves the downstream adoption gate without auditable evidence that it is consuming the published artifact that was checked, so record the publish helper's registry readback (or refresh the dedicated evidence document) before marking this item complete.

AGENTS.md reference: AGENTS.md:L15-L15

Useful? React with 👍 / 👎.

- [x] Publish `archctx@0.4.2` and read back version, integrity, shasum, Node engine, and exact CodeGraph dependency.
- [x] Clean-room Node 24 smoke returns the `0.4.2` capabilities handshake.
- [ ] Update repo-harness to exact `archctx@0.4.2` and `archctx-contracts@0.4.2`, then prove the accepted refresh signal end to end.
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,17 @@
"schemaVersion": "archcontext.al10-npm-release-readback/v1",
"status": "verified",
"scope": "official-public-npm-latest-release",
"publishedAt": "2026-08-09T00:55:24.678Z",
"publishedAt": "2026-08-11T13:21:18.733Z",
"package": {
"name": "archctx",
"version": "0.4.0",
"version": "0.4.2",
"distTag": "latest",
"installCommand": "npm install -g archctx@latest",
"explicitInstallCommand": "npm install -g archctx@0.4.0",
"tarball": "https://registry.npmjs.org/archctx/-/archctx-0.4.0.tgz",
"shasum": "ea6cacb33353272d01989f7bdbacf852187ac55b",
"sha256": "d4a165d1599bf303bce79d9cbe58a0879571d2d0483cd2622e8087ccd5a532be",
"integrity": "sha512-LFl8PqYv6Yu/VUbQHKJR00v2VZerRiyEvTlPXZVYEVjh1DzD37QmvlCq6zTUgZE3+wVLJJRpKe69u1vj2P4N7w==",
"explicitInstallCommand": "npm install -g archctx@0.4.2",
"tarball": "https://registry.npmjs.org/archctx/-/archctx-0.4.2.tgz",
"shasum": "d249a726be28ea673ff677cd239f327093446327",
"sha256": "f323122bb43bada4b4d6ef1ed6bb1a09544bd359d3799d7fe39471d2ac6f40cd",
"integrity": "sha512-mDsl6fKZ5sg4tZrt+cN3ym0oHJOcYWQsRPzAu9eNbUez79qRgq7aA8moRpYWMTBGQUlq78QmyQHE0r14cZq51w==",
"bin": {
"archctx": "bin/archctx.mjs"
},
Expand All @@ -27,7 +27,7 @@
"license": "Apache-2.0"
},
"registry": {
"latest": "0.4.0",
"latest": "0.4.2",
"beta": "0.1.4-beta.0",
"latestMoved": true,
"versionVisible": true,
Expand All @@ -45,29 +45,31 @@
"0.2.2",
"0.2.3",
"0.3.0",
"0.4.0"
"0.4.0",
"0.4.1",
"0.4.2"
]
},
"smoke": {
"nodeVersion": "v24.19.0",
"installPackage": "archctx@0.4.0",
"installPackage": "archctx@0.4.2",
"helpOk": true,
"helpRequestId": "help",
"helpCommandCount": 41,
"doctorOk": true,
"doctorProductVersion": "0.4.0",
"doctorCliVersion": "0.4.0",
"doctorDaemonVersion": "0.4.0",
"doctorMcpVersion": "0.4.0",
"doctorProductVersion": "0.4.2",
"doctorCliVersion": "0.4.2",
"doctorDaemonVersion": "0.4.2",
"doctorMcpVersion": "0.4.2",
"updateCheckOk": true,
"updateCheckCurrentVersion": "0.4.0",
"updateCheckLatestVersion": "0.4.0",
"updateCheckCurrentVersion": "0.4.2",
"updateCheckLatestVersion": "0.4.2",
"updateCheckStatus": "current"
},
"source": {
"dryRun": "docs/verification/fg6-npm-release-dry-run.json",
"releaseDistribution": "docs/verification/fg6-release-distribution-readback.json",
"publishedTarball": "_ops/npm/fg6-release-dry-run/archctx-0.4.0.tgz",
"publishedTarball": "_ops/npm/fg6-release-dry-run/archctx-0.4.2.tgz",
"sprintChecklist": "plans/sprints/archctx-architecture-ledger-sprint-checklist.md"
},
"verification": {
Expand All @@ -76,19 +78,20 @@
"bun run verify:governance",
"bun run readback:fg6:npm-release-dry-run",
"bun scripts/fg6-npm-release-dry-run.ts inspect --evidence docs/verification/fg6-npm-release-dry-run.json --json",
"npm view archctx@0.4.0 version --registry=https://registry.npmjs.org/ returned E404 before publish",
"npm view archctx@0.4.2 version --registry=https://registry.npmjs.org/ returned E404 before publish",
"npm whoami returned ancienttwo after interactive web authorization"
],
"publish": "npm@11.17.0 publish _ops/npm/fg6-release-dry-run/archctx-0.4.0.tgz --access public --registry=https://registry.npmjs.org/ (interactive web authorization)",
"publish": "node scripts/publish-archctx.mjs --confirm-publish --tarball <temp>/archctx-0.4.2.tgz --registry https://registry.npmjs.org/ --json (interactive web authorization)",
"postPublish": [
"npm view archctx dist-tags versions --json --registry=https://registry.npmjs.org/",
"npm view archctx@0.4.0 name version dist.tarball dist.shasum dist.integrity bin dependencies engines homepage license --json --registry=https://registry.npmjs.org/",
"npm view archctx@0.4.0 time --json --registry=https://registry.npmjs.org/",
"npm view archctx@0.4.2 name version dist.tarball dist.shasum dist.integrity bin dependencies engines homepage license --json --registry=https://registry.npmjs.org/",
"npm view archctx@0.4.2 time --json --registry=https://registry.npmjs.org/",
"bun run readback:fg6:release-distribution",
"bun scripts/fg6-release-distribution-readback.ts inspect --evidence docs/verification/fg6-release-distribution-readback.json --json",
"npm exec --yes --package node@24 --package archctx@0.4.0 -- archctx help --json",
"npm exec --yes --package node@24 --package archctx@0.4.0 -- archctx doctor --json",
"npm exec --yes --package node@24 --package archctx@0.4.0 -- archctx update --check --json"
"npm exec --yes --package node@24 --package archctx@0.4.2 -- archctx capabilities --json",
"npm exec --yes --package node@24 --package archctx@0.4.2 -- archctx help --json",
"npm exec --yes --package node@24 --package archctx@0.4.2 -- archctx doctor --json",
"npm exec --yes --package node@24 --package archctx@0.4.2 -- archctx update --check --json"
]
},
"assertions": {
Expand Down
38 changes: 20 additions & 18 deletions docs/verification/architecture-ledger-al10-npm-release.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,30 +2,30 @@

Status: verified

Scope: official public npm release for the `archctx` one-package distribution. This moves npm `latest` to `0.4.0`; it does not by itself enable production `ledger-authoritative` mode or hard enforcement.
Scope: official public npm release for the `archctx` one-package distribution. This moves npm `latest` to `0.4.2`; it does not by itself enable production `ledger-authoritative` mode or hard enforcement.

## Published Artifact

- Package: `archctx@0.4.0`
- Package: `archctx@0.4.2`
- Dist-tag: `latest`
- Install: `npm install -g archctx@latest`
- Explicit install: `npm install -g archctx@0.4.0`
- Tarball: `https://registry.npmjs.org/archctx/-/archctx-0.4.0.tgz`
- Shasum: `ea6cacb33353272d01989f7bdbacf852187ac55b`
- SHA256: `d4a165d1599bf303bce79d9cbe58a0879571d2d0483cd2622e8087ccd5a532be`
- Integrity: `sha512-LFl8PqYv6Yu/VUbQHKJR00v2VZerRiyEvTlPXZVYEVjh1DzD37QmvlCq6zTUgZE3+wVLJJRpKe69u1vj2P4N7w==`
- Explicit install: `npm install -g archctx@0.4.2`
- Tarball: `https://registry.npmjs.org/archctx/-/archctx-0.4.2.tgz`
- Shasum: `d249a726be28ea673ff677cd239f327093446327`
- SHA256: `f323122bb43bada4b4d6ef1ed6bb1a09544bd359d3799d7fe39471d2ac6f40cd`
- Integrity: `sha512-mDsl6fKZ5sg4tZrt+cN3ym0oHJOcYWQsRPzAu9eNbUez79qRgq7aA8moRpYWMTBGQUlq78QmyQHE0r14cZq51w==`

## Registry Readback

- `latest` points to `0.4.0`.
- `latest` points to `0.4.2`.
- `beta` remains `0.1.4-beta.0`.
- `archctx@0.4.0` is registry-visible with Node engine `>=24 <26`, the `archctx` bin, exact `@colbymchenry/codegraph@1.5.0`, homepage `https://archcontext.repoharness.com`, and license `Apache-2.0`.
- `archctx@0.4.2` is registry-visible with Node engine `>=24 <26`, the `archctx` bin, exact `@colbymchenry/codegraph@1.5.0`, homepage `https://archcontext.repoharness.com`, and license `Apache-2.0`.

## Source And Artifact Provenance

- Root source manifest: `package.json` is `archcontext@0.4.0`, `private: true`.
- Source packages: `@archcontext/contracts`, `@archcontext/core`, `@archcontext/local-runtime`, `@archcontext/surfaces`, and `@archcontext/cloud` are version-aligned at `0.4.0`; only `@archcontext/contracts` is a publishable contracts surface.
- Generated npm artifact: `archctx@0.4.0`, publishable, generated through `docs/verification/fg6-npm-release-dry-run.json`.
- Root source manifest: `package.json` is `archcontext@0.4.2`, `private: true`.
- Source packages: `@archcontext/contracts`, `@archcontext/core`, `@archcontext/local-runtime`, `@archcontext/surfaces`, and `@archcontext/cloud` are version-aligned at `0.4.2`; only `@archcontext/contracts` is a publishable contracts surface.
- Generated npm artifact: `archctx@0.4.2`, publishable, generated through `docs/verification/fg6-npm-release-dry-run.json`.
- Release/source/help consistency readback: `bun run readback:release`.

## Install Smoke
Expand All @@ -34,17 +34,19 @@ The clean install smoke used a temporary npm prefix with `node@24` and `archctx@

- Node: `v24.19.0`
- Help surface: ok, requestId `help`, 41 commands
- `archctx doctor --json`: ok, product/CLI/daemon/MCP version `0.4.0`; package-local CodeGraph version `1.5.0`
- `archctx update --check --json`: ok, currentVersion `0.4.0`, latestVersion `0.4.0`, status `current`
- `archctx capabilities --json`: package version `0.4.2`, projection request/result v1, refresh signal v1, docs renderer v2
- `archctx doctor --json`: ok, product/CLI/daemon/MCP version `0.4.2`; package-local CodeGraph version `1.5.0`
- `archctx update --check --json`: ok, currentVersion `0.4.2`, latestVersion `0.4.2`, status `current`

## Verification

- `bun run verify` (1218 pass, 0 fail)
- `bun run verify` under Node 24.18.0 (1229 pass, 0 fail)
- `bun run readback:fg6:npm-release-dry-run`
- `bun scripts/fg6-npm-release-dry-run.ts inspect --evidence docs/verification/fg6-npm-release-dry-run.json --json`
- `npm publish _ops/npm/fg6-release-dry-run/archctx-0.4.0.tgz --tag latest --access public --registry=https://registry.npmjs.org/`
- `node scripts/publish-archcontext-contracts.mjs publish --confirm-publish --json` with interactive Web Auth
- `node scripts/publish-archctx.mjs --confirm-publish --tarball <temp>/archctx-0.4.2.tgz --registry https://registry.npmjs.org/ --json` with interactive Web Auth
- `npm view archctx version dist-tags versions --json --registry=https://registry.npmjs.org/`
- `npm view archctx@0.4.0 name version dist.tarball dist.shasum dist.integrity bin dependencies engines homepage license --json --registry=https://registry.npmjs.org/`
- `npm view archctx@0.4.2 name version dist.tarball dist.shasum dist.integrity bin dependencies engines homepage license --json --registry=https://registry.npmjs.org/`
- `bun run readback:fg6:release-distribution`
- `bun scripts/fg6-release-distribution-readback.ts inspect --evidence docs/verification/fg6-release-distribution-readback.json --json`
- `bun run readback:release`
Expand All @@ -53,4 +55,4 @@ The clean install smoke used a temporary npm prefix with `node@24` and `archctx@

## Boundary

This release publishes the official npm distribution with AXR1-AXR7 architecture-source-tree runtime fixes and exact package-local CodeGraph `1.5.0`. Authority promotion and production `ledger-authoritative` enablement still require their own canonical evidence.
This release publishes the official npm distribution with the 0.4.1 accepted-change projection bridge and the 0.4.2 Claude runtime-trace stability fix, while retaining exact package-local CodeGraph `1.5.0`. Authority promotion and production `ledger-authoritative` enablement still require their own canonical evidence.
18 changes: 9 additions & 9 deletions docs/verification/fg6-npm-release-dry-run.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@
"environment": "npm-release-dry-run",
"status": "verified",
"ok": true,
"generatedAt": "2026-08-08T22:04:40.660Z",
"generatedAt": "2026-08-11T13:22:18.657Z",
"package": {
"name": "archctx",
"version": "0.4.0",
"version": "0.4.2",
"private": false,
"homepage": "https://archcontext.repoharness.com",
"license": "Apache-2.0",
Expand All @@ -31,12 +31,12 @@
},
"artifact": {
"artifactDir": "_ops/npm/fg6-release-dry-run",
"tarball": "archctx-0.4.0.tgz",
"publishDryRunId": "archctx@0.4.0",
"integrity": "sha512-LFl8PqYv6Yu/VUbQHKJR00v2VZerRiyEvTlPXZVYEVjh1DzD37QmvlCq6zTUgZE3+wVLJJRpKe69u1vj2P4N7w==",
"shasum": "ea6cacb33353272d01989f7bdbacf852187ac55b",
"size": 425792,
"unpackedSize": 2249429,
"tarball": "archctx-0.4.2.tgz",
"publishDryRunId": "archctx@0.4.2",
"integrity": "sha512-mDsl6fKZ5sg4tZrt+cN3ym0oHJOcYWQsRPzAu9eNbUez79qRgq7aA8moRpYWMTBGQUlq78QmyQHE0r14cZq51w==",
"shasum": "d249a726be28ea673ff677cd239f327093446327",
"size": 427478,
"unpackedSize": 2253803,
"entryCount": 86,
"files": [
"NOTICE.md",
Expand Down Expand Up @@ -206,7 +206,7 @@
"noticeMentionsAllAttribution": true
},
"rollout": {
"postPublishInstallCommand": "npm install -g archctx@0.4.0",
"postPublishInstallCommand": "npm install -g archctx@0.4.2",
"homeUrl": "https://archcontext.repoharness.com"
},
"assertions": {
Expand Down
28 changes: 14 additions & 14 deletions docs/verification/fg6-release-distribution-readback.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"environment": "release-distribution",
"status": "verified",
"ok": true,
"generatedAt": "2026-08-09T00:57:47.497Z",
"generatedAt": "2026-08-11T13:22:21.869Z",
"sources": {
"homeUrl": "https://archcontext.repoharness.com",
"outputPath": "docs/verification/fg6-release-distribution-readback.json",
Expand Down Expand Up @@ -32,7 +32,7 @@
"rootPackage": {
"path": "package.json",
"name": "archcontext",
"version": "0.4.0",
"version": "0.4.2",
"private": true,
"binNames": [],
"publishConfigRegistry": null
Expand All @@ -41,31 +41,31 @@
{
"path": "packages/contracts/package.json",
"name": "@archcontext/contracts",
"version": "0.4.0",
"version": "0.4.2",
"private": false,
"binNames": [],
"publishConfigRegistry": null
},
{
"path": "packages/core/package.json",
"name": "@archcontext/core",
"version": "0.4.0",
"version": "0.4.2",
"private": true,
"binNames": [],
"publishConfigRegistry": null
},
{
"path": "packages/local-runtime/package.json",
"name": "@archcontext/local-runtime",
"version": "0.4.0",
"version": "0.4.2",
"private": true,
"binNames": [],
"publishConfigRegistry": null
},
{
"path": "packages/surfaces/package.json",
"name": "@archcontext/surfaces",
"version": "0.4.0",
"version": "0.4.2",
"private": true,
"binNames": [
"archctx"
Expand All @@ -75,7 +75,7 @@
{
"path": "packages/cloud/package.json",
"name": "@archcontext/cloud",
"version": "0.4.0",
"version": "0.4.2",
"private": true,
"binNames": [],
"publishConfigRegistry": null
Expand All @@ -86,12 +86,12 @@
"path": "docs/verification/fg6-npm-release-dry-run.json",
"ok": true,
"packageName": "archctx",
"version": "0.4.0",
"version": "0.4.2",
"homepage": "https://archcontext.repoharness.com",
"license": "Apache-2.0",
"tarball": "archctx-0.4.0.tgz",
"publishDryRunId": "archctx@0.4.0",
"postPublishInstallCommand": "npm install -g archctx@0.4.0"
"tarball": "archctx-0.4.2.tgz",
"publishDryRunId": "archctx@0.4.2",
"postPublishInstallCommand": "npm install -g archctx@0.4.2"
}
},
"registry": [
Expand All @@ -110,7 +110,7 @@
{
"name": "archctx",
"status": "published",
"version": "0.4.0",
"version": "0.4.2",
"homepage": "https://archcontext.repoharness.com",
"license": "Apache-2.0",
"engines": {
Expand All @@ -126,8 +126,8 @@
"ready": true,
"packageName": "archctx",
"installCommand": "npm install -g archctx",
"postPublishInstallCommand": "npm install -g archctx@0.4.0",
"version": "0.4.0",
"postPublishInstallCommand": "npm install -g archctx@0.4.2",
"version": "0.4.2",
"blockers": []
},
"assertions": {
Expand Down
8 changes: 4 additions & 4 deletions docs/verification/fg6-release-distribution.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
- Task: FG6 release distribution precondition
- Environment: release-distribution
- Home URL: https://archcontext.repoharness.com
- Generated At: 2026-08-09T00:57:47.497Z
- Generated At: 2026-08-11T13:22:21.869Z
- Status: verified

## Decision
Expand All @@ -14,14 +14,14 @@ PASS: public install command is `npm install -g archctx`.

- `archcontext`: missing (E404)
- `@archcontext/cli`: missing (E404)
- `archctx`: published 0.4.0
- `archctx`: published 0.4.2

## Local Manifests

- Root package: `archcontext` 0.4.0, private=true
- Root package: `archcontext` 0.4.2, private=true
- Publishable manifests exposing `archctx`: 0
- Placeholder package: missing
- Dry-run package: `archctx` 0.4.0, ok=true
- Dry-run package: `archctx` 0.4.2, ok=true

## Rollout Implication

Expand Down
Loading