@praxis-framework/cli 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# @praxis-framework/cli
+
+Operator CLI for the [praxis-framework](https://github.com/steveworley/praxis-framework). Use this for **scripted / CI setup** or for running `praxis log` from inside verbs. For first-time exploration of the framework, the [`docker run` flow](https://github.com/steveworley/praxis-framework#quickstart) is lower friction — no install, the dashboard wizard writes the same files into the mounted directory.
+
+## Install
+
+```bash
+npm install -g @praxis-framework/cli
+```
+
+Requires Node.js 20 or newer.
+
+## Quick start
+
+```bash
+mkdir my-role && cd my-role
+
+# Interactive wizard — walks organisation context, role definition,
+# voice traits, capabilities, inhibitions, and verbs.
+praxis init
+
+# Or hand it a config file (useful for CI / reproducible setups).
+praxis init --config role.json --path .
+
+# Set your API key and bring the dashboard up.
+cp .env.example .env && vim .env   # set ANTHROPIC_API_KEY
+docker compose up                   # pulls ghcr.io/steveworley/praxis-framework/dashboard:main
+```
+
+Open `http://localhost:4321/`.
+
+The CLI emits a populated role directory with `persona.md`, `CLAUDE.md`, `verbs/`, `lib/`, `memory/`, `escalations/`, `output/`, plus `docker-compose.yml` + `.env.example` so the role is runnable with one `docker compose up` — no framework clone required. The seed auto-initialises the target as a git repo on `main`, so you can run `praxis init` against a freshly-`mkdir`'d empty dir without pre-running `git init`. Commits are left for you to make when you're ready. See `examples/sample-role.json` for the config schema.
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `praxis init` | Walk the wizard and write a new role into the target path. |
+| `praxis init --config <file>` | Skip the wizard and seed from a JSON role definition. |
+| `praxis init --path <dir>` | Target directory for the seeded role (default: current directory). |
+| `praxis log` | Append a structured log entry to the active role's runtime log. |
+
+## Docs
+
+- [Framework overview](https://github.com/steveworley/praxis-framework#readme)
+- [Creating a role](https://github.com/steveworley/praxis-framework/blob/main/docs/creating-a-role.md)
+- [Sample role config](https://github.com/steveworley/praxis-framework/blob/main/cli/examples/sample-role.json)
+
+## License
+
+MIT — see [LICENSE](https://github.com/steveworley/praxis-framework/blob/main/LICENSE).

package/dist/app.js

@@ -0,0 +1,122 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text, useApp } from 'ink';
+import { emptyForm, } from './state/form.js';
+import { firstStep } from './state/steps.js';
+import { Welcome } from './flows/welcome.js';
+import { OrganisationFlow } from './flows/organisation.js';
+import { RoleDefinitionFlow } from './flows/role-definition.js';
+import { PathChoiceFlow } from './flows/path-choice.js';
+import { ToolSelection } from './flows/tools.js';
+import { VoiceFlow } from './flows/voice.js';
+import { CapabilitiesFlow } from './flows/capabilities.js';
+import { InhibitionsFlow } from './flows/inhibitions.js';
+import { InitialVerbsFlow } from './flows/initial-verbs.js';
+import { Review } from './flows/review.js';
+import { Wrote } from './flows/wrote.js';
+import { adaptFormToSeedInput } from './lib/seed-adapter.js';
+import { Header } from './ui/header.js';
+import { warn } from './ui/theme.js';
+/**
+ * Wraps the active step's content in a Box that always has the praxis
+ * pixel-art Header at top. The Header is rendered once at the App level
+ * and persists across every state transition — keeps the brand presence
+ * consistent throughout the wizard.
+ */
+export const App = ({ scaffoldPath, catalog }) => {
+    const { exit } = useApp();
+    const [step, setStep] = useState(firstStep());
+    const [form, setForm] = useState(emptyForm());
+    const [seedInput, setSeedInput] = useState(null);
+    const [cancelled, setCancelled] = useState(false);
+    const cancel = () => {
+        setCancelled(true);
+        exit();
+    };
+    const goTo = (next) => setStep(next);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Header, {}), cancelled ? (_jsxs(Text, { children: [warn('cancelled'), " \u2014 no changes were written."] })) : (renderStep({
+                step,
+                form,
+                setForm,
+                seedInput,
+                setSeedInput,
+                goTo,
+                cancel,
+                exit,
+                scaffoldPath,
+                catalog,
+            }))] }));
+};
+const renderStep = ({ step, form, setForm, seedInput, setSeedInput, goTo, cancel, exit, scaffoldPath, catalog, }) => {
+    if (step === 'welcome') {
+        return _jsx(Welcome, { onNext: () => goTo('organisation'), onCancel: cancel });
+    }
+    if (step === 'organisation') {
+        return (_jsx(OrganisationFlow, { initial: form.organisation, onCancel: cancel, onNext: (next) => {
+                setForm({ ...form, organisation: next });
+                goTo('role-definition');
+            } }));
+    }
+    if (step === 'role-definition') {
+        return (_jsx(RoleDefinitionFlow, { initial: form.role_definition, onCancel: cancel, onNext: (next) => {
+                setForm({ ...form, role_definition: next });
+                goTo('path-choice');
+            } }));
+    }
+    if (step === 'path-choice') {
+        return (_jsx(PathChoiceFlow, { onCancel: cancel, onNext: (path) => {
+                setForm({ ...form, path });
+                goTo('tool-selection');
+            } }));
+    }
+    if (step === 'tool-selection') {
+        return (_jsx(ToolSelection, { catalog: catalog, initial: form.tools, onCancel: cancel, onNext: (tools) => {
+                setForm({ ...form, tools });
+                goTo('voice');
+            } }));
+    }
+    if (step === 'voice') {
+        return (_jsx(VoiceFlow, { initial: form.voice_traits, onCancel: cancel, onNext: (voice_traits) => {
+                setForm({ ...form, voice_traits });
+                goTo('capabilities');
+            } }));
+    }
+    if (step === 'capabilities') {
+        return (_jsx(CapabilitiesFlow, { initial: form.capabilities, onCancel: cancel, onNext: (capabilities) => {
+                setForm({ ...form, capabilities });
+                goTo('inhibitions');
+            } }));
+    }
+    if (step === 'inhibitions') {
+        return (_jsx(InhibitionsFlow, { initial: form.inhibitions, onCancel: cancel, onNext: (inhibitions) => {
+                setForm({ ...form, inhibitions });
+                goTo('initial-verbs');
+            } }));
+    }
+    if (step === 'initial-verbs') {
+        return (_jsx(InitialVerbsFlow, { initial: form.initial_verbs, onCancel: cancel, onNext: (initial_verbs) => {
+                setForm({ ...form, initial_verbs });
+                goTo('review');
+            } }));
+    }
+    if (step === 'review') {
+        return (_jsx(Review, { form: form, scaffoldPath: scaffoldPath, onCancel: cancel, onConfirm: () => {
+                // Re-validate at the seam — the review screen has already shown
+                // any issues, but we don't trust it to be the only source of
+                // truth. If validation fails here it's a wizard bug.
+                const result = adaptFormToSeedInput(form);
+                if (!result.ok)
+                    return;
+                setSeedInput(result.input);
+                goTo('wrote');
+            } }));
+    }
+    // 'wrote'
+    if (seedInput === null) {
+        // Defensive: someone landed on `wrote` without a validated input.
+        // Treat as cancellation rather than try to seed an empty form.
+        return _jsx(Text, { children: warn('Internal: no seed input available — cancelled.') });
+    }
+    return _jsx(Wrote, { input: seedInput, scaffoldPath: scaffoldPath, onExit: exit });
+};
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"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"}

