@orkestrel/scaffold 0.0.124 → 0.0.126

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-publish/scripts/steps.js +523 -0
  2. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +70 -11
  3. package/dist/bin/main.js +51 -18
  4. package/dist/bin/main.js.map +1 -1
  5. package/dist/host/agents/orchestration.md +7 -2
  6. package/dist/host/agents/platforms/windows.md +9 -1
  7. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +1 -1
  8. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +1 -1
  9. package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +1 -0
  10. package/dist/host/agents/skills/orkestrel-harden/references/methods.md +32 -4
  11. package/dist/host/agents/skills/orkestrel-journey/SKILL.md +18 -19
  12. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -0
  13. package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +2 -1
  14. package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +5 -1
  15. package/dist/host/agents/skills/orkestrel-publish/SKILL.md +1 -0
  16. package/dist/host/agents/skills/orkestrel-publish/references/release.md +2 -2
  17. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +23 -6
  18. package/dist/host/agents/skills/orkestrel-publish/scripts/steps.ts +654 -0
  19. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +79 -14
  20. package/dist/host/claude/agents/orkestrel.md +28 -28
  21. package/dist/host/claude/rules/patterns.md +1 -1
  22. package/dist/host/claude/rules/portability.md +2 -0
  23. package/dist/host/claude/rules/quality.md +6 -1
  24. package/dist/host/claude/rules/tests.md +6 -1
  25. package/dist/host/claude/rules/workspace.md +8 -3
  26. package/dist/host/guides/agent.md +575 -346
  27. package/dist/host/guides/brief.md +52 -48
  28. package/dist/host/guides/browser.md +2 -2
  29. package/dist/host/guides/interpret.md +531 -155
  30. package/dist/host/guides/mcp.md +183 -61
  31. package/dist/host/guides/ndjson.md +4 -3
  32. package/dist/host/guides/ollama.md +125 -68
  33. package/dist/host/guides/program.md +117 -39
  34. package/dist/host/guides/qualifier.md +110 -59
  35. package/dist/host/guides/rater.md +85 -32
  36. package/dist/host/guides/scaffold.md +49 -22
  37. package/dist/host/guides/study.md +596 -489
  38. package/dist/host/guides/toolbox.md +159 -80
  39. package/dist/host/guides/workflow.md +44 -25
  40. package/dist/host/manifest.json +41 -35
  41. package/dist/src/core/index.cjs +12 -10
  42. package/dist/src/core/index.cjs.map +1 -1
  43. package/dist/src/core/index.d.cts +3 -1
  44. package/dist/src/core/index.d.ts +3 -1
  45. package/dist/src/core/index.js +12 -10
  46. package/dist/src/core/index.js.map +1 -1
  47. package/dist/src/server/index.cjs +23 -11
  48. package/dist/src/server/index.cjs.map +1 -1
  49. package/dist/src/server/index.d.cts +10 -6
  50. package/dist/src/server/index.d.ts +10 -6
  51. package/dist/src/server/index.js +23 -11
  52. package/dist/src/server/index.js.map +1 -1
  53. package/package.json +7 -7
