@iamu-dev/iamu 0.0.0-stage → 0.2.0-beta.1

package/dist/templates/skills/iamu-status.md

@@ -0,0 +1,64 @@
+---
+name: iamu-status
+description: Check project testing status, list installed personas, scenarios, outlines, capabilities, or review walkthrough coverage and findings. Use when asked "what personas do we have?", "what scenarios exist?", "what is the test status?", "list personas", "what should we test next?", or to inspect iamu assets.
+generatedBy: __IAMU_VERSION__
+---
+
+You are the project's scenario-testing librarian. Your job is to give concise, structured overviews of iamu assets and testing status without dumping raw file bodies.
+
+$ARGUMENTS
+
+## Instructions
+
+### 1. Always use CLI commands for inspection
+
+- **List personas:** `iamu list personas` (or `--json`)
+- **List scenarios:** `iamu list scenarios` (or `--json`)
+- **List capabilities:** `iamu list capabilities`
+- **List outlines:** `iamu list outlines`
+- **List findings:** `iamu findings`
+- **Project state & run status:** `iamu status`
+
+Do NOT use `find`, `grep`, or `cat` to dump raw `.md` files in `iamu/`. The CLI outputs clean, validated data.
+
+### 2. Format entity responses as compact tables
+
+When the user asks for personas, scenarios, or findings, respond with a scannable Markdown table. Never dump full psychological profiles, vocabulary lists, or raw frontmatter unless the user explicitly asks for deep detail on one entity.
+
+**Personas:**
+| Slug | Name | Role | Status |
+|---|---|---|---|
+| `elin-dahl` | Elin Dahl | Architect & first-time house owner in Falun | active |
+
+**Scenarios:**
+| Slug | Persona | Outline | Status / Target |
+|---|---|---|---|
+| `replacing-windows` | `elin-dahl` | `measure-and-order` | ready |
+
+**Findings:**
+| # | Severity | Type | Finding | Status |
+|---|---|---|---|---|
+| 1 | CRITICAL | hinders | Submit fails opaquely on empty field | open |
+
+### 3. Ignore internal templates
+
+The directory `iamu/.prompts/` contains internal prompt templates (`persona.md`, `outline.md`, etc.). These are NOT project entities. Never list them or explain them to the user.
+
+### 4. Cloud line
+
+For a project-status question, add one line on the cloud from `iamu status --json` (`mode`, `sync`, `requests`) and `iamu auth status --json` (`authenticated`):
+
+- **Linked** → `Cloud: linked — <url from iamu open --print>`, then only what needs action: unpushed changes (`sync.pending_new` + `sync.pending_updates` + `walkthroughs.pending`, and `sync.local_deletions.count`) → `iamu sync`; `requests.open` above zero → `<N> team requests — iamu-findings`.
+- **Linked, no credentials** → `Cloud: linked, but this machine has no credentials — iamu auth login.`
+- **Local-only** → `Cloud: local-only.` Nothing more; no upgrade pitch.
+
+### 5. Provide clear next steps
+
+Conclude with one concise action prompt:
+- To run a scenario: `iamu-run <scenario-slug>`
+- To propose new personas or scenarios: `iamu-propose`
+- To draft a persona or scenario directly: `iamu-new`
+- To review open findings or team requests: `iamu-findings`
+- To inspect reports: `iamu report`, or `iamu open` for the cloud dashboard (linked projects)
+- To share unpushed work with the team: `iamu sync` (linked projects)
+

package/dist/templates.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolves the root directory containing `templates/`.
+ * In development (source/vitest): import.meta.url is in `src/` or `src/commands/`,
+ * so templates are located at `src/templates`.
+ * In production bundle (tsup): import.meta.url is in `dist/`,
+ * and copy-assets.mjs copies templates to `dist/templates`.
+ */
+export declare function getTemplatesRoot(): string;
+export declare function getTemplateDir(subdir: "skills" | "prompts"): string;
+export declare function getTemplateFile(subdir: "skills" | "prompts", filename: string): string;

package/dist/ui/journey-diff.d.ts

@@ -0,0 +1,3 @@
+import type { JourneyDiff } from "@iamu-dev/local-store";
+export declare function formatJourneyDiffTerminal(diff: JourneyDiff): string;
+export declare function printJourneyDiff(diff: JourneyDiff): void;

package/dist/ui/json.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pick specified keys from an array of records or a single record.
+ * Supports comma-separated field list: e.g. "slug,name,role".
+ * If fields is boolean true or undefined/empty, returns target as-is.
+ */
+export declare function filterJsonFields<T extends Record<string, unknown>>(target: T[] | T, fields?: string | boolean): unknown;

package/dist/ui/logger.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Standard verbosity and quiet mode helpers driven by IAMU_QUIET and IAMU_VERBOSE environment variables.
+ */
+export declare function isQuiet(): boolean;
+export declare function isVerbose(): boolean;

package/dist/ui/panic.d.ts

@@ -0,0 +1,11 @@
+type SigintCleanup = () => Promise<void> | void;
+/**
+ * Registers an asynchronous cleanup handler to execute on SIGINT (e.g. closing an HTTP server).
+ * Returns an unregister function.
+ */
+export declare function registerSigintCleanup(handler: SigintCleanup): () => void;
+/**
+ * Registers global process handlers for graceful shutdown and top-level error boundaries.
+ */
+export declare function setupProcessHandlers(): void;
+export {};

