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

package/dist/commands/browse-actions.d.ts

@@ -28,6 +28,7 @@ export interface IndexedElement {
     name: string;
     type?: string;
     disabled?: boolean;
+    checked?: boolean;
 }
 export declare const INDEXED_SELECTOR: string;
 export declare function markAndQueryIndexedElements(page: Page): Promise<IndexedElement[]>;

package/dist/commands/browse-driver.d.ts

@@ -43,7 +43,7 @@ export interface BrowserDriver {
     /** The full command line of `pid`, or null when it is gone or cannot be read. */
     commandLine(pid: number): Promise<string | null>;
     /** Send SIGTERM to `pid`. Never throws. */
-    kill(pid: number): void;
+    kill(pid: number, signal?: NodeJS.Signals | number): void;
 }
 /** How long a CDP liveness probe may take before the port counts as dead. */
 export declare const CDP_PROBE_TIMEOUT_MS = 1000;
@@ -65,10 +65,9 @@ export declare const CDP_PROBE_TIMEOUT_MS = 1000;
  */
 export declare function probeCdp(port: number, timeoutMs?: number): Promise<boolean>;
 /**
- * The command line of a running process, read without a shell:
- * `/proc/<pid>/cmdline` on Linux, else `ps -ww -o args= -p <pid>`.
- * Windows has no equivalent we trust, so it answers null there — and
- * callers then leave the process alone.
+ * The command line of a running process:
+ * `/proc/<pid>/cmdline` on Linux, PowerShell CIM query on Windows,
+ * else `ps -ww -o args= -p <pid>`.
  *
  * @param pid - Process ID to inspect.
  * @param platform - Defaults to `process.platform`.
@@ -82,6 +81,12 @@ export declare function probeCdp(port: number, timeoutMs?: number): Promise<bool
  * @public
  */
 export declare function readProcessCommandLine(pid: number, platform?: NodeJS.Platform): Promise<string | null>;
+/**
+ * Supported browser executable names in process command lines.
+ *
+ * @public
+ */
+export declare const BROWSER_NAME_RE: RegExp;
 /**
  * Was this command line launched with exactly this `--user-data-dir`?
  * The profile directory is ours alone, so a match means the PID is the
@@ -117,5 +122,20 @@ export declare function isOurBrowser(commandLine: string | null, profileDir: str
  * @public
  */
 export declare function reapBrowser(pid: number, profileDir: string, driver: Pick<BrowserDriver, "commandLine" | "kill">): Promise<boolean>;
+/**
+ * Select the target page to act on from all open pages in the context.
+ * Filters out devtools and browser internal/extension pages unless only internal pages exist.
+ * Respects pageIndex when valid; otherwise prefers the last active non-blank page.
+ *
+ * @param rawPages - All pages returned by the browser context.
+ * @param pageIndex - Optional explicit zero-based index into the filtered pages array.
+ * @returns The selected Page and the list of user/available pages.
+ *
+ * @public
+ */
+export declare function selectTargetPage(rawPages: Page[], pageIndex?: number): {
+    page: Page | undefined;
+    pages: Page[];
+};
 /** The real driver: spawns Chrome and speaks CDP through playwright-core. */
 export declare const cdpDriver: BrowserDriver;

package/dist/commands/browse.d.ts

