@orkestrel/scaffold 0.0.98 → 0.0.100

package/dist/agents/skills/orkestrel-scout/scripts/map.js

@@ -9,8 +9,9 @@
 // heading the named file, or the same file, does not carry. Walks skip node_modules, .git, dist,
 // tmp, .orkestrel, .idea, and host.json; --paths narrows a census or refs walk. Modes combine, each
 // printing its section; --json prints one object; --out writes the output to FILE instead of the
-// terminal. Give each flag once; a later duplicate is not read. Exit 0, or 64 when no mode is
-// given or --refs names no path.
+// terminal. Give each flag once; a later duplicate is not read. A value that opens with `--` is a
+// missing value, so census a custom property without its leading dashes. Exit 0, or 64 when no
+// mode is given or a flag is given with no value.
 import { existsSync, readFileSync, statSync, mkdirSync, writeFileSync } from 'node:fs';
 import { basename, dirname } from 'node:path';
 import { listFiles, normalizeSlashes, readList, readMissingFlags, readOption, } from "../../orkestrel-dispatch/scripts/helpers.js";
@@ -252,7 +253,17 @@ function renderReport(report) {
     return `${lines.join('\n')}\n`;
 }
 function main(argv) {
-    const missing = readMissingFlags(argv, ['--refs', '--paths', '--out']);
+    const missing = readMissingFlags(argv, [
+        '--tree',
+        '--headings',
+        '--frontmatter',
+        '--exports',
+        '--census',
+        '--refs',
+        '--anchors',
+        '--paths',
+        '--out',
+    ]);
     if (missing.length > 0) {
         console.error(`map: ${missing.join(', ')} given with no value`);
         return 64;

package/dist/bin/main.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { align, renderTable, strip, stripControls, width } from "@orkestrel/console";
 import { attempt, isArray, isError, isInstance, isRecord, isString, parseJSON } from "@orkestrel/contract";
-import { AXES, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, FRAMEWORKS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, JOURNEY_CONFIG_PATH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, RESERVED_SHEET_NAMES, SERVICE_SETUP_PATH, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, STYLES_ENTRY_PATH, ScaffoldError, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToFaces, blueprintToProjects, blueprintToScripts, blueprintToSheets, blueprintToTestArtifacts, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isFloorPath, isScaffoldError, isSheetName, manifestToDependencies, manifestToName, nameToGuide, parseExtension, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
+import { AXES, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, FRAMEWORKS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, JOURNEY_CONFIG_PATH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, RESERVED_SHEET_NAMES, SERVICE_SETUP_PATH, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, STYLES_ENTRY_PATH, ScaffoldError, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToFaces, blueprintToManifestOverrides, blueprintToProjects, blueprintToScripts, blueprintToSheets, blueprintToTestArtifacts, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isFloorPath, isScaffoldError, isSheetName, manifestToDependencies, manifestToName, nameToGuide, parseExtension, replaceManifestOverrides, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
 import { MAX_INVENTORY_PATHS, Materializer, Upstream, filesToHost, isExactCaseFile, isPhysicalDirectory, isWorktree, listFiles, readFileText, readHostFloor, readHostManifest, readSnapshot, resolveContainedPath } from "../src/server/index.js";
 import { createMarkdown, flattenText, isTableNode } from "@orkestrel/markdown";
 import { createSession } from "@orkestrel/process/server";
@@ -10,7 +10,7 @@ import { normalize } from "node:path";
 import { parseArgs } from "node:util";
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.98",
+	version: "0.0.100",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -637,6 +637,9 @@ function auditToExit(audit) {
 * @param manifest - The target manifest text.
 * @param blueprint - The workspace shape that supplies the planned tool set.
 * @returns The declared fleet rows and planned foreign tools in their writable sections.
+* @remarks
+* Selected showcase tools retain every string declaration in both sections.
+* Other foreign tools retain runtime precedence when declared in both sections.
 */
 function manifestToWritableDependencies(manifest, blueprint) {
 	const declared = manifestToDependencies(manifest);
@@ -657,7 +660,7 @@ function manifestToWritableDependencies(manifest, blueprint) {
 				name,
 				range: runtimeRange
 			});
-			continue;
+			if (!(blueprint.showcase && blueprint.app.includes("browser") && Object.hasOwn(SHOWCASE_DEV_DEPENDENCIES, name))) continue;
 		}
 		const developmentRange = developmentRecord[name];
 		if (isString(developmentRange)) development.push({
@@ -1816,7 +1819,7 @@ var CLI = class {
 		const blueprint = this.#derive(target);
 		const groups = selectionToGroups(command.groups);
 		const declared = manifestToWritableDependencies(manifest, blueprint);
-		const versions = await this.#versions(declared, command.offline === true);
+		const versions = await this.#versions(declared, command.offline === true, blueprint);
 		const questions = [...this.#targetQuestions(target, blueprint, groups), ...releasesToQuestions(versions.releases)];
 		const host = await this.#host(command.from, target, command.offline === true);
 		try {
@@ -1861,11 +1864,12 @@ var CLI = class {
 				else this.#present(audit);
 				return 1;
 			}
-			const versions = await this.#versions(manifestToWritableDependencies(this.#manifest(target), blueprint), command.offline === true);
+			const versions = await this.#versions(manifestToWritableDependencies(this.#manifest(target), blueprint), command.offline === true, blueprint);
 			const refusal = versionsToRefusal(versions);
 			if (refusal !== void 0) throw refusal;
 			const result = mergeResults(host.materializer.repair(plan, audit, target), host.materializer.declare({
 				pins: versions.pins,
+				overrides: blueprintToManifestOverrides(blueprint),
 				scripts: manifestToWritableScripts(this.#manifest(target), blueprint)
 			}, target));
 			const terminalBlueprint = this.#derive(target);
@@ -1967,25 +1971,34 @@ var CLI = class {
 				return 1;
 			}
 			const declared = {
+				overrides: blueprintToManifestOverrides(blueprint),
 				pins: manifestToWritableDependencies(this.#manifest(target), blueprint),
 				scripts: manifestToWritableScripts(this.#manifest(target), blueprint)
 			};
 			const additions = manifestToAdditions(this.#manifest(target), blueprint);
 			const repaired = host.materializer.repair(plan, audit, target);
-			const added = additions.runtime.length === 0 && additions.development.length === 0 ? void 0 : host.materializer.declare({
+			const policy = blueprint.showcase && blueprint.app.includes("browser") ? SHOWCASE_DEV_DEPENDENCIES : {};
+			const added = additions.runtime.length === 0 && additions.development.length === 0 && Object.keys(policy).length === 0 ? void 0 : host.materializer.declare({
 				pins: {
-					runtime: [],
-					development: []
+					runtime: declared.pins.runtime.filter(({ name }) => Object.hasOwn(policy, name)).map(({ name, range }) => ({
+						name,
+						range: policy[name] ?? range
+					})),
+					development: declared.pins.development.filter(({ name }) => Object.hasOwn(policy, name)).map(({ name, range }) => ({
+						name,
+						range: policy[name] ?? range
+					}))
 				},
 				scripts: [],
-				additions
+				additions,
+				overrides: blueprintToManifestOverrides(blueprint)
 			}, target);
 			const removed = host.materializer.remove(plan, audit, command.dirty === true ? {
 				tracked: worktree.tracked,
 				dirty: []
 			} : worktree, target);
 			const local = mergeResults(added === void 0 ? repaired : mergeResults(repaired, added), removed);
-			const remainder = command.offline === true ? await this.#declare(host.materializer, target, declared, host.baseline) : await this.#reconcile(host.materializer, target, declared, host.baseline, host.forced);
+			const remainder = command.offline === true ? await this.#declare(host.materializer, target, declared, host.baseline, blueprint) : await this.#reconcile(host.materializer, target, declared, host.baseline, host.forced, blueprint);
 			const [measured] = this.#survey(host.materializer, blueprint, target, groups);
 			const terminal = this.#appendQuestions(measured, target, blueprint, groups);
 			const outcome = {
@@ -2014,14 +2027,14 @@ var CLI = class {
 			host.materializer.destroy();
 		}
 	}
-	async #declare(materializer, target, declared, host) {
-		const versions = await this.#versions(declared.pins, true);
+	async #declare(materializer, target, declared, host, blueprint) {
+		const versions = await this.#versions(declared.pins, true, blueprint);
 		const refusal = versionsToRefusal(versions);
 		if (refusal !== void 0) throw refusal;
 		return {
 			...materializer.declare({
-				pins: versions.pins,
-				scripts: declared.scripts
+				...declared,
+				pins: versions.pins
 			}, target),
 			mirrors: [],
 			releases: versions.releases,
@@ -2032,12 +2045,12 @@ var CLI = class {
 			note: "The catalog step did not complete: USAGE: 'catalog' does not take --offline."
 		};
 	}
-	async #reconcile(materializer, target, declared, host, hostForced) {
+	async #reconcile(materializer, target, declared, host, hostForced, blueprint) {
 		const previous = catalogToNames(target);
 		let releases = [];
 		let provenance = { ...host === void 0 ? {} : { host } };
 		try {
-			const versions = await this.#versions(declared.pins, false);
+			const versions = await this.#versions(declared.pins, false, blueprint);
 			releases = versions.releases;
 			provenance = {
 				...versions.baseline === void 0 ? {} : { versions: versions.baseline },
@@ -2057,8 +2070,8 @@ var CLI = class {
 				...host === void 0 ? {} : { host }
 			};
 			const written = mergeResults(this.#publish(materializer, target, fetched.entries, fetched.mirrors), materializer.declare({
-				pins: versions.pins,
-				scripts: declared.scripts
+				...declared,
+				pins: versions.pins
 			}, target));
 			const floors = [];
 			if (hostForced) floors.push("host");
@@ -2115,7 +2128,26 @@ var CLI = class {
 			upstream.destroy();
 		}
 	}
-	async #versions(declared, offline) {
+	async #versions(declared, offline, blueprint) {
+		if (blueprint?.showcase === true && blueprint.app.includes("browser")) {
+			const ordinary = await this.#versions({
+				runtime: declared.runtime.filter(({ name }) => !Object.hasOwn(SHOWCASE_DEV_DEPENDENCIES, name)),
+				development: declared.development.filter(({ name }) => !Object.hasOwn(SHOWCASE_DEV_DEPENDENCIES, name))
+			}, offline);
+			return {
+				...ordinary,
+				pins: {
+					runtime: [...ordinary.pins.runtime, ...declared.runtime.filter(({ name }) => Object.hasOwn(SHOWCASE_DEV_DEPENDENCIES, name)).map(({ name, range }) => ({
+						name,
+						range: SHOWCASE_DEV_DEPENDENCIES[name] ?? range
+					}))],
+					development: [...ordinary.pins.development, ...declared.development.filter(({ name }) => Object.hasOwn(SHOWCASE_DEV_DEPENDENCIES, name)).map(({ name, range }) => ({
+						name,
+						range: SHOWCASE_DEV_DEPENDENCIES[name] ?? range
+					}))]
+				}
+			};
+		}
 		const dependencies = [...declared.runtime, ...declared.development];
 		if (dependencies.length === 0) return {
 			releases: [],
@@ -2542,6 +2574,29 @@ var CLI = class {
 	}
 	#targetQuestions(target, blueprint, groups, writing = false, declaring = false) {
 		const questions = [];
+		if (blueprint.showcase && blueprint.app.includes("browser")) {
+			const manifest = this.#manifest(target);
+			const parsed = parseJSON(manifest);
+			const malformed = isRecord(parsed) ? ["dependencies", "devDependencies"].flatMap((section) => {
+				const entries = parsed[section];
+				return isRecord(entries) ? Object.keys(SHOWCASE_DEV_DEPENDENCIES).filter((name) => Object.hasOwn(entries, name) && !isString(entries[name])).map((name) => `${section}.${name}`) : [];
+			}) : [];
+			if (malformed.length > 0) questions.push({
+				field: "dependencies",
+				message: `The showcase declarations ${malformed.join(", ")} must hold version strings. Correct package.json before writing configuration or dependencies.`,
+				blocking: true,
+				groups: ["manifest"]
+			});
+			const aligned = replaceManifestOverrides(manifest, blueprintToManifestOverrides(blueprint));
+			const pins = manifestToWritableDependencies(manifest, blueprint);
+			const stale = [...pins.runtime, ...pins.development].filter(({ name, range }) => Object.hasOwn(SHOWCASE_DEV_DEPENDENCIES, name) && SHOWCASE_DEV_DEPENDENCIES[name] !== range);
+			if (aligned === void 0 || !writing && (aligned !== manifest || stale.length > 0)) questions.push({
+				field: "dependencies",
+				message: aligned === void 0 ? "The showcase npm override path is malformed or duplicated. Correct package.json before writing configuration or dependencies." : `The showcase dependency contract has drifted. Run repair to apply ${JSON.stringify(SHOWCASE_DEV_DEPENDENCIES)} and ${JSON.stringify(blueprintToManifestOverrides(blueprint))}.`,
+				blocking: true,
+				groups: ["manifest"]
+			});
+		}
 		const browser = resolveContainedPath(target, "app/browser");
 		if (browser !== void 0 && listFiles(browser).some((path) => path.endsWith(".vue"))) questions.push({
 			field: "extensions",