@iamu-dev/iamu 0.3.0-beta.6 → 0.4.0-beta.1

package/dist/commands/advise.d.ts

@@ -0,0 +1,31 @@
+/** Stamped into `advised_by` and `advice.json`. Bump when advise.md changes meaningfully. */
+export declare const ADVISOR_VERSION = "1.2.0";
+/** The installed `iamu/.prompts/advise.md`, or the bundled template. */
+export declare function readAdvisePrompt(projectRoot: string): string;
+export interface AdviseOptions {
+    project?: boolean;
+    json?: boolean;
+    promptFile?: string;
+}
+/**
+ * Print the advisor's input: for a run (after the judge, before publish)
+ * or, with --project, across every open finding in the project.
+ */
+export declare function advise(runId: string | undefined, opts?: AdviseOptions): Promise<void>;
+export interface AdviseRecordOptions {
+    project?: boolean;
+    file?: string;
+    data?: string;
+    json?: boolean;
+}
+/** Record the advisor's answer for a run, or a project synthesis. */
+export declare function adviseRecord(runId: string | undefined, opts: AdviseRecordOptions): Promise<void>;
+export interface DirectionsOptions {
+    json?: boolean;
+}
+/** List directions, open ones first. */
+export declare function directionsList(opts: DirectionsOptions): Promise<void>;
+/** Change a direction's status. */
+export declare function directionsSet(slug: string, opts: DirectionsOptions & {
+    status?: string;
+}): Promise<void>;

package/dist/commands/answer-input.d.ts

@@ -0,0 +1,20 @@
+export interface AnswerInputOptions {
+    file?: string;
+    data?: string;
+    json?: boolean;
+}
+/** All of stdin as UTF-8 text. */
+export declare function readStdinText(): Promise<string>;
+/**
+ * Read a subagent's JSON answer for a `<stage>-record` command: `--data`
+ * inline, `--file -` from stdin, `--file <path>`, or the stage's default
+ * file in the run directory when neither is given (then `opts.file` is
+ * set to it). Reports problems as command errors and returns `undefined`.
+ */
+export declare function readAnswerInput(opts: AnswerInputOptions, what: string, fallback: {
+    defaultPath: string;
+    code: string;
+    fix: string;
+}): Promise<{
+    value: unknown;
+} | undefined>;

package/dist/commands/complete.d.ts

@@ -76,11 +76,6 @@ export declare function auditStepProvenance(steps: Array<{
 }>): ProvenanceAudit;
 /** Strictly validate runtime canonical structure against the protocol schema. */
 export declare function validateCanonicalWalkthrough(canonical: unknown): CanonicalWalkthrough;
-/**
- * Read recorded judge verdicts (if present) and overlay them onto the canonical
- * walkthrough for report markdown rendering.
- */
-export declare function applyRecordedVerdicts(canonical: CanonicalWalkthrough, runDirPath: string): Promise<CanonicalWalkthrough>;
 /** Persist canonical.json to disk atomically. */
 export declare function persistCanonical(runDirPath: string, canonical: CanonicalWalkthrough): Promise<string>;
 /** Persist report.md to disk atomically. */
@@ -100,6 +95,7 @@ export declare function assembleRun(projectRoot: string, runId: string, manifest
     };
     canonicalPath: string;
     reportPath: string;