package/dist/commands/init-config.js

@@ -0,0 +1,85 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { SeedError, SeedInputSchema, seedRole, } from '@praxis-framework/seed';
+/**
+ * Typed error class so the commander wrapper can map clean exit codes
+ * without leaking stack traces to operator-facing output. The `cause`
+ * preserves the underlying error (Zod issue, fs ENOENT, JSON parse fail)
+ * for callers that want to inspect it — tests assert on `code` instead.
+ */
+export class InitConfigError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'InitConfigError';
+    }
+}
+/**
+ * Read + validate the config file, then call `seedRole`.
+ *
+ * Errors are normalised into `InitConfigError` so the commander wrapper
+ * can write a single-line stderr message and exit non-zero. The result
+ * mirrors `seedRole`'s `SeedResult` so callers can format their own
+ * success message.
+ */
+export async function runInitConfig(options) {
+    const input = await loadAndValidateConfig(options.configPath);
+    const absTarget = path.resolve(options.targetPath);
+    try {
+        return await seedRole(input, absTarget, { overwrite: options.overwrite ?? false });
+    }
+    catch (err) {
+        if (err instanceof SeedError) {
+            throw new InitConfigError(err.message, 'SEED_FAILED', err);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        throw new InitConfigError(`Seed failed: ${message}`, 'SEED_FAILED', err);
+    }
+}
+/**
+ * Read the file, parse as JSON, validate against `SeedInputSchema`. Each
+ * failure mode gets its own error code so tests can distinguish them
+ * cleanly without string-matching messages.
+ */
+async function loadAndValidateConfig(configPath) {
+    const absConfig = path.resolve(configPath);
+    let raw;
+    try {
+        raw = await fs.readFile(absConfig, 'utf-8');
+    }
+    catch (err) {
+        const errno = err.code;
+        if (errno === 'ENOENT') {
+            throw new InitConfigError(`Config file not found: ${absConfig}`, 'CONFIG_NOT_FOUND', err);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        throw new InitConfigError(`Failed to read config file ${absConfig}: ${message}`, 'CONFIG_UNREADABLE', err);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new InitConfigError(`Config file is not valid JSON (${absConfig}): ${message}`, 'CONFIG_INVALID_JSON', err);
+    }
+    const result = SeedInputSchema.safeParse(parsed);
+    if (!result.success) {
+        const summary = formatZodError(result.error);
+        throw new InitConfigError(`Config does not match SeedInput schema: ${summary}`, 'CONFIG_INVALID_SCHEMA', result.error);
+    }
+    return result.data;
+}
+/**
+ * Render a Zod issue list as a single line. Mirrors the `seedRole` internal
+ * formatter so operators get the same flavour of error from both surfaces.
+ */
+function formatZodError(error) {
+    return error.issues
+        .map((i) => `${i.path.join('.') || '<root>'}: ${i.message}`)
+        .join('; ');
+}
+//# sourceMappingURL=init-config.js.map

package/dist/commands/init-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-config.js","sourceRoot":"","sources":["../../src/commands/init-config.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink';
+import { App } from '../app.js';
+import { loadCatalog } from '../lib/catalog.js';
+import { InitConfigError, runInitConfig } from './init-config.js';
+export const initCommand = async (options) => {
+    const scaffoldPath = options.path ?? process.cwd();
+    // Non-interactive branch — read a JSON config and call `seedRole` directly.
+    // We deliberately don't load the framework catalog here: the catalog is the
+    // wizard's source of truth for tool/trait options, but a config-driven seed
+    // is just "trust the file", so we hand straight off to the seed package.
+    if (options.config !== undefined) {
+        try {
+            const result = await runInitConfig({
+                configPath: options.config,
+                targetPath: scaffoldPath,
+                overwrite: options.overwrite ?? false,
+            });
+            process.stdout.write(`praxis: seeded ${result.filesWritten.length} files to ${result.targetPath}\n`);
+            return;
+        }
+        catch (err) {
+            const message = err instanceof InitConfigError ? err.message : err instanceof Error ? err.message : String(err);
+            process.stderr.write(`praxis: ${message}\n`);
+            process.exit(1);
+        }
+    }
+    // Interactive branch — Ink's useInput requires raw mode, which only works
+    // on a real TTY. Refuse to start cleanly when run under CI, piped input,
+    // or any non-interactive context — beats letting the React reconciler
+    // crash with an obscure "Raw mode is not supported" stack trace.
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        process.stderr.write('praxis init requires an interactive terminal.\n' +
+            'Run it from a real shell — not piped, not in CI, not nested in another process.\n' +
+            'For non-interactive use, pass --config <path-to-role.json>.\n');
+        process.exit(1);
+    }
+    // Load the framework catalog up-front. The wizard can't function without
+    // it, and surfacing the failure here keeps the Ink tree free of a
+    // loading-spinner detour for what should be an instant disk read.
+    let catalog;
+    try {
+        catalog = await loadCatalog();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`praxis: ${message}\n`);
+        process.exit(1);
+    }
+    const { waitUntilExit } = render(_jsx(App, { scaffoldPath: scaffoldPath, catalog: catalog }), {
+        exitOnCtrlC: true,
+    });
+    waitUntilExit().catch((err) => {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`praxis: ${message}\n`);
+        process.exit(1);
+    });
+};
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.tsx"],"names":[],"mappings":"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"}

