@praxis-framework/cli 0.1.0

package/dist/ui/list-builder.js

@@ -0,0 +1,144 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text, useInput } from 'ink';
+import TextInput from 'ink-text-input';
+import { accent, muted, ok, warn } from './theme.js';
+import { applyAction, initialState, trimEmptyRows, } from './list-builder-state.js';
+/**
+ * Generic add/edit/delete list builder. Keeps the row data structure
+ * opaque to the component — callers describe the editable fields via
+ * `fields` and how to mint a new item via `empty`.
+ *
+ * Interactions:
+ *   ↑/↓         navigate rows (↓ on the last row appends an empty trailing row)
+ *   tab         cycle editable field within the focused row
+ *   enter       "next entry" — commit the current row and either advance to the
+ *               next existing row, append a new empty row at the bottom, or
+ *               finalise (the latter when the focused row is itself empty, or
+ *               when the row count is already at `max`).
+ *   backspace   on an empty row → delete it
+ *   esc         cancel the entire step
+ *
+ * Why enter doesn't always finalise: shift+enter is the operator's natural
+ * "submit and add another" shortcut, but Ink's `useInput` broadcasts shift+enter
+ * as a literal `\n` to the focused TextInput, polluting the data with embedded
+ * newlines. So the framework remaps the bare-enter semantics to match the
+ * intuition — finalise then becomes "press enter on an empty trailing row",
+ * which is what falls out naturally after the operator's last item.
+ *
+ * Plain alphabetic keys (including `j`/`k`/`d`) are intentionally NOT bound
+ * to navigation — they collide with text input. The reported "typed second
+ * field's text into first field" bug came from `d` racing with the row-clear
+ * shortcut while a `TextInput` was focused. The state machine that drives
+ * this component lives in `./list-builder-state.ts` for unit-testing.
+ */
+export const ListBuilder = ({ title, helper, initial, fields, empty, validate, min, max, onNext, onCancel, }) => {
+    // Strip the FieldSpec down to what the state machine needs — the rest of
+    // the spec (label, placeholder) is presentational only. `validate` is
+    // forwarded so the state machine can refuse to advance past an invalid
+    // row, matching the protective gate the finalise path already enforces.
+    const config = {
+        fields: fields.map((f) => ({ extract: f.extract, apply: f.apply })),
+        empty,
+        max,
+        validate,
+    };
+    const [state, setState] = useState(() => initialState(initial, config));
+    const [topLevelError, setTopLevelError] = useState(null);
+    const finalise = (items) => {
+        const trimmed = trimEmptyRows(items, config);
+        if (trimmed.length < min) {
+            setTopLevelError(min === 1
+                ? 'At least one entry is required.'
+                : `At least ${min} entries are required.`);
+            return;
+        }
+        for (const item of trimmed) {
+            const err = validate(item);
+            if (err !== null) {
+                setTopLevelError(`Fix the highlighted row before continuing: ${err}`);
+                return;
+            }
+        }
+        onNext(trimmed);
+    };
+    useInput((input, key) => {
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.tab) {
+            setTopLevelError(null);
+            const result = applyAction(state, { type: 'tab' }, config);
+            if (result.kind === 'state')
+                setState(result.state);
+            return;
+        }
+        if (key.downArrow) {
+            setTopLevelError(null);
+            const result = applyAction(state, { type: 'down' }, config);
+            if (result.kind === 'state')
+                setState(result.state);
+            return;
+        }
+        if (key.upArrow) {
+            setTopLevelError(null);
+            const result = applyAction(state, { type: 'up' }, config);
+            if (result.kind === 'state')
+                setState(result.state);
+            return;
+        }
+        // Backspace on an empty draft (and only when more than one row exists)
+        // deletes the focused row. The `TextInput` itself ignores backspace once
+        // its cursor is at offset 0, so this doesn't fight the editor.
+        if (key.backspace &&
+            state.draft.length === 0 &&
+            state.items.length > 1) {
+            const result = applyAction(state, { type: 'deleteRow' }, config);
+            if (result.kind === 'state')
+                setState(result.state);
+            return;
+        }
+        // Plain printable characters fall through to the focused TextInput's own
+        // `useInput` handler — we deliberately don't intercept them here so words
+        // containing 'j', 'k', or 'd' type cleanly. (See header comment.)
+        void input;
+    });
+    // ink-text-input swallows enter for us, so the submit handler is the
+    // single place we decide whether enter advances to the next row, adds
+    // a new trailing row, or finalises the step.
+    const handleSubmit = () => {
+        setTopLevelError(null);
+        const result = applyAction(state, { type: 'submit' }, config);
+        if (result.kind === 'finalise') {
+            finalise(result.items);
+            return;
+        }
+        setState(result.state);
+    };
+    const setDraft = (value) => {
+        setTopLevelError(null);
+        const result = applyAction(state, { type: 'setDraft', value }, config);
+        if (result.kind === 'state')
+            setState(result.state);
+    };
+    const focusedField = fields[state.fieldIdx];
+    const focusedFieldKey = focusedField?.key ?? '';
+    return (_jsxs(Box, { flexDirection: "column", children: [title.length > 0 ? (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: accent(title) }) })) : null, helper.length > 0 ? (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: muted(helper) }) })) : null, _jsxs(Box, { flexDirection: "column", children: [state.items.map((item, i) => {
+                        const isFocused = i === state.rowIdx;
+                        const rowErr = validate(item);
+                        const isRowEmpty = fields.every((f) => f.extract(item).trim().length === 0);
+                        return (_jsx(Row, { item: item, fields: fields, focused: isFocused, focusedFieldKey: isFocused ? focusedFieldKey : '', draft: isFocused ? state.draft : null, setDraft: setDraft, onSubmit: handleSubmit, error: isRowEmpty ? null : rowErr }, i));
+                    }), state.items.length < max ? (_jsx(Box, { marginTop: 0, children: _jsxs(Text, { children: [muted('  ↳ '), muted(state.items.length === 0
+                                    ? 'press enter to add the first entry'
+                                    : 'enter to add another (or finish on an empty row)')] }) })) : (_jsx(Box, { marginTop: 0, children: _jsx(Text, { children: muted(`  · max ${max} reached — enter to finish`) }) }))] }), topLevelError ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "red", children: topLevelError }) })) : null, _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "\u2191/\u2193 navigate \u00B7 tab next field \u00B7 enter add/finish (empty row to finish) \u00B7 backspace clear/delete \u00B7 esc cancel" }), _jsx(Text, { dimColor: true, children: `${state.items.length} entr${state.items.length === 1 ? 'y' : 'ies'} · min ${min} · max ${max}` })] })] }));
+};
+const Row = ({ item, fields, focused, focusedFieldKey, draft, setDraft, onSubmit, error, }) => {
+    const cursor = focused ? accent('›') : ' ';
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsxs(Text, { children: [cursor, " "] }), fields.map((field, i) => {
+                        const isEditing = focused && field.key === focusedFieldKey;
+                        const stored = field.extract(item);
+                        return (_jsxs(Box, { children: [i > 0 ? _jsx(Text, { children: muted(' · ') }) : null, _jsx(Text, { children: muted(field.label + ': ') }), isEditing && draft !== null ? (_jsx(TextInput, { value: draft, onChange: setDraft, onSubmit: onSubmit, placeholder: field.placeholder ?? '' })) : stored.length > 0 ? (_jsx(Text, { children: focused ? stored : ok(stored) })) : (_jsx(Text, { children: muted(field.placeholder ?? '(empty)') }))] }, field.key));
+                    })] }), error ? (_jsx(Box, { marginLeft: 2, children: _jsx(Text, { children: warn('  ' + error) }) })) : null] }));
+};
+//# sourceMappingURL=list-builder.js.map

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

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

