@justfortytwo/installer 0.1.0

package/dist/engine.js

@@ -0,0 +1,170 @@
+// engine.ts — access to the optional @justfortytwo/* engine siblings.
+//
+// The installer declares the engine packages as OPTIONAL peerDependencies and
+// reaches them via dynamic import, so a partial install (e.g. gate-only) never
+// crashes the CLI — a missing sibling makes the dependent command/check report
+// "not installed" instead of throwing.
+import { createRequire } from 'node:module';
+import { readFileSync, existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join, parse } from 'node:path';
+const require = createRequire(import.meta.url);
+/** Dynamically import an engine sibling; null if it is not installed. */
+export async function loadSibling(spec) {
+    try {
+        return (await import(spec));
+    }
+    catch {
+        return null;
+    }
+}
+export const loadGate = () => loadSibling('@justfortytwo/gate');
+export const loadMemory = () => loadSibling('@justfortytwo/memory');
+export const loadTelegram = () => loadSibling('@justfortytwo/telegram');
+/** Installed version of a sibling (its package.json `version`), or null. */
+export function readInstalledVersion(spec) {
+    // Prefer the direct package.json subpath; packages with a restrictive
+    // `exports` map block it, so fall back to resolving the entry and walking up
+    // to the package.json whose `name` matches the spec.
+    const readVersion = (pkgPath) => {
+        try {
+            return JSON.parse(readFileSync(pkgPath, 'utf8')).version ?? null;
+        }
+        catch {
+            return null;
+        }
+    };
+    try {
+        return readVersion(require.resolve(`${spec}/package.json`));
+    }
+    catch {
+        /* exports-restricted — fall through */
+    }
+    try {
+        // Resolve the entry with the ESM resolver (matches the package's `import`
+        // condition — the same path loadSibling uses), then walk up to the
+        // package.json whose name matches. CJS require.resolve can't see
+        // import-only exports maps, so prefer import.meta.resolve.
+        let entry = null;
+        const esmResolve = import.meta.resolve;
+        if (esmResolve) {
+            try {
+                entry = fileURLToPath(esmResolve(spec));
+            }
+            catch { /* try CJS next */ }
+        }
+        if (!entry)
+            entry = require.resolve(spec);
+        let dir = dirname(entry);
+        const root = parse(dir).root;
+        while (true) {
+            const candidate = join(dir, 'package.json');
+            if (existsSync(candidate)) {
+                const json = JSON.parse(readFileSync(candidate, 'utf8'));
+                if (json.name === spec)
+                    return json.version ?? null;
+            }
+            if (dir === root)
+                return null;
+            dir = dirname(dir);
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/** Walk up from this module to find the installer's own package.json. */
+function findSelfPackageJson() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    const root = parse(dir).root;
+    while (true) {
+        const candidate = join(dir, 'package.json');
+        if (existsSync(candidate)) {
+            try {
+                return JSON.parse(readFileSync(candidate, 'utf8'));
+            }
+            catch {
+                return null;
+            }
+        }
+        if (dir === root)
+            return null;
+        dir = dirname(dir);
+    }
+}
+/** The CLI's declared compat ranges (package.json `fortytwo.compat`). */
+export function readSelfCompatRanges() {
+    const pkg = findSelfPackageJson();
+    const fortytwo = (pkg?.fortytwo ?? {});
+    return fortytwo.compat ?? {};
+}
+/**
+ * Minimal semver-range satisfaction for the forms this CLI's compat contract
+ * uses: exact (`1.2.3`) and caret (`^1.2.3`, with npm's 0.x rule where the
+ * left-most non-zero element is the lock point). Avoids a runtime dependency.
+ */
+export function satisfiesRange(version, range) {
+    const parse3 = (v) => {
+        const [a = 0, b = 0, c = 0] = v.replace(/^[v^~]/, '').split('.').map((n) => parseInt(n, 10));
+        return [a, b, c];
+    };
+    const [vMaj, vMin, vPatch] = parse3(version);
+    const [rMaj, rMin, rPatch] = parse3(range);
+    if (Number.isNaN(vMaj) || Number.isNaN(rMaj))
+        return false;
+    if (!range.startsWith('^'))
+        return vMaj === rMaj && vMin === rMin && vPatch === rPatch;
+    const geFloor = vMaj > rMaj || (vMaj === rMaj && (vMin > rMin || (vMin === rMin && vPatch >= rPatch)));
+    if (!geFloor)
+        return false;
+    if (rMaj > 0)
+        return vMaj === rMaj; // ^1.2.3 -> >=1.2.3 <2.0.0
+    if (rMin > 0)
+        return vMaj === 0 && vMin === rMin; // ^0.1.2 -> >=0.1.2 <0.2.0
+    return vMaj === 0 && vMin === 0 && vPatch === rPatch; // ^0.0.z -> exact
+}
+/** GET {baseUrl}/api/tags; return installed model names, or null if unreachable. */
+export async function fetchOllamaModels(baseUrl) {
+    try {
+        const res = await fetch(`${baseUrl.replace(/\/$/, '')}/api/tags`);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return (data.models ?? []).map((m) => m.name);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Migration health for the memory DB: 'missing' (no DB file → run init),
+ * 'ok' (the migrated `memories` table exists), 'pending' (DB present but not
+ * migrated), or 'unavailable' (memory package not installed / DB unreadable).
+ */
+export async function readMigrationState(dbPath) {
+    const mem = await loadMemory();
+    if (!mem || typeof mem.openDb !== 'function')
+        return 'unavailable';
+    if (!existsSync(dbPath))
+        return 'missing';
+    let handle;
+    try {
+        handle = mem.openDb(dbPath);
+        const migrated = await handle.k.schema.hasTable('memories');
+        return migrated ? 'ok' : 'pending';
+    }
+    catch {
+        return 'unavailable';
+    }
+    finally {
+        try {
+            await handle?.k?.destroy?.();
+        }
+        catch { /* best-effort close */ }
+        try {
+            handle?.close?.();
+        }
+        catch { /* best-effort close */ }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+export type Verb = 'init' | 'pair' | 'doctor' | 'update' | 'rollback' | 'enrich' | 'forget' | 'unbind';
+/**
+ * Decide the verb. `create-fortytwo` with no verb means `init`; `fortytwo` with
+ * no verb prints usage. The invoked-as name comes from argv[1]'s basename.
+ */
+export declare function resolveVerb(argv: string[], invokedAs: string): Verb | 'help' | null;
+export declare function main(argv?: string[]): Promise<number>;
+//# 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":";AA4BA,MAAM,MAAM,IAAI,GACZ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAwBb;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CASnF;AAED,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBxE"}

package/dist/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+// @justfortytwo/installer — the all-in-one installer + lifecycle CLI.
+//
+// Exposed as two bins (same entry):
+//   create-fortytwo   — the install-time alias (`npm create fortytwo` / `npx
+//                       create-fortytwo`); with no verb it implies `init`.
+//   fortytwo          — the post-install lifecycle alias for everyday verbs.
+//
+// This is the operator's single surface over BOTH halves of the system:
+//   - the npm ENGINE (@justfortytwo/memory, /gate, /telegram, embedder), and
+//   - the scaffolded PERSONA (CLAUDE.md + context/*, rendered from
+//     @justfortytwo/persona templates against .fortytwo/identity.json).
+//
+// init/doctor/unbind are wired against the local engine siblings; update/rollback
+// (npm-registry installs) and forget (a memory deletion API) report clearly that
+// they await publish / an upstream API rather than failing opaquely.
+import { fileURLToPath } from 'node:url';
+import { realpathSync } from 'node:fs';
+import { runInit } from './commands/init.js';
+import { runPair } from './commands/pair.js';
+import { runDoctor } from './commands/doctor.js';
+import { runUpdate } from './commands/update.js';
+import { runRollback } from './commands/rollback.js';
+import { runEnrich } from './commands/enrich.js';
+import { runForget } from './commands/forget.js';
+import { runUnbind } from './commands/unbind.js';
+const USAGE = `fortytwo — install + lifecycle CLI for fortytwo
+
+Usage:
+  create-fortytwo [init] [options]   first-run install + scaffold (init implied)
+  fortytwo <verb> [options]
+
+Verbs:
+  init        Capture identity, write .env + .fortytwo/identity.json, render
+              persona, provision (ollama pull + db migrate), issue a pairing code.
+  pair        Issue a one-time /login pairing code for a channel (e.g. Telegram).
+  doctor      Health-check the engine: memory MCP contract, gate, db migrations,
+              embedder model, and declared peerDeps / fortytwo.compat.
+  update      Resolve latest-in-range, install, run doctor, report. Points to
+              rollback on failure.
+  rollback    Restore the prior version set recorded in .fortytwo/state.json.
+  enrich      Deepen the persona by capturing more answers; re-render (no clobber).
+  forget      Redact/remove specific memories from the memory MCP store.
+  unbind      Revoke a channel binding (un-pair a chat / drop the allowlist entry).
+
+Run "fortytwo <verb> --help" for verb-specific options.
+`;
+/**
+ * Decide the verb. `create-fortytwo` with no verb means `init`; `fortytwo` with
+ * no verb prints usage. The invoked-as name comes from argv[1]'s basename.
+ */
+export function resolveVerb(argv, invokedAs) {
+    const first = argv[0];
+    const verbs = ['init', 'pair', 'doctor', 'update', 'rollback', 'enrich', 'forget', 'unbind'];
+    if (first && verbs.includes(first))
+        return first;
+    if (!first || first === '--help' || first === '-h' || first === 'help') {
+        // `create-fortytwo` with no verb implies init; otherwise show help.
+        return invokedAs.startsWith('create-') && !first ? 'init' : 'help';
+    }
+    return null; // unknown verb
+}
+export async function main(argv = process.argv.slice(2)) {
+    const invokedAs = (process.argv[1] ?? '').split('/').pop() ?? 'fortytwo';
+    const verb = resolveVerb(argv, invokedAs);
+    const rest = argv.slice(verb && verb !== 'help' && argv[0] === verb ? 1 : 0);
+    switch (verb) {
+        case 'init': return runInit(rest);
+        case 'pair': return runPair(rest);
+        case 'doctor': return runDoctor(rest);
+        case 'update': return runUpdate(rest);
+        case 'rollback': return runRollback(rest);
+        case 'enrich': return runEnrich(rest);
+        case 'forget': return runForget(rest);
+        case 'unbind': return runUnbind(rest);
+        case 'help':
+            process.stdout.write(USAGE);
+            return 0;
+        default:
+            process.stderr.write(`Unknown command: ${argv[0]}\n\n${USAGE}`);
+            return 2;
+    }
+}
+// Run only when invoked as a bin — never when imported (e.g. by tests). Compare
+// realpaths so the npm bin SYMLINK (node_modules/.bin/create-fortytwo -> dist/
+// index.js) still matches this module's real path.
+function invokedAsBin() {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return false;
+    try {
+        return realpathSync(argv1) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (invokedAsBin()) {
+    main()
+        .then((code) => process.exit(code))
+        .catch((err) => {
+        process.stderr.write(`fortytwo: ${err?.stack ?? err}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,78 @@
+import type { Identity, Answers } from './state.js';
+/** Maps each persona template to an output path + render mode. */
+export interface PersonaFile {
+    /** Template path, relative to the persona package's templates dir. */
+    template: string;
+    /** Output path, relative to the project root. */
+    output: string;
+    /** CAPTURED = write-once (user-owned after); MANAGED = re-render every run. */
+    mode: 'captured' | 'managed';
+}
+/** One persona manifest field (drives `fortytwo init` prompts + answer resolution). */
+export interface PersonaManifestField {
+    key: string;
+    prompt: string;
+    type: string;
+    required?: boolean;
+    default?: unknown;
+}
+/** The persona package's manifest, resolved for rendering. */
+export interface PersonaManifest {
+    manifestVersion: number;
+    files: PersonaFile[];
+    /** The raw field descriptors (for init's prompt + answer resolution). */
+    fields: PersonaManifestField[];
+    /** Field keys the renderer must have a value for (manifest fields, required=true). */
+    requiredVars: string[];
+    /** Field keys that are optional (required=false). */
+    optionalVars: string[];
+    /** Absolute path to the package's `templates/` dir. */
+    templatesDir: string;
+}
+export interface RenderOptions {
+    /** Project root that receives CLAUDE.md + context/*. Defaults to cwd. */
+    root?: string;
+    /** Resolved location of the @justfortytwo/persona package (for loadPersonaManifest). */
+    personaPackageDir?: string;
+    /** If true, report what WOULD be written without touching disk. */
+    dryRun?: boolean;
+    /** Injected file map (hermetic/testable; bypasses loadPersonaManifest). */
+    files?: PersonaFile[];
+    /** Directory the `template` paths are resolved against (hermetic/testable). */
+    templatesDir?: string;
+}
+export interface RenderResult {
+    written: string[];
+    skipped: string[];
+}
+/**
+ * Substitute `{{key}}` references with captured answers (flat, keyed by the
+ * persona manifest field keys — snake_case, exactly what templates use).
+ *   - string value: inlined as-is.
+ *   - list value (array): joined with "\n- " so it slots after a leading "- "
+ *     in the template (the markdown bullet convention the templates rely on).
+ * Fails LOUDLY on a referenced variable that's missing/null — a half-filled
+ * persona (blank owner name, blank agent name) is worse than a clear error at
+ * scaffold time. Own-property only: `{{toString}}`/`{{__proto__}}` fail loud,
+ * they never resolve a prototype member into the rendered persona.
+ */
+export declare function renderTemplate(template: string, answers: Answers): string;
+/**
+ * Locate the persona package and read its manifest. With `personaPackageDir`
+ * (tests, or an explicitly-resolved path) we read `<dir>/manifest.json`;
+ * otherwise we resolve `@justfortytwo/persona/manifest.json` from the installed
+ * dependency so we honor the user's installed version. The manifest's `files`
+ * map drives rendering; `fields` (required flag) gives the required/optional
+ * var split; templates live under `<packageDir>/templates`.
+ */
+export declare function loadPersonaManifest(personaPackageDir?: string): PersonaManifest;
+/**
+ * Render the whole persona surface. Idempotent and non-clobbering:
+ *   - MANAGED outputs: always (re)written from templates.
+ *   - CAPTURED outputs: written only if they don't already exist; if present,
+ *     left exactly as the user edited them (recorded in `skipped`).
+ * The file map + templates dir come from the persona manifest unless injected
+ * via opts (hermetic tests).
+ */
+export declare function renderPersona(identity: Identity, opts?: RenderOptions): RenderResult;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEpD,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9B;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,yEAAyE;IACzE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,sFAAsF;IACtF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qDAAqD;IACrD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CASzE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,eAAe,CAyB/E;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAkCxF"}

package/dist/render.js

@@ -0,0 +1,113 @@
+// render.ts — materialize the PERSONA SURFACE.
+//
+// Two-surface model:
+//   1. The npm "engine" (memory MCP, safety gate, channel adapters, embedder) —
+//      installed as @justfortytwo/* packages, wired as Claude Code plugins.
+//   2. The PERSONA — CLAUDE.md + context/* . This is NOT a plugin. It is per-user,
+//      gitignored, and personal. The CLI SCAFFOLDS it by rendering the
+//      @justfortytwo/persona package's `templates/` against the user's captured
+//      `.fortytwo/identity.json`, guided by that package's manifest.
+//
+// IDEMPOTENCE CONTRACT: re-rendering must NOT clobber captured fields. A user who
+// hand-edits context/SOUL.md after init keeps those edits on the next
+// `update`/`enrich` re-render. Strategy: MANAGED outputs are (re)written every
+// run; CAPTURED outputs are written only on first render (when absent).
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname, join, resolve, sep } from 'node:path';
+import { createRequire } from 'node:module';
+/**
+ * Substitute `{{key}}` references with captured answers (flat, keyed by the
+ * persona manifest field keys — snake_case, exactly what templates use).
+ *   - string value: inlined as-is.
+ *   - list value (array): joined with "\n- " so it slots after a leading "- "
+ *     in the template (the markdown bullet convention the templates rely on).
+ * Fails LOUDLY on a referenced variable that's missing/null — a half-filled
+ * persona (blank owner name, blank agent name) is worse than a clear error at
+ * scaffold time. Own-property only: `{{toString}}`/`{{__proto__}}` fail loud,
+ * they never resolve a prototype member into the rendered persona.
+ */
+export function renderTemplate(template, answers) {
+    return template.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (_m, key) => {
+        const has = Object.prototype.hasOwnProperty.call(answers, key);
+        const v = has ? answers[key] : undefined;
+        if (v === undefined || v === null) {
+            throw new Error(`renderTemplate: missing required variable {{${key}}} in identity`);
+        }
+        return Array.isArray(v) ? v.join('\n- ') : String(v);
+    });
+}
+/**
+ * Locate the persona package and read its manifest. With `personaPackageDir`
+ * (tests, or an explicitly-resolved path) we read `<dir>/manifest.json`;
+ * otherwise we resolve `@justfortytwo/persona/manifest.json` from the installed
+ * dependency so we honor the user's installed version. The manifest's `files`
+ * map drives rendering; `fields` (required flag) gives the required/optional
+ * var split; templates live under `<packageDir>/templates`.
+ */
+export function loadPersonaManifest(personaPackageDir) {
+    let manifestPath;
+    let pkgDir;
+    if (personaPackageDir) {
+        pkgDir = resolve(personaPackageDir);
+        manifestPath = join(pkgDir, 'manifest.json');
+    }
+    else {
+        const require = createRequire(import.meta.url);
+        manifestPath = require.resolve('@justfortytwo/persona/manifest.json');
+        pkgDir = dirname(manifestPath);
+    }
+    const raw = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    const fields = raw.fields ?? [];
+    return {
+        manifestVersion: raw.manifestVersion ?? 1,
+        files: raw.files ?? [],
+        fields,
+        requiredVars: fields.filter((f) => f.required).map((f) => f.key),
+        optionalVars: fields.filter((f) => !f.required).map((f) => f.key),
+        templatesDir: join(pkgDir, 'templates'),
+    };
+}
+/**
+ * Render the whole persona surface. Idempotent and non-clobbering:
+ *   - MANAGED outputs: always (re)written from templates.
+ *   - CAPTURED outputs: written only if they don't already exist; if present,
+ *     left exactly as the user edited them (recorded in `skipped`).
+ * The file map + templates dir come from the persona manifest unless injected
+ * via opts (hermetic tests).
+ */
+export function renderPersona(identity, opts = {}) {
+    const root = resolve(opts.root ?? process.cwd());
+    let files = opts.files;
+    let tplRoot = opts.templatesDir ? resolve(opts.templatesDir) : undefined;
+    if (!files || !tplRoot) {
+        const manifest = loadPersonaManifest(opts.personaPackageDir);
+        files = files ?? manifest.files;
+        tplRoot = tplRoot ?? resolve(manifest.templatesDir);
+    }
+    const written = [];
+    const skipped = [];
+    for (const f of files) {
+        // Defense-in-depth: even though the manifest ships in the trusted persona
+        // package, never let an output/template path escape its root via `..`.
+        const outPath = resolve(root, f.output);
+        if (outPath !== root && !outPath.startsWith(root + sep)) {
+            throw new Error(`renderPersona: output path escapes project root: ${f.output}`);
+        }
+        if (f.mode === 'captured' && existsSync(outPath)) {
+            skipped.push(f.output);
+            continue;
+        }
+        const tplPath = resolve(tplRoot, f.template);
+        if (!tplPath.startsWith(tplRoot + sep)) {
+            throw new Error(`renderPersona: template path escapes templates dir: ${f.template}`);
+        }
+        const rendered = renderTemplate(readFileSync(tplPath, 'utf8'), identity.answers);
+        if (!opts.dryRun) {
+            mkdirSync(dirname(outPath), { recursive: true });
+            writeFileSync(outPath, rendered, 'utf8');
+        }
+        written.push(f.output);
+    }
+    return { written, skipped };
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,58 @@
+export declare const FORTYTWO_DIR = ".fortytwo";
+export declare const IDENTITY_FILE = "identity.json";
+export declare const STATE_FILE = "state.json";
+/**
+ * Captured answers, keyed by the persona manifest's field `key` (snake_case) —
+ * exactly the `{{tokens}}` the templates reference. A `string` for scalar
+ * fields, a `string[]` for `list` fields. This is the single map render.ts
+ * substitutes against; there is no separate owner sub-object.
+ */
+export type Answers = Record<string, string | string[]>;
+/** Channel binding captured at init/pair (e.g. the Telegram chat allowlist). */
+export interface ChannelBinding {
+    channel: 'telegram' | string;
+    allowedChatIds?: string[];
+    pairedAt?: string;
+}
+/**
+ * `.fortytwo/identity.json` — captured answers. Persona templates render
+ * against this. Secrets do NOT live here (they go to `.env`); only the
+ * non-secret identity/answers the persona needs to render.
+ */
+export interface Identity {
+    /** Schema version of THIS file's shape, so future CLI versions can migrate it. */
+    identityVersion: number;
+    /**
+     * Captured answers keyed by persona manifest field key (e.g. `agent_name`,
+     * `owner_name`, `owner_values`). `enrich` adds/updates keys here over time.
+     */
+    answers: Answers;
+    channels?: ChannelBinding[];
+    createdAt: string;
+    updatedAt: string;
+}
+/** One resolved sibling-package version pin. */
+export interface VersionPin {
+    name: string;
+    range: string;
+    resolved: string;
+}
+/**
+ * `.fortytwo/state.json` — installed version set + rollback ledger.
+ * `current` is what's installed now; `previous` is the set BEFORE the last
+ * update (the rollback target). Update safety = install latest-in-range, run
+ * doctor (post-verify health check), and on success keep `current`; rollback is
+ * MANUAL — the user runs `fortytwo rollback`, which restores `previous`.
+ */
+export interface InstallState {
+    stateVersion: number;
+    current: VersionPin[];
+    previous: VersionPin[] | null;
+    lastUpdatedAt: string;
+}
+export declare function readIdentity(root?: string): Identity | null;
+export declare function writeIdentity(identity: Identity, root?: string): void;
+export declare function readState(root?: string): InstallState | null;
+export declare function writeState(state: InstallState, root?: string): void;
+export declare function recordVersionSet(next: VersionPin[], root?: string): InstallState;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,YAAY,cAAc,CAAC;AACxC,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAExD,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAG7B,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,kFAAkF;IAClF,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AAyBD,wBAAgB,YAAY,CAAC,IAAI,SAAgB,GAAG,QAAQ,GAAG,IAAI,CAElE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,SAAgB,GAAG,IAAI,CAQ5E;AAID,wBAAgB,SAAS,CAAC,IAAI,SAAgB,GAAG,YAAY,GAAG,IAAI,CAEnE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,SAAgB,GAAG,IAAI,CAE1E;AAeD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,SAAgB,GAAG,YAAY,CAevF"}