@orkestrel/scaffold 0.0.134 → 0.0.136

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +777 -83
  2. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +327 -21
  3. package/dist/bin/main.js +254 -36
  4. package/dist/bin/main.js.map +1 -1
  5. package/dist/host/AGENTS.md +2 -2
  6. package/dist/host/agents/orchestration.md +2 -2
  7. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -1
  8. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +983 -123
  9. package/dist/host/agents/skills/orkestrel-publish/references/release.md +1 -0
  10. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +22 -5
  11. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +403 -32
  12. package/dist/host/claude/agents/orkestrel.md +17 -17
  13. package/dist/host/claude/agents/reviewer.md +1 -1
  14. package/dist/host/claude/rules/architecture.md +1 -1
  15. package/dist/host/claude/rules/documentation.md +1 -1
  16. package/dist/host/claude/rules/patterns.md +4 -2
  17. package/dist/host/claude/rules/workspace.md +73 -67
  18. package/dist/host/configs/helpers.ts +109 -73
  19. package/dist/host/dotfiles/oxlintrc.json +1 -57
  20. package/dist/host/guides/agent.md +989 -395
  21. package/dist/host/guides/contract.md +198 -163
  22. package/dist/host/guides/database.md +978 -503
  23. package/dist/host/guides/indexeddb.md +80 -66
  24. package/dist/host/guides/middleware.md +5 -5
  25. package/dist/host/guides/ollama.md +41 -42
  26. package/dist/host/guides/relation.md +56 -32
  27. package/dist/host/guides/scaffold.md +185 -107
  28. package/dist/host/guides/sqlite.md +44 -23
  29. package/dist/host/guides/study.md +12 -12
  30. package/dist/host/guides/test.md +163 -47
  31. package/dist/host/guides/toolbox.md +127 -81
  32. package/dist/host/guides/workspace.md +21 -14
  33. package/dist/host/manifest.json +30 -30
  34. package/dist/host/scripts/browsers.sh +0 -0
  35. package/dist/host/scripts/codex.sh +0 -0
  36. package/dist/host/scripts/cursor.sh +0 -0
  37. package/dist/host/scripts/deps.sh +0 -0
  38. package/dist/host/scripts/npm.sh +0 -0
  39. package/dist/host/scripts/ollama.sh +0 -0
  40. package/dist/host/tests/config.test.ts +237 -115
  41. package/dist/src/core/index.cjs +591 -218
  42. package/dist/src/core/index.cjs.map +1 -1
  43. package/dist/src/core/index.d.cts +248 -29
  44. package/dist/src/core/index.d.ts +248 -29
  45. package/dist/src/core/index.js +581 -216
  46. package/dist/src/core/index.js.map +1 -1
  47. package/dist/src/server/index.cjs +18 -8
  48. package/dist/src/server/index.cjs.map +1 -1
  49. package/dist/src/server/index.d.cts +4 -3
  50. package/dist/src/server/index.d.ts +4 -3
  51. package/dist/src/server/index.js +19 -9
  52. package/dist/src/server/index.js.map +1 -1
  53. package/package.json +3 -3
@@ -630,7 +630,7 @@ export declare function isInventory(value: unknown): value is readonly unknown[]
630
630
  * The whole closed record a manifest-writing method accepts, so a caller
631
631
  * naming a region the writer does not carry is refused before any byte moves.
632
632
  * Each region is bounded by the same collection law its own list guard applies,
633
- * and `additions` is the one region a caller may omit.
633
+ * and `additions`, `overrides`, and `entries` are the regions a caller may omit.
634
634
  *
635
635
  * @example
636
636
  * ```ts
@@ -962,7 +962,7 @@ export declare function listFiles(root: string): readonly string[];
962
962
  *
963
963
  * @remarks
964
964
  * The population sits under `configs/src` and `configs/app`, and the widest blueprint
965
- * compiles it: every environment on both axes, `bin`, `reporter`, `styles`, `themes`, `showcase`,
965
+ * compiles it: every environment on both axes, `bin`, `styles`, `themes`, `showcase`,
966
966
  * `journey`, and each framework on both axes. A wrapper the plan claims pairs with its
967
967
  * artifact, and the rest report `foreign`, which lets the deletion verb take the wrappers
968
968
  * an environment left behind.
@@ -1397,7 +1397,8 @@ export declare class Materializer implements MaterializerInterface {
1397
1397
  * the manifest does not declare is the caller's mistake and throws. A script
1398
1398
  * holding a value the region does not accept is the workspace author's own
1399
1399
  * chain, so the script region is skipped without a byte moving and the range
1400
- * region is still written. The advisory channel reports what the maintainer
1400
+ * region is still written. An entry section holding another shape is the package's own
1401
+ * value, so the entry region is skipped the same way. The advisory channel reports what the maintainer
1401
1402
  * must paste.
1402
1403
  */
1403
1404
  declare(regions: ManifestRegionSet, target: string): MaterializeResult;
@@ -630,7 +630,7 @@ export declare function isInventory(value: unknown): value is readonly unknown[]
630
630
  * The whole closed record a manifest-writing method accepts, so a caller
631
631
  * naming a region the writer does not carry is refused before any byte moves.
632
632
  * Each region is bounded by the same collection law its own list guard applies,
633
- * and `additions` is the one region a caller may omit.
633
+ * and `additions`, `overrides`, and `entries` are the regions a caller may omit.
634
634
  *
635
635
  * @example
636
636
  * ```ts