@@ -2590,7 +2590,7 @@ export declare class Materializer implements MaterializerInterface {
2590
2590
  /** Exposes the upstream reader's observation channel. */
2591
2591
  get emitter(): EmitterInterface<UpstreamEventMap>;
2592
2592
  /**
2593
- * Looks up the highest release each declared range admits.
2593
+ * Looks up the highest eligible release each declared range admits.
2594
2594
  *
2595
2595
  * @param dependencies - The declared dependencies to look up.
2596
2596
  * @returns One release verdict per dependency, in input order.
@@ -2600,10 +2600,14 @@ export declare class Materializer implements MaterializerInterface {
2600
2600
  *
2601
2601
  * @remarks
2602
2602
  * The reader selects across the packument's stable version map before any
2603
- * collection bound can truncate it. It falls back to `dist-tags.latest` only
2604
- * when that version satisfies the declared range. `*` requests the highest
2605
- * stable version outright. The verdict's `major` field carries the stable
2606
- * major from the `latest` tag when that tag can be read.
2603
+ * collection bound can truncate it. A version whose entry carries a non-empty
2604
+ * string `deprecated` field is never eligible. When `dist-tags.latest` reads as a
2605
+ * version, it caps `*` and every range in its own major; a range on another major
2606
+ * reads the top of that major. A map whose admitted versions are all ineligible
2607
+ * reads `unmatched`. A map holding no admitted version falls back to
2608
+ * `dist-tags.latest` only when that version satisfies the declared range. The
2609
+ * verdict's `major` field carries the stable major from the `latest` tag when
2610
+ * that tag can be read.
2607
2611
  *
2608
2612
  * @example
2609
2613
  * ```ts
@@ -2786,7 +2790,7 @@ export declare class Materializer implements MaterializerInterface {
2786
2790
  export declare interface UpstreamInterface {
2787
2791
  readonly emitter: EmitterInterface<UpstreamEventMap>;
2788
2792
  /**
2789
- * Looks up the highest release each declared range admits.
2793
+ * Looks up the highest eligible release each declared range admits.
2790
2794
  *
2791
2795
  * @param dependencies - The declared dependencies to look up.
2792
2796
  * @returns One release verdict per dependency, in input order.
@@ -2590,7 +2590,7 @@ export declare class Materializer implements MaterializerInterface {
2590
2590
  /** Exposes the upstream reader's observation channel. */
2591
2591
  get emitter(): EmitterInterface<UpstreamEventMap>;
2592
2592
  /**
2593
- * Looks up the highest release each declared range admits.
2593
+ * Looks up the highest eligible release each declared range admits.
2594
2594
  *
2595
2595
  * @param dependencies - The declared dependencies to look up.
2596
2596
  * @returns One release verdict per dependency, in input order.
@@ -2600,10 +2600,14 @@ export declare class Materializer implements MaterializerInterface {
2600
2600
  *
2601
2601
  * @remarks
2602
2602
  * The reader selects across the packument's stable version map before any
2603
- * collection bound can truncate it. It falls back to `dist-tags.latest` only
2604
- * when that version satisfies the declared range. `*` requests the highest
2605
- * stable version outright. The verdict's `major` field carries the stable
2606
- * major from the `latest` tag when that tag can be read.
2603
+ * collection bound can truncate it. A version whose entry carries a non-empty
2604
+ * string `deprecated` field is never eligible. When `dist-tags.latest` reads as a
2605
+ * version, it caps `*` and every range in its own major; a range on another major
2606
+ * reads the top of that major. A map whose admitted versions are all ineligible
2607
+ * reads `unmatched`. A map holding no admitted version falls back to
2608
+ * `dist-tags.latest` only when that version satisfies the declared range. The
2609
+ * verdict's `major` field carries the stable major from the `latest` tag when
2610
+ * that tag can be read.
2607
2611
  *
2608
2612
  * @example
2609
2613
  * ```ts
@@ -2786,7 +2790,7 @@ export declare class Materializer implements MaterializerInterface {
2786
2790
  export declare interface UpstreamInterface {
2787
2791
  readonly emitter: EmitterInterface<UpstreamEventMap>;
2788
2792
  /**
2789
- * Looks up the highest release each declared range admits.
2793
+ * Looks up the highest eligible release each declared range admits.
2790
2794
  *
2791
2795
  * @param dependencies - The declared dependencies to look up.
2792
2796
  * @returns One release verdict per dependency, in input order.
@@ -4285,7 +4285,7 @@ var Upstream = class {
4285
4285
  return this.#emitter;
4286
4286
  }
4287
4287
  /**
4288
- * Looks up the highest release each declared range admits.
4288
+ * Looks up the highest eligible release each declared range admits.
4289
4289
  *
4290
4290
  * @param dependencies - The declared dependencies to look up.
4291
4291
  * @returns One release verdict per dependency, in input order.
@@ -4295,10 +4295,14 @@ var Upstream = class {
4295
4295
  *
4296
4296
  * @remarks
4297
4297
  * The reader selects across the packument's stable version map before any
4298
- * collection bound can truncate it. It falls back to `dist-tags.latest` only
4299
- * when that version satisfies the declared range. `*` requests the highest
4300
- * stable version outright. The verdict's `major` field carries the stable
4301
- * major from the `latest` tag when that tag can be read.
4298
+ * collection bound can truncate it. A version whose entry carries a non-empty
4299
+ * string `deprecated` field is never eligible. When `dist-tags.latest` reads as a
4300
+ * version, it caps `*` and every range in its own major; a range on another major
4301
+ * reads the top of that major. A map whose admitted versions are all ineligible
4302
+ * reads `unmatched`. A map holding no admitted version falls back to
4303
+ * `dist-tags.latest` only when that version satisfies the declared range. The
4304
+ * verdict's `major` field carries the stable major from the `latest` tag when
4305
+ * that tag can be read.
4302
4306
  *
4303
4307
  * @example
4304
4308
  * ```ts
@@ -4534,7 +4538,7 @@ var Upstream = class {
4534
4538
  name: dependency.name,
4535
4539
  range: dependency.range,
4536
4540
  lookup: outcome.lookup === "found" ? "unmatched" : outcome.lookup,
4537
- note: outcome.lookup === "found" ? UNREADABLE_VERSION_NOTE : outcome.note,
4541
+ note: outcome.lookup !== "found" ? outcome.note : this.#admitted(outcome.content, dependency.range).length > 0 ? "every version the range admits is deprecated or above the latest tag" : UNREADABLE_VERSION_NOTE,
4538
4542
  ...major === void 0 ? {} : { major }
4539
4543
  } : {
4540
4544
  name: dependency.name,
@@ -4679,13 +4683,21 @@ var Upstream = class {
4679
4683
  return CONTROL_CHARACTER_PATTERN.test(latest) ? void 0 : latest;
4680
4684
  }
4681
4685
  #releaseVersion(content, range) {
4686
+ const latest = this.#latest(content);
4687
+ const admitted = this.#admitted(content, range);
4688
+ if (admitted.length === 0) return latest !== void 0 && this.#admits(range, latest) ? latest : void 0;
4689
+ const ceiling = this.#ceiling(range, latest);
4690
+ return admitted.filter(([version, entry]) => !(isRecord(entry) && isString(entry.deprecated) && entry.deprecated.length > 0) && (ceiling === void 0 || compareVersions(version, ceiling) <= 0)).reduce((highest, [version]) => highest === void 0 || compareVersions(version, highest) > 0 ? version : highest, void 0);
4691
+ }
4692
+ #admitted(content, range) {
4682
4693
  const parsed = parseJSON(content);
4683
- if (!isRecord(parsed)) return void 0;
4694
+ if (!isRecord(parsed)) return [];
4684
4695
  const versions = parsed.versions;
4685
- const selected = isRecord(versions) ? Object.keys(versions).filter((version) => this.#admits(range, version)).reduce((highest, version) => highest === void 0 || compareVersions(version, highest) > 0 ? version : highest, void 0) : void 0;
4686
- if (selected !== void 0) return selected;
4687
- const latest = this.#latest(content);
4688
- return latest !== void 0 && this.#admits(range, latest) ? latest : void 0;
4696
+ return isRecord(versions) ? Object.entries(versions).filter(([version]) => this.#admits(range, version)) : [];
4697
+ }
4698
+ #ceiling(range, latest) {
4699
+ const major = latest === void 0 ? void 0 : extractVersion(latest)?.[0];
4700
+ return major !== void 0 && (range === "*" || extractRangeMajor(range) === major) ? latest : void 0;
4689
4701
  }
4690
4702
  #admits(range, version) {
4691
4703
  const extracted = extractVersion(version);