plumbbob 0.9.3 → 0.10.0

package/node_modules/checkride/dist/init.d.ts

@@ -12,7 +12,10 @@
  * it afterward.
  */
 import type { Adapter, Slot } from './adapters.js';
+import type { HookName } from './agent-setup/index.js';
+import type { HarnessName } from './gate.js';
 import type { Out } from './orchestrator.js';
+import type { PackageManager } from './pm/index.js';
 export type Shape = 'flat' | 'monorepo' | 'hybrid';
 export type InitOptions = {
     cwd?: string;
@@ -25,16 +28,27 @@ export type InitOptions = {
     add?: string[] | null;
     checkrideSpec?: string;
     /**
-     * New mode: overwrite existing files instead of refusing. Without it, `init`
-     * refuses (exit 2) rather than clobber any file it would scaffold (D4);
-     * existing mode is already additive-only and ignores this flag.
+     * Overwrite instead of refusing. Without it, `init` refuses (exit 2) rather
+     * than clobber any file new mode would scaffold, or an AGENTS.md stanza
+     * existing mode would refresh that carries local edits. Existing mode is
+     * otherwise additive-only, so the flag reaches nothing else there.
      */
     force?: boolean;
     /**
-     * Write the Claude Code Stop hook to `.claude/settings.json` (step 12).
+     * Write the agent stop-gate hooks into each selected harness's config.
      * Opt-out: defaults to on; `--no-hook` sets it `false`.
      */
     hook?: boolean;
+    /** Which hooks to write (`--hook <a,b>`). Omitted → all of them. */
+    hooks?: readonly HookName[];
+    /**
+     * Hooks to tear out of an already-wired repo (`--remove-hook <a,b>`): the
+     * config entry is stripped and the generated script deleted. Composes with
+     * `hook: false` to remove without refreshing anything else.
+     */
+    removeHooks?: readonly HookName[];
+    /** Which harnesses to write them for (`--harness <a,b>`). Omitted → detected. */
+    harnesses?: readonly HarnessName[];
     stdout?: Out;
     slots?: readonly Slot[];
     adapters?: readonly Adapter[];
@@ -42,7 +56,7 @@ export type InitOptions = {
     probeFailures?: (slots: string[], cwd: string) => Promise<string[]>;
     /**
      * Existing mode: grandfather current debt into `checkride.baseline.json`
-     * instead of disabling failing slots (`--baseline`, step 6 / c10). A failing
+     * instead of disabling failing slots (`--baseline`). A failing
      * fingerprintable slot stays enabled and is masked by the baseline; a failing
      * slot with no extractor still falls back to a `false` disable.
      */
@@ -54,6 +68,8 @@ export type InitResult = {
     mode: 'new' | 'existing';
     shape: Shape | null;
     written: string[];
+    /** Files deleted by `--remove-hook`. */
+    removed: string[];
     skipped: string[];
     disabled: string[];
     /** Slots whose failing debt was grandfathered into the baseline (`--baseline`). */
@@ -65,11 +81,44 @@ export type InventoryEntry = {
     status: 'adopted' | 'empty';
     adapter: string | null;
 };
-/** The agent-facing contract block, parameterized by the active checks. */
-export declare function buildStanza(activeSlots: readonly string[]): string;
+/**
+ * How the stanza on disk relates to the one checkride would write:
+ *
+ * - `absent` — no stanza yet; writing one takes nothing away.
+ * - `pristine` — checkride's own output, untouched; refreshing it is lossless.
+ *   Either it carries a stamp that still matches, or it predates stamping and
+ *   its wording is one checkride shipped (see {@link LEGACY_STANZA_PREAMBLES}).
+ * - `edited` — stamped, but the body no longer matches its stamp: a human or an
+ *   agent customized it, and a blind refresh would silently discard that.
+ * - `unstamped` — predates stamping and matches no wording checkride released,
+ *   so it has been edited too; same protection as `edited`, and the message says
+ *   so differently because the evidence is weaker.
+ */
+export type StanzaState = 'absent' | 'pristine' | 'edited' | 'unstamped';
+/** Classify the stanza in `content` against the `body` checkride would write. */
+export declare function inspectStanza(content: string, body: string): StanzaState;
+/**
+ * The agent-facing contract block, parameterized by the active checks and the
+ * repo's package manager.
+ *
+ * `pm` is not cosmetic. The stanza is a list of commands an agent is told to
+ * run, and `pnpm check` in an npm repo is an instruction that cannot succeed —
+ * the agent either invents a substitute or reports the pipeline as broken.
+ * Everything here routes through {@link runScript}/{@link execCommand} for that
+ * reason; nothing spells a launcher literally.
+ *
+ * The gate profile is deliberately *not* a parameter. A repo can add `gate` to
+ * checkride.config.json without re-running `agent-setup`, so a stanza naming a
+ * specific profile would go stale in exactly the direction that costs something
+ * — telling an agent the hook covered everything when it no longer does. The
+ * paragraph points at the gate's verdict instead, which is generated per run and
+ * states the narrowing itself (see `gate.ts`'s `profileClause`).
+ */
+export declare function buildStanza(activeSlots: readonly string[], pm?: PackageManager, proseExemplars?: string | null): string;
 /**
  * Insert or refresh the checkride stanza in an AGENTS.md body. Idempotent:
- * applying twice yields identical output.
+ * applying twice yields identical output. It rewrites the marked region without
+ * looking at what was there — callers gate on {@link inspectStanza} first.
  */
 export declare function applyStanza(content: string, body: string): string;
 /** For each default (non-opt-in) slot, report whether a tool config is present. */
@@ -86,23 +135,41 @@ export declare function runInit(options: InitOptions): Promise<InitResult>;
 export type AgentSetupOptions = {
     cwd?: string;
     dryRun?: boolean;
-    /** Write the Claude Code Stop hook (opt-out; `--no-hook`). Defaults to on. */
+    /** Write the agent hooks (opt-out; `--no-hook`). Defaults to on. */
     hook?: boolean;
+    /** Which hooks to write (`--hook <a,b>`). Omitted → all of them. */
+    hooks?: readonly HookName[];
+    /**
+     * Hooks to tear out (`--remove-hook <a,b>`): the config entry is stripped and
+     * the generated script deleted. With `hook: false` it removes those and
+     * refreshes nothing else.
+     */
+    removeHooks?: readonly HookName[];
+    /** Which harnesses to write them for (`--harness <a,b>`). Omitted → detected. */
+    harnesses?: readonly HarnessName[];
+    /**
+     * Refresh the AGENTS.md stanza even when it carries local edits. Without it a
+     * customized stanza stops the run (exit 2) instead of being overwritten.
+     */
+    force?: boolean;
     stdout?: Out;
     slots?: readonly Slot[];
     adapters?: readonly Adapter[];
 };
 export type AgentSetupResult = {
     written: string[];
+    /** Files deleted by `--remove-hook`. */
+    removed: string[];
     skipped: string[];
     exitCode: number;
 };
 /**
  * `checkride agent-setup` — wire the agent contract into an *existing* repo
  * without a full `init`: the `check` alias the hook resolves to, the AGENTS.md
- * stanza (the human-readable contract), and the Claude Code Stop hook (the
- * mechanical gate). Every write is additive and idempotent — a second run is a
- * no-op — and the hook is opt-out (`hook: false`).
+ * stanza (the human-readable contract), the stop-gate hooks for every detected
+ * harness (the mechanical gate), and the skills a harness cannot get from the
+ * bundled plugin. Every write is additive and idempotent — a second run is a
+ * no-op — and the hooks are opt-out (`hook: false`).
  */
 export declare function runAgentSetup(options: AgentSetupOptions): Promise<AgentSetupResult>;
 //# sourceMappingURL=init.d.ts.map

package/node_modules/checkride/dist/init.d.ts.map

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