@iamu-dev/iamu 0.2.0-beta.17 → 0.2.0-beta.19

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

@@ -0,0 +1,8 @@
+export interface EditEntityOptions {
+    json?: boolean;
+}
+/**
+ * Open an entity in the user's $EDITOR or $VISUAL, and validate its frontmatter
+ * against the entity schema on exit.
+ */
+export declare function editEntity(type: string, slug: string, opts?: EditEntityOptions): Promise<void>;

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

@@ -0,0 +1,46 @@
+/**
+ * Options for `iamu set`. Every field is staging: where a walk starts,
+ * what the world holds, which account a persona uses, which routes an
+ * area owns. What a scenario is about (narrative, tension, human tests,
+ * brief, background) is not settable here — that is authoring's.
+ *
+ * Commander maps `--no-<flag>` to `false`, which clears the field.
+ */
+export interface SetEntityOptions {
+    /** Scenario start path, or `false` to clear. */
+    entry?: string | false;
+    /** Scenario default target URL, or `false` to clear. */
+    target?: string | false;
+    /** Scenario `state.description`. */
+    stateDescription?: string;
+    /** Scenario `state.approximation`. */
+    stateApproximation?: string;
+    /** `false` clears scenario `state` (Commander defaults it to `true`). */
+    state?: boolean;
+    /** Persona access key, or `false` to clear. */
+    access?: string | false;
+    /** Capability route prefixes, comma-separated; replaces `paths`, or `false` to clear. */
+    paths?: string | false;
+    /** Capability route prefix to add (repeatable). */
+    addPath?: string[];
+    /** Capability route prefix to remove (repeatable). */
+    removePath?: string[];
+    /** Capability visual grouping, or `false` to clear. */
+    area?: string | false;
+    /** JSON patch file (or - for stdin) containing staging fields. */
+    file?: string;
+    json?: boolean;
+}
+/**
+ * `iamu set <type> <slug>` — change the staging fields of an existing
+ * entity: a scenario's start path, target and starting state, a
+ * persona's access key, a capability's route prefixes and area.
+ *
+ * @example
+ * ```bash
+ * iamu set scenario maria--handoff --entry /incidents \
+ *   --state-description "Five open incidents at one site"
+ * iamu set capability team-access --add-path /team
+ * ```
+ */
+export declare function setEntity(type: string, slug: string, opts: SetEntityOptions): Promise<void>;

package/dist/commands/summary.d.ts

@@ -3,6 +3,8 @@ export interface SummaryOptions {
     worked?: string | string[];
     question?: string | string[];
     model?: string;
+    /** The walk could not start as set up: what was missing, or `false` to clear. */
+    blocked?: string | false;
     file?: string;
     json?: boolean;
 }
@@ -10,5 +12,9 @@ export interface SummaryData {
     what_worked: string[];
     open_questions: string[];
     model?: string;
+    /** Set when the walk could not start as set up (`--blocked`). */
+    blocked?: {
+        reason: string;
+    };
 }
 export declare function summaryCommand(runIdArg: string | undefined, opts: SummaryOptions): Promise<void>;

package/dist/commands/validate.d.ts

@@ -1,3 +1,6 @@
+import { type EntityType } from "@iamu-dev/protocol";
+import type { ZodSchema } from "zod";
+export declare const schemaByType: Record<EntityType, ZodSchema>;
 export declare function validate(filePath: string | undefined, opts: {
     run?: string;
     all?: boolean;