zelari-code 0.2.2 → 0.6.2

package/dist/cli/wizard/useWizardState.js

@@ -0,0 +1,151 @@
+import { setActiveProviderId, setModelForProvider, } from '../providerConfig.js';
+import { setApiKey as setKeyStoreApiKey } from '../keyStore.js';
+const ORDER = ['welcome', 'provider', 'model', 'apikey', 'confirm'];
+function next(s) {
+    const idx = ORDER.indexOf(s);
+    if (idx === -1 || idx === ORDER.length - 1)
+        return null;
+    return ORDER[idx + 1];
+}
+function prev(s) {
+    const idx = ORDER.indexOf(s);
+    if (idx <= 0)
+        return null;
+    return ORDER[idx - 1];
+}
+/**
+ * Pure-function factory for the wizard state machine. Returned API is
+ * stateless from the caller's perspective — pass the same instance to
+ * React via `useMemo`.
+ *
+ * @public
+ */
+export function createWizardState(opts) {
+    const persistActive = opts.persistActiveProvider ?? ((id) => setActiveProviderId(id));
+    const persistModel = opts.persistModel ?? ((id, m) => setModelForProvider(id, m));
+    const persistKey = opts.persistApiKey ?? ((id, k) => setKeyStoreApiKey(id, k));
+    let s = {
+        step: 'welcome',
+        providerCursor: 0,
+        apiKeyCursor: 0,
+        committed: false,
+    };
+    const listeners = new Set();
+    function notify() {
+        for (const l of listeners)
+            l();
+    }
+    const api = {
+        get state() {
+            return s;
+        },
+        moveProvider(up) {
+            const n = opts.providers.length;
+            const c = s.providerCursor;
+            s = {
+                ...s,
+                providerCursor: up ? (c - 1 + n) % n : (c + 1) % n,
+            };
+            notify();
+        },
+        selectProvider() {
+            const provider = opts.providers[s.providerCursor];
+            if (!provider)
+                return; // shouldn't happen
+            s = {
+                ...s,
+                step: 'model',
+                providerId: provider.id,
+                model: opts.defaultModelFor(provider.id),
+            };
+            notify();
+        },
+        setModel(name) {
+            const trimmed = name.trim();
+            if (!trimmed || !s.providerId)
+                return;
+            s = { ...s, model: trimmed };
+            notify();
+        },
+        moveApiKey(up) {
+            const c = s.apiKeyCursor;
+            // 3 options: 0=env, 1=keystore, 2=skip
+            s = { ...s, apiKeyCursor: up ? (c - 1 + 3) % 3 : (c + 1) % 3 };
+            notify();
+        },
+        selectApiKey(choice, value) {
+            // 'keystore' stores the (trimmed) value; 'env' and 'skip' clear it.
+            // Distinguish `value === undefined` (no value provided) from
+            // `value === ''` or whitespace-only (empty after trim) — both
+            // are guarded at commit time, but the type signature is clearer
+            // if we keep `undefined` for "not provided".
+            let apiKeyValue;
+            if (choice === 'keystore') {
+                apiKeyValue = value === undefined ? undefined : value.trim();
+            }
+            s = {
+                ...s,
+                apiKeyChoice: choice,
+                apiKeyValue,
+                step: 'confirm',
+            };
+            notify();
+        },
+        back() {
+            const p = prev(s.step);
+            if (!p)
+                return;
+            s = { ...s, step: p };
+            notify();
+        },
+        commit() {
+            if (s.committed || !s.providerId || !s.model)
+                return;
+            persistActive(s.providerId);
+            persistModel(s.providerId, s.model);
+            // Persist API key only if user chose 'keystore' AND provided a
+            // non-empty value. 'env' means "use env var, don't save" and
+            // 'skip' means "no key yet, user will set it later via /login".
+            if (s.apiKeyChoice === 'keystore' && s.apiKeyValue && s.apiKeyValue.length > 0) {
+                try {
+                    persistKey(s.providerId, s.apiKeyValue);
+                }
+                catch (err) {
+                    // Key persistence failure shouldn't block config commit —
+                    // the user can re-add the key later via /login. Log to
+                    // stderr for debuggability, then proceed.
+                    // eslint-disable-next-line no-console
+                    console.error(`[zelari-code wizard] failed to persist API key for ${s.providerId}: ` +
+                        (err instanceof Error ? err.message : String(err)));
+                }
+            }
+            s = { ...s, committed: true };
+            notify();
+        },
+    };
+    // Internal: allow React UI to re-render. We expose `subscribe` so the
+    // Ink component can useSyncExternalStore (or call manually in tests).
+    api.subscribe = (l) => {
+        listeners.add(l);
+        return () => listeners.delete(l);
+    };
+    // Advance to first non-welcome step programmatically — used by tests
+    // and by the "skip intro" flag (future).
+    api.jumpToProvider = () => {
+        s = { ...s, step: 'provider' };
+        notify();
+    };
+    // Advance from model to apikey step (used by runWizard when user
+    // confirms the model on step 3).
+    api.advanceToApikey = () => {
+        if (s.step === 'model') {
+            s = { ...s, step: 'apikey' };
+            notify();
+        }
+    };
+    return api;
+}
+/** Convenience constants for tests + UI. */
+export const API_KEY_OPTIONS = ['env', 'keystore', 'skip'];
+export const WIZARD_STEPS = ORDER;
+//# sourceMappingURL=useWizardState.js.map