package/dist/commands/log.js

@@ -0,0 +1,171 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Run the log subcommand. Resolves the role root, writes the JSONL entry,
+ * and returns when the file has been appended. Throws on failure so the
+ * commander wrapper can map the error to a non-zero exit + clean stderr.
+ *
+ * Pure side-effect-driven: filesystem write + optional stdout echo. The
+ * function returns the JSON line that was written so tests can assert
+ * against the in-memory shape without re-reading the file.
+ */
+export async function runLog(options, extras, cwd = process.cwd(), now = new Date()) {
+    if (!options.action || options.action.length === 0) {
+        throw new LogError('--action is required');
+    }
+    const parsedExtras = parseExtras(extras);
+    const root = resolveRoleRoot(cwd);
+    const logsDir = options.campaign
+        ? path.join(root, 'campaigns', options.campaign, 'logs')
+        : path.join(root, 'logs');
+    // When a campaign is supplied, the campaign directory must already exist —
+    // logging into a non-existent campaign would scatter orphan log files the
+    // dashboard never reads. The role-local `logs/` directory is auto-created
+    // because there's no equivalent "is this a real campaign?" check available.
+    if (options.campaign) {
+        const campaignDir = path.dirname(logsDir);
+        if (!directoryExists(campaignDir)) {
+            throw new LogError(`Campaign directory does not exist: ${campaignDir}. Create it before logging, or check the campaign id.`);
+        }
+    }
+    fs.mkdirSync(logsDir, { recursive: true });
+    const today = localDateIsoString(now);
+    const logPath = path.join(logsDir, `${today}.jsonl`);
+    // Field ordering matters for human-readability of the JSONL — timestamp
+    // first, then conventional fields in a fixed order, then operator extras
+    // in the order they appeared on the command line. Mirrors the Python
+    // implementation so dashboard parsers see no shape change.
+    const record = {
+        timestamp: localIsoString(now),
+    };
+    const flagFields = [
+        ['agent', options.agent],
+        ['action', options.action],
+        ['prospect_id', options.prospect],
+        ['campaign_id', options.campaign],
+        ['details', options.details],
+        ['subject', options.subject],
+    ];
+    for (const [key, value] of flagFields) {
+        if (value !== undefined)
+            record[key] = value;
+    }
+    for (const [key, value] of parsedExtras) {
+        if (key in record) {
+            process.stderr.write(`warning: extra '${key}' shadowed by flag value\n`);
+            continue;
+        }
+        record[key] = value;
+    }
+    const line = JSON.stringify(record);
+    fs.appendFileSync(logPath, `${line}\n`, 'utf-8');
+    if (options.echo) {
+        process.stdout.write(`${line}\n`);
+    }
+    return { line, logPath };
+}
+/**
+ * Thin error class used by the command implementation. The commander wrapper
+ * (in index.tsx) catches these and writes the message to stderr + exits
+ * non-zero, so the CLI never surfaces a stack trace for operator-facing
+ * failures.
+ */
+export class LogError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LogError';
+    }
+}
+/**
+ * Walk up from `start` looking for a directory containing `persona.md`.
+ * That's the framework's canonical role-root marker — every seeded role has
+ * one, and only role roots have one at the top level. Throws if we hit the
+ * filesystem root without finding it.
+ */
+function resolveRoleRoot(start) {
+    let cur = path.resolve(start);
+    // Loop guard: stop once parent equals self (filesystem root).
+    while (true) {
+        if (fileExists(path.join(cur, 'persona.md'))) {
+            return cur;
+        }
+        const parent = path.dirname(cur);
+        if (parent === cur) {
+            throw new LogError(`Could not locate a 'persona.md' walking up from ${start}. Run from inside a praxis role directory.`);
+        }
+        cur = parent;
+    }
+}
+/**
+ * Parse trailing `key=value` arguments. Empty keys or pairs missing the
+ * separator are both fatal — silently dropping malformed extras would let
+ * agents log garbage forever without noticing.
+ */
+function parseExtras(pairs) {
+    const out = [];
+    for (const p of pairs) {
+        const eq = p.indexOf('=');
+        if (eq < 0) {
+            throw new LogError(`Extra arg must be key=value (got: ${JSON.stringify(p)})`);
+        }
+        const key = p.slice(0, eq);
+        const value = p.slice(eq + 1);
+        if (key.length === 0) {
+            throw new LogError(`Extra arg has empty key: ${JSON.stringify(p)}`);
+        }
+        out.push([key, value]);
+    }
+    return out;
+}
+function fileExists(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function directoryExists(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Render the local date as `YYYY-MM-DD`. Matches Python's
+ * `datetime.now().astimezone().date().isoformat()` — the day boundary is
+ * the local boundary, not UTC, so a midnight-PT log lands in the right
+ * file regardless of where the operator is.
+ */
+function localDateIsoString(d) {
+    const yyyy = d.getFullYear();
+    const mm = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}`;
+}
+/**
+ * Render an ISO 8601 string with a local timezone offset (e.g.
+ * `2026-05-08T10:23:45+10:00`). Mirrors Python's
+ * `datetime.now().astimezone().isoformat(timespec='seconds')`.
+ *
+ * `Date.prototype.toISOString()` returns UTC with a trailing `Z`, which
+ * loses the operator's local clock context — useful when reading logs
+ * during a session — so we assemble the offset string by hand.
+ */
+function localIsoString(d) {
+    const yyyy = d.getFullYear();
+    const mm = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    const hh = String(d.getHours()).padStart(2, '0');
+    const mi = String(d.getMinutes()).padStart(2, '0');
+    const ss = String(d.getSeconds()).padStart(2, '0');
+    const offsetMinutes = -d.getTimezoneOffset();
+    const sign = offsetMinutes >= 0 ? '+' : '-';
+    const absOffset = Math.abs(offsetMinutes);
+    const offHh = String(Math.floor(absOffset / 60)).padStart(2, '0');
+    const offMm = String(absOffset % 60).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}T${hh}:${mi}:${ss}${sign}${offHh}:${offMm}`;
+}
+//# sourceMappingURL=log.js.map

package/dist/commands/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/commands/log.ts"],"names":[],"mappings":"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"}

package/dist/flows/capabilities.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ListBuilder } from '../ui/list-builder.js';
+const FIELDS = [
+    {
+        key: 'value',
+        label: 'capability',
+        placeholder: 'e.g. drafts cold-outreach emails',
+        extract: (i) => i.value,
+        apply: (i, value) => ({ ...i, value }),
+    },
+];
+const validate = (i) => i.value.trim().length === 0 ? 'capability is required' : null;
+export const CapabilitiesFlow = ({ initial, onNext, onCancel }) => (_jsx(ListBuilder, { title: "Capabilities", helper: "What this role is responsible for. Action-shaped.", initial: initial.map((value) => ({ value })), fields: FIELDS, empty: () => ({ value: '' }), validate: validate, min: 1, max: 10, onNext: (items) => onNext(items.map((i) => i.value.trim())), onCancel: onCancel }));
+//# sourceMappingURL=capabilities.js.map

