@praxis-framework/seed 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @praxis-framework/seed
+
+Role-scaffolding library that powers [`@praxis-framework/cli`](https://www.npmjs.com/package/@praxis-framework/cli)'s `init` command.
+
+Given a validated role definition, `seedRole()` writes a populated [praxis-framework](https://github.com/steveworley/praxis-framework) role into a target directory: `persona.md`, `CLAUDE.md`, `verbs/`, `lib/`, `memory/`, `escalations/`, and `output/`.
+
+## Who should use this
+
+Most operators should reach for [`@praxis-framework/cli`](https://www.npmjs.com/package/@praxis-framework/cli) instead — it wraps this library in an interactive wizard and handles input collection, validation feedback, and git integration. The CLI is the supported entry point.
+
+This package is published separately so the framework's dashboard can also call `seedRole()` directly from its in-browser setup flow. If you're building tooling on top of praxis and need programmatic scaffolding, import from here. Otherwise use the CLI.
+
+## Install
+
+```bash
+npm install @praxis-framework/seed
+```
+
+## Usage
+
+```ts
+import { seedRole, type SeedInput } from '@praxis-framework/seed';
+
+const input: SeedInput = {
+  organisation: { name: 'Acme', size: 'small' },
+  role_definition: {
+    role_name: 'sales-lead',
+    one_sentence_purpose: 'drives outbound on Acme\'s flagship product',
+  },
+  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'] }],
+  tools: [],
+};
+
+const result = await seedRole(input, '/path/to/new-role');
+console.log(result.filesWritten);
+```
+
+`SeedInput` is validated with Zod; invalid input throws `SeedError` with `code: 'INVALID_INPUT'`. Refer to the source in [`src/types.ts`](./src/types.ts) for the full schema.
+
+If the target directory isn't already a git repository, `seedRole()` runs `git init --initial-branch=main` before writing any files. Existing repos are left untouched — the seed never re-inits or renames the operator's chosen default branch. Commits are the caller's responsibility.
+
+## License
+
+MIT — see [LICENSE](https://github.com/steveworley/praxis-framework/blob/main/LICENSE).

package/dist/catalog.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Tools-catalog parsing and writing for the seed package.
+ *
+ * The framework template ships a single `template/lib/tools.yaml` listing
+ * every capability a role can opt into. When seeding a role we don't want to
+ * copy the catalog wholesale — the seeded `lib/tools.yaml` should contain
+ * only the tools enabled for *this* role: every always-available built-in
+ * (bash, edit, log) plus any optional capability the operator selected via
+ * the wizard.
+ *
+ * Parser shape mirrors `cli/src/lib/catalog.ts` so the two packages stay in
+ * sync. The seed package can't depend on the CLI (the dashboard imports the
+ * seed package and we don't want to drag CLI code in), so the parser is
+ * duplicated here. If a third caller appears, lift this into a shared module.
+ */
+export type CatalogFieldValue = string | number | boolean | null | string[];
+export type CatalogEntry = Record<string, CatalogFieldValue>;
+export type RawCatalog = Record<string, CatalogEntry>;
+/**
+ * Parse a `tools.yaml` payload into `{ capabilityName: { fieldKey: value } }`.
+ *
+ * Supported shape — the same as the framework catalog ships today:
+ *
+ *   capabilities:
+ *     bash:
+ *       description: "..."
+ *       transport_options: [native]
+ *       default_transport: native
+ *       always_available: true
+ *     mcp:slack:
+ *       description: "..."
+ *       transport_options: [stdio, sse, url]
+ *       default_transport: stdio
+ *       default_auth_env: SLACK_MCP_TOKEN
+ *       docker_image: praxis/mcp-slack:latest
+ *
+ * Comments and blank lines are skipped at any depth. Unknown YAML constructs
+ * are skipped rather than failing — strict validation is the catalog
+ * loader's job (the seed package only needs to filter and re-emit).
+ */
+export declare function parseToolsYaml(text: string): RawCatalog;
+/**
+ * Read the framework catalog and return the entries enabled for a seeded
+ * role: every built-in (`always_available: true`) plus any optional
+ * capability whose name appears in `selectedTools`. Selected names with no
+ * matching catalog entry are silently dropped — the wizard validates against
+ * the catalog upstream, so unknown names here are an invariant violation
+ * we'd rather not propagate into the seeded file.
+ *
+ * Throws `SeedError('TEMPLATE_MISSING')` when the template's tools.yaml
+ * isn't readable.
+ */
+export declare function buildSeededCatalog(templateRoot: string, selectedTools: readonly string[]): Promise<RawCatalog>;
+/**
+ * Render a filtered catalog back to YAML matching the framework template's
+ * shape. Header comment is short — operators read the framework's catalog
+ * for the schema; the seeded file is just the activated subset.
+ */
+export declare function renderToolsYaml(catalog: RawCatalog): string;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CA+DvD;AAgDD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAmC3D"}

package/dist/catalog.js

@@ -0,0 +1,239 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { SeedError } from './types.js';
+/**
+ * Parse a `tools.yaml` payload into `{ capabilityName: { fieldKey: value } }`.
+ *
+ * Supported shape — the same as the framework catalog ships today:
+ *
+ *   capabilities:
+ *     bash:
+ *       description: "..."
+ *       transport_options: [native]
+ *       default_transport: native
+ *       always_available: true
+ *     mcp:slack:
+ *       description: "..."
+ *       transport_options: [stdio, sse, url]
+ *       default_transport: stdio
+ *       default_auth_env: SLACK_MCP_TOKEN
+ *       docker_image: praxis/mcp-slack:latest
+ *
+ * Comments and blank lines are skipped at any depth. Unknown YAML constructs
+ * are skipped rather than failing — strict validation is the catalog
+ * loader's job (the seed package only needs to filter and re-emit).
+ */
+export function parseToolsYaml(text) {
+    const lines = text.split('\n');
+    const out = {};
+    let i = 0;
+    let inCapabilities = false;
+    let currentCap = null;
+    let currentCapIndent = 0;
+    while (i < lines.length) {
+        const raw = lines[i] ?? '';
+        const trimmed = raw.trim();
+        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:`. Names may contain colons (e.g. `mcp:slack`), so we
+        // strip only the trailing `:` separator.
+        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;
+                out[name] = {};
+                i += 1;
+                continue;
+            }
+        }
+        if (currentCap !== null && leading > currentCapIndent) {
+            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;
+}
+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;
+}
+/**
+ * Field-emit order for each capability. Matches the order the framework
+ * catalog uses today so the seeded file is visually familiar to operators.
+ * Fields not in this list (if any future schema additions slip through) are
+ * appended in insertion order at the end.
+ */
+const FIELD_ORDER = [
+    'description',
+    'transport_options',
+    'default_transport',
+    'always_available',
+    'default_auth_env',
+    'docker_image',
+];
+/**
+ * Read the framework catalog and return the entries enabled for a seeded
+ * role: every built-in (`always_available: true`) plus any optional
+ * capability whose name appears in `selectedTools`. Selected names with no
+ * matching catalog entry are silently dropped — the wizard validates against
+ * the catalog upstream, so unknown names here are an invariant violation
+ * we'd rather not propagate into the seeded file.
+ *
+ * Throws `SeedError('TEMPLATE_MISSING')` when the template's tools.yaml
+ * isn't readable.
+ */
+export async function buildSeededCatalog(templateRoot, selectedTools) {
+    const catalogPath = path.join(templateRoot, 'lib', 'tools.yaml');
+    let text;
+    try {
+        text = await fs.readFile(catalogPath, 'utf-8');
+    }
+    catch (e) {
+        const cause = e instanceof Error ? e.message : String(e);
+        throw new SeedError(`Failed to read template catalog ${catalogPath}: ${cause}`, 'TEMPLATE_MISSING');
+    }
+    const full = parseToolsYaml(text);
+    const selected = new Set(selectedTools);
+    const out = {};
+    for (const [name, entry] of Object.entries(full)) {
+        const isBuiltin = entry['always_available'] === true;
+        if (isBuiltin || selected.has(name)) {
+            out[name] = entry;
+        }
+    }
+    return out;
+}
+/**
+ * Render a filtered catalog back to YAML matching the framework template's
+ * shape. Header comment is short — operators read the framework's catalog
+ * for the schema; the seeded file is just the activated subset.
+ */
+export function renderToolsYaml(catalog) {
+    const lines = [];
+    lines.push('# Tools enabled for this role.');
+    lines.push('#');
+    lines.push("# Mirrors the framework catalog at <framework>/template/lib/tools.yaml,");
+    lines.push('# filtered to the always-available built-ins plus any optional capabilities');
+    lines.push("# the operator selected during `praxis init`. To enable another tool, add");
+    lines.push('# its entry from the framework catalog here.');
+    lines.push('');
+    lines.push('capabilities:');
+    const names = Object.keys(catalog);
+    for (const name of names) {
+        const entry = catalog[name] ?? {};
+        lines.push(`  ${name}:`);
+        const seen = new Set();
+        for (const key of FIELD_ORDER) {
+            if (key in entry) {
+                seen.add(key);
+                lines.push(`    ${key}: ${formatYamlValue(entry[key])}`);
+            }
+        }
+        // Trail with any fields not in the canonical order.
+        for (const [key, value] of Object.entries(entry)) {
+            if (seen.has(key))
+                continue;
+            lines.push(`    ${key}: ${formatYamlValue(value)}`);
+        }
+        lines.push('');
+    }
+    // Trim the trailing blank line so file ends with one newline.
+    while (lines.length > 0 && lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    return `${lines.join('\n')}\n`;
+}
+function formatYamlValue(value) {
+    if (value === null)
+        return 'null';
+    if (value === true)
+        return 'true';
+    if (value === false)
+        return 'false';
+    if (typeof value === 'number')
+        return String(value);
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        return `[${value.map((v) => formatYamlScalar(v)).join(', ')}]`;
+    }
+    return formatYamlScalar(value);
+}
+/**
+ * Quote a string scalar when bare emission would change its meaning to a
+ * parser: reserved literals (`true` / `false` / `null` / `~`), integer-shaped
+ * values, leading/trailing whitespace, or characters that introduce YAML
+ * structure (`#`, `{`, `[`, `,`, `&`, `*`, `!`, `|`, `>`, `'`, `"`, `%`, `@`,
+ * backtick) at the start of the value. Mid-value `:` and `/` are safe in
+ * block scalars and would force every docker-image string to be quoted, so
+ * we leave those bare to match the framework catalog's existing style.
+ */
+function formatYamlScalar(value) {
+    if (value.length === 0)
+        return '""';
+    const first = value[0] ?? '';
+    if (value === 'true' ||
+        value === 'false' ||
+        value === 'null' ||
+        value === '~' ||
+        /^-?\d+$/.test(value) ||
+        value !== value.trim() ||
+        '#{}[],&*!|>\'"%@`'.includes(first)) {
+        return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return value;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @praxis-framework/seed — shared role-seeding logic.
+ *
+ * The dashboard's setup wizard and the CLI's `praxis init` both call
+ * `seedRole(input, targetPath, options?)` to materialise a populated
+ * praxis role from the framework template. The function performs only
+ * file IO; callers layer their own concerns (git commits, approval flows,
+ * UI feedback) on top.
+ */
+export { seedRole, injectPersona, injectClaudeDescription, injectVerbsTable } from './seed.js';
+export { resolveTemplatePath } from './template.js';
+export { TRAIT_LIBRARY, findTrait } from './traits.js';
+export type { TraitEntry } from './traits.js';
+export { SeedVerbSchema, SeedInputSchema, OrganisationSchema, RoleDefinitionSchema, VoiceTraitSchema, SeedError, } from './types.js';
+export type { SeedVerb, SeedInput, SeedOptions, SeedResult, Organisation, RoleDefinition, VoiceTrait, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @praxis-framework/seed — shared role-seeding logic.
+ *
+ * The dashboard's setup wizard and the CLI's `praxis init` both call
+ * `seedRole(input, targetPath, options?)` to materialise a populated
+ * praxis role from the framework template. The function performs only
+ * file IO; callers layer their own concerns (git commits, approval flows,
+ * UI feedback) on top.
+ */
+export { seedRole, injectPersona, injectClaudeDescription, injectVerbsTable } from './seed.js';
+export { resolveTemplatePath } from './template.js';
+export { TRAIT_LIBRARY, findTrait } from './traits.js';
+export { SeedVerbSchema, SeedInputSchema, OrganisationSchema, RoleDefinitionSchema, VoiceTraitSchema, SeedError, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EACL,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/seed.d.ts

@@ -0,0 +1,43 @@
+import { type SeedVerb, type SeedInput, type SeedOptions, type SeedResult } from './types.js';
+/**
+ * Seed a praxis role from the framework template into `targetPath`.
+ *
+ * The seed owns one repo concern: if `targetPath` isn't already a git
+ * repository, it runs `git init --initial-branch=main` before writing
+ * any files. Existing repos are left alone (no branch rename, no
+ * re-init). Beyond that, the seed performs only file IO — no commits,
+ * no environment side-effects beyond writing into the target. Callers
+ * (dashboard, CLI) layer their own commit / approval / cleanup behaviour
+ * around the result.
+ */
+export declare function seedRole(rawInput: SeedInput, targetPath: string, options?: SeedOptions): Promise<SeedResult>;
+/**
+ * Replace the CLAUDE.md placeholder one-liner with the operator's role
+ * description.
+ */
+export declare function injectClaudeDescription(body: string, description: string): string;
+/**
+ * Replace the verbs-table placeholder row in CLAUDE.md with one row per
+ * operator-supplied verb. The framework template ships the table with
+ * `Persona` and `Escalate` rows already in place plus a single
+ * `_(add your role's verbs here)_` placeholder row; this function deletes
+ * the placeholder and appends one row per captured verb in the order they
+ * were captured.
+ *
+ * Columns: `Verb` (slug, prettified bold) / `File` (path to the stub) /
+ * `Input Stage` (always `<unset>` — the wizard does not capture this yet) /
+ * `Output Stage` (first description bullet, or `<unset>` when the operator
+ * left description empty).
+ *
+ * If the placeholder row is absent (e.g. the template has been customised),
+ * the body is returned unchanged — losing the operator's verbs from the
+ * manual is bad, but mangling a customised manual is worse.
+ */
+export declare function injectVerbsTable(body: string, verbs: readonly SeedVerb[]): string;
+/**
+ * Inject operator-supplied content into the persona template, replacing
+ * placeholder section bodies under known section headings. Exported for
+ * testing.
+ */
+export declare function injectPersona(body: string, input: SeedInput): string;
+//# sourceMappingURL=seed.d.ts.map

package/dist/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAC;AAgFpB;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,SAAS,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAkJrB;AAuCD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAkBjF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CA2CpE"}