@paths.design/caws-cli 11.1.7 → 11.1.8

package/dist/shell/binding/types.d.ts

@@ -18,6 +18,16 @@ export interface ResolveBindingInput {
      * cannot be invoked. Production injects a real git runner.
      */
     readonly gitWorktreeList?: (repoRoot: string) => readonly GitWorktreeEntry[];
+    /**
+     * SCOPE-CHECK-CWD-BINDING-RESOLUTION-001: the repo-root-relative path whose
+     * binding is being resolved. When set and the cwd does NOT match a worktree
+     * (step 1 yields no candidate), resolution falls back to (2) the path's
+     * worktree-location and (3) the bound spec(s) whose `scope.in` admits this
+     * path. This makes `caws scope check <path>` cwd-independent: the governing
+     * binding is a property of the PATH, not of where the command ran. Omitted
+     * → pre-existing cwd-only behavior.
+     */
+    readonly targetPath?: string;
 }
 export interface GitWorktreeEntry {
     /** Absolute path of the worktree on disk. */
@@ -25,18 +35,52 @@ export interface GitWorktreeEntry {
     /** Branch name (may be `(detached)` or `refs/heads/<x>`). */
     readonly branch?: string;
 }
+/**
+ * SCOPE-CHECK-CWD-BINDING-RESOLUTION-001: one spec that claims a target path
+ * via its `scope.in`. Carried in the `ambiguous` result so the refusal is
+ * actionable — the agent can name and inspect each contender.
+ */
+export interface BindingClaimant {
+    readonly specId: string;
+    readonly worktreeName: string;
+    /** The exact `scope.in` entry that matched the target path. */
+    readonly matchedScopeInEntry: string;
+}
+/**
+ * SCOPE-CHECK-CWD-BINDING-RESOLUTION-001: refuse-on-conflict detail surfaced
+ * when step-(3) scope.in-claim resolution finds MORE THAN ONE active bound
+ * spec claiming the same target path. Carried in a DEDICATED `ambiguous`
+ * field on `ResolvedBinding` (not inside `binding`) so that consumers which
+ * never pass a targetPath — e.g. `caws status`, which resolves from cwd —
+ * continue to see only the kernel `BindingState` and need no narrowing. Only
+ * `caws scope check/show`, which passes a targetPath, inspects `ambiguous`.
+ */
+export interface AmbiguousBindingDetail {
+    readonly targetPath: string;
+    readonly claimants: readonly BindingClaimant[];
+}
 export interface ResolvedBinding {
-    /** The kernel's `BindingState`. */
+    /** The kernel's `BindingState`. For an ambiguous result this is `unbound`
+     * (the safe default for non-scope-check consumers); inspect `ambiguous`. */
     readonly binding: BindingState;
+    /**
+     * Refuse-on-conflict detail. Present ONLY when step-(3) resolution found
+     * >1 claimant for the target path. When set, `binding` is `unbound` and
+     * `worktreeName` is undefined — no single owner was selected, by design.
+     * `caws scope check` keys its ambiguous-binding refusal off this field.
+     */
+    readonly ambiguous?: AmbiguousBindingDetail;
     /**
      * The resolved worktree name, if any. `undefined` when cwd is in the main
-     * checkout (no worktree).
+     * checkout with no resolvable target-path binding, or when ambiguous.
      */
     readonly worktreeName?: string;
     /**
      * Where the worktree-name resolution came from. Helps explain `bound`
      * vs `one_sided` decisions to the user.
+     *   - target_worktree_location: step (2), path under .caws/worktrees/<name>/
+     *   - target_scope_in_claim:    step (3), a bound spec's scope.in admits path
      */
-    readonly source: 'registry_path_match' | 'git_porcelain_match' | 'none';
+    readonly source: 'registry_path_match' | 'git_porcelain_match' | 'target_worktree_location' | 'target_scope_in_claim' | 'none';
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/shell/binding/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shell/binding/types.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,YAAY,EACZ,IAAI,EACJ,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,gBAAgB,EAAE,CAAC;CAC9E;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,GAAG,MAAM,CAAC;CACzE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shell/binding/types.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,YAAY,EACZ,IAAI,EACJ,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,gBAAgB,EAAE,CAAC;IAC7E;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B;gFAC4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EACX,qBAAqB,GACrB,qBAAqB,GACrB,0BAA0B,GAC1B,uBAAuB,GACvB,MAAM,CAAC;CACZ"}

package/dist/shell/command-metadata.d.ts

@@ -0,0 +1,93 @@
+/** A positional argument on a command (this CLI uses at most one per command). */
+export interface CommandArgMeta {
+    /** Argument name as it appears in usage, e.g. "id" or "path". */
+    readonly name: string;
+    /** Whether the argument is required (`<name>`) or optional (`[name]`). */
+    readonly required: boolean;
+    /** Help text for the argument. */
+    readonly description: string;
+}
+/**
+ * A Commander option. The `flag` string is authored verbatim (e.g.
+ * "--mode <mode>" or "--apply") so register.ts calls
+ * `.option(flag, description, defaultValue?)` with no string literal of its
+ * own.
+ */
+export interface CommandOptionMeta {
+    /** Full Commander flag string, e.g. "--mode <mode>", "--ack <sha>", "--apply". */
+    readonly flag: string;
+    /** When true, register.ts uses `.requiredOption()` (Commander pre-validates). */
+    readonly required?: boolean;
+    /**
+     * Help prose. When `allowedValues` is set, register.ts appends
+     * ": <v1> | <v2> | ..." and the lock test asserts that list equals the
+     * kernel/schema enum — so the value list is the derived, locked part and
+     * this string is only the prose prefix.
+     */
+    readonly description: string;
+    /**
+     * Enum-backed value list (e.g. SPEC_MODES). Present only for options whose
+     * accepted values come from a kernel enum / JSON-schema enum. The lock test
+     * asserts deep-equality against that authority; drift becomes a test failure.
+     */
+    readonly allowedValues?: readonly (string | number)[];
+    /** Commander default value, passed as the 3rd arg to `.option()`. */
+    readonly defaultValue?: string | boolean | readonly string[];
+    /**
+     * True for repeatable options that accumulate (e.g. `--ack <sha>` collected
+     * into an array). register.ts supplies the collector; this flag records the
+     * intent so the metadata is self-describing.
+     */
+    readonly collect?: boolean;
+}
+/** A leaf command (one that has an `.action()` handler). */
+export interface LeafCommandMeta {
+    readonly kind: 'leaf';
+    /** Command name as passed to `.command()` (without the `<arg>` suffix). */
+    readonly name: string;
+    /** The positional argument, if any. */
+    readonly argument?: CommandArgMeta;
+    /** The `.description()` text. */
+    readonly description: string;
+    /** Declared options, in display order. */
+    readonly options: readonly CommandOptionMeta[];
+}
+/** A group command whose subcommands carry the `.action()` handlers. */
+export interface GroupCommandMeta {
+    readonly kind: 'group';
+    /** Group name as passed to `.command()`, e.g. "specs". */
+    readonly name: string;
+    /** The group-level `.description()` (shown in `caws --help` and `caws <group> --help`). */
+    readonly description: string;
+    /** The group's subcommands. */
+    readonly subcommands: readonly LeafCommandMeta[];
+}
+/** Either a flat leaf command or a group with subcommands. */
+export type CommandMeta = LeafCommandMeta | GroupCommandMeta;
+export declare const SPECS_COMMAND_META: GroupCommandMeta;
+export declare const WORKTREE_COMMAND_META: GroupCommandMeta;
+export declare const INIT_COMMAND_META: LeafCommandMeta;
+export declare const DOCTOR_COMMAND_META: LeafCommandMeta;
+export declare const STATUS_COMMAND_META: LeafCommandMeta;
+export declare const CLAIM_COMMAND_META: LeafCommandMeta;
+export declare const PREPUSH_COMMAND_META: LeafCommandMeta;
+export declare const SCOPE_COMMAND_META: GroupCommandMeta;
+export declare const GATES_COMMAND_META: GroupCommandMeta;
+export declare const EVIDENCE_COMMAND_META: GroupCommandMeta;
+export declare const EVENTS_COMMAND_META: GroupCommandMeta;
+export declare const WAIVER_COMMAND_META: GroupCommandMeta;
+export declare const AGENTS_COMMAND_META: GroupCommandMeta;
+/**
+ * The complete v11 command-surface metadata — the single authority for every
+ * `.description()` / `.argument()` / `.option()` in register.ts.
+ *
+ * SLICE 3: all thirteen surface entries are populated and consumed by
+ * register.ts — the five flat top-level commands (init/doctor/status/claim/
+ * prepush) as LeafCommandMeta, and eight groups (scope/gates/evidence/events/
+ * waiver/agents/specs/worktree). The lock test enforces full set-equality with
+ * REGISTERED_COMMAND_GROUPS (L1), enum/value-list parity (L3), non-empty
+ * descriptions (L4), and the global no-inline-strings invariant on register.ts
+ * (L5).
+ */
+export declare const COMMAND_SURFACE_METADATA: readonly CommandMeta[];
+//# sourceMappingURL=command-metadata.d.ts.map

package/dist/shell/command-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-metadata.d.ts","sourceRoot":"","sources":["../../src/shell/command-metadata.ts"],"names":[],"mappings":"AAqCA,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACtD,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,MAAM,EAAE,CAAC;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAED,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAgB7D,eAAO,MAAM,kBAAkB,EAAE,gBA8KhC,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,gBAsFnC,CAAC;AAOF,eAAO,MAAM,iBAAiB,EAAE,eAuB/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAKjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAMjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAmBhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAmBlC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,gBAoBhC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,gBAqBhC,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,gBAsBnC,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,gBA+DjC,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,gBAiEjC,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,gBAoGjC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,WAAW,EAczD,CAAC"}