package/dist/flows/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/flows/capabilities.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAkB,MAAM,uBAAuB,CAAC;AAYpE,MAAM,MAAM,GAAsB;IAChC;QACE,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK;QACvB,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;KACvC;CACF,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,CAAO,EAAiB,EAAE,CAC1C,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC;AAEhE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAS,EAAE,EAAE,CAAC,CACxE,KAAC,WAAW,IACV,KAAK,EAAC,cAAc,EACpB,MAAM,EAAC,mDAAmD,EAC1D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAC5C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAC5B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,CAAC,EACN,GAAG,EAAE,EAAE,EACP,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAC3D,QAAQ,EAAE,QAAQ,GAClB,CACH,CAAC"}

package/dist/flows/inhibitions.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ListBuilder } from '../ui/list-builder.js';
+const FIELDS = [
+    {
+        key: 'value',
+        label: 'inhibition',
+        placeholder: 'e.g. never quote prices without sign-off',
+        extract: (i) => i.value,
+        apply: (i, value) => ({ ...i, value }),
+    },
+];
+const validate = (i) => i.value.trim().length === 0 ? 'inhibition is required' : null;
+export const InhibitionsFlow = ({ initial, onNext, onCancel }) => (_jsx(ListBuilder, { title: "Hard inhibitions", helper: "Things this role must never do. Use sparingly \u2014 these are absolute.", initial: initial.map((value) => ({ value })), fields: FIELDS, empty: () => ({ value: '' }), validate: validate, min: 0, max: 10, onNext: (items) => onNext(items.map((i) => i.value.trim())), onCancel: onCancel }));
+//# sourceMappingURL=inhibitions.js.map

