Phase 4 cutover prep: release queue, docs cleanup, AUDN-SC rename#4
Merged
Conversation
Stage metadata-only cutover versions across public packages, adapters, and host plugins. Add the npm publish queue, marketplace audit, and cutover readiness runbook so the release queue can be reviewed before the public cutover.
Keep the public docs tree user-facing by removing migration provenance and cutover artifacts from docs/migration. Drop the migration inventory CI hook that depended on those internal artifacts and add a repo-hygiene guard so docs/migration cannot be reintroduced accidentally.
The mutation decision space exposes seven actions in code today: Add, Update, Delete, No-op, Supersede, Clarify, Skip. The public docs previously expanded "AUDN" to only the first four, which undersold the engine and disagreed with the actual action set emitted by extraction. This commit updates the four prose surfaces that customers read: - packages/core/README.md (tagline, features bullet, API table, footer) - packages/core/CHANGELOG.md (initial-release entry) - packages/mcp-server/README.md (memory_ingest tool bullet) - adapters/openai-agents/README.md (smoke-test paragraph) Code identifiers (AudnFactContext, executeAudnDecision, etc.), filenames (memory-audn.ts, etc.), the DEFERRED_AUDN_ENABLED env var, the AUDN-prefixed DB migration filename, and runtime error strings all keep the four-letter AUDN prefix for stability. AUDN-SCS is the conceptual name; AUDN remains the code prefix.
…prep # Conflicts: # AGENTS.md # README.md
SKIP is a pre-AUDN ingest trace sentinel, not a mutation decision — keeping it in the acronym was misleading. The decision space is six actions: Add, Update, Delete, No-op, Supersede, Clarify (A/U/D/N + S/C). Updates all seven remaining AUDN-SCS mentions across the four prose files touched by the original rename and the follow-up clarification: - packages/core/README.md - packages/core/CHANGELOG.md - packages/mcp-server/README.md - adapters/openai-agents/README.md
1. Remove docs/ layout entries. The cutover branch's earlier merge
resolution kept descriptions of a top-level docs/ surface in
AGENTS.md and README.md, but the directory was deleted on main
and will not be reintroduced. Drop the descriptions so the layout
sections describe what actually exists.
2. Bump stale internal-dependency minimums to match the cutover
versions. Adapters and packages that depend on @atomicmemory/sdk
now require ^1.0.2 (SDK is at 1.0.2); plugins/openclaw now
requires @atomicmemory/mcp-server ^0.1.2 (MCP server is at 0.1.2).
Affected: packages/cli, packages/mcp-server, adapters/{langchain,
langgraph, mastra, vercel-ai, openai-agents}, plugins/openclaw.
3. Derive renderHelp()'s default version from CLI_SPEC.package_version
instead of the hardcoded '0.1.0' literal. loadSpec() is already
imported and CLI_SPEC is already in scope, so this is a one-line
change that keeps the default in lockstep with cli-spec.json and
prevents the help banner from drifting on future version bumps.
The existing help.test passes an explicit '0.1.0' arg so it
remains unaffected.
The previous commit bumped @atomicmemory/sdk to ^1.0.2 and @atomicmemory/mcp-server to ^0.1.2 across adapters, plugins, and packages, but pnpm-lock.yaml still had the old specifiers, so `pnpm install --frozen-lockfile` rejected the mismatch on CI. Ran `pnpm install --lockfile-only` to update the specifier fields under each workspace project's `dependencies` block in the lockfile. No other dependency resolution changed; the `link:` targets to the in-workspace packages are unchanged.
ethanj
changed the title
ethanj
added a commit
that referenced
this pull request
May 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Phase 4 public-cutover preparation. The branch grew through several review rounds; the final shipped state on each major thread:
1ef8edf). Metadata-only cutover versions across public packages, adapters, and host plugins; npm publish queue, marketplace audit, and cutover-readiness runbook added so the release queue can be reviewed before public cutover.24eee6f).docs/migration/deleted from the public docs tree along with the migration-inventory CI hook that depended on those internal artifacts; repo-hygiene guard added sodocs/migration/cannot be reintroduced accidentally. The top-leveldocs/directory itself is not part of the public tree on this branch.a884f4d→74325eb→cf3b0eb). The mutation decision space is six actions: Add, Update, Delete, No-op, Supersede, Clarify.SKIPis a pre-AUDN ingest trace sentinel for rejections before the mutation pipeline runs — it is not an AUDN-SC decision and is documented separately wherever the decision list is enumerated. Updated four prose surfaces (packages/core/README.md,packages/core/CHANGELOG.md,packages/mcp-server/README.md,adapters/openai-agents/README.md). Code identifiers, filenames, theDEFERRED_AUDN_ENABLEDenv var, the AUDN-prefixed DB migration, and runtime error strings all keep the four-letterAUDNprefix for stability — AUDN-SC is the conceptual/public name; AUDN remains the code prefix.95efa23+06cce39). Removed staledocs/layout entries fromAGENTS.mdandREADME.md; bumped internal-dependency minimums to match cutover versions (@atomicmemory/sdk ^1.0.1 → ^1.0.2across adapters and CLI/MCP-server packages;@atomicmemory/mcp-server ^0.1.0 → ^0.1.2inplugins/openclaw); switchedrenderHelp()'s default version to derive fromCLI_SPEC.package_versionso the help banner cannot drift on future bumps; regeneratedpnpm-lock.yamlsopnpm install --frozen-lockfileaccepts the new specifiers.Test plan
24eee6fenforces thatdocs/migration/stays empty;pnpm install --frozen-lockfileaccepts the regenerated lockfile)packages/core/README.md,packages/core/CHANGELOG.md,packages/mcp-server/README.md,adapters/openai-agents/README.mdrender correctly on GitHub (visual check)SKIPseparately as a pre-AUDN trace sentinel*/package.jsonversion bumps from1ef8edfand the dependency-minimum bumps from95efa23docs/migration/*or a top-leveldocs/directory exist in CI workflows, scripts, README, or AGENTS.md