@@ -962,7 +962,7 @@ export declare function listFiles(root: string): readonly string[];
962
962
  *
963
963
  * @remarks
964
964
  * The population sits under `configs/src` and `configs/app`, and the widest blueprint
965
- * compiles it: every environment on both axes, `bin`, `reporter`, `styles`, `themes`, `showcase`,
965
+ * compiles it: every environment on both axes, `bin`, `styles`, `themes`, `showcase`,
966
966
  * `journey`, and each framework on both axes. A wrapper the plan claims pairs with its
967
967
  * artifact, and the rest report `foreign`, which lets the deletion verb take the wrappers
968
968
  * an environment left behind.
@@ -1397,7 +1397,8 @@ export declare class Materializer implements MaterializerInterface {
1397
1397
  * the manifest does not declare is the caller's mistake and throws. A script
1398
1398
  * holding a value the region does not accept is the workspace author's own
1399
1399
  * chain, so the script region is skipped without a byte moving and the range
1400
- * region is still written. The advisory channel reports what the maintainer
1400
+ * region is still written. An entry section holding another shape is the package's own
1401
+ * value, so the entry region is skipped the same way. The advisory channel reports what the maintainer
1401
1402
  * must paste.
1402
1403
  */
1403
1404
  declare(regions: ManifestRegionSet, target: string): MaterializeResult;
@@ -1,6 +1,6 @@
1
1
  import { createRequire } from "node:module";
2
2
  import { andOf, arrayOf, attempt, boundsOf, comparePrimitives, compileGuard, holds, isArray, isBoolean, isDefined, isError, isFunction, isInteger, isNonNegativeInteger, isNumber, isObject, isRecord, isString, parseJSON, parseJSONAs, parseStringField, recordOf, recordShape, stringOf, stringShape, unionOf, whereOf } from "@orkestrel/contract";
3
- import { AXES, CANON_PATHS, CATALOG_AGENT_PATH, CATALOG_END_MARKER, CATALOG_START_MARKER, CONTROL_CHARACTER_PATTERN, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, FRAMEWORKS, HOST_INVENTORY_PATH, HOST_PATHS, MAX_ARTIFACT_BYTES, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, REFERENCE_PATHS, SURFACE_TRANSFERS, ScaffoldError, blueprintToConfigArtifacts, bytesToHex, catalogToLayers, collectSurfaceCollisions, collectSurfaceConflicts, compareSurfaceCollisions, compareVersions, computeBytes, computeTotal, contentToHex, createBlueprint, extractRangeMajor, extractVersion, inferArtifactGroup, insertManifestDependencies, isAudit, isCatalogEntry, isCollection, isDependency, isDependencyName, isFloorPath, isHexContent, isManifestScript, isMirror, isPath, isPlan, isRetainedPath, isSnapshot, iterateAnswers, manifestToName, matchesArtifactDriftReachability, matchesRange, nameToGuide, parseOwnedJSONValue, planToArtifactFindings, renderSkillPointer, replaceManifestOverrides, replaceManifestRanges, replaceManifestScripts } from "../core/index.js";
3
+ import { AXES, CANON_PATHS, CATALOG_AGENT_PATH, CATALOG_END_MARKER, CATALOG_START_MARKER, CONTROL_CHARACTER_PATTERN, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, FRAMEWORKS, HOST_INVENTORY_PATH, HOST_PATHS, MAX_ARTIFACT_BYTES, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, REFERENCE_PATHS, SURFACE_TRANSFERS, ScaffoldError, blueprintToConfigArtifacts, bytesToHex, catalogToLayers, collectSurfaceCollisions, collectSurfaceConflicts, compareSurfaceCollisions, compareVersions, computeBytes, computeTotal, contentToHex, createBlueprint, extractRangeMajor, extractVersion, inferArtifactGroup, insertManifestDependencies, insertManifestEntries, isAudit, isCatalogEntry, isCollection, isDependency, isDependencyName, isFloorPath, isHexContent, isManifestScript, isMirror, isPath, isPlan, isRetainedPath, isSnapshot, iterateAnswers, manifestToName, matchesArtifactDriftReachability, matchesRange, nameToGuide, parseOwnedJSONValue, planToArtifactFindings, renderSkillPointer, replaceManifestOverrides, replaceManifestRanges, replaceManifestScripts } from "../core/index.js";
4
4
  import { createHash, randomUUID } from "node:crypto";
5
5
  import { chmodSync, closeSync, constants, copyFileSync, fstatSync, linkSync, lstatSync, mkdirSync, mkdtempSync, openSync, opendirSync, readSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, rmdirSync, writeFileSync } from "node:fs";
6
6
  import { tmpdir } from "node:os";
@@ -1020,7 +1020,7 @@ function listCanonPaths(target, groups) {
1020
1020
  *
1021
1021
  * @remarks
1022
1022
  * The population sits under `configs/src` and `configs/app`, and the widest blueprint
1023
- * compiles it: every environment on both axes, `bin`, `reporter`, `styles`, `themes`, `showcase`,
1023
+ * compiles it: every environment on both axes, `bin`, `styles`, `themes`, `showcase`,
1024
1024
  * `journey`, and each framework on both axes. A wrapper the plan claims pairs with its
1025
1025
  * artifact, and the rest report `foreign`, which lets the deletion verb take the wrappers
1026
1026
  * an environment left behind.
@@ -1045,8 +1045,7 @@ function listWrapperPaths(target, groups) {
1045
1045
  name,
1046
1046
  axes: AXES
1047
1047
  })),
