@iamu-dev/iamu 0.2.0-beta.16 → 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/explore.d.ts

@@ -38,6 +38,7 @@ export declare function exploreList(opts: {
  */
 export declare function exploreCoverageCommand(mapId: string | undefined, opts: {
     json?: boolean;
+    all?: boolean;
 }): Promise<void>;
 /**
  * `iamu explore diff [a] [b]` — default: the two latest maps.

package/dist/commands/init.d.ts

@@ -4,6 +4,17 @@ import type { HostAdapter } from "../adapters/types.js";
  * Claude Code has `/iamu:init` and no `iamu-setup`.
  */
 export declare function setupCommand(projectRoot: string, hosts: HostAdapter[]): string;
+/**
+ * Detect the target port for local dev execution.
+ * Checks, in order:
+ * 1. process.env.PORT
+ * 2. .env files (.env.local, .env.development, .env) for PORT, VITE_PORT, APP_URL, NEXT_PUBLIC_APP_URL
+ * 3. package.json scripts for `-p <port>` or `--port <port>` flags
+ * 4. package.json dependencies and framework config files (vite -> 5173, astro -> 4321)
+ */
+export declare function detectTargetPort(projectRoot: string): number | undefined;
+export declare function detectTargetUrl(projectRoot: string): string;
+export declare function createDraftTestabilityContent(targetUrl?: string): string;
 export interface InitOptions {
     name?: string;
     yes?: boolean;

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

@@ -13,10 +13,16 @@ export interface NewEntityOptions {
     authority?: string;
     /** Primary capability slug (outline only). */
     capability?: string;
+    /** Secondary capability slugs, comma-separated or array (outline only). */
+    additionalCapabilities?: string | string[];
     /** Structural tension driving the situation (outline only). */
     tension?: string;
     /** Human-test question to evaluate at walkthrough completion (outline only). */
     humanTest?: string | string[];
+    /** Route patterns owned by this capability, comma-separated or array (capability only). */
+    paths?: string | string[];
+    /** Optional visual grouping category (capability only). */
+    area?: string;
     /** Scenario start path, e.g. /en/episodes/1. */
     entry?: string;
     /** Scenario assumed environment state description. */

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;