package/dist/cli/wizard/useWizardState.js.map

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

package/dist/cli/workspace/agentsMd.js

@@ -0,0 +1,314 @@
+/**
+ * workspace/agentsMd.ts — AGENTS.MD auto-maintenance.
+ *
+ * Reads `.zelari/` artifacts and updates the project-root `AGENTS.MD`
+ * file in place using marker-delimited sections. Sections outside
+ * markers (e.g. "Overview") are NEVER touched. Sections inside
+ * markers are auto-curated from workspace artifacts.
+ *
+ * Idempotency: if the generated section content matches what's already
+ * in the file, no write happens → no spurious git diff.
+ *
+ * Fail-safe: if AGENTS.MD has been manually edited and the markers are
+ * missing, the entire file is treated as manual and no auto-update
+ * is performed. The user can re-enable by re-adding the markers.
+ *
+ * @see docs/plans/2026-07-01-council-workspace-cli-stubs.md
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { projectName as deriveProjectName } from './paths.js';
+/** All auto-managed section ids in canonical order. */
+export const AUTO_SECTIONS = [
+    'tech-stack',
+    'decisions',
+    'conventions',
+    'build',
+    'open-questions',
+];
+// ── Markers ───────────────────────────────────────────────────────────
+const MARKER_OPEN = (id) => `<!-- zelari:auto:start section="${id}" -->`;
+const MARKER_CLOSE = (id) => `<!-- zelari:auto:end section="${id}" -->`;
+/** Read package.json from the project root. */
+async function readPackageJson(projectRoot) {
+    const path = join(projectRoot, 'package.json');
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Generate the tech-stack section from package.json. */
+async function genTechStack(ctx) {
+    const pkg = await readPackageJson(ctx.projectRoot);
+    if (!pkg)
+        return '_No package.json found._';
+    const runtime = Object.entries(pkg.dependencies ?? {})
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => `- ${k} \`${v}\``)
+        .join('\n');
+    const dev = Object.entries(pkg.devDependencies ?? {})
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => `- ${k} \`${v}\``)
+        .join('\n');
+    return [
+        '<!-- Auto-derived from package.json -->',
+        '',
+        '**Runtime:**',
+        runtime || '_none_',
+        '',
+        '**Dev:**',
+        dev || '_none_',
+        '',
+    ].join('\n');
+}
+/** Generate the decisions section from `.zelari/decisions/`. */
+async function genDecisions(ctx) {
+    const decisionsDir = join(ctx.rootDir, 'decisions');
+    if (!existsSync(decisionsDir))
+        return '_No ADRs yet._';
+    const files = ctx.storage.listMarkdown(decisionsDir).sort();
+    const accepted = [];
+    const proposed = [];
+    for (const file of files) {
+        const doc = ctx.storage.readIfExists(file);
+        if (!doc?.meta)
+            continue;
+        const line = `- **${doc.meta.id}** _(${doc.meta.status ?? 'proposed'})_`;
+        if (doc.meta.status === 'accepted')
+            accepted.push(line);
+        else
+            proposed.push(line);
+    }
+    if (accepted.length === 0 && proposed.length === 0)
+        return '_No ADRs yet._';
+    return [
+        'See `.zelari/decisions/` for full ADRs (context/decision/consequences).',
+        '',
+        '**Accepted:**',
+        ...(accepted.length ? accepted : ['_none yet_']),
+        '',
+        '**Proposed:**',
+        ...(proposed.length ? proposed : ['_none_']),
+        '',
+    ].join('\n');
+}
+/**
+ * Generate the conventions section.
+ * v1: extract from existing CLAUDE.MD / README.md if present; otherwise generic.
+ * Future: infer from code patterns via Caronte + Nettuno observations.
+ */
+async function genConventions(ctx) {
+    const lines = [];
+    // Try to detect from CLAUDE.md
+    const claudeMd = join(ctx.projectRoot, 'CLAUDE.MD');
+    if (existsSync(claudeMd)) {
+        const content = readFileSync(claudeMd, 'utf8');
+        const match = content.match(/## Architecture rules[\s\S]+?(?=\n## |\n*$)/);
+        if (match) {
+            lines.push('<!-- Extracted from CLAUDE.MD "Architecture rules" -->');
+            lines.push('');
+            lines.push(match[0].trim());
+            lines.push('');
+        }
+    }
+    // Generic Zelari Code conventions
+    lines.push('<!-- Zelari Code defaults -->');
+    lines.push('');
+    lines.push('- One tool definition per file in `src/main/core/tools/builtin/`');
+    lines.push('- Async-first; never block the event loop');
+    lines.push('- Zod schemas for all LLM tool args');
+    lines.push('- Single-task atomic commits; no batching');
+    lines.push('- Zero new heavy deps (lodash, immer, etc.) — use std lib');
+    lines.push('- Files ≤ 300 LOC preferred for new modules');
+    lines.push('');
+    return lines.join('\n');
+}
+/** Generate the build section from package.json scripts. */
+async function genBuild(ctx) {
+    const pkg = await readPackageJson(ctx.projectRoot);
+    if (!pkg?.scripts)
+        return '_No scripts defined._';
+    const scriptLines = Object.entries(pkg.scripts)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => `\`npm run ${k}\` — ${v.length > 80 ? v.slice(0, 77) + '…' : v}`)
+        .join('\n');
+    return [
+        '<!-- Auto-derived from package.json scripts -->',
+        '',
+        scriptLines,
+        '',
+    ].join('\n');
+}
+/** Generate the open-questions section from `.zelari/risks.md` info-level items. */
+async function genOpenQuestions(ctx) {
+    const path = join(ctx.rootDir, 'risks.md');
+    if (!existsSync(path))
+        return '_No open questions._';
+    const content = readFileSync(path, 'utf8');
+    // Extract items that look like info-level questions
+    const lines = content.split('\n');
+    const questions = [];
+    let currentTitle = '';
+    let inInfo = false;
+    for (const line of lines) {
+        if (line.startsWith('## ')) {
+            currentTitle = line.slice(3).trim();
+            inInfo = currentTitle.toLowerCase().includes('info');
+        }
+        else if (inInfo && line.startsWith('- ')) {
+            questions.push(line);
+        }
+    }
+    if (questions.length === 0)
+        return '_No open questions._';
+    return [
+        '<!-- Auto-derived from `.zelari/risks.md` info-level items -->',
+        '',
+        ...questions,
+        '',
+    ].join('\n');
+}
+/** Map section id to its generator. */
+const GENERATORS = {
+    'tech-stack': genTechStack,
+    'decisions': genDecisions,
+    'conventions': genConventions,
+    'build': genBuild,
+    'open-questions': genOpenQuestions,
+};
+// ── File parser / writer ─────────────────────────────────────────────
+/** Parse AGENTS.MD into manual content + per-section content. */
+export function parseAgentsMd(content) {
+    const sections = new Map();
+    let cursor = 0;
+    for (const id of AUTO_SECTIONS) {
+        const startMarker = MARKER_OPEN(id);
+        const endMarker = MARKER_CLOSE(id);
+        const startIdx = content.indexOf(startMarker, cursor);
+        if (startIdx < 0)
+            continue;
+        const endIdx = content.indexOf(endMarker, startIdx);
+        if (endIdx < 0)
+            continue;
+        const innerStart = startIdx + startMarker.length;
+        const innerContent = content.slice(innerStart, endIdx).replace(/^\n/, '').replace(/\n$/, '');
+        sections.set(id, {
+            id,
+            startMarker,
+            endMarker,
+            content: innerContent,
+        });
+        cursor = endIdx + endMarker.length;
+    }
+    // Manual content = the file minus all auto-managed sections.
+    // We rebuild it by walking through and replacing each section block.
+    let manual = content;
+    for (const section of sections.values()) {
+        const block = `${section.startMarker}\n${section.content}\n${section.endMarker}`;
+        manual = manual.replace(block, '');
+    }
+    return {
+        manualBlocks: { before: '', after: manual },
+        sections,
+    };
+}
+/** Serialize AGENTS.MD from manual content + auto sections. */
+export function serializeAgentsMd(manualContent, sections) {
+    // Insert each section into the manual content at its original position
+    // if possible; otherwise append at the end.
+    const out = [];
+    const lines = manualContent.split('\n');
+    let cursor = 0;
+    // Find a good insertion point: after the first heading + first paragraph.
+    // For v1: just append sections at the end of the file.
+    out.push(...lines);
+    for (const id of AUTO_SECTIONS) {
+        const content = sections.get(id);
+        if (!content)
+            continue;
+        out.push('');
+        out.push(`## ${titleCase(id)}`);
+        out.push('');
+        out.push(MARKER_OPEN(id));
+        out.push(content);
+        out.push(MARKER_CLOSE(id));
+    }
+    return out.join('\n').replace(/\n{3,}/g, '\n\n').trim() + '\n';
+}
+function titleCase(id) {
+    return id.split('-').map((w) => w[0].toUpperCase() + w.slice(1)).join(' ');
+}
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Update AGENTS.MD based on current workspace state.
+ * Returns whether the file was actually changed (idempotent).
+ */
+export async function updateAgentsMd(ctx, projectRoot) {
+    const agentsPath = join(projectRoot, 'AGENTS.MD');
+    // Fail-safe: if AGENTS.MD exists but no markers at all → manual file, skip.
+    if (existsSync(agentsPath)) {
+        const content = readFileSync(agentsPath, 'utf8');
+        const hasAnyMarker = AUTO_SECTIONS.some((id) => content.includes(MARKER_OPEN(id)));
+        if (!hasAnyMarker) {
+            return {
+                changed: false,
+                sections: [],
+                reason: 'AGENTS.MD exists without zelari markers — treating as manual file, skipping auto-update.',
+            };
+        }
+    }
+    // Generate content for all sections.
+    const newSections = new Map();
+    for (const id of AUTO_SECTIONS) {
+        newSections.set(id, await GENERATORS[id](ctx));
+    }
+    // Parse existing manual content (if file exists).
+    let manualContent = '';
+    if (existsSync(agentsPath)) {
+        const { manualBlocks } = parseAgentsMd(readFileSync(agentsPath, 'utf8'));
+        manualContent = manualBlocks.after;
+    }
+    else {
+        // First-time creation: build a minimal skeleton.
+        const projectName = deriveProjectName(projectRoot);
+        manualContent = [
+            `# AGENTS.MD — ${projectName}`,
+            '',
+            '> Auto-curated by Zelari Code council. Run `/council` to refresh.',
+            '> See `.zelari/` for raw decision log.',
+            '',
+            '## Overview',
+            '',
+            '_Free-form project description. This section is manual and preserved across updates._',
+            '',
+        ].join('\n');
+    }
+    // Check idempotency: compare each section's hash.
+    const oldContent = existsSync(agentsPath) ? readFileSync(agentsPath, 'utf8') : '';
+    const { sections: oldSections } = parseAgentsMd(oldContent);
+    const changedSections = [];
+    for (const id of AUTO_SECTIONS) {
+        const oldHash = oldSections.get(id)?.content ? hash(oldSections.get(id).content) : null;
+        const newHash = hash(newSections.get(id));
+        if (oldHash !== newHash)
+            changedSections.push(id);
+    }
+    if (changedSections.length === 0) {
+        return { changed: false, sections: [] };
+    }
+    // Serialize and write.
+    const newContent = serializeAgentsMd(manualContent, newSections);
+    writeFileSync(agentsPath, newContent, 'utf8');
+    return { changed: true, sections: changedSections };
+}
+/** Hash a string to detect changes. */
+function hash(s) {
+    return createHash('sha256').update(s).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=agentsMd.js.map

package/dist/cli/workspace/agentsMd.js.map

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

package/dist/cli/workspace/index.js

@@ -0,0 +1,24 @@
+/**
+ * workspace/index.ts — Public API barrel for the council workspace subsystem.
+ *
+ * The council workspace persists council output (plan/risks/decisions/reviews/docs)
+ * to `.zelari/` at the project root and auto-curates `AGENTS.MD` from the
+ * collected artifacts. This is the CLI replacement for the Electron-only
+ * `ctx.createPhase`/etc. injection that AnathemaBrain uses.
+ *
+ * @see docs/plans/2026-07-01-council-workspace-cli-stubs.md
+ * @module cli/workspace
+ */
+// Storage primitives — YAML frontmatter parser/serializer + per-key mutex.
+export { Storage, workspaceMutex, parseFrontmatter, serializeFrontmatter, parseYaml, serializeYaml, } from './storage.js';
+// Filesystem paths + workspace root resolution.
+export { resolveWorkspaceRoot, workspaceFile, workspaceArtifact, projectName, WORKSPACE_SUBDIRS, } from './paths.js';
+// Tool stubs — the 9 council workspace tools as filesystem-backed implementations.
+export { createWorkspaceContext, createWorkspaceStubs, } from './stubs.js';
+// Tool registry — wraps stubs as EnhancedToolDefinition[] for the harness.
+export { createWorkspaceToolRegistry, } from './toolRegistry.js';
+// AGENTS.MD auto-maintenance — marker-delimited sections + idempotent writes.
+export { updateAgentsMd, parseAgentsMd, serializeAgentsMd, AUTO_SECTIONS, } from './agentsMd.js';
+// Post-council hook — orchestrates `updateAgentsMd` after every council run.
+export { runPostCouncilHook, } from './postCouncilHook.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,OAAO,EACL,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,EACT,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,gDAAgD;AAChD,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAYpB,mFAAmF;AACnF,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,2EAA2E;AAC3E,OAAO,EACL,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,8EAA8E;AAC9E,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,eAAe,CAAC;AAGvB,6EAA6E;AAC7E,OAAO,EACL,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/cli/workspace/paths.js

@@ -0,0 +1,88 @@
+/**
+ * workspace/paths.ts — Workspace root resolution.
+ *
+ * Default: project-local `.zelari/` (auto-gitignored).
+ * Fallback: `~/.zelari-code/workspace/<project-hash>/` if cwd not writable.
+ *
+ * The fallback ensures the workspace always works — even in read-only
+ * directories (Docker containers, system dirs, etc.).
+ */
+import { mkdirSync, writeFileSync, existsSync, accessSync, constants, realpathSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { homedir } from 'node:os';
+import { createHash } from 'node:crypto';
+/**
+ * Resolve the workspace root. Returns the first writable option:
+ * 1. `<cwd>/.zelari/` if cwd is writable
+ * 2. `~/.zelari-code/workspace/<project-hash>/` otherwise
+ *
+ * Side effect: creates the directory + auto-gitignore if missing.
+ */
+export function resolveWorkspaceRoot(projectRoot = process.cwd()) {
+    const candidates = [
+        join(projectRoot, '.zelari'),
+        join(homedir(), '.zelari-code', 'workspace', hashProject(projectRoot)),
+    ];
+    for (const candidate of candidates) {
+        if (isWritableDir(projectRoot) || candidate !== candidates[0]) {
+            ensureWorkspaceDir(candidate);
+            return candidate;
+        }
+    }
+    // Last resort: first candidate (will likely fail on write but we tried)
+    ensureWorkspaceDir(candidates[0]);
+    return candidates[0];
+}
+/** Hash a project path to a stable short id (used in global fallback path). */
+function hashProject(projectPath) {
+    return createHash('sha1').update(realpathSync(projectPath)).digest('hex').slice(0, 12);
+}
+/** Check if a directory is writable (creates if missing). */
+function isWritableDir(dir) {
+    try {
+        if (!existsSync(dir))
+            return false; // don't create, just check
+        accessSync(dir, constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Create workspace dir + auto-gitignore (if inside a git repo). */
+function ensureWorkspaceDir(workspaceDir) {
+    mkdirSync(workspaceDir, { recursive: true });
+    // Auto-gitignore ONLY if workspace is project-local AND inside a git repo
+    if (workspaceDir.endsWith('/.zelari') && existsSync(join(workspaceDir, '..', '.git'))) {
+        const gitignorePath = join(workspaceDir, '.gitignore');
+        if (!existsSync(gitignorePath)) {
+            writeFileSync(gitignorePath, '*\n!.gitignore\n');
+        }
+    }
+}
+/** All standard workspace subdirs. */
+export const WORKSPACE_SUBDIRS = [
+    'decisions',
+    'reviews',
+    'docs',
+    'risks', // file, not dir
+    'plan.md', // file, not dir
+    'workspace.json', // file, index
+];
+/** Get the absolute path to a standard workspace file. */
+export function workspaceFile(rootDir, kind) {
+    switch (kind) {
+        case 'plan': return join(rootDir, 'plan.md');
+        case 'risks': return join(rootDir, 'risks.md');
+        case 'index': return join(rootDir, 'workspace.json');
+    }
+}
+/** Get the absolute path to a numbered artifact in a subdir. */
+export function workspaceArtifact(rootDir, subdir, slug) {
+    return join(rootDir, subdir, `${slug}.md`);
+}
+/** Get human-readable project name from path (basename). */
+export function projectName(projectRoot = process.cwd()) {
+    return basename(realpathSync(projectRoot));
+}
+//# sourceMappingURL=paths.js.map

package/dist/cli/workspace/paths.js.map

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

package/dist/cli/workspace/postCouncilHook.js

@@ -0,0 +1,38 @@
+/**
+ * workspace/postCouncilHook.ts — Run the AGENTS.MD auto-maintenance
+ * after every council run completes.
+ *
+ * Used by `councilDispatcher` (Phase 4 wiring) to keep AGENTS.MD in sync
+ * with the latest `.zelari/` artifacts.
+ */
+import { updateAgentsMd } from './agentsMd.js';
+/**
+ * Run the post-council AGENTS.MD maintenance hook.
+ * Returns info about what happened so the CLI can show a one-line summary
+ * to the user (e.g. "AGENTS.MD updated: 2 sections changed (decisions, conventions)").
+ *
+ * Respects `ZELARI_AGENTS_MD=0` env var to opt out.
+ */
+export async function runPostCouncilHook(ctx) {
+    if (process.env['ZELARI_AGENTS_MD'] === '0') {
+        return { ran: false, changed: false, sections: [], reason: 'ZELARI_AGENTS_MD=0 (disabled)' };
+    }
+    try {
+        const result = await updateAgentsMd(ctx, ctx.projectRoot);
+        return {
+            ran: true,
+            changed: result.changed,
+            sections: result.sections,
+            ...(result.reason ? { reason: result.reason } : {}),
+        };
+    }
+    catch (err) {
+        return {
+            ran: false,
+            changed: false,
+            sections: [],
+            reason: `error: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=postCouncilHook.js.map

package/dist/cli/workspace/postCouncilHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postCouncilHook.js","sourceRoot":"","sources":["../../../src/cli/workspace/postCouncilHook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAU/C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAqB;IAC5D,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,GAAG,EAAE,CAAC;QAC5C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;IAC/F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1D,OAAO;YACL,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,GAAG,EAAE,KAAK;YACV,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACrE,CAAC;IACJ,CAAC;AACH,CAAC"}