@seanmars/tospec 0.19.0-beta.8 → 0.21.0

package/dist/core/change-status-policy.d.ts

@@ -21,14 +21,10 @@ export interface ChangeStatusPolicyArtifact {
     status: ArtifactStatusValue;
 }
 /**
- * `optional` and `skipped` are separate values, not one.
- *
- * Round 4 report 12: both an optional artifact nobody has written and one the
- * change declared away with `skip_specs: true` reported `skipped`, so a caller
- * could not tell "you may still write this" from "this change says there is
- * nothing to write". The issue schema's delta specs are the case that matters:
- * its own instruction says to write them when the fix changes observable
- * behaviour, and an agent driving off this field was told they were skipped.
+ * `optional` and `skipped` are separate values: collapsed into one, a caller
+ * cannot tell "you may still write this" from "this change says there is
+ * nothing to write". The issue schema's delta specs are the case that matters —
+ * its instruction asks for them whenever the fix changes observable behaviour.
  */
 export type ArtifactStatusValue = 'done' | 'ready' | 'blocked' | 'skipped' | 'optional' | 'stub';
 export interface ChangeNextStepsInput {

package/dist/core/change-status-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-status-policy.d.ts","sourceRoot":"","sources":["../../src/core/change-status-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,6BAA6B,EAAE,OAAO,CAAC;IACvC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjG,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,0BAA0B,EAAE,CAAC;IAC/C,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,mBAAmB,GAAG,SAAS,CAWjC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAU3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAiCpE"}
+{"version":3,"file":"change-status-policy.d.ts","sourceRoot":"","sources":["../../src/core/change-status-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,6BAA6B,EAAE,OAAO,CAAC;IACvC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjG,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,0BAA0B,EAAE,CAAC;IAC/C,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,mBAAmB,GAAG,SAAS,CAWjC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAU3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,EAAE,CA+BpE"}

package/dist/core/change-status-policy.js

@@ -29,16 +29,14 @@ export function buildNextSteps(input) {
     }
     if (input.allArtifactsComplete) {
         steps.push('All planning artifacts are complete; review tasks before implementation.');
-        // Still offered: "complete" means every *required* artifact is written, and
-        // an unwritten optional one is exactly what a reader would want told here.
+        // Still offered: "complete" means every *required* artifact is written, so
+        // an unwritten optional one is worth naming here.
         steps.push(...optionalSteps(input));
         return steps;
     }
-    // A stub is neither ready nor done, so without this the only state that
-    // reports `isComplete: false` with no next step at all was the one where the
-    // work looks finished from a directory listing: the files exist and still hold
-    // the template. Human output named it (`[!] design (stub: ...)`); the machine
-    // contract left a caller with nothing to do and no reason why.
+    // A stub is neither ready nor done, so without this it is the one state
+    // reporting `isComplete: false` with no next step — and the one that looks
+    // finished from a directory listing.
     const stubs = input.artifactStatuses.filter((artifact) => artifact.status === 'stub');
     for (const stub of stubs) {
         steps.push(`Artifact ${stub.id} is still the unfilled template. Run tospec instructions ${stub.id} --change "${input.changeName}" --json, then replace the file's contents.`);
@@ -47,16 +45,10 @@ export function buildNextSteps(input) {
     return steps;
 }
 /**
- * Optional artifacts an author may still want to write.
- *
- * They never reach `ready` — an optional artifact is not a prerequisite for
- * anything — so before this they appeared in no next step at any point in a
- * change's life (round 4 report 12). An agent following `nextSteps` therefore
- * never wrote delta specs for an issue fix, even though the issue schema's own
- * instruction asks for them whenever the fix changes observable behaviour.
- *
- * Phrased as an offer, not an instruction: the whole point of `optional` is
- * that skipping it is a legitimate outcome.
+ * Optional artifacts an author may still want to write. Nothing depends on them,
+ * so they never reach `ready` and would otherwise appear in no next step at any
+ * point in a change's life. Phrased as an offer, not an instruction: skipping
+ * an optional artifact is a legitimate outcome.
  */
 function optionalSteps(input) {
     return input.artifactStatuses

package/dist/core/change-status-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"change-status-policy.js","sourceRoot":"","sources":["../../src/core/change-status-policy.ts"],"names":[],"mappings":"AA+CA,MAAM,UAAU,qBAAqB,CACnC,YAAsC;IAEtC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,aAAa,EAAE,YAAY,CAAC,aAAa;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,aAAa,EAAE,MAAM;QACrB,iBAAiB,EAAE,KAAK,CAAC,WAAW;QACpC,aAAa,EAAE,EAAE;QACjB,gBAAgB,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;QACrC,6BAA6B,EAAE,KAAK;QACpC,WAAW,EAAE,CAAC,kFAAkF,CAAC;KAClG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA2B;IACxD,MAAM,aAAa,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CACR,2BAA2B,aAAa,CAAC,EAAE,cAAc,KAAK,CAAC,UAAU,wCAAwC,CAClH,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACvF,4EAA4E;QAC5E,2EAA2E;QAC3E,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wEAAwE;IACxE,6EAA6E;IAC7E,+EAA+E;IAC/E,8EAA8E;IAC9E,+DAA+D;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CACR,YAAY,IAAI,CAAC,EAAE,4DAA4D,IAAI,CAAC,EAAE,cAAc,KAAK,CAAC,UAAU,6CAA6C,CAClK,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,aAAa,CAAC,KAA2B;IAChD,OAAO,KAAK,CAAC,gBAAgB;SAC1B,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC;SACpD,GAAG,CACF,CAAC,QAAQ,EAAE,EAAE,CACX,aAAa,QAAQ,CAAC,EAAE,4CAA4C,QAAQ,CAAC,EAAE,cAAc,KAAK,CAAC,UAAU,mCAAmC,CACnJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"change-status-policy.js","sourceRoot":"","sources":["../../src/core/change-status-policy.ts"],"names":[],"mappings":"AA2CA,MAAM,UAAU,qBAAqB,CACnC,YAAsC;IAEtC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,aAAa,EAAE,YAAY,CAAC,aAAa;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,aAAa,EAAE,MAAM;QACrB,iBAAiB,EAAE,KAAK,CAAC,WAAW;QACpC,aAAa,EAAE,EAAE;QACjB,gBAAgB,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;QACrC,6BAA6B,EAAE,KAAK;QACpC,WAAW,EAAE,CAAC,kFAAkF,CAAC;KAClG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA2B;IACxD,MAAM,aAAa,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CACR,2BAA2B,aAAa,CAAC,EAAE,cAAc,KAAK,CAAC,UAAU,wCAAwC,CAClH,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACvF,2EAA2E;QAC3E,kDAAkD;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wEAAwE;IACxE,2EAA2E;IAC3E,qCAAqC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CACR,YAAY,IAAI,CAAC,EAAE,4DAA4D,IAAI,CAAC,EAAE,cAAc,KAAK,CAAC,UAAU,6CAA6C,CAClK,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,KAA2B;IAChD,OAAO,KAAK,CAAC,gBAAgB;SAC1B,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC;SACpD,GAAG,CACF,CAAC,QAAQ,EAAE,EAAE,CACX,aAAa,QAAQ,CAAC,EAAE,4CAA4C,QAAQ,CAAC,EAAE,cAAc,KAAK,CAAC,UAAU,mCAAmC,CACnJ,CAAC;AACN,CAAC"}

package/dist/core/codex-metrics.d.ts

@@ -3,22 +3,17 @@
  * report `skill-metrics.ts` builds from Claude Code transcripts.
  *
  * Codex keeps one session tree shared by every project
- * (`<CODEX_HOME or ~/.codex>/sessions/<yyyy>/<mm>/<dd>/rollout-*.jsonl`),
- * partitioned by date rather than by project, with the working directory
- * recorded once per session (`type: "session_meta"`, `payload.cwd`) rather than
- * encoded into a directory name. Project scoping therefore reads that field
- * instead of resolving a path (see codex-metrics-source spec, "Codex sessions
- * are scoped to a project by their recorded working directory").
+ * (`<CODEX_HOME or ~/.codex>/sessions/<yyyy>/<mm>/<dd>/rollout-*.jsonl`), with
+ * the working directory recorded once per session (`type: "session_meta"`,
+ * `payload.cwd`) rather than encoded into a directory name, so project scoping
+ * reads that field instead of resolving a path.
  *
- * Codex transcripts carry nothing like Claude Code's `attributionSkill`. Every
- * session's system prompt lists all installed skills identically whether or
- * not any of them were used, so that listing carries no signal. The one event
- * confirmed (against this project's own real `~/.codex` history) to correlate
- * with a skill actually being used is a tool-call command whose text reads a
- * path ending in `<skill-name>/SKILL.md` — the moment the agent pulls in that
- * skill's instructions. Skill attribution here is therefore a heuristic, not a
- * recorded fact, and undercounts by construction: a skill run that never
- * re-reads its own instructions file is invisible to it.
+ * Codex transcripts carry nothing like `attributionSkill`, and the system prompt
+ * lists every installed skill whether used or not, so that listing is no signal.
+ * The one event that correlates with a skill being used is a tool-call command
+ * reading a path ending in `<skill-name>/SKILL.md`. Attribution here is
+ * therefore a heuristic that undercounts: a run that never re-reads its own
+ * instructions file is invisible.
  */
 import { type RunGroupingOptions, type SkillMetrics, type TranscriptEntry } from './skill-metrics.js';
 export interface CodexSessionsDirOptions {
@@ -26,16 +21,13 @@ export interface CodexSessionsDirOptions {
     homedir?: string;
 }
 /**
- * Locates Codex's session tree. `CODEX_HOME` is honoured the same way
- * `CLAUDE_CONFIG_DIR` is for Claude Code; without it the default is
- * `~/.codex`. This is the directory to search, not a per-project one — Codex
- * has no equivalent of Claude Code's per-project transcript directory.
+ * Codex's session tree (`CODEX_HOME`, else `~/.codex`). The whole directory has
+ * to be searched: Codex has no per-project transcript directory.
  */
 export declare function resolveCodexSessionsDir(options?: CodexSessionsDirOptions): string;
 /**
- * Whether a session's recorded working directory names the given project.
- * `null` (no `session_meta` seen, or no `cwd` field) never matches — a session
- * with nothing recorded cannot be attributed to any project.
+ * Whether a session's recorded working directory names the given project. `null`
+ * never matches: a session with nothing recorded belongs to no project.
  */
 export declare function sessionBelongsToProject(cwd: string | null, rootPath: string): boolean;
 export interface CodexSessionResult {
@@ -44,18 +36,13 @@ export interface CodexSessionResult {
     entries: TranscriptEntry[];
 }
 /**
- * Parses one Codex rollout `.jsonl` file into the recorded project directory
- * plus a sorted, timestamped, skill-labelled entry list — the same shape
- * `parseTranscript` produces for Claude Code, so `buildRuns`/`aggregateRuns`
- * apply unchanged (design.md D3). Malformed lines are skipped rather than
- * fatal, for the same reason Claude Code transcripts are: an append-only log
- * that can be torn at the tail while a session is live.
+ * Produces the same shape `parseTranscript` does for Claude Code, so
+ * `buildRuns`/`aggregateRuns` apply unchanged (D3). Malformed lines are skipped:
+ * an append-only log can be torn at the tail.
  *
- * Only `function_call`/`custom_tool_call` entries are ever inspected for a
- * `SKILL.md` read. Every other entry — including the one carrying the fixed
- * skill-listing text every session opens with — is folded in unattributed
- * (`skill: null`), exactly as an unattributed Claude Code entry is: it cannot
- * end a run, but it is not evidence a skill became active either.
+ * Only `function_call`/`custom_tool_call` entries are inspected for a `SKILL.md`
+ * read. Everything else — including the fixed skill-listing text every session
+ * opens with — is folded in unattributed.
  */
 export declare function parseCodexSession(text: string): CodexSessionResult;
 export interface CodexProjectSession {
@@ -71,11 +58,8 @@ export interface CodexSessionScan {
     sessions: CodexProjectSession[];
 }
 /**
- * Finds and parses every Codex session belonging to one project.
- *
- * Shared by `collectCodexSkillMetrics` and the metrics server, which need
- * exactly this and previously each carried their own copy of the walk — so the
- * probe optimisation could otherwise have been applied to one and not the other.
+ * Finds and parses every Codex session belonging to one project. Shared by
+ * `collectCodexSkillMetrics` and the metrics server, so the probe reaches both.
  */
 export declare function scanCodexSessions(rootPath: string, options?: CodexSessionsDirOptions): Promise<CodexSessionScan>;
 export interface CollectCodexMetricsOptions extends RunGroupingOptions, CodexSessionsDirOptions {
@@ -83,13 +67,9 @@ export interface CollectCodexMetricsOptions extends RunGroupingOptions, CodexSes
     sinceMs?: number;
 }
 /**
- * Derives skill timings from the `SKILL.md`-read heuristic over this project's
- * Codex sessions — the Codex-flavoured equivalent of `collectSkillMetrics`.
- * `scanCodexSessions` does the finding and scoping.
- *
- * A missing sessions directory is a reportable state (`available: false`), not
- * an error, for the same reason it is for Claude Code: the project may simply
- * never have been opened in Codex.
+ * The Codex equivalent of `collectSkillMetrics`, over the `SKILL.md`-read
+ * heuristic. A missing sessions directory is a reportable state
+ * (`available: false`), not an error.
  */
 export declare function collectCodexSkillMetrics(rootPath: string, options?: CollectCodexMetricsOptions): Promise<SkillMetrics>;
 //# sourceMappingURL=codex-metrics.d.ts.map

package/dist/core/codex-metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-metrics.d.ts","sourceRoot":"","sources":["../../src/core/codex-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAMrF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKrF;AAMD,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AA8CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA4ClE;AAsED,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AAMD,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB,EAAE,uBAAuB;IAC7F,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,YAAY,CAAC,CAqDvB"}
+{"version":3,"file":"codex-metrics.d.ts","sourceRoot":"","sources":["../../src/core/codex-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAMrF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKrF;AAED,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA4ClE;AAwDD,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAED,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB,EAAE,uBAAuB;IAC7F,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,YAAY,CAAC,CAqDvB"}

package/dist/core/codex-metrics.js

@@ -3,22 +3,17 @@
  * report `skill-metrics.ts` builds from Claude Code transcripts.
  *
  * Codex keeps one session tree shared by every project
- * (`<CODEX_HOME or ~/.codex>/sessions/<yyyy>/<mm>/<dd>/rollout-*.jsonl`),
- * partitioned by date rather than by project, with the working directory
- * recorded once per session (`type: "session_meta"`, `payload.cwd`) rather than
- * encoded into a directory name. Project scoping therefore reads that field
- * instead of resolving a path (see codex-metrics-source spec, "Codex sessions
- * are scoped to a project by their recorded working directory").
+ * (`<CODEX_HOME or ~/.codex>/sessions/<yyyy>/<mm>/<dd>/rollout-*.jsonl`), with
+ * the working directory recorded once per session (`type: "session_meta"`,
+ * `payload.cwd`) rather than encoded into a directory name, so project scoping
+ * reads that field instead of resolving a path.
  *
- * Codex transcripts carry nothing like Claude Code's `attributionSkill`. Every
- * session's system prompt lists all installed skills identically whether or
- * not any of them were used, so that listing carries no signal. The one event
- * confirmed (against this project's own real `~/.codex` history) to correlate
- * with a skill actually being used is a tool-call command whose text reads a
- * path ending in `<skill-name>/SKILL.md` — the moment the agent pulls in that
- * skill's instructions. Skill attribution here is therefore a heuristic, not a
- * recorded fact, and undercounts by construction: a skill run that never
- * re-reads its own instructions file is invisible to it.
+ * Codex transcripts carry nothing like `attributionSkill`, and the system prompt
+ * lists every installed skill whether used or not, so that listing is no signal.
+ * The one event that correlates with a skill being used is a tool-call command
+ * reading a path ending in `<skill-name>/SKILL.md`. Attribution here is
+ * therefore a heuristic that undercounts: a run that never re-reads its own
+ * instructions file is invisible.
  */
 import { promises as fs } from 'node:fs';
 import * as os from 'node:os';
@@ -27,10 +22,8 @@ import fg from 'fast-glob';
 import { aggregateRuns, buildRuns, normalizeSkillName, DEFAULT_IDLE_GAP_MS, DEFAULT_SPLIT_GAP_MS, } from './skill-metrics.js';
 const CODEX_HOME_DIR_NAME = '.codex';
 /**
- * Locates Codex's session tree. `CODEX_HOME` is honoured the same way
- * `CLAUDE_CONFIG_DIR` is for Claude Code; without it the default is
- * `~/.codex`. This is the directory to search, not a per-project one — Codex
- * has no equivalent of Claude Code's per-project transcript directory.
+ * Codex's session tree (`CODEX_HOME`, else `~/.codex`). The whole directory has
+ * to be searched: Codex has no per-project transcript directory.
  */
 export function resolveCodexSessionsDir(options = {}) {
     const env = options.env ?? process.env;
@@ -40,9 +33,8 @@ export function resolveCodexSessionsDir(options = {}) {
     return path.join(home, 'sessions');
 }
 /**
- * Whether a session's recorded working directory names the given project.
- * `null` (no `session_meta` seen, or no `cwd` field) never matches — a session
- * with nothing recorded cannot be attributed to any project.
+ * Whether a session's recorded working directory names the given project. `null`
+ * never matches: a session with nothing recorded belongs to no project.
  */
 export function sessionBelongsToProject(cwd, rootPath) {
     if (cwd === null)
@@ -52,11 +44,8 @@ export function sessionBelongsToProject(cwd, rootPath) {
     return process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b;
 }
 /**
- * The working directory a record records, or null when it is not the kind of
- * record that carries one. Shared by the full parse and the prefix probe so a
- * single statement defines a session's cwd — the first `session_meta` whose
- * `payload.cwd` is a string — and the probe can never disagree with the parse
- * it exists to skip.
+ * Shared by the full parse and the prefix probe, so the probe cannot disagree
+ * with the parse it exists to skip.
  */
 function recordedCwd(record) {
     if (record.type !== 'session_meta')
@@ -65,17 +54,11 @@ function recordedCwd(record) {
     return typeof cwd === 'string' ? cwd : null;
 }
 /**
- * Matches a tool-call command's text against a path ending in
- * `<skill-name>/SKILL.md`, on either separator. This is the one signal
- * confirmed to correlate with a skill actually being read, as opposed to
- * merely appearing in the session's fixed skill-listing text (see the module
- * docstring).
+ * A path ending in `<skill-name>/SKILL.md`, on either separator — the one signal
+ * that a skill was read rather than merely listed.
  *
- * `function_call` arguments are JSON-encoded twice — once as the tool-call
- * argument string itself, once more for the outer transcript line — so a
- * Windows path's single backslash separator survives as a doubled `\\` in the
- * text this matches against. The separator class therefore matches one or
- * more repetitions rather than exactly one.
+ * `function_call` arguments are JSON-encoded twice, so a Windows path's single
+ * backslash arrives doubled; hence `[\\/]+`.
  */
 const SKILL_MD_READ_PATTERN = /([^\\/"]+)[\\/]+SKILL\.md/i;
 function extractSkillFromCommandText(text) {
@@ -83,18 +66,13 @@ function extractSkillFromCommandText(text) {
     return match ? match[1] : null;
 }
 /**
- * Parses one Codex rollout `.jsonl` file into the recorded project directory
- * plus a sorted, timestamped, skill-labelled entry list — the same shape
- * `parseTranscript` produces for Claude Code, so `buildRuns`/`aggregateRuns`
- * apply unchanged (design.md D3). Malformed lines are skipped rather than
- * fatal, for the same reason Claude Code transcripts are: an append-only log
- * that can be torn at the tail while a session is live.
+ * Produces the same shape `parseTranscript` does for Claude Code, so
+ * `buildRuns`/`aggregateRuns` apply unchanged (D3). Malformed lines are skipped:
+ * an append-only log can be torn at the tail.
  *
- * Only `function_call`/`custom_tool_call` entries are ever inspected for a
- * `SKILL.md` read. Every other entry — including the one carrying the fixed
- * skill-listing text every session opens with — is folded in unattributed
- * (`skill: null`), exactly as an unattributed Claude Code entry is: it cannot
- * end a run, but it is not evidence a skill became active either.
+ * Only `function_call`/`custom_tool_call` entries are inspected for a `SKILL.md`
+ * read. Everything else — including the fixed skill-listing text every session
+ * opens with — is folded in unattributed.
  */
 export function parseCodexSession(text) {
     let cwd = null;
@@ -137,19 +115,11 @@ export function parseCodexSession(text) {
     entries.sort((a, b) => a.timeMs - b.timeMs);
     return { cwd, entries };
 }
-// -----------------------------------------------------------------------------
-// IO: project scoping without reading whole sessions
-// -----------------------------------------------------------------------------
 /**
- * Bytes read from a session when only its `cwd` is wanted.
- *
- * Codex writes `session_meta` as the very first line, but that line embeds the
- * session's whole base-instructions text and so runs to ~20 KB. The probe has
- * to be large enough to hold a *complete* line: a line cut by the read boundary
- * fails `JSON.parse` and is indistinguishable from an absent one. 64 KiB clears
- * the observed maximum several times over, and anything the probe cannot settle
- * falls back to a full read — so an unusually long first line costs time, never
- * correctness.
+ * Bytes read from a session when only its `cwd` is wanted. `session_meta` is the
+ * first line but embeds the whole base-instructions text (~20 KB), and the probe
+ * must hold a *complete* line — one cut by the read boundary fails `JSON.parse`
+ * and looks absent. Anything inconclusive falls back to a full read.
  */
 const CWD_PROBE_BYTES = 64 * 1024;
 /** First recorded cwd in already-read text, stopping at the first one found. */
@@ -171,15 +141,10 @@ function findRecordedCwd(text) {
     return null;
 }
 /**
- * Reads just enough of a session to decide which project it belongs to.
- *
- * Every session in the shared Codex tree has to be classified, but only the
- * matching ones are worth parsing, and on a real machine the tree is dominated
- * by other projects: the history that motivated this held 716 MB of sessions of
- * which one project owned 0.9 MB, and parsing all of it cost ~9 s of the
- * command's startup. Because the deciding field sits on line 0, reading a prefix
- * instead of the whole file makes the cost proportional to this project's share
- * of Codex history rather than to all of it.
+ * Reads just enough of a session to decide which project it belongs to. The
+ * shared tree is dominated by other projects — one real history held 716 MB of
+ * sessions of which this project owned 0.9 MB — and the deciding field sits on
+ * line 0, so a prefix read makes the cost proportional to this project's share.
  */
 async function probeSessionCwd(filePath) {
     const handle = await fs.open(filePath, 'r');
@@ -187,8 +152,8 @@ async function probeSessionCwd(filePath) {
         const buffer = Buffer.alloc(CWD_PROBE_BYTES);
         const { bytesRead } = await handle.read(buffer, 0, CWD_PROBE_BYTES, 0);
         const cwd = findRecordedCwd(buffer.subarray(0, bytesRead).toString('utf8'));
-        // A short read means the prefix was the entire file, so "no session_meta
-        // here" is the final answer rather than a reason to read it again.
+        // A short read means the prefix was the whole file, so "no session_meta
+        // here" is final rather than a reason to read it again.
         return { cwd, conclusive: cwd !== null || bytesRead < CWD_PROBE_BYTES };
     }
     finally {
@@ -196,18 +161,14 @@ async function probeSessionCwd(filePath) {
     }
 }
 /**
- * Finds and parses every Codex session belonging to one project.
- *
- * Shared by `collectCodexSkillMetrics` and the metrics server, which need
- * exactly this and previously each carried their own copy of the walk — so the
- * probe optimisation could otherwise have been applied to one and not the other.
+ * Finds and parses every Codex session belonging to one project. Shared by
+ * `collectCodexSkillMetrics` and the metrics server, so the probe reaches both.
  */
 export async function scanCodexSessions(rootPath, options = {}) {
     const sessionsDir = resolveCodexSessionsDir(options);
     // fast-glob returns an empty list for a missing `cwd` rather than throwing,
-    // so existence has to be checked directly — otherwise "Codex never used on
-    // this machine" (available: false) would be indistinguishable from "used,
-    // but nothing here matches this project" (available: true, sessions: 0).
+    // so without this check "Codex never ran here" and "ran, but nothing matches
+    // this project" look identical.
     const stat = await fs.stat(sessionsDir).catch(() => null);
     if (!stat)
         return { sessionsDir, available: false, sessions: [] };
@@ -218,8 +179,7 @@ export async function scanCodexSessions(rootPath, options = {}) {
             const probe = await probeSessionCwd(filePath);
             if (probe.conclusive && !sessionBelongsToProject(probe.cwd, rootPath))
                 continue;
-            // The probe only ever skips work; the full parse stays authoritative for
-            // every session that survives it.
+            // The probe only skips work; the full parse stays authoritative.
             const { cwd, entries } = parseCodexSession(await fs.readFile(filePath, 'utf8'));
             if (!sessionBelongsToProject(cwd, rootPath))
                 continue;
@@ -233,13 +193,9 @@ export async function scanCodexSessions(rootPath, options = {}) {
     return { sessionsDir, available: true, sessions };
 }
 /**
- * Derives skill timings from the `SKILL.md`-read heuristic over this project's
- * Codex sessions — the Codex-flavoured equivalent of `collectSkillMetrics`.
- * `scanCodexSessions` does the finding and scoping.
- *
- * A missing sessions directory is a reportable state (`available: false`), not
- * an error, for the same reason it is for Claude Code: the project may simply
- * never have been opened in Codex.
+ * The Codex equivalent of `collectSkillMetrics`, over the `SKILL.md`-read
+ * heuristic. A missing sessions directory is a reportable state
+ * (`available: false`), not an error.
  */
 export async function collectCodexSkillMetrics(rootPath, options = {}) {
     const thresholds = {

package/dist/core/codex-metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex-metrics.js","sourceRoot":"","sources":["../../src/core/codex-metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codex-metrics.js","sourceRoot":"","sources":["../../src/core/codex-metrics.ts"],"names":[],"mappings":"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"}

package/dist/core/codex-residue.d.ts

@@ -1,23 +1,22 @@
 /**
- * Residual Codex Output Detection
- *
  * `.codex` was a write target until Codex turned out to read its skills from
- * `.agents`. Projects initialized by an earlier version still hold that output.
- *
- * This module answers one question and holds no writer: rule files are content
- * hash-protected precisely because users edit them, so anything that could
- * delete them must not exist here. Removing leftovers stays the user's call.
+ * `.agents`, and projects initialized by an earlier version still hold that
+ * output. Read-only by design: rule files are content hash-protected precisely
+ * because users edit them, so removing leftovers stays the user's call.
  */
 /**
  * Whether `<projectPath>/.codex` still holds tospec output: a `tospec-` skill
- * directory, or a file under `rules/tospec/`. Either alone is enough — a user
- * who cleaned up one half should still hear about the other.
- *
- * Both halves match only what tospec itself writes. The directory merely
- * existing is not enough: a project that only ever kept its own Codex settings
- * there would otherwise be told to delete them.
+ * directory, or a file under `rules/tospec/`. Either alone is enough. Both
+ * halves match only what tospec writes, so a project keeping its own Codex
+ * settings is not told to delete them.
  */
 export declare function hasResidualCodexOutput(projectPath: string): boolean;
-/** Shared by init and update so neither can report what the other suppresses. */
-export declare const RESIDUAL_CODEX_NOTICE = "Note: .codex/ still holds tospec output from an earlier version. tospec no longer writes there \u2014 Codex reads skills from .agents/. Removing .codex/skills/tospec-* and .codex/rules/tospec/ is optional and entirely up to you; tospec will not touch them.";
+/**
+ * Shared by init and update so neither can report what the other suppresses.
+ * Split into message and fix because both commands carry it through their
+ * `warn` helper: under `--json` a `say()` line is dropped, and the leftover
+ * would be reported to a human and hidden from an agent.
+ */
+export declare const RESIDUAL_CODEX_NOTICE = ".codex/ still holds tospec output from an earlier version. tospec no longer writes there \u2014 Codex reads skills from .agents/.";
+export declare const RESIDUAL_CODEX_FIX = "Removing .codex/skills/tospec-* and .codex/rules/tospec/ is optional and entirely up to you; tospec will not touch them.";
 //# sourceMappingURL=codex-residue.d.ts.map

package/dist/core/codex-residue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-residue.d.ts","sourceRoot":"","sources":["../../src/core/codex-residue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2CH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,qQAC6N,CAAC"}
+{"version":3,"file":"codex-residue.d.ts","sourceRoot":"","sources":["../../src/core/codex-residue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwCH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,sIAC8F,CAAC;AACjI,eAAO,MAAM,kBAAkB,6HAC6F,CAAC"}

package/dist/core/codex-residue.js

@@ -1,12 +1,8 @@
 /**
- * Residual Codex Output Detection
- *
  * `.codex` was a write target until Codex turned out to read its skills from
- * `.agents`. Projects initialized by an earlier version still hold that output.
- *
- * This module answers one question and holds no writer: rule files are content
- * hash-protected precisely because users edit them, so anything that could
- * delete them must not exist here. Removing leftovers stays the user's call.
+ * `.agents`, and projects initialized by an earlier version still hold that
+ * output. Read-only by design: rule files are content hash-protected precisely
+ * because users edit them, so removing leftovers stays the user's call.
  */
 import path from 'node:path';
 import * as fs from 'node:fs';
@@ -26,13 +22,10 @@ function hasTospecSkillDir(codexDir) {
     }
 }
 /**
- * Scoped to `rules/tospec/` rather than all of `rules/`, for the same reason
- * the skill check is scoped to the `tospec-` prefix: rule generation only ever
- * writes under that subdirectory, and the notice tells the user to delete
- * exactly it. Scanning the whole tree made a project's own
- * `.codex/rules/team-style.md` trigger a notice claiming tospec had put it
- * there — the very mistake this module's docstring warns against one paragraph
- * down. Still recursive, so a nested layout from an older version counts.
+ * Scoped to `rules/tospec/`, not all of `rules/`: generation only writes under
+ * that subdirectory, so scanning the whole tree makes a project's own
+ * `.codex/rules/team-style.md` trigger a notice claiming tospec put it there.
+ * Still recursive, so a nested layout from an older version counts.
  */
 function hasTospecRuleFile(codexDir) {
     try {
@@ -49,17 +42,20 @@ function hasTospecRuleFile(codexDir) {
 }
 /**
  * Whether `<projectPath>/.codex` still holds tospec output: a `tospec-` skill
- * directory, or a file under `rules/tospec/`. Either alone is enough — a user
- * who cleaned up one half should still hear about the other.
- *
- * Both halves match only what tospec itself writes. The directory merely
- * existing is not enough: a project that only ever kept its own Codex settings
- * there would otherwise be told to delete them.
+ * directory, or a file under `rules/tospec/`. Either alone is enough. Both
+ * halves match only what tospec writes, so a project keeping its own Codex
+ * settings is not told to delete them.
  */
 export function hasResidualCodexOutput(projectPath) {
     const codexDir = path.join(projectPath, CODEX_DIR);
     return hasTospecSkillDir(codexDir) || hasTospecRuleFile(codexDir);
 }
-/** Shared by init and update so neither can report what the other suppresses. */
-export const RESIDUAL_CODEX_NOTICE = 'Note: .codex/ still holds tospec output from an earlier version. tospec no longer writes there — Codex reads skills from .agents/. Removing .codex/skills/tospec-* and .codex/rules/tospec/ is optional and entirely up to you; tospec will not touch them.';
+/**
+ * Shared by init and update so neither can report what the other suppresses.
+ * Split into message and fix because both commands carry it through their
+ * `warn` helper: under `--json` a `say()` line is dropped, and the leftover
+ * would be reported to a human and hidden from an agent.
+ */
+export const RESIDUAL_CODEX_NOTICE = '.codex/ still holds tospec output from an earlier version. tospec no longer writes there — Codex reads skills from .agents/.';
+export const RESIDUAL_CODEX_FIX = 'Removing .codex/skills/tospec-* and .codex/rules/tospec/ is optional and entirely up to you; tospec will not touch them.';
 //# sourceMappingURL=codex-residue.js.map

package/dist/core/codex-residue.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex-residue.js","sourceRoot":"","sources":["../../src/core/codex-residue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,SAAS,CAAC;AACnC,sFAAsF;AACtF,MAAM,YAAY,GAAG,QAAQ,CAAC;AAE9B,SAAS,iBAAiB,CAAC,QAAgB;IACzC,IAAI,CAAC;QACH,OAAO,EAAE;aACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACnE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,IAAI,CAAC;QACH,OAAO,EAAE;aACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;YACvD,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;SACpB,CAAC;aACD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAChC,6PAA6P,CAAC"}
+{"version":3,"file":"codex-residue.js","sourceRoot":"","sources":["../../src/core/codex-residue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,SAAS,CAAC;AACnC,sFAAsF;AACtF,MAAM,YAAY,GAAG,QAAQ,CAAC;AAE9B,SAAS,iBAAiB,CAAC,QAAgB;IACzC,IAAI,CAAC;QACH,OAAO,EAAE;aACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACnE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,IAAI,CAAC;QACH,OAAO,EAAE;aACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;YACvD,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;SACpB,CAAC;aACD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,8HAA8H,CAAC;AACjI,MAAM,CAAC,MAAM,kBAAkB,GAC7B,0HAA0H,CAAC"}

package/dist/core/command-generation/adapters/claude.d.ts

@@ -1,14 +1,7 @@
-/**
- * Claude Code Command Adapter
- *
- * Formats commands for Claude Code following its frontmatter specification.
- */
 import type { ToolCommandAdapter } from '../types.js';
 /**
- * Claude Code adapter for command generation.
- * File path: .claude/commands/tosx/<id>.md — the `tosx` sub-folder becomes the
- * command namespace, so commands are invoked as `/tosx:<id>`.
- * Frontmatter: name, description, category, tags
+ * The `tosx` sub-folder becomes the command namespace, so what lands at
+ * `.claude/commands/tosx/<id>.md` is invoked as `/tosx:<id>`.
  */
 export declare const claudeAdapter: ToolCommandAdapter;
 //# sourceMappingURL=claude.d.ts.map