1048
- bin: true,
1049
- reporter: true,
1048
+ bin: ["main"],
1050
1049
  styles: true,
1051
1050
  themes: true,
1052
1051
  showcase: true,
@@ -2470,7 +2469,7 @@ var isDependencies = andOf(isCollection, arrayOf(isDependency));
2470
2469
  * The whole closed record a manifest-writing method accepts, so a caller
2471
2470
  * naming a region the writer does not carry is refused before any byte moves.
2472
2471
  * Each region is bounded by the same collection law its own list guard applies,
2473
- * and `additions` is the one region a caller may omit.
2472
+ * and `additions`, `overrides`, and `entries` are the regions a caller may omit.
2474
2473
  *
2475
2474
  * @example
2476
2475
  * ```ts
@@ -2495,8 +2494,17 @@ var isManifestRegionSet = recordOf({
2495
2494
  runtime: isDependencies,
2496
2495
  development: isDependencies
2497
2496
  }),
2498
- overrides: compileGuard(recordShape(recordShape(stringShape())))
2499
- }, ["additions", "overrides"]);
2497
+ overrides: compileGuard(recordShape(recordShape(stringShape()))),
2498
+ entries: recordOf({
2499
+ bin: compileGuard(recordShape(stringShape())),
2500
+ files: andOf(isCollection, arrayOf(isString)),
2501
+ exports: isRecord
2502
+ })
2503
+ }, [
2504
+ "additions",
2505
+ "overrides",
2506
+ "entries"
2507
+ ]);
2500
2508
  /** Narrows a value to a bounded list of fetched guide mirrors. */
2501
2509
  var isMirrors = andOf(isCollection, arrayOf(isMirror));
2502
2510
  /** Narrows a value to a bounded list of fleet catalog rows. */
@@ -3512,7 +3520,8 @@ var Materializer = class {
3512
3520
  * the manifest does not declare is the caller's mistake and throws. A script
3513
3521
  * holding a value the region does not accept is the workspace author's own
3514
3522
  * chain, so the script region is skipped without a byte moving and the range
3515
- * region is still written. The advisory channel reports what the maintainer
3523
+ * region is still written. An entry section holding another shape is the package's own
3524
+ * value, so the entry region is skipped the same way. The advisory channel reports what the maintainer
3516
3525
  * must paste.
3517
3526
  */
3518
3527
  declare(regions, target) {
@@ -4106,7 +4115,8 @@ var Materializer = class {
4106
4115
  const missing = [...regions.pins.runtime, ...regions.pins.development].find((dependency) => !text.includes(JSON.stringify(dependency.name)));
4107
4116
  throw this.#error("INVALID", `The manifest does not declare ${missing?.name ?? "a requested package"}, so its range cannot be rewritten.`, missing === void 0 ? void 0 : { name: missing.name });
4108
4117
  }
4109
- return replaceManifestScripts(manifest, regions.scripts) ?? manifest;
4118
+ const scripted = replaceManifestScripts(manifest, regions.scripts) ?? manifest;
4119
+ return regions.entries === void 0 ? scripted : insertManifestEntries(scripted, regions.entries) ?? scripted;
4110
4120
  };
4111
4121
  }
4112
4122
  #finish(result) {