package/dist/ui/theme.js

@@ -0,0 +1,8 @@
+import pc from 'picocolors';
+export const ink = pc.cyan;
+export const ok = pc.green;
+export const warn = pc.yellow;
+export const danger = pc.red;
+export const muted = pc.dim;
+export const accent = pc.magenta;
+//# sourceMappingURL=theme.js.map

package/dist/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;AAC3B,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC;AAC9B,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC;AAC7B,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC;AAC5B,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC"}

package/examples/sample-role.json

@@ -0,0 +1,24 @@
+{
+  "organisation": {
+    "name": "Acme BD",
+    "size": "small"
+  },
+  "role_definition": {
+    "role_name": "sales-lead",
+    "working_title": "Sales lead",
+    "one_sentence_purpose": "drives outbound on Acme's flagship product",
+    "day_to_day": "drafts cold outreach, reviews replies, escalates complex deals"
+  },
+  "tools": ["websearch", "mcp:google-workspace"],
+  "voice_traits": [
+    { "trait": "direct", "qualifiers": ["short sentences, no hedging"] }
+  ],
+  "capabilities": ["drafts cold-outreach emails"],
+  "inhibitions": ["never quote prices without sign-off"],
+  "initial_verbs": [
+    {
+      "slug": "draft-cold-emails",
+      "description": ["compose an outreach email per prospect"]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@praxis-framework/cli",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "praxis CLI — set up and manage praxis-framework roles",
+  "bin": {
+    "praxis": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/steveworley/praxis-framework.git",
+    "directory": "cli"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/steveworley/praxis-framework#readme",
+  "bugs": {
+    "url": "https://github.com/steveworley/praxis-framework/issues"
+  },
+  "author": "Steve Worley",
+  "keywords": [
+    "praxis",
+    "agent",
+    "cli",
+    "scaffold",
+    "role"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.tsx",
+    "build": "tsc",
+    "test": "vitest run",
+    "check": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@praxis-framework/seed": "^0.1.0",
+    "commander": "^12.0.0",
+    "ink": "^5.0.0",
+    "react": "^18.3.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "ink-select-input": "^6.0.0",
+    "ink-big-text": "^2.0.0",
+    "ink-gradient": "^3.0.0",
+    "ink-task-list": "^2.0.0",
+    "boxen": "^7.1.1",
+    "picocolors": "^1.0.0",
+    "simple-git": "^3.27.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/react": "^18.3.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}