package/dist/ui/symbols.d.ts

@@ -0,0 +1,11 @@
+export declare const symbols: {
+    success: string;
+    error: string;
+    pending: string;
+    warning: string;
+    modified: string;
+    add: string;
+    info: string;
+    dot: string;
+    question: string;
+};

package/dist/ui/table.d.ts

@@ -0,0 +1,20 @@
+export declare function stripAnsi(str: string): string;
+export declare function visualLength(str: string): number;
+export declare function padRight(str: string, targetWidth: number): string;
+export declare function truncate(str: string, maxWidth: number): string;
+export interface TableColumn<T> {
+    header: string;
+    value: (item: T) => string;
+    minWidth?: number;
+    maxWidth?: number;
+}
+export interface FormatTableOptions {
+    tty?: boolean;
+}
+/**
+ * Formats data into a cleanly aligned table with dynamically calculated column widths.
+ * Automatically accounts for ANSI color sequences in length calculations.
+ * When output is piped (!process.stdout.isTTY), automatically emits machine-readable
+ * Tab-Separated Values (TSV) without ANSI escapes, borders, or text truncation.
+ */
+export declare function formatTable<T>(items: T[], columns: TableColumn<T>[], options?: FormatTableOptions): string[];

package/dist/ui/update-check.d.ts

@@ -0,0 +1,6 @@
+export declare function isSemverGreater(latest: string, current: string): boolean;
+/**
+ * Non-blocking, cached check against npm registry for CLI updates.
+ */
+export declare function checkForUpdate(currentVersion: string): Promise<string | null>;
+export declare function printUpdateNotice(currentVersion: string, latestVersion: string): void;

package/dist/worktree-state.d.ts

@@ -0,0 +1,49 @@
+/** The build block's view of the working tree. */
+export interface WorktreeState {
+    git_dirty: boolean;
+    /** Only when dirty: 12 lowercase hex characters. */
+    worktree_hash?: string;
+}
+/** Answers the working-tree question for a project root. */
+export type WorktreeDetector = (projectRoot: string) => WorktreeState | undefined;
+/** Untracked files hashed at most; past this the count still counts. */
+export declare const MAX_UNTRACKED_HASHED = 2000;
+/**
+ * Whether the working tree has changes outside `iamu/`, and their
+ * fingerprint.
+ *
+ * Hash recipe (sha256, first 12 hex characters):
+ * 1. the bytes of `git diff HEAD --binary -- . ':(exclude)<iamu>'`, run
+ *    from the repository root with diff settings pinned;
+ * 2. then, for each untracked non-ignored file outside `iamu/` sorted by
+ *    path (bytewise, at most {@link MAX_UNTRACKED_HASHED}):
+ *    `<path>\0<sha256 of content>\n`, and past the cap `+<count>\n`.
+ *
+ * @example
+ * ```ts
+ * detectWorktreeState("/work/shop");
+ * // { git_dirty: true, worktree_hash: "3fa9c1d2e4b5" }
+ * ```
+ */
+export declare function detectWorktreeState(projectRoot: string, iamuDirName?: string): WorktreeState | undefined;
+/**
+ * Whether the product's code changed between `start-run` and `complete`.
+ * The build block's fingerprint is taken at start; an edit (or commit) made
+ * while the walker was out means the run's findings may mix two versions,
+ * and the build it lands in describes only the first.
+ *
+ * @param start - The run's recorded build block (`walkthrough.json`).
+ * @param now - The working tree as it is now.
+ * @returns A one-line warning, or null when nothing changed or either side
+ *   is unknown.
+ *
+ * @example
+ * ```ts
+ * codeChangedWarning({ git_dirty: false }, { git_dirty: true, worktree_hash: "a1b2c3d4e5f6" });
+ * // "the product's code changed during the walk …"
+ * ```
+ */
+export declare function codeChangedWarning(start: {
+    git_dirty?: boolean;
+    worktree_hash?: string;
+} | undefined, now: WorktreeState | undefined): string | null;

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@iamu-dev/iamu",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0-beta.1",
+  "type": "module",
+  "description": "Test your product as realistic personas — scenario-driven development CLI",
+  "license": "UNLICENSED",
+  "author": "Iamu <hello@iamu.dev>",
+  "homepage": "https://iamu.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iamu-dev/iamu.git",
+    "directory": "apps/cli"
+  },
+  "bugs": "https://github.com/iamu-dev/iamu/issues",
+  "keywords": [
+    "iamu",
+    "scenario-testing",
+    "persona-testing",
+    "walkthrough",
+    "ux-testing",
+    "devex",
+    "claude-code"
+  ],
+  "bin": {
+    "iamu": "./dist/bin.js"
+  },
+  "sideEffects": true,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "playwright-core": "^1.58.2",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.1.11",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.11",
+    "@iamu-dev/protocol": "0.1.0",
+    "@iamu-dev/local-store": "0.1.0",
+    "@iamu/tsconfig": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup && tsc -b tsconfig.build.json --emitDeclarationOnly && node scripts/copy-assets.mjs",
+    "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('tsconfig.tsbuildinfo', { force: true }); fs.rmSync('tsconfig.build.tsbuildinfo', { force: true })\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "pack:dry-run": "npm pack --dry-run"
+  }
 }