@iamu-dev/iamu 0.8.0-beta.0 → 0.8.0-beta.2

package/dist/commands/set-entity.d.ts

@@ -19,8 +19,16 @@ export interface SetEntityOptions {
     stateApproximation?: string;
     /** `false` clears scenario `state` (Commander defaults it to `true`). */
     state?: boolean;
+    /** Scenario bound persona slug, or `false` to clear. */
+    persona?: string | false;
+    /** Scenario outline slug. */
+    outline?: string | false;
     /** Persona access key or testability switching mechanism, or `false` to clear. */
     access?: string | false;
+    /** Persona role description. */
+    role?: string | false;
+    /** Persona disposition / attitude, or `false` to clear. */
+    disposition?: string | false;
     /** Capability route prefixes, comma-separated; replaces `paths`, or `false` to clear. */
     paths?: string | false;
     /** Capability route prefix to add (repeatable). */
@@ -33,6 +41,8 @@ export interface SetEntityOptions {
     capability?: string | false;
     /** Outline additional capabilities (comma-separated), or `false` to clear. */
     additionalCapabilities?: string | false;
+    /** Outline structural tension, or `false` to clear. */
+    tension?: string | false;
     /** Dev startup command, or `false` to clear (testability). */
     devCommand?: string | false;
     /** Authentication strategy (dev_switcher, interactive, test_accounts, public), or `false` to clear (testability). */
@@ -49,9 +59,9 @@ export interface SetEntityOptions {
     jurisdiction?: string | false;
     /** Orientation notes (context). */
     notes?: string | false;
-    /** Project description (context, alias for body narrative). */
+    /** Description (capability, outline, or context alias for body narrative). */
     description?: string | false;
-    /** Project name (context). */
+    /** Name or title (scenario, persona, outline, capability, context). */
     name?: string | false;
     /** Governing documents/standards (context patch). */
     governedBy?: ContextFrontmatter["governed_by"] | false;
@@ -59,12 +69,14 @@ export interface SetEntityOptions {
     actors?: ContextFrontmatter["actors"] | false;
     /** Domain glossary (context patch). */
     glossary?: ContextFrontmatter["glossary"] | false;
-    /** Markdown body narrative (testability, context). */
+    /** Markdown body narrative. */
     body?: string;
     /** JSON patch file (or - for stdin) containing staging fields. */
     file?: string;
     json?: boolean;
 }
+/** Fields `iamu set <type>` may change, by type (the keys are the types). */
+export declare const SETTABLE: Record<string, readonly (keyof SetEntityOptions)[]>;
 /**
  * `iamu set <type> <slug>` — change the staging fields of an existing
  * entity: a scenario's start path, target and starting state, a

package/dist/commands/skill-command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The command that runs skill `name` (`setup`, `run`, `findings`, …) in
+ * `projectRoot`, with `args` appended when given.
+ *
+ * @example
+ * ```ts
+ * skillCommand(root, "setup"); // "/iamu:init" with the plugin enabled
+ * skillCommand(root, "run", "maria--handoff"); // "/iamu-run maria--handoff"
+ * ```
+ */
+export declare function skillCommand(projectRoot: string, name: string, args?: string): string;
+/** The setup skill for `projectRoot`: what "run setup" means here. */
+export declare function setupSkill(projectRoot: string): string;

package/dist/commands/step.d.ts

@@ -25,6 +25,8 @@ export interface RecordStepInput {
     note?: string | null;
     /** Path of an existing screenshot to copy in; a missing file is an error. */
     shot?: string | null;
+    /** When true, move `shot` into `screenshots/step-N.png` via rename instead of copying. */
+    moveShot?: boolean;
     url?: string | null;
     surface?: string | null;
     grounding?: string | null;
@@ -77,6 +79,8 @@ export interface StepOptions {
     surface?: string;
     grounding?: string;
     maxSteps?: string | number;
+    /** Record into a run that is already completed. */
+    force?: boolean;
     json?: boolean;
 }
 /**

package/dist/commands/summary.d.ts

@@ -12,6 +12,8 @@ export interface SummaryOptions {
     /** The walk stopped before that: why. */
     stopped?: string;
     file?: string;
+    /** Record into a run that is already completed. */
+    force?: boolean;
     json?: boolean;
 }
 export interface SummaryData {

package/dist/commands/triage.d.ts

@@ -1,3 +1,5 @@
+/** Where a guidance rule written by `iamu triage --scope` applies. */
+export declare const SCOPES: readonly ["project", "outline", "capability"];
 export interface TriageOptions {
     status: string;
     /** Why — the triager's words. Required when dismissing. */
@@ -18,6 +20,19 @@ export interface TriageOptions {
     sweep?: boolean | string;
     json?: boolean;
 }
+/**
+ * What an addressed finding's fix now waits for: a re-run of its
+ * scenario (the persona's), or a designer's review of its screen.
+ */
+export interface AwaitingStep {
+    kind: "rerun" | "design_review";
+    /** The scenario to re-run (`rerun`). */
+    scenario?: string;
+    /** The screen to review (`design_review`). */
+    screen?: string;
+    /** The command that produces the proof. */
+    command: string;
+}
 /**
  * Set the triage status of one or more findings. Dismissing as
  * `not_relevant` or `walker_error` also writes a tester guidance rule