@orkestrel/scaffold 0.0.55 → 0.0.57

package/README.md

@@ -7,6 +7,18 @@ Every `@orkestrel` repository shares one toolchain, one set of agent instruction
 root dotfiles. Scaffold ships that shared set as data inside the package and gives it verbs: create
 a workspace from it, report how a workspace differs from it, and write the difference back.
 
+The set splits by how a repository meets it. Every target carries its own copy of the vendored set —
+its toolchain, its policy proofs, its harness permission file, its bench probe scripts — and the
+verbs write it and compare it. A bench probe script is a session-start hook that reports whether a
+bench CLI resolves; what wires that bench stays in the canon, and a session reads it at its primary
+root. The instruction canon — the coding and orchestration contracts, the rules, the skills, the
+templates, the transport contracts, the agent roles, the bench configuration, and the MCP
+registrations — is published for reading instead, from a scaffold checkout sitting beside the
+repository, or from `node_modules/@orkestrel/scaffold/dist/host/` in the installed package. Every
+target carries the `AGENTS.md` and `CLAUDE.md` pointers that name where to read it, and the
+`.claude/agents/orkestrel.md` catalog file the `catalog` verb rewrites. Anything else a target holds
+at a canon path is a superseded copy, and `overwrite` deletes it.
+
 ## Install
 
 ```sh
@@ -34,10 +46,11 @@ npx scaffold new router --src core,server
 ```
 
 Writes a complete workspace into `./router`: its manifest, its build configuration, empty barrels
-for each selected environment, its tests, its documentation, and every shared file. `--app` selects
-private application environments on an independent axis, and `--deps` names `@orkestrel/*` runtime
-dependencies, each pinned to the registry's latest release. `--bin` adds the command-line entry, its
-test, and its scoped build configuration.
+for each selected environment, its tests, its documentation, the `AGENTS.md` and `CLAUDE.md`
+pointers, and every vendored file. `--app` selects private application environments on an
+independent axis, and `--deps` names `@orkestrel/*` runtime dependencies, each pinned to the
+registry's latest release. `--bin` adds the command-line entry, its test, and its scoped build
+configuration.
 
 ### `audit` — report how a target compares to its plan
 
@@ -78,8 +91,10 @@ npx scaffold overwrite --dirty
 
 Everything `repair` and `catalog` do, plus the steps only this verb carries: it deletes tracked
 files the plan does not own, and it rewrites the `@orkestrel/*` ranges in the manifest to the
-registry's latest releases. It needs a git repository, and it refuses a tree carrying uncommitted
-changes unless `--dirty` waives that refusal.
+registry's latest releases. The deletion covers a stray beneath a vendored directory and a superseded
+instruction copy alike, so one run repairs the pointers and sweeps the canon paths a release moved.
+It needs a git repository, and it refuses a tree carrying uncommitted changes unless `--dirty` waives
+that refusal.
 
 ## Library
 

package/dist/bin/main.js

@@ -3,7 +3,7 @@ import { align, renderTable, strip, stripControls, width } from "@orkestrel/cons
 import { attempt, isRecord, isString, parseJSON } from "@orkestrel/contract";
 import { createMarkdown, flattenText, isTableNode } from "@orkestrel/markdown";
 import { executeSync } from "@orkestrel/process/server";
-import { BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, MAX_MANIFEST_BYTES, SERVICE_SETUP_PATH, SHOWCASE_CONFIG_PATH, ScaffoldError, blueprintToDevDependencies, blueprintToRootVite, blueprintToScripts, blueprintToTestArtifacts, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isDeferredPath, isScaffoldError, manifestToDependencies, manifestToName, nameToGuide, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
+import { BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, MAX_MANIFEST_BYTES, SERVICE_SETUP_PATH, SHOWCASE_CONFIG_PATH, ScaffoldError, blueprintToDevDependencies, blueprintToRootVite, blueprintToScripts, blueprintToTestArtifacts, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isCanonPath, isDeferredPath, isScaffoldError, manifestToDependencies, manifestToName, nameToGuide, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
 import { Materializer, Upstream, filesToHost, isExactCaseFile, isPhysicalDirectory, isWorktree, listFiles, readFileText, readHostFloor, readSnapshot, resolveContainedPath } from "../src/server/index.js";
 import { parseArgs } from "node:util";
 //#region src/bin/constants.ts
@@ -1031,7 +1031,7 @@ var CLI = class CLI {
 			baseline: "floor",
 			forced: false
 		};
-		const paths = floor.manifest.entries.filter((entry) => !isDeferredPath(entry.destination)).map((entry) => entry.destination);
+		const paths = floor.manifest.entries.filter((entry) => !isDeferredPath(entry.destination) && !isCanonPath(entry.destination)).map((entry) => entry.destination);
 		const current = target === void 0 ? floor.bytes : readSnapshot(target, paths);
 		const upstream = new Upstream(this.#upstream);
 		try {