@iamu-dev/iamu 0.5.0-beta.0 → 0.6.0-beta.0

package/dist/commands/advise.d.ts

@@ -1,5 +1,5 @@
 /** Stamped into `advised_by` and `advice.json`. Bump when advise.md changes meaningfully. */
-export declare const ADVISOR_VERSION = "1.3.0";
+export declare const ADVISOR_VERSION = "1.5.0";
 /** The installed `iamu/.prompts/advise.md`, or the bundled template. */
 export declare function readAdvisePrompt(projectRoot: string): string;
 export interface AdviseOptions {

package/dist/commands/complete.d.ts

@@ -80,13 +80,7 @@ export declare function validateCanonicalWalkthrough(canonical: unknown): Canoni
 export declare function persistCanonical(runDirPath: string, canonical: CanonicalWalkthrough): Promise<string>;
 /** Persist report.md to disk atomically. */
 export declare function persistReport(runDirPath: string, canonical: CanonicalWalkthrough): Promise<string>;
-/**
- * Build canonical.json (with the verification delta) and report.md for a
- * run. The report keeps any verdicts already recorded by
- * `evaluate-record`, so re-assembling after the judge (`--force`,
- * `match-record`) does not drop them.
- */
-export declare function assembleRun(projectRoot: string, runId: string, manifest: WalkthroughManifest, completedAt: string): Promise<{
+type AssembledRunFiles = {
     canonical: CanonicalWalkthrough;
     verification: VerificationSummary | null;
     journeyDiff: JourneyDiff | null;
@@ -96,7 +90,15 @@ export declare function assembleRun(projectRoot: string, runId: string, manifest
     canonicalPath: string;
     reportPath: string;
     htmlReportPath?: string;
-}>;
+};
+/**
+ * Build canonical.json (with the verification delta) and report.md for a
+ * run. The report keeps any verdicts already recorded by
+ * `evaluate-record`, so re-assembling after the judge (`--force`,
+ * `match-record`) does not drop them. It holds the run's record lock so
+ * stages that re-derive them in parallel never interleave.
+ */
+export declare function assembleRun(projectRoot: string, runId: string, manifest: WalkthroughManifest, completedAt: string): Promise<AssembledRunFiles>;
 /** One requested place, whether the run reached it, and what awaits there. */
 export type RevisitReportPlace = RevisitPlaceCoverage & {
     findings: Array<{
@@ -126,3 +128,4 @@ export declare function printRevisit(r: RevisitReport): void;
  * — so the heading says what it compares with.
  */
 export declare function printVerification(verification: VerificationSummary): void;
+export {};

package/dist/commands/design-check.d.ts

@@ -0,0 +1,5 @@
+import { type DesignOptions } from "./design-output.js";
+/** Write the match prompt and refs for a page's latest review. */
+export declare function designReviewMatch(target: string, opts: DesignOptions): Promise<void>;
+/** Record a match answer for a page's latest review. */
+export declare function designReviewMatchRecord(target: string, opts: DesignOptions): Promise<void>;

package/dist/commands/design-decide.d.ts

@@ -0,0 +1,5 @@
+import { type DesignOptions } from "./design-output.js";
+/** List proposed edits to the design docs. */
+export declare function designProposals(opts: DesignOptions): Promise<void>;
+/** Accept (apply the exact Before → After to its doc) or reject a proposal. */
+export declare function designDecide(slug: string, decision: "accepted" | "rejected", opts: DesignOptions): Promise<void>;

package/dist/commands/design-docs.d.ts

@@ -0,0 +1,19 @@
+import { type DesignOptions } from "./design-output.js";
+/** Which design files are recorded, open proposals, and the rules cited. */
+export declare function designStatus(opts: DesignOptions): Promise<void>;
+/** Find design material; with --record, record every candidate. */
+export declare function designDetect(opts: DesignOptions): Promise<void>;
+/**
+ * Record these files (or `file#heading` sections) as design docs: kind
+ * from --kind, else as detected, else `design`; --applies-to limits them
+ * to URL path prefixes or app directories; --remove stops recording them.
+ */
+export declare function designSources(paths: string[], opts: DesignOptions): Promise<void>;
+/**
+ * Migrate a legacy `iamu/design.md` once: print the plan, or with --apply
+ * write `sources.json` (ids frozen, `migrated_at` set) and, with
+ * --move-to, the plain doc in place of `iamu/design.md`.
+ */
+export declare function designMigrate(opts: DesignOptions): Promise<void>;
+/** Add (once) a pointer to the design docs in an agent instructions file. */
+export declare function designLinkAgents(opts: DesignOptions): Promise<void>;

package/dist/commands/design-output.d.ts

@@ -0,0 +1,33 @@
+import { type CommandDiagnosticOptions } from "./context.js";
+export interface DesignOptions {
+    /** migrate: write the plan instead of printing it. */
+    apply?: boolean;
+    /** migrate: move the legacy doc to this file. */
+    moveTo?: string;
+    /** link-agents: rewrite an existing block with the current wording. */
+    refresh?: boolean;
+    json?: boolean;
+    record?: boolean;
+    kind?: string;
+    /** sources: URL path prefixes or app directories, comma-separated. */
+    appliesTo?: string;
+    /** sources: entries to stop recording. */
+    remove?: boolean;
+    /** proposals: list decided ones too. */
+    all?: boolean;
+    file?: string;
+    data?: string;
+    promptFile?: string;
+    /**
+     * review: a check — the reviewer is not shown the previous review or
+     * the designer's earlier notes, so it cannot just confirm them.
+     */
+    blind?: boolean;
+}
+/** JSON with --json, else the human output. */
+export declare const out: (opts: DesignOptions, value: unknown, human: () => void) => void;
+export declare const plural: (n: number, word: string) => string;
+/** A command error that also shows its fix hint in text mode. */
+export declare function designError(message: string, opts: CommandDiagnosticOptions & {
+    fix?: string;
+}): void;

package/dist/commands/design-prompt.d.ts

@@ -0,0 +1,4 @@
+import { type PROMPT_FILES } from "../templates.js";
+export type PromptFile = (typeof PROMPT_FILES)[number];
+/** Prompt = method (installed template), product principles, bundle. */
+export declare function composeDesignPrompt(projectRoot: string, name: PromptFile, bundle: unknown): string;

package/dist/commands/design.d.ts

@@ -1,29 +1,14 @@
-export interface DesignOptions {
-    json?: boolean;
-    record?: boolean;
-    kind?: string;
-    file?: string;
-    data?: string;
-    answers?: string;
-    promptFile?: string;
-}
-/** What design material the project has, and the state of its rules. */
-export declare function designStatus(opts: DesignOptions): Promise<void>;
-/** Find design material; with --record, record every candidate as a source. */
-export declare function designDetect(opts: DesignOptions): Promise<void>;
-/** Record exactly these sources (kind from detection, else --kind, else rules). */
-export declare function designSources(paths: string[], opts: DesignOptions): Promise<void>;
-/** Write the drafting prompt: intent, people, what the code establishes. */
-export declare function designDraft(opts: DesignOptions): Promise<void>;
-/** Record a drafted or edited design doc (Markdown). */
-export declare function designRecord(opts: DesignOptions): Promise<void>;
+import { type DesignOptions } from "./design-output.js";
+export type { DesignOptions } from "./design-output.js";
+export { designDetect, designLinkAgents, designMigrate, designSources, designStatus, } from "./design-docs.js";
+export { designDecide, designProposals } from "./design-decide.js";
+/** The project, the resolved surface, and where its review files go. */
+export declare function surfaceContext(target: string, opts: DesignOptions): Promise<{
+    ctx: import("./context.js").ProjectContext;
+    surface: import("@iamu-dev/local-store").SurfaceTarget;
+    dir: string;
+} | null>;
 /** Write the review prompt for one surface: its dossier and the method. */
 export declare function designReview(target: string, opts: DesignOptions): Promise<void>;
 /** Record a design review answer (JSON) for one surface. */
 export declare function designReviewRecord(target: string, opts: DesignOptions): Promise<void>;
-/** List proposed edits to the design rules, open first. */
-export declare function designProposals(opts: DesignOptions): Promise<void>;
-/** Accept (apply to the doc) or reject a proposal. */
-export declare function designDecide(slug: string, decision: "accepted" | "rejected", opts: DesignOptions): Promise<void>;
-/** Add (once) a pointer to the design rules in an agent instructions file. */
-export declare function designLinkAgents(opts: DesignOptions): Promise<void>;

package/dist/commands/designer.d.ts

@@ -0,0 +1,25 @@
+export interface DesignerOptions {
+    json?: boolean;
+}
+/** Where the judge's answer goes, beside its prompt. */
+export declare const DESIGNER_ANSWER_FILE = "designer_answer.json";
+/** Write the designer's prompt and refs for a run, and say what it holds. */
+export declare function designer(runId: string, opts?: DesignerOptions): Promise<void>;
+export interface DesignerRecordOptions {
+    file?: string;
+    data?: string;
+    /** The orchestrator answered the prompt itself: weaker independence. */
+    byOrchestrator?: boolean;
+    /** Older name for `byOrchestrator`. */
+    inline?: boolean;
+    /** Record that the pass did not run, and why. */
+    skipped?: string;
+    json?: boolean;
+}
+/** Record the designer's answer, then re-derive canonical.json and report.md. */
+export declare function designerRecord(runId: string, opts?: DesignerRecordOptions): Promise<void>;
+/** Dismiss one designer finding: later reviews are told not to raise it again. */
+export declare function designerDismiss(runId: string, issueId: string, opts?: {
+    reason?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/findings.d.ts

@@ -3,5 +3,7 @@ export declare function findings(opts?: {
     resolved?: boolean;
     dismissed?: boolean;
     scenario?: string;
+    /** Only the persona's, or only the designer's. Default: both. */
+    source?: string;
     json?: boolean | string;
 }): Promise<void>;

package/dist/commands/fix-brief.d.ts

@@ -1,3 +1,9 @@
+import { type DesignerFixBrief, type FixBrief } from "@iamu-dev/local-store";
 export declare function fixBrief(ref: string, opts: {
     json?: boolean;
 }): Promise<void>;
+/**
+ * A loop step as a person reads it: each backticked field name becomes
+ * the section above that holds it, or its value.
+ */
+export declare function readable(step: string, b: Pick<FixBrief | DesignerFixBrief, "rerun" | "closing_check">): string;

package/dist/commands/live-run-client.d.ts

@@ -1,4 +1,4 @@
-import type { RunStep } from "@iamu-dev/protocol";
+import { type FindingSeverity, type RunStep } from "@iamu-dev/protocol";
 /** Timeout for run registration on start-run (3 seconds). */
 export declare const REGISTER_TIMEOUT_MS = 3000;
 /** Timeout for per-step and phase event dispatches (1.5 seconds). */
@@ -54,7 +54,7 @@ export interface LiveFindingEvent {
         id: string;
         title: string;
         type: "helps" | "hinders" | "missing" | "irrelevant" | "incorrect";
-        severity: "critical" | "major" | "minor" | "observation";
+        severity: FindingSeverity | "observation";
         ui_fact?: string | null;
         consequence?: string | null;
         step_number?: number | null;
@@ -114,7 +114,7 @@ export declare function sendLiveFinding(projectRoot: string, runId: string, find
     id: string;
     title: string;
     type: "helps" | "hinders" | "missing" | "irrelevant" | "incorrect";
-    severity: "critical" | "major" | "minor" | "observation";
+    severity: FindingSeverity;
     ui_fact?: string | null;
     consequence?: string | null;
     step_number?: number | null;

package/dist/commands/register-design.d.ts

@@ -1,5 +1,6 @@
 import type { Command } from "commander";
 /**
- * Registers `design` (rules, reviews, proposals) and `fix-brief`.
+ * Registers `design` (the project's design docs, reviews, proposals) and
+ * `fix-brief`.
  */
 export declare function registerDesignCommands(program: Command): void;

package/dist/commands/register-walkthrough.d.ts

@@ -1,5 +1,5 @@
-import type { Command } from "commander";
+import { type Command } from "commander";
 /**
- * Registers walkthrough execution commands: start-run, instructions, browse, step, new-finding, complete, match, match-record, advise, advise-record, directions, evaluate, evaluate-record, prune.
+ * Registers walkthrough execution commands: start-run, instructions, browse, step, new-finding, complete, match, match-record, advise, advise-record, designer, designer-record, designer-dismiss, directions, evaluate, evaluate-record, prune.
  */
 export declare function registerWalkthroughCommands(program: Command): void;

package/dist/commands/summary.d.ts

@@ -7,6 +7,10 @@ export interface SummaryOptions {
     model?: string;
     /** The walk could not start as set up: what was missing, or `false` to clear. */
     blocked?: string | false;
+    /** The walk reached what the persona came to do: the last thing they did. */
+    reached?: string;
+    /** The walk stopped before that: why. */
+    stopped?: string;
     file?: string;
     json?: boolean;
 }
@@ -20,5 +24,11 @@ export interface SummaryData {
     blocked?: {
         reason: string;
     };
+    /** How the walk ended: reached the goal, or stopped and why. */
+    ended?: WalkEnded;
+}
+export interface WalkEnded {
+    reached: boolean;
+    note: string;
 }
 export declare function summaryCommand(runIdArg: string | undefined, opts: SummaryOptions): Promise<void>;