@@ -19,6 +19,10 @@ export interface BrowseOptions {
     surface?: string;
     maxSteps?: string | number;
     stepFile?: string;
+    /** Chained page actions executed sequentially in a single browse step before screenshot. */
+    then?: string[];
+    /** Include post-action indexed snapshot in browse step output (default: true). */
+    snapshot?: boolean;
     json?: boolean;
     /** Annotate snapshot with 1-based index numbers [#N] for click-index / fill-index */
     indexed?: boolean;
@@ -177,7 +181,16 @@ export declare function detectAntiBotChallenge(page: Page, allowEvaluate?: boole
  */
 export declare function withPage(opts: BrowseOptions, driver: BrowserDriver, fn: (page: Page) => Promise<void>, 
 /** What the action looks for, named for the error message. */
-target?: string): Promise<PageResult | null>;
+target?: string, 
+/** Optional post-screenshot hook executed before detaching from CDP. */
+onPostShot?: (page: Page) => Promise<void>): Promise<PageResult | null>;
+/**
+ * Obtain an ARIA accessibility snapshot with fallback from body to :root,
+ * handling empty or about:blank pages gracefully.
+ *
+ * @public
+ */
+export declare function resilientAriaSnapshot(page: Page): Promise<string>;
 /** What {@link clearOriginStorage} removed. */
 export interface ClearedStorage {
     origin: string;
@@ -194,6 +207,13 @@ export declare function clearOriginStorage(origin: string, driver?: BrowserDrive
 returnTo?: string): Promise<ClearedStorage | {
     error: string;
 }>;
+/**
+ * Split a chained action string (e.g. `fill-index 22 "2026-11-20"`) into tokens,
+ * respecting single and double quotes.
+ *
+ * @public
+ */
+export declare function parseActionCommand(raw: string): string[];
 /**
  * `iamu browse <command> [args…]` — dispatch one browse subcommand.
  * Failures print to stderr and set exit code 1.

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

@@ -2,7 +2,7 @@ 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.
+ * Open an entity or project configuration file in the user's $EDITOR or $VISUAL,
+ * and validate its frontmatter against the schema on exit.
  */
-export declare function editEntity(type: string, slug: string, opts?: EditEntityOptions): Promise<void>;
+export declare function editEntity(type: string, slug?: string, opts?: EditEntityOptions): Promise<void>;

package/dist/commands/init.d.ts

@@ -8,18 +8,18 @@ export declare function setupCommand(projectRoot: string, hosts: HostAdapter[]):
  * 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)
+ * 2. Root .env files, vite/astro config `port:`, package.json scripts/deps
+ * 3. Monorepo workspace subdirectories (apps/*, packages/*, web, frontend, client)
  */
 export declare function detectTargetPort(projectRoot: string): number | undefined;
 export declare function detectTargetUrl(projectRoot: string): string;
-export declare function createDraftTestabilityContent(targetUrl?: string): string;
+export declare function createDraftTestabilityContent(targetUrl?: string, status?: "draft" | "verified"): string;
 export interface InitOptions {
     name?: string;
     yes?: boolean;
     json?: boolean;
     cloud?: boolean;
+    target?: string;
 }
 /**
  * Scaffold `iamu/` and install skills for the detected hosts.

package/dist/commands/instructions-walk.d.ts

@@ -1,5 +1,11 @@
 import { type GuidanceRule, type RevisitPlace } from "@iamu-dev/local-store";
 import { type RunViewport, type ScenarioState } from "@iamu-dev/protocol";
+/**
+ * How to invoke this very CLI from a subagent's shell. Aliases and
+ * shell functions do not exist there, so name the executable that is
+ * running now.
+ */
+export declare function selfCommand(execPath?: string, scriptPath?: string): string;
 /** "The browser is sized as a phone screen, 390×844." */
 export declare function viewportLine(v: RunViewport): string;
 interface WalkerPromptParts {

package/dist/commands/preflight.d.ts

@@ -10,14 +10,16 @@ export interface PreflightCheckResult {
     reason?: string;
 }
 /**
- * Detect the fast compile/typecheck/lint command for a target project.
+ * Detect the fast compile/typecheck command for a target project.
+ * Deliberately excludes lint scripts (`check`, `eslint`, `biome check`) so
+ * lint rules never block walkthrough execution.
  */
 export declare function detectPreflightCommand(targetDir: string): Promise<{
     command: string;
     args: string[];
 } | null>;
 /**
- * Executes a fast preflight type/lint check.
+ * Executes a fast preflight typecheck.
  */
 export declare function runPreflightCheck(targetDir: string): Promise<PreflightCheckResult>;
 /**

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;