@orkestrel/scaffold 0.0.83 → 0.0.85

package/dist/src/core/index.d.cts

@@ -379,7 +379,8 @@ export declare function blueprintToConfigArtifacts(blueprint: Blueprint): readon
  * environment on either axis, a sheet, or themes. A framework face counts without a clause of
  * its own, because a face is selected only on an axis that carries a browser environment.
  * A browser setup runtime alone receives nothing, because it renders no surface for `browse`
- * to drive.
+ * to drive. A workspace {@link BROWSE_UPSTREAM} names receives nothing either, because
+ * `@orkestrel/browser` depends on it at runtime and the declaration would close a cycle.
  *
  * A peer is declared here as well as under `peerDependencies`, because a peer is
  * not installed by the workspace that declares it and developing against one
@@ -890,10 +891,22 @@ export declare function blueprintToWritableScripts(blueprint: Blueprint): readon
  * @remarks
  * The package ships the `browse` binary, an MCP server that drives a rendered page and records
  * journeys, and `.claude/rules/quality.md` § Instruments names its registration.
- * `blueprintToDevDependencies` names the blueprints that receive it.
+ * `blueprintToDevDependencies` names the blueprints that receive it, and it withholds the
+ * dependency from the workspaces {@link BROWSE_UPSTREAM} lists.
  */
 export declare const BROWSE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