package/dist/flows/inhibitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inhibitions.js","sourceRoot":"","sources":["../../src/flows/inhibitions.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAkB,MAAM,uBAAuB,CAAC;AAYpE,MAAM,MAAM,GAAsB;IAChC;QACE,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,0CAA0C;QACvD,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK;QACvB,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;KACvC;CACF,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,CAAO,EAAiB,EAAE,CAC1C,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC;AAEhE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAS,EAAE,EAAE,CAAC,CACvE,KAAC,WAAW,IACV,KAAK,EAAC,kBAAkB,EACxB,MAAM,EAAC,0EAAqE,EAC5E,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAC5C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAC5B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,CAAC,EACN,GAAG,EAAE,EAAE,EACP,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAC3D,QAAQ,EAAE,QAAQ,GAClB,CACH,CAAC"}

package/dist/flows/initial-verbs.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text } from 'ink';
+import { ListBuilder } from '../ui/list-builder.js';
+import { accent, muted } from '../ui/theme.js';
+const MIN_VERBS = 1;
+const MAX_VERBS = 6;
+const MAX_BULLETS_PER_VERB = 6;
+const SLUG_RE = /^[a-z][a-z0-9-]*$/;
+export const InitialVerbsFlow = ({ initial, onNext, onCancel }) => {
+    const [stage, setStage] = useState({
+        kind: 'name',
+        verbs: initial.length > 0 ? initial : [],
+    });
+    if (stage.kind === 'name') {
+        return (_jsx(NameVerbs, { initial: stage.verbs, onCancel: onCancel, onNext: (verbs) => {
+                setStage({ kind: 'author', verbs, cursor: 0 });
+            } }));
+    }
+    // Authoring stage — one verb at a time. Cursor is bounded by the verb
+    // list we just built, so an out-of-range cursor would be a bug rather
+    // than a user-reachable state.
+    const verb = stage.verbs[stage.cursor];
+    if (!verb) {
+        return (_jsx(Box, { children: _jsx(Text, { color: "red", children: "Internal: verb cursor out of range \u2014 please cancel and retry." }) }));
+    }
+    return (_jsx(AuthorBullets, { slug: verb.slug, position: stage.cursor + 1, total: stage.verbs.length, initial: verb.description, onCancel: () => setStage({ kind: 'name', verbs: stage.verbs }), onNext: (description) => {
+            const nextVerbs = stage.verbs.map((v, i) => i === stage.cursor ? { ...v, description } : v);
+            if (stage.cursor === stage.verbs.length - 1) {
+                onNext(nextVerbs);
+                return;
+            }
+            setStage({ kind: 'author', verbs: nextVerbs, cursor: stage.cursor + 1 });
+        } }));
+};
+const SLUG_FIELDS = [
+    {
+        key: 'slug',
+        label: 'slug',
+        placeholder: 'e.g. account-curator',
+        extract: (r) => r.slug,
+        apply: (r, value) => ({ ...r, slug: value }),
+    },
+];
+const NameVerbs = ({ initial, onNext, onCancel }) => {
+    // Seed slug rows from any prior pass; carry their authored descriptions
+    // forward via a side map so backing out of stage 2 doesn't lose work.
+    const initialRows = initial.map((v) => ({ slug: v.slug }));
+    const priorDescriptions = new Map(initial.map((v) => [v.slug, [...v.description]]));
+    return (_jsx(ListBuilder, { title: "Initial verbs \u2014 name the verbs", helper: `The first verbs the role will run. Slug is filename-shaped (lowercase letters, digits, hyphens; starts with a letter). ${MIN_VERBS}-${MAX_VERBS} verbs. You'll author the bullets for each one in the next step.`, initial: initialRows, fields: SLUG_FIELDS, empty: () => ({ slug: '' }), validate: (r) => {
+            const slug = r.slug.trim();
+            if (slug.length === 0)
+                return 'slug is required';
+            if (!SLUG_RE.test(slug)) {
+                return 'slug must be lowercase letters, digits, and hyphens (start with a letter)';
+            }
+            return null;
+        }, min: MIN_VERBS, max: MAX_VERBS, onNext: (rows) => {
+            const verbs = rows.map((r) => {
+                const slug = r.slug.trim();
+                return {
+                    slug,
+                    description: priorDescriptions.get(slug) ?? [],
+                };
+            });
+            onNext(verbs);
+        }, onCancel: onCancel }));
+};
+const BULLET_FIELDS = [
+    {
+        key: 'text',
+        label: 'bullet',
+        placeholder: 'one bullet describing what this verb does (or leave blank to skip)',
+        extract: (r) => r.text,
+        apply: (r, value) => ({ ...r, text: value }),
+    },
+];
+const AuthorBullets = ({ slug, position, total, initial, onNext, onCancel, }) => {
+    const initialRows = initial.map((text) => ({ text }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { children: _jsx(Text, { children: muted(`verb ${position} of ${total}`) }) }), _jsx(Box, { children: _jsxs(Text, { children: [accent('→ '), accent(slug)] }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: muted('Author the bullets that describe what this verb does.') }) }), _jsx(ListBuilder, { title: "", helper: "", initial: initialRows, fields: BULLET_FIELDS, empty: () => ({ text: '' }), validate: (r) => (r.text.trim().length === 0 ? 'bullet text is required' : null), min: 0, max: MAX_BULLETS_PER_VERB, onNext: (rows) => onNext(rows.map((r) => r.text.trim()).filter((t) => t.length > 0)), onCancel: onCancel }, slug), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Tip: enter on the last (or empty) row advances to the next verb. Esc returns to the slug list." }) })] }));
+};
+//# sourceMappingURL=initial-verbs.js.map