+    htmlReportPath?: string;
 }>;
 /** One requested place, whether the run reached it, and what awaits there. */
 export type RevisitReportPlace = RevisitPlaceCoverage & {

package/dist/commands/context.d.ts

@@ -30,13 +30,6 @@ export declare function resolveRunDir(projectRoot: string, runId: string, opts?:
  * 3. Single-entity auto-selection: if exactly 1 scenario exists on disk, auto-select it.
  */
 export declare function resolveScenarioSlug(projectRoot: string, explicitSlug?: string): string | null;
-/**
- * Resolves the active finding slug following the OpenSpec single-entity resolution pattern:
- * 1. Explicit slug argument if provided
- * 2. Active finding in session state (`iamu/.cache/session-state.json`)
- * 3. Single-entity auto-selection: if exactly 1 finding exists on disk, auto-select it.
- */
-export declare function resolveFindingSlug(projectRoot: string, explicitSlug?: string): string | null;
 /**
  * Resolves the active run ID from an explicit argument or falls back to
  * session state (`iamu/.cache/session-state.json`).

package/dist/commands/evaluate.d.ts

@@ -18,6 +18,11 @@ export interface RecordedVerdicts {
  * itself never carries them (its writer is `complete`); the report does.
  */
 export declare function applyVerdicts(canonical: CanonicalWalkthrough, recorded: RecordedVerdicts): CanonicalWalkthrough;
+/**
+ * Read recorded judge verdicts (if present) and overlay them onto the canonical
+ * walkthrough for report markdown rendering.
+ */
+export declare function applyRecordedVerdicts(canonical: CanonicalWalkthrough, runDirPath: string): Promise<CanonicalWalkthrough>;
 export declare function evaluate(runId: string, opts?: {
     json?: boolean;
     promptFile?: string;

package/dist/commands/match.d.ts

@@ -1,3 +1,8 @@
+import { type WalkthroughManifest } from "@iamu-dev/local-store";
+/** A completed run's manifest, or null after reporting why not. */
+export declare function completedManifest(runDirPath: string, runId: string, opts?: {
+    json?: boolean;
+}): Promise<WalkthroughManifest | null>;
 /**
  * Print the matcher's input bundle: this run's findings, the scenario's
  * earlier canonical findings, this run's steps, and the prompt.

package/dist/commands/new-finding.d.ts

@@ -16,6 +16,8 @@ export interface NewFindingOptions {
     step?: string;
     /** Finding narrative description. */
     description?: string;
+    /** What the persona needed at that moment, with no solution. */
+    need?: string;
     /** Concrete recommendation for fixing the finding. */
     recommendation?: string;
     /** Complete markdown body (overrides description and recommendation). */

package/dist/commands/open.d.ts

@@ -1,8 +1,9 @@
 export interface OpenOptions {
     printOnly?: boolean;
+    local?: boolean;
 }
 /**
  * Opens the Iamu Cloud dashboard for the project or a specific walkthrough run.
- * If the project is not cloud-linked, prompts the user to link or view the terminal summary.
+ * If not cloud-linked (or if --local is passed), generates and opens the local HTML report.
  */
 export declare function openDashboard(runId?: string, opts?: OpenOptions): Promise<void>;

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

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

package/dist/commands/report-data.d.ts

@@ -0,0 +1,16 @@
+import type { CanonicalWalkthrough } from "@iamu-dev/protocol";
+import { type OverviewView, type RunView, type VerdictLabel } from "../ui/report-view.js";
+export interface CompletedRun {
+    runId: string;
+    manifest: Record<string, unknown>;
+    /** canonical.json with the judge's recorded verdicts applied. */
+    canonical: CanonicalWalkthrough | null;
+}
+/** Completed runs, newest first, optionally for one scenario. */
+export declare function readCompletedRuns(projectRoot: string, runIds: string[], scenario?: string): Promise<CompletedRun[]>;
+/** One label for the run: every judged test agreeing, or PARTIAL. */
+export declare function verdictLabel(c: CanonicalWalkthrough | null): VerdictLabel;
+/** "/request · step 8" from a page URL and a step id. */
+export declare function whereOf(pageUrl: unknown, stepId: unknown): string | null;
+export declare function buildRunView(projectRoot: string, run: CompletedRun): Promise<RunView>;
+export declare function buildOverview(projectRoot: string, runs: CompletedRun[]): Promise<OverviewView>;

package/dist/commands/report.d.ts

@@ -1,4 +1,8 @@
-export declare function report(scenario?: string, opts?: {
+export interface ReportOptions {
     json?: boolean;
     all?: boolean;
-}): Promise<void>;
+    html?: boolean;
+    open?: boolean;
+    journey?: boolean;
+}
+export declare function report(scenario?: string, opts?: ReportOptions): Promise<void>;

package/dist/commands/summary.d.ts

@@ -2,6 +2,8 @@ export interface SummaryOptions {
     run?: string;
     worked?: string | string[];
     question?: string | string[];
+    /** Doubts about the test setup (data, accounts, dates), not the product. */
+    setupNote?: string | string[];
     model?: string;
     /** The walk could not start as set up: what was missing, or `false` to clear. */
     blocked?: string | false;
@@ -11,6 +13,8 @@ export interface SummaryOptions {
 export interface SummaryData {
     what_worked: string[];
     open_questions: string[];
+    /** Doubts about the test setup, for whoever stages the scenario. */
+    setup_notes: string[];
     model?: string;
     /** Set when the walk could not start as set up (`--blocked`). */
     blocked?: {