+/**
+ * Lists the packages `@orkestrel/browser` depends on at runtime, directly or transitively, frozen.
+ *
+ * @remarks
+ * A workspace this list names cannot declare `@orkestrel/browser`, because the declaration closes
+ * a dependency cycle through the browser package's runtime dependencies. The list is the closure
+ * of `dependencies` and `peerDependencies` over the installed manifests, sorted by name, and moves
+ * with the `@orkestrel/browser` pin.
+ */
+export declare const BROWSE_UPSTREAM: readonly string[];
+
 /** Represents a browser framework and its physically occupied axes. */
 export declare interface BrowserExtension {
     readonly surface: 'browser';

package/dist/src/core/index.d.ts

@@ -379,7 +379,8 @@ export declare function blueprintToConfigArtifacts(blueprint: Blueprint): readon
  * environment on either axis, a sheet, or themes. A framework face counts without a clause of
  * its own, because a face is selected only on an axis that carries a browser environment.
  * A browser setup runtime alone receives nothing, because it renders no surface for `browse`
- * to drive.
+ * to drive. A workspace {@link BROWSE_UPSTREAM} names receives nothing either, because
+ * `@orkestrel/browser` depends on it at runtime and the declaration would close a cycle.
  *
  * A peer is declared here as well as under `peerDependencies`, because a peer is
  * not installed by the workspace that declares it and developing against one
@@ -890,10 +891,22 @@ export declare function blueprintToWritableScripts(blueprint: Blueprint): readon
  * @remarks
  * The package ships the `browse` binary, an MCP server that drives a rendered page and records
  * journeys, and `.claude/rules/quality.md` § Instruments names its registration.
- * `blueprintToDevDependencies` names the blueprints that receive it.
+ * `blueprintToDevDependencies` names the blueprints that receive it, and it withholds the
+ * dependency from the workspaces {@link BROWSE_UPSTREAM} lists.
  */
 export declare const BROWSE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
+/**
+ * Lists the packages `@orkestrel/browser` depends on at runtime, directly or transitively, frozen.
+ *
+ * @remarks
+ * A workspace this list names cannot declare `@orkestrel/browser`, because the declaration closes
+ * a dependency cycle through the browser package's runtime dependencies. The list is the closure
+ * of `dependencies` and `peerDependencies` over the installed manifests, sorted by name, and moves
+ * with the `@orkestrel/browser` pin.
+ */
+export declare const BROWSE_UPSTREAM: readonly string[];
+
 /** Represents a browser framework and its physically occupied axes. */
 export declare interface BrowserExtension {
     readonly surface: 'browser';

package/dist/src/core/index.js

@@ -3,7 +3,7 @@ import { fillTemplate } from "@orkestrel/template";
 import { Emitter } from "@orkestrel/emitter";
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.83",
+	version: "0.0.85",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -107,7 +107,7 @@ var package_default = {
 		"@orkestrel/html": "^0.0.12",
 		"@orkestrel/probe": "^0.0.19",
 		"@orkestrel/test": "^0.0.24",
-		"@types/node": "^26.6.3",
+		"@types/node": "^26.6.4",
 		"@vitest/browser-playwright": "^4.1.11",
 		"oxfmt": "^0.71.0",
 		"oxlint": "^1.86.0",
@@ -668,9 +668,35 @@ var SOURCE_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 * @remarks
 * The package ships the `browse` binary, an MCP server that drives a rendered page and records
 * journeys, and `.claude/rules/quality.md` § Instruments names its registration.
-* `blueprintToDevDependencies` names the blueprints that receive it.
+* `blueprintToDevDependencies` names the blueprints that receive it, and it withholds the
+* dependency from the workspaces {@link BROWSE_UPSTREAM} lists.
 */
 var BROWSE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/browser": package_default.devDependencies["@orkestrel/browser"] });
+/**
+* Lists the packages `@orkestrel/browser` depends on at runtime, directly or transitively, frozen.
+*
+* @remarks
+* A workspace this list names cannot declare `@orkestrel/browser`, because the declaration closes
+* a dependency cycle through the browser package's runtime dependencies. The list is the closure
+* of `dependencies` and `peerDependencies` over the installed manifests, sorted by name, and moves
+* with the `@orkestrel/browser` pin.
+*/
+var BROWSE_UPSTREAM = Object.freeze([
+	"@orkestrel/abort",
+	"@orkestrel/codec",
+	"@orkestrel/contract",
+	"@orkestrel/emitter",
+	"@orkestrel/html",
+	"@orkestrel/markdown",
+	"@orkestrel/mcp",
+	"@orkestrel/process",
+	"@orkestrel/router",
+	"@orkestrel/server",
+	"@orkestrel/sse",
+	"@orkestrel/timeout",
+	"@orkestrel/tool",
+	"@orkestrel/websocket"
+]);
 /** Names the development dependency every private `app` environment adds. */
 var APP_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/contract": package_default.dependencies["@orkestrel/contract"] });
 /** Lists the development dependencies a private browser application adds. */
@@ -5648,7 +5674,8 @@ function srcToExports(src) {
 * environment on either axis, a sheet, or themes. A framework face counts without a clause of
 * its own, because a face is selected only on an axis that carries a browser environment.
 * A browser setup runtime alone receives nothing, because it renders no surface for `browse`
-* to drive.
+* to drive. A workspace {@link BROWSE_UPSTREAM} names receives nothing either, because
+* `@orkestrel/browser` depends on it at runtime and the declaration would close a cycle.
 *
 * A peer is declared here as well as under `peerDependencies`, because a peer is
 * not installed by the workspace that declares it and developing against one
@@ -5673,9 +5700,10 @@ function srcToExports(src) {
 function blueprintToDevDependencies(blueprint) {
 	const sheets = blueprintToSheets(blueprint).length > 0 || blueprint.themes;
 	const rendered = blueprint.src.includes("browser") || blueprint.app.includes("browser") || sheets;
+	const own = blueprint.src.length > 0 || sheets ? `@orkestrel/${blueprint.name}` : blueprint.name;
 	const merged = {
 		...BASE_DEV_DEPENDENCIES,
-		...rendered ? BROWSE_DEV_DEPENDENCIES : {},
+		...rendered && !BROWSE_UPSTREAM.includes(own) ? BROWSE_DEV_DEPENDENCIES : {},
 		...sheets ? STYLES_DEV_DEPENDENCIES : {},
 		...blueprint.src.length > 0 || blueprint.bin ? DECLARATION_DEV_DEPENDENCIES : {},
 		...blueprint.src.includes("browser") || blueprint.setup.includes("browser") || sheets ? SOURCE_BROWSER_DEV_DEPENDENCIES : {},
@@ -5687,7 +5715,6 @@ function blueprintToDevDependencies(blueprint) {
 	for (const framework of blueprintToMachinery(blueprint).frameworks) Object.assign(merged, FRAMEWORK_MATRIX[framework].dependencies);
 	for (const extra of blueprint.extras) merged[extra.name] = extra.range;
 	for (const peer of blueprint.peers) if (!Object.hasOwn(merged, peer.name)) merged[peer.name] = peer.range;
-	const own = blueprint.src.length > 0 || sheets ? `@orkestrel/${blueprint.name}` : blueprint.name;
 	const runtime = new Set(blueprint.dependencies.map((dependency) => dependency.name));
 	return Object.fromEntries(Object.entries(merged).filter(([name]) => name !== own && !runtime.has(name)).sort(([left], [right]) => compareValues(left, right)));
 }
@@ -8419,6 +8446,6 @@ var Compiler = class {
 	}
 };
 //#endregion
-export { APP_BROWSER_DEV_DEPENDENCIES, APP_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_TEMPLATES, AXES, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, BROWSE_DEV_DEPENDENCIES, CANON_PATHS, CATALOG_AGENT_PATH, CATALOG_CLOSING_MARKER, CATALOG_OPENING_MARKER, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_RANGE_PATTERN, FLOOR_RANGE_PATTERN, FOREIGN_NAME_PATTERN, FRAMEWORKS, FRAMEWORK_MATRIX, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HEX_PATTERN, HOST_INVENTORY_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, JOURNEY_CONFIG_PATH, MANIFEST_PATH, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_SCRIPT_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, MINIMUM_NODE_VERSION, MINIMUM_NPM_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, REFERENCE_PATHS, RELEASE_PROOF_COMMAND, RESERVED_SHEET_NAMES, SEED_GUIDE_PATHS, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, STYLES_DEV_DEPENDENCIES, STYLES_ENTRY_PATH, SURFACES, ScaffoldError, TAB_WIDTH, TARGET_SKILL_NAMES, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, VERSION_PATTERN, WORKSPACE_DEV_ENGINES, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToExports, blueprintToFaces, blueprintToGuideArtifacts, blueprintToHostArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToOrchestrationArtifacts, blueprintToProjects, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSheets, blueprintToSourceArtifacts, blueprintToTestArtifacts, blueprintToWritableScripts, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeHash, contentToHex, createBlueprint, dependenciesToQuestions, extractRangeMajor, extractVersion, inferDrift, inferGroup, isArtifact, isAudit, isBlueprint, isBrowserExtension, isCanonPath, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDeferredPath, isDependency, isDependencyName, isEnvironment, isExtension, isFinding, isFloorPath, isGroup, isGroups, isHex, isManifestScript, isMirror, isOverride, isPath, isPlan, isQuestion, isRetainedPath, isScaffoldError, isSheetName, isSnapshot, isStylesExtension, isSurface, manifestToDependencies, manifestToName, matchesDriftReachability, matchesEngines, matchesOrchestrationPath, matchesPrintWidth, matchesRange, nameToGuide, overridesToQuestions, parseBlueprint, parseCompilerOptions, parseExtension, parseGroups, parseSnapshot, pathToCondition, planToFindings, planToHash, planToSummary, renderSkillPointer, replaceManifestRanges, replaceManifestScripts, replacePlanRanges, selectGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
+export { APP_BROWSER_DEV_DEPENDENCIES, APP_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_TEMPLATES, AXES, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, BROWSE_DEV_DEPENDENCIES, BROWSE_UPSTREAM, CANON_PATHS, CATALOG_AGENT_PATH, CATALOG_CLOSING_MARKER, CATALOG_OPENING_MARKER, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_RANGE_PATTERN, FLOOR_RANGE_PATTERN, FOREIGN_NAME_PATTERN, FRAMEWORKS, FRAMEWORK_MATRIX, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HEX_PATTERN, HOST_INVENTORY_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, JOURNEY_CONFIG_PATH, MANIFEST_PATH, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_SCRIPT_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, MINIMUM_NODE_VERSION, MINIMUM_NPM_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, REFERENCE_PATHS, RELEASE_PROOF_COMMAND, RESERVED_SHEET_NAMES, SEED_GUIDE_PATHS, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, STYLES_DEV_DEPENDENCIES, STYLES_ENTRY_PATH, SURFACES, ScaffoldError, TAB_WIDTH, TARGET_SKILL_NAMES, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, VERSION_PATTERN, WORKSPACE_DEV_ENGINES, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToExports, blueprintToFaces, blueprintToGuideArtifacts, blueprintToHostArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToOrchestrationArtifacts, blueprintToProjects, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSheets, blueprintToSourceArtifacts, blueprintToTestArtifacts, blueprintToWritableScripts, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeHash, contentToHex, createBlueprint, dependenciesToQuestions, extractRangeMajor, extractVersion, inferDrift, inferGroup, isArtifact, isAudit, isBlueprint, isBrowserExtension, isCanonPath, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDeferredPath, isDependency, isDependencyName, isEnvironment, isExtension, isFinding, isFloorPath, isGroup, isGroups, isHex, isManifestScript, isMirror, isOverride, isPath, isPlan, isQuestion, isRetainedPath, isScaffoldError, isSheetName, isSnapshot, isStylesExtension, isSurface, manifestToDependencies, manifestToName, matchesDriftReachability, matchesEngines, matchesOrchestrationPath, matchesPrintWidth, matchesRange, nameToGuide, overridesToQuestions, parseBlueprint, parseCompilerOptions, parseExtension, parseGroups, parseSnapshot, pathToCondition, planToFindings, planToHash, planToSummary, renderSkillPointer, replaceManifestRanges, replaceManifestScripts, replacePlanRanges, selectGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
 
 //# sourceMappingURL=index.js.map