@praxis-framework/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { initCommand } from './commands/init.js';
+import { LogError, runLog } from './commands/log.js';
+program
+    .name('praxis')
+    .description('praxis-framework CLI')
+    .version('0.0.1');
+program
+    .command('init')
+    .description('set up a new praxis role')
+    .option('--path <path>', 'directory to scaffold the role into', process.cwd())
+    .option('--config <file>', 'seed non-interactively from a JSON file matching SeedInput (see cli/examples/sample-role.json)')
+    .option('--overwrite', 'overwrite existing files at the target (only with --config)', false)
+    .addHelpText('after', `
+Examples:
+  $ praxis init                                          # interactive wizard
+  $ praxis init --config ./role.json --path ./my-role    # non-interactive seed
+  $ praxis init --config ./role.json --overwrite         # re-seed an existing dir
+
+A sample config lives at cli/examples/sample-role.json — copy and edit it
+as a starting template for the non-interactive flow.
+`)
+    .action(initCommand);
+program
+    .command('log')
+    .description("append a JSONL entry to today's log")
+    .option('--campaign <id>', 'campaign id (logs land under campaigns/{id}/logs/)')
+    .option('--agent <name>', 'agent / verb name responsible for the action')
+    .option('--action <verb>', 'action verb, e.g. email_drafted, decision')
+    .option('--prospect <id>', 'prospect id (optional conventional extra)')
+    .option('--details <text>', 'short narrative (optional)')
+    .option('--subject <text>', 'email/message subject (optional)')
+    .option('--echo', 'print the JSON line that was written', false)
+    .argument('[extras...]', 'extra key=value pairs to merge into the entry')
+    .addHelpText('after', `
+Examples:
+  $ praxis log --campaign=q1-outreach --agent=draft-emails --action=email_drafted
+  $ praxis log --campaign=manual-leads --agent=monitor-channels --action=channel_intake \\
+      channel=notifications-searchai message_ts=1234.5
+`)
+    .action(async (extras, options) => {
+    try {
+        await runLog(options, extras);
+    }
+    catch (err) {
+        if (err instanceof LogError) {
+            process.stderr.write(`${err.message}\n`);
+            process.exit(1);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`praxis log: ${message}\n`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAA0B,MAAM,mBAAmB,CAAC;AAE7E,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,sBAAsB,CAAC;KACnC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,eAAe,EAAE,qCAAqC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAC7E,MAAM,CACL,iBAAiB,EACjB,gGAAgG,CACjG;KACA,MAAM,CAAC,aAAa,EAAE,6DAA6D,EAAE,KAAK,CAAC;KAC3F,WAAW,CACV,OAAO,EACP;;;;;;;;CAQH,CACE;KACA,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,iBAAiB,EAAE,oDAAoD,CAAC;KAC/E,MAAM,CAAC,gBAAgB,EAAE,8CAA8C,CAAC;KACxE,MAAM,CAAC,iBAAiB,EAAE,2CAA2C,CAAC;KACtE,MAAM,CAAC,iBAAiB,EAAE,2CAA2C,CAAC;KACtE,MAAM,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;KACxD,MAAM,CAAC,kBAAkB,EAAE,kCAAkC,CAAC;KAC9D,MAAM,CAAC,QAAQ,EAAE,sCAAsC,EAAE,KAAK,CAAC;KAC/D,QAAQ,CAAC,aAAa,EAAE,+CAA+C,CAAC;KACxE,WAAW,CACV,OAAO,EACP;;;;;CAKH,CACE;KACA,MAAM,CAAC,KAAK,EAAE,MAAgB,EAAE,OAA0B,EAAE,EAAE;IAC7D,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/catalog.js

@@ -0,0 +1,190 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveTemplatePath } from '@praxis-framework/seed';
+import { z } from 'zod';
+/**
+ * Framework-level catalog of tool capabilities that roles can opt into.
+ *
+ * Roles declare which capabilities they need per-agent; the runtime maps
+ * capabilities to concrete adapters at startup. The CLI's `praxis init`
+ * wizard surfaces the optional ones for operator selection.
+ */
+export const CapabilitySchema = z
+    .object({
+    description: z.string(),
+    transport_options: z.array(z.string()).min(1),
+    default_transport: z.string(),
+    always_available: z.boolean().optional().default(false),
+    default_auth_env: z.string().nullable().optional(),
+    docker_image: z.string().optional(),
+})
+    // Permissive on unknown fields — schema may grow without breaking older CLIs.
+    .passthrough();
+/**
+ * Resolve `<template-root>/lib/tools.yaml` by delegating to the seed package's
+ * template resolver. The seed package owns template-path resolution: it
+ * checks `<package-root>/template/` first (the published-mode layout, where
+ * the template ships inside the seed tarball), then walks up looking for a
+ * sibling `template/` directory (the dev-monorepo layout). Using its
+ * resolver here keeps both packages in lockstep on where the template lives.
+ */
+function catalogPath() {
+    return path.join(resolveTemplatePath(), 'lib', 'tools.yaml');
+}
+/**
+ * Load the framework catalog from `template/lib/tools.yaml`. Throws if the
+ * file is missing or unparseable — the CLI cannot function without it.
+ */
+export async function loadCatalog() {
+    const CATALOG_PATH = catalogPath();
+    let text;
+    try {
+        text = await fs.readFile(CATALOG_PATH, 'utf-8');
+    }
+    catch (e) {
+        const cause = e instanceof Error ? e.message : String(e);
+        throw new Error(`praxis catalog not found at ${CATALOG_PATH}: ${cause}`);
+    }
+    return parseCatalog(text);
+}
+/** Parse a catalog YAML payload. Exported for tests. */
+export function parseCatalog(text) {
+    const raw = parseToolsYaml(text);
+    const capabilities = [];
+    for (const [name, fields] of Object.entries(raw)) {
+        const result = CapabilitySchema.safeParse(fields);
+        if (!result.success) {
+            throw new Error(`praxis catalog: invalid entry "${name}" — ${result.error.issues
+                .map((i) => `${i.path.join('.') || '<root>'}: ${i.message}`)
+                .join('; ')}`);
+        }
+        const cap = {
+            name,
+            description: result.data.description,
+            transport_options: result.data.transport_options,
+            default_transport: result.data.default_transport,
+            always_available: result.data.always_available,
+        };
+        if (result.data.default_auth_env !== undefined) {
+            cap.default_auth_env = result.data.default_auth_env;
+        }
+        if (result.data.docker_image !== undefined) {
+            cap.docker_image = result.data.docker_image;
+        }
+        capabilities.push(cap);
+    }
+    if (capabilities.length === 0) {
+        throw new Error('praxis catalog: no capabilities defined in tools.yaml');
+    }
+    return {
+        capabilities,
+        builtins: () => capabilities.filter((c) => c.always_available),
+        optional: () => capabilities.filter((c) => !c.always_available),
+    };
+}
+export function parseToolsYaml(text) {
+    const lines = text.split('\n');
+    const out = {};
+    let i = 0;
+    let inCapabilities = false;
+    let currentCap = null;
+    let currentCapIndent = 0;
+    let fieldIndent = null;
+    while (i < lines.length) {
+        const raw = lines[i] ?? '';
+        const trimmed = raw.trim();
+        // Skip blanks and comments at any depth.
+        if (trimmed.length === 0 || trimmed.startsWith('#')) {
+            i += 1;
+            continue;
+        }
+        if (!inCapabilities) {
+            if (/^capabilities\s*:\s*$/.test(trimmed)) {
+                inCapabilities = true;
+            }
+            i += 1;
+            continue;
+        }
+        const leading = raw.length - raw.trimStart().length;
+        // A new top-level key (zero indent) ends the capabilities block.
+        if (leading === 0 && /:\s*$/.test(trimmed)) {
+            break;
+        }
+        // Capability header: `<name>:` at the first indent level under
+        // `capabilities:`. The header line has the form `<indent><name>:` (line
+        // ends with `:` and nothing after) and the indent is the same as (or
+        // first establishes) the capability indent. The name itself may contain
+        // colons — `mcp:slack:` is `mcp:slack` followed by the trailing `:`.
+        const isHeaderLine = trimmed.endsWith(':') && !trimmed.startsWith('-');
+        if (isHeaderLine && (currentCap === null || leading <= currentCapIndent)) {
+            const name = trimmed.slice(0, -1).trim();
+            if (name.length > 0) {
+                currentCap = name;
+                currentCapIndent = leading;
+                fieldIndent = null;
+                out[name] = {};
+                i += 1;
+                continue;
+            }
+        }
+        // Field under the current capability.
+        if (currentCap !== null && leading > currentCapIndent) {
+            if (fieldIndent === null)
+                fieldIndent = leading;
+            const fieldMatch = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*:\s*(.*)$/.exec(raw);
+            if (fieldMatch) {
+                const key = (fieldMatch[1] ?? '').trim();
+                const rest = (fieldMatch[2] ?? '').trim();
+                out[currentCap][key] = parseScalar(rest);
+            }
+            i += 1;
+            continue;
+        }
+        i += 1;
+    }
+    return out;
+}
+/**
+ * Parse a YAML scalar / inline-list value. Handles:
+ *   - empty                → null
+ *   - `null` / `~`         → null
+ *   - `true` / `false`     → boolean
+ *   - `[a, b, c]`          → string[]
+ *   - quoted "string"      → string (quotes stripped)
+ *   - bare string          → string
+ *   - integer literal      → number
+ */
+function parseScalar(raw) {
+    const value = raw.trim();
+    if (value.length === 0)
+        return null;
+    if (value === 'null' || value === '~')
+        return null;
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value.startsWith('[') && value.endsWith(']')) {
+        const inner = value.slice(1, -1).trim();
+        if (inner.length === 0)
+            return [];
+        return inner.split(',').map((part) => stripQuotes(part.trim()));
+    }
+    if (/^-?\d+$/.test(value)) {
+        const n = Number.parseInt(value, 10);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return stripQuotes(value);
+}
+function stripQuotes(value) {
+    if (value.length < 2)
+        return value;
+    const first = value[0];
+    const last = value[value.length - 1];
+    if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/lib/catalog.js.map

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

package/dist/lib/seed-adapter.js

@@ -0,0 +1,28 @@
+import { SeedInputSchema } from '@praxis-framework/seed';
+export function adaptFormToSeedInput(form) {
+    // Parse via the package schema directly. The CLI's Form already mirrors
+    // the SeedInput shape one-to-one (modulo the `path` and partial wrapping)
+    // so we can hand the relevant slice over and let zod do the strict
+    // validation in one place.
+    const candidate = {
+        organisation: form.organisation,
+        role_definition: form.role_definition,
+        voice_traits: form.voice_traits,
+        capabilities: form.capabilities,
+        inhibitions: form.inhibitions,
+        initial_verbs: form.initial_verbs,
+        tools: form.tools,
+    };
+    const parsed = SeedInputSchema.safeParse(candidate);
+    if (!parsed.success) {
+        return {
+            ok: false,
+            issues: parsed.error.issues.map((i) => ({
+                path: i.path.join('.') || '<root>',
+                message: i.message,
+            })),
+        };
+    }
+    return { ok: true, input: parsed.data };
+}
+//# sourceMappingURL=seed-adapter.js.map

package/dist/lib/seed-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-adapter.js","sourceRoot":"","sources":["../../src/lib/seed-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,wBAAwB,CAAC;AAmBzE,MAAM,UAAU,oBAAoB,CAAC,IAAU;IAC7C,wEAAwE;IACxE,0EAA0E;IAC1E,mEAAmE;IACnE,2BAA2B;IAC3B,MAAM,SAAS,GAAG;QAChB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;IAEF,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ;gBAClC,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/lib/traits.js

@@ -0,0 +1,13 @@
+/**
+ * Re-export the canonical trait library from `@praxis-framework/seed`. Both the CLI's
+ * voice flow (multi-select cloud) and the seeder (persona rendering) need
+ * the same authored list, and the seed package owns the source of truth so
+ * no copy can drift.
+ *
+ * A planned follow-up replaces the inline list in the seed package with a
+ * loader that reads `template/lib/traits.yaml`, mirroring the way
+ * `template/lib/tools.yaml` is loaded today. When that lands, this re-export
+ * stays in place and the CLI's import path doesn't change.
+ */
+export { TRAIT_LIBRARY, findTrait } from '@praxis-framework/seed';
+//# sourceMappingURL=traits.js.map

package/dist/lib/traits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.js","sourceRoot":"","sources":["../../src/lib/traits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/state/form.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+export const Organisation = z.object({
+    name: z.string().min(1),
+    website: z.string().optional(),
+    sector: z.string().optional(),
+    size: z.enum(['solo', 'small', 'mid', 'large', 'enterprise']).optional(),
+    description: z.string().optional(),
+    moats: z.string().optional(),
+    customer_profile: z.string().optional(),
+});
+export const RoleDefinition = z.object({
+    role_name: z.string().min(1),
+    working_title: z.string().optional(),
+    one_sentence_purpose: z.string().min(1),
+    day_to_day: z.string().optional(),
+});
+export const VoiceTrait = z.object({
+    /** Canonical name from the trait library (`cli/src/lib/traits.ts`). */
+    trait: z.string().min(1),
+    /** Free-text descriptors qualifying *how* the trait should manifest. */
+    qualifiers: z.array(z.string()).default([]),
+});
+export const InitialVerb = z.object({
+    /** Filename-shaped slug (lowercase letters, digits, hyphens; starts with a letter). */
+    slug: z.string().min(1),
+    /**
+     * Bullet-shaped body content for the verb file. 0-N free-text strings;
+     * each renders as a `- bullet` line in `verbs/<slug>.md`. An empty array
+     * is valid — the seeded file falls back to a bare heading + TODO marker.
+     */
+    description: z.array(z.string()).default([]),
+});
+export const Form = z.object({
+    organisation: Organisation.partial(),
+    role_definition: RoleDefinition.partial(),
+    path: z.enum(['research', 'manual', 'unset']).default('unset'),
+    // Optional MCP capability names selected during the tool-selection step.
+    // Built-in capabilities (always_available in the catalog) are not stored
+    // here — they're implicit. v2 will extend each entry with per-MCP transport
+    // and auth overrides; v1 stores names only.
+    tools: z.array(z.string()).default([]),
+    // Voice & personality — canonical trait name (from the curated library at
+    // `cli/src/lib/traits.ts`) plus 0-N free-text qualifiers describing how the
+    // trait should manifest.
+    voice_traits: z.array(VoiceTrait).default([]),
+    // Action-shaped responsibilities for this role.
+    capabilities: z.array(z.string()).default([]),
+    // Hard "never do" rules, intentionally absolute.
+    inhibitions: z.array(z.string()).default([]),
+    // First verbs the role will run; slug is filename-shaped.
+    initial_verbs: z.array(InitialVerb).default([]),
+});
+export const emptyForm = () => ({
+    organisation: {},
+    role_definition: {},
+    path: 'unset',
+    tools: [],
+    voice_traits: [],
+    capabilities: [],
+    inhibitions: [],
+    initial_verbs: [],
+});
+//# sourceMappingURL=form.js.map

package/dist/state/form.js.map

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

package/dist/state/steps.js

@@ -0,0 +1,28 @@
+export const STEPS = [
+    'welcome',
+    'organisation',
+    'role-definition',
+    'path-choice',
+    'tool-selection',
+    'voice',
+    'capabilities',
+    'inhibitions',
+    'initial-verbs',
+    'review',
+    'wrote',
+];
+export const firstStep = () => STEPS[0];
+export const nextStep = (current) => {
+    const idx = STEPS.indexOf(current);
+    if (idx === -1 || idx === STEPS.length - 1)
+        return null;
+    return STEPS[idx + 1] ?? null;
+};
+export const previousStep = (current) => {
+    const idx = STEPS.indexOf(current);
+    if (idx <= 0)
+        return null;
+    return STEPS[idx - 1] ?? null;
+};
+export const isLastStep = (current) => current === STEPS[STEPS.length - 1];
+//# sourceMappingURL=steps.js.map

package/dist/state/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/state/steps.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,SAAS;IACT,cAAc;IACd,iBAAiB;IACjB,aAAa;IACb,gBAAgB;IAChB,OAAO;IACP,cAAc;IACd,aAAa;IACb,eAAe;IACf,QAAQ;IACR,OAAO;CACC,CAAC;AAIX,MAAM,CAAC,MAAM,SAAS,GAAG,GAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE9C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAa,EAAe,EAAE;IACrD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAa,EAAe,EAAE;IACzD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAa,EAAW,EAAE,CACnD,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC"}

package/dist/ui/header.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import BigText from 'ink-big-text';
+import Gradient from 'ink-gradient';
+/** Full hero header — used once at welcome to establish presence. */
+export const Header = () => (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Gradient, { name: "atlas", children: _jsx(BigText, { text: "praxis", font: "tiny" }) }), _jsx(Text, { dimColor: true, children: " role-based agents that fit your business" })] }));
+/**
+ * Compact persistent header — used on every step after welcome.
+ * Single-line brand mark with the same atlas gradient + an optional
+ * muted wayfinding string. Keeps the wizard branded without dominating
+ * the form below.
+ */
+export const CompactHeader = ({ context }) => (_jsxs(Box, { marginBottom: 1, children: [_jsx(Gradient, { name: "atlas", children: _jsx(Text, { children: "praxis" }) }), context && (_jsxs(Text, { dimColor: true, children: [' · ', context] }))] }));
+//# sourceMappingURL=header.js.map

package/dist/ui/header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../src/ui/header.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,QAAQ,MAAM,cAAc,CAAC;AAEpC,qEAAqE;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,CAC1B,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,YAAY,EAAE,CAAC,aACzC,KAAC,QAAQ,IAAC,IAAI,EAAC,OAAO,YACpB,KAAC,OAAO,IAAC,IAAI,EAAC,QAAQ,EAAC,IAAI,EAAC,MAAM,GAAG,GAC5B,EACX,KAAC,IAAI,IAAC,QAAQ,gEAAiD,IAC3D,CACP,CAAC;AAOF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,OAAO,EAAsB,EAAE,EAAE,CAAC,CAChE,MAAC,GAAG,IAAC,YAAY,EAAE,CAAC,aAClB,KAAC,QAAQ,IAAC,IAAI,EAAC,OAAO,YACpB,KAAC,IAAI,yBAAc,GACV,EACV,OAAO,IAAI,CACV,MAAC,IAAI,IAAC,QAAQ,mBACX,KAAK,EACL,OAAO,IACH,CACR,IACG,CACP,CAAC"}

package/dist/ui/list-builder-state.js

@@ -0,0 +1,179 @@
+/**
+ * Pure state machine for {@link ListBuilder}. Extracted so the navigation /
+ * commit / focus rules can be unit-tested without rendering Ink, and so the
+ * component itself stays a thin presentational shell over `applyAction()`.
+ *
+ * The component owns three pieces of state that move together — `items`,
+ * `(rowIdx, fieldIdx)`, and the in-flight `draft` buffer — and a bug fixed
+ * here lived in the gap between them. The original useInput handler bound
+ * plain alphabetic keys (`j`, `k`, `d`) as navigation/delete shortcuts; those
+ * shortcuts also fired while a `TextInput` was focused, so a user typing
+ * `direct` would have the leading `d` racing with a row-clear. Centralising
+ * the rules into one transition function makes it obvious which keys mutate
+ * structure (tab/arrow/return/escape/empty-backspace) and which are purely
+ * for the text input to consume.
+ */
+/**
+ * Build the initial state for a fresh ListBuilder mount. Always seeds at
+ * least one editable row so the operator has somewhere to start; the empty
+ * trailing row is dropped at finalise time.
+ */
+export function initialState(initial, config) {
+    const items = initial.length > 0 ? [...initial] : [config.empty()];
+    const draft = readDraft(items, 0, 0, config);
+    return { items, rowIdx: 0, fieldIdx: 0, draft };
+}
+/**
+ * Apply a user-driven action to the state. Returns either the next state
+ * (`kind: 'state'`) or a finalise signal (`kind: 'finalise'`) carrying the
+ * trimmed items the caller should hand to `onNext`.
+ *
+ * The pure-function shape means tests can drive the same transitions the
+ * component does without setting up Ink, React, or input plumbing.
+ */
+export function applyAction(state, action, config) {
+    switch (action.type) {
+        case 'setDraft':
+            return { kind: 'state', state: { ...state, draft: action.value } };
+        case 'tab': {
+            if (config.fields.length === 0) {
+                return { kind: 'state', state };
+            }
+            const committed = commit(state, config);
+            const nextField = (state.fieldIdx + 1) % config.fields.length;
+            return {
+                kind: 'state',
+                state: refocus(committed, state.rowIdx, nextField, config),
+            };
+        }
+        case 'down': {
+            const committed = commit(state, config);
+            if (committed.rowIdx < committed.items.length - 1) {
+                return {
+                    kind: 'state',
+                    state: refocus(committed, committed.rowIdx + 1, 0, config),
+                };
+            }
+            if (committed.items.length < config.max) {
+                const grown = {
+                    ...committed,
+                    items: [...committed.items, config.empty()],
+                };
+                return {
+                    kind: 'state',
+                    state: refocus(grown, grown.items.length - 1, 0, config),
+                };
+            }
+            return { kind: 'state', state: committed };
+        }
+        case 'up': {
+            if (state.rowIdx === 0) {
+                return { kind: 'state', state };
+            }
+            const committed = commit(state, config);
+            return {
+                kind: 'state',
+                state: refocus(committed, committed.rowIdx - 1, 0, config),
+            };
+        }
+        case 'deleteRow': {
+            // If only one row remains, "delete" clears it back to empty rather
+            // than leaving the operator with zero rows to type into.
+            if (state.items.length <= 1) {
+                const cleared = [config.empty()];
+                return {
+                    kind: 'state',
+                    state: refocus({ ...state, items: cleared }, 0, 0, config),
+                };
+            }
+            const next = state.items.filter((_, i) => i !== state.rowIdx);
+            const nextRow = Math.min(state.rowIdx, next.length - 1);
+            return {
+                kind: 'state',
+                state: refocus({ ...state, items: next }, nextRow, 0, config),
+            };
+        }
+        case 'submit': {
+            // Enter is "submit and add another" — commit the in-flight draft, then
+            // either advance to the next row (existing or freshly appended) or
+            // finalise. Finalise only fires when the operator hits enter on a row
+            // that is genuinely empty, mirroring "you've stopped adding things".
+            const committed = commit(state, config);
+            const focusedRow = committed.items[committed.rowIdx];
+            const focusedRowEmpty = focusedRow !== undefined &&
+                config.fields.every((f) => f.extract(focusedRow).trim().length === 0);
+            const isLast = committed.rowIdx === committed.items.length - 1;
+            // Empty trailing row — operator is signalling "I'm done". Drop the
+            // empty row and let the parent run its min/validate gates.
+            if (isLast && focusedRowEmpty) {
+                return {
+                    kind: 'finalise',
+                    items: trimEmptyRows(committed.items, config),
+                };
+            }
+            // Row has content — gate advancement on the row-level validator so the
+            // operator can't accumulate broken rows and only discover it on
+            // finalise. Without an advance, focus stays put and the row's inline
+            // error (rendered by the component using the same validator) surfaces.
+            if (focusedRow !== undefined && config.validate) {
+                const err = config.validate(focusedRow);
+                if (err !== null) {
+                    return { kind: 'state', state: committed };
+                }
+            }
+            if (!isLast) {
+                // Same as ↓: commit current, move to existing next row.
+                return {
+                    kind: 'state',
+                    state: refocus(committed, committed.rowIdx + 1, 0, config),
+                };
+            }
+            // Last row, valid, has content. Try to grow; if at max, finalise so
+            // the operator isn't stuck pressing keys with no visible effect.
+            if (committed.items.length < config.max) {
+                const grown = {
+                    ...committed,
+                    items: [...committed.items, config.empty()],
+                };
+                return {
+                    kind: 'state',
+                    state: refocus(grown, grown.items.length - 1, 0, config),
+                };
+            }
+            return { kind: 'finalise', items: trimEmptyRows(committed.items, config) };
+        }
+        default:
+            return { kind: 'state', state };
+    }
+}
+/**
+ * Strip rows where every field is blank — these are the "press enter to
+ * add another" affordance, not real entries.
+ */
+export function trimEmptyRows(items, config) {
+    return items.filter((item) => config.fields.some((f) => f.extract(item).trim().length > 0));
+}
+function readDraft(items, rowIdx, fieldIdx, config) {
+    const item = items[rowIdx];
+    const field = config.fields[fieldIdx];
+    return item && field ? field.extract(item) : '';
+}
+function commit(state, config) {
+    const item = state.items[state.rowIdx];
+    const field = config.fields[state.fieldIdx];
+    if (!item || !field)
+        return state;
+    const nextItem = field.apply(item, state.draft.trim());
+    const nextItems = [...state.items];
+    nextItems[state.rowIdx] = nextItem;
+    return { ...state, items: nextItems };
+}
+function refocus(state, rowIdx, fieldIdx, config) {
+    return {
+        ...state,
+        rowIdx,
+        fieldIdx,
+        draft: readDraft(state.items, rowIdx, fieldIdx, config),
+    };
+}
+//# sourceMappingURL=list-builder-state.js.map

package/dist/ui/list-builder-state.js.map

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