peaks-loop 4.0.0-beta.7 → 4.0.0-beta.8

package/dist/src/services/artifacts/workspace-service.js

@@ -1,272 +0,0 @@
-import { existsSync } from 'node:fs';
-import { Buffer } from 'node:buffer';
-import { resolve } from 'node:path';
-import { isInsidePath, stablePath } from '../../shared/path-utils.js';
-import { getWorkspaceConfig, getWorkspaceConfigForCurrentPath } from '../config/config-service.js';
-import { pathExists } from '../../shared/fs.js';
-import { execCommand } from '../../shared/process.js';
-function canonicalPath(path) {
-    return stablePath(path);
-}
-function canonicalChildPath(parentPath, ...segments) {
-    return stablePath(resolve(parentPath, ...segments));
-}
-export function getLocalArtifactPath(workspace) {
-    if (workspace.artifactStorage?.localPath) {
-        return resolve(workspace.artifactStorage.localPath);
-    }
-    return resolve(workspace.rootPath, '.peaks', 'artifacts');
-}
-export function isArtifactWorkspaceOutsideTarget(_workspace, _artifactWorkspacePath) {
-    return true;
-}
-export function hasValidArtifactWorkspace(workspace, artifactWorkspacePath = getLocalArtifactPath(workspace)) {
-    if (!isArtifactWorkspaceOutsideTarget(workspace, artifactWorkspacePath))
-        return false;
-    const artifactRoot = canonicalPath(artifactWorkspacePath);
-    const peaksRoot = canonicalChildPath(artifactWorkspacePath, '.peaks');
-    const changesRoot = canonicalChildPath(artifactWorkspacePath, '.peaks', 'changes');
-    const configPath = canonicalChildPath(artifactWorkspacePath, '.peaks', 'config.json');
-    if (!existsSync(resolve(artifactWorkspacePath, '.peaks', 'config.json')))
-        return false;
-    if (!isInsidePath(peaksRoot, artifactRoot))
-        return false;
-    if (!isInsidePath(changesRoot, artifactRoot))
-        return false;
-    if (!isInsidePath(configPath, artifactRoot))
-        return false;
-    return true;
-}
-export function getArtifactRemoteRepo(workspace) {
-    if (workspace.artifactStorage?.mode === 'local-with-remote-sync') {
-        return workspace.artifactStorage.remote;
-    }
-    if (workspace.artifactStorage?.mode === 'local') {
-        return null;
-    }
-    return workspace.artifactRepo ?? null;
-}
-function getPublicRemoteUrl(artifactRepo) {
-    if (!artifactRepo)
-        return null;
-    return artifactRepo.provider === 'github'
-        ? `https://github.com/${artifactRepo.owner}/${artifactRepo.name}.git`
-        : `https://gitlab.com/${artifactRepo.owner}/${artifactRepo.name}.git`;
-}
-function getGitAuthEnv(artifactRepo) {
-    if (!artifactRepo || artifactRepo.provider !== 'github')
-        return undefined;
-    const token = process.env.GH_TOKEN;
-    if (!token)
-        return undefined;
-    const authValue = Buffer.from(`x-access-token:${token}`, 'utf-8').toString('base64');
-    return {
-        ...process.env,
-        GIT_CONFIG_COUNT: '1',
-        GIT_CONFIG_KEY_0: 'http.https://github.com/.extraheader',
-        GIT_CONFIG_VALUE_0: `AUTHORIZATION: basic ${authValue}`
-    };
-}
-function redactSecrets(message) {
-    const token = process.env.GH_TOKEN;
-    const urlRedacted = message.replace(/https:\/\/x-access-token:[^@]+@/g, 'https://x-access-token:***@');
-    const headerRedacted = urlRedacted.replace(/AUTHORIZATION:\s*basic\s+[A-Za-z0-9+/=]+/gi, 'AUTHORIZATION: basic ***');
-    if (!token)
-        return headerRedacted;
-    const encoded = Buffer.from(`x-access-token:${token}`, 'utf-8').toString('base64');
-    return headerRedacted.replaceAll(token, '***').replaceAll(encoded, '***');
-}
-export async function executeArtifactSync(workspaceId) {
-    const workspace = workspaceId
-        ? getWorkspaceConfig(workspaceId)
-        : getWorkspaceConfigForCurrentPath();
-    if (!workspace) {
-        return {
-            workspaceId: workspaceId ?? 'unknown',
-            success: false,
-            localPath: '.peaks-artifacts',
-            remoteUrl: null,
-            commands: [],
-            output: [],
-            error: 'Workspace not found'
-        };
-    }
-    const localPath = getLocalArtifactPath(workspace);
-    if (!isArtifactWorkspaceOutsideTarget(workspace, localPath)) {
-        return {
-            workspaceId: workspace.workspaceId,
-            success: false,
-            localPath,
-            remoteUrl: null,
-            commands: [],
-            output: [],
-            error: 'Artifact workspace must be outside the target repository'
-        };
-    }
-    const artifactRepo = getArtifactRemoteRepo(workspace);
-    if (!artifactRepo) {
-        return {
-            workspaceId: workspace.workspaceId,
-            success: true,
-            localPath,
-            remoteUrl: null,
-            commands: [],
-            output: ['Local artifact storage is configured']
-        };
-    }
-    const remoteUrl = getPublicRemoteUrl(artifactRepo);
-    const gitAuthEnv = getGitAuthEnv(artifactRepo);
-    if (!remoteUrl) {
-        return {
-            workspaceId: workspace.workspaceId,
-            success: false,
-            localPath,
-            remoteUrl: null,
-            commands: [],
-            output: [],
-            error: 'Invalid artifact repository configuration'
-        };
-    }
-    const commands = [];
-    const output = [];
-    const hasLocalDir = await pathExists(localPath);
-    if (!hasLocalDir) {
-        commands.push(`git clone ${remoteUrl} "${localPath}"`);
-        try {
-            await execCommand('git', ['clone', remoteUrl, localPath], { env: gitAuthEnv });
-            output.push(`Cloned artifact repository to ${localPath}`);
-        }
-        catch (err) {
-            return {
-                workspaceId: workspace.workspaceId,
-                success: false,
-                localPath,
-                remoteUrl,
-                commands,
-                output,
-                error: `Clone failed: ${redactSecrets(err instanceof Error ? err.message : String(err))}`
-            };
-        }
-    }
-    else {
-        commands.push(`cd "${localPath}" && git fetch origin`);
-        commands.push(`cd "${localPath}" && git pull origin main`);
-        try {
-            await execCommand('git', ['fetch', 'origin'], { cwd: localPath, env: gitAuthEnv });
-            output.push('Fetched latest from remote');
-            await execCommand('git', ['pull', 'origin', 'main'], { cwd: localPath, env: gitAuthEnv });
-            output.push('Pulled latest changes');
-        }
-        catch (err) {
-            return {
-                workspaceId: workspace.workspaceId,
-                success: false,
-                localPath,
-                remoteUrl,
-                commands,
-                output,
-                error: `Sync failed: ${redactSecrets(err instanceof Error ? err.message : String(err))}`
-            };
-        }
-    }
-    return {
-        workspaceId: workspace.workspaceId,
-        success: true,
-        localPath,
-        remoteUrl,
-        commands,
-        output
-    };
-}
-export function getArtifactWorkspaceStatus(workspaceId) {
-    const workspace = workspaceId
-        ? getWorkspaceConfig(workspaceId)
-        : getWorkspaceConfigForCurrentPath();
-    if (!workspace) {
-        return {
-            workspaceId: workspaceId ?? 'unknown',
-            localPath: '.peaks-artifacts',
-            configured: false,
-            syncStatus: 'unknown',
-            lastSync: null,
-            hasLocalChanges: false,
-            artifactRepo: null,
-            nextActions: ['Add a workspace with: peaks config workspace add --id <id> --name <name> --path <path>']
-        };
-    }
-    const localPath = getLocalArtifactPath(workspace);
-    const hasLocalDir = existsSync(localPath);
-    const artifactRepo = getArtifactRemoteRepo(workspace);
-    const hasSafeBoundary = isArtifactWorkspaceOutsideTarget(workspace, localPath);
-    const syncStatus = !hasSafeBoundary
-        ? 'unknown'
-        : !hasLocalDir
-            ? 'pending'
-            : 'synced';
-    return {
-        workspaceId: workspace.workspaceId,
-        localPath,
-        configured: hasSafeBoundary,
-        syncStatus,
-        lastSync: null,
-        hasLocalChanges: false,
-        artifactRepo,
-        nextActions: !hasSafeBoundary
-            ? ['Configure artifact workspace outside the target repository.']
-            : artifactRepo
-                ? [`Run peaks artifacts sync --workspace ${workspace.workspaceId} --dry-run`]
-                : [`Local artifact storage ready at ${localPath}`]
-    };
-}
-export function planArtifactSync(workspaceId, dryRun = true) {
-    const workspace = workspaceId
-        ? getWorkspaceConfig(workspaceId)
-        : getWorkspaceConfigForCurrentPath();
-    if (!workspace) {
-        return {
-            workspaceId: workspaceId ?? 'unknown',
-            dryRun,
-            localPath: '.peaks-artifacts',
-            remoteUrl: null,
-            plannedCommands: ['No artifact repo configured — add one with peaks config workspace add --provider github --repo-owner <owner> --repo-name <name>']
-        };
-    }
-    const localPath = getLocalArtifactPath(workspace);
-    if (!isArtifactWorkspaceOutsideTarget(workspace, localPath)) {
-        return {
-            workspaceId: workspace.workspaceId,
-            dryRun,
-            localPath,
-            remoteUrl: null,
-            plannedCommands: ['Artifact workspace must be outside the target repository']
-        };
-    }
-    const artifactRepo = getArtifactRemoteRepo(workspace);
-    const remoteUrl = getPublicRemoteUrl(artifactRepo);
-    const plannedCommands = artifactRepo
-        ? dryRun
-            ? [
-                `# Sync plan for workspace ${workspace.workspaceId}`,
-                `# Local: ${localPath}`,
-                `# Remote: ${remoteUrl}`,
-                '# peaks artifacts sync --workspace ' + workspace.workspaceId,
-                '# (dry-run only — no changes made)'
-            ]
-            : [
-                `# Sync execution for workspace ${workspace.workspaceId}`,
-                `# Confirm: will sync ${localPath} with ${remoteUrl}`,
-                '# Exit 1 if not confirmed'
-            ]
-        : [
-            `# Local artifact storage for workspace ${workspace.workspaceId}`,
-            `# Local: ${localPath}`,
-            '# No remote repository is configured or required'
-        ];
-    return {
-        workspaceId: workspace.workspaceId,
-        dryRun,
-        localPath,
-        remoteUrl,
-        plannedCommands
-    };
-}

package/dist/src/services/audit/artifact-writer.d.ts

@@ -1,93 +0,0 @@
-/**
- * Audit artifact writer — Slice 2026-06-26-audit-artifact-writer-generalization.
- *
- * Generalizes the original `decision-writer.ts` (which only knew how to
- * persist a `RedLineAudit` snapshot) into a polymorphic writer that
- * handles the 4 artifact types produced during a peaks-loop audit:
- *
- *   1. **decision**      — `RedLineAudit` snapshot             → audit-decisions/<slug>.md
- *   2. **prompt**        — methodology input (LLM-facing text) → audit-prompts/<slug>.md
- *   3. **machine-output** — JSON audit result                  → audit-<date>-<slug>.md (envelope)
- *   4. **narrative**     — free-form prose report              → <slug>.md (top level)
- *
- * Each writer enforces canonical frontmatter (`name` / `description` /
- * `metadata.type` ∈ ProjectMemoryKind / `metadata.artifactType`) so the
- * `.peaks/memory/` shape stays compliant with `memory-shape-guard.test.ts`.
- *
- * Back-compat: `writeAuditDecision` in `decision-writer.ts` re-exports
- * `writeDecision` so existing callers of `peaks audit static --record`
- * keep working unchanged.
- *
- * Design notes (Karpathy #1 Think Before Coding):
- *
- *   - **Why 4 writers instead of 1 polymorphic writer?** Each artifact
- *     type has a distinct subdir + envelope semantics. A single writer
- *     with a kind-flag would need conditional logic on every field. Four
- *     named writers are 4 × ~30 lines each vs. 1 × ~150 line monolith
- *     with nested if-trees. The cost of polymorphism here is lower
- *     clarity; the cost of 4 small writers is one extra import line at
- *     the call site.
- *
- *   - **Why a strict frontmatter contract on every writer?** The memory
- *     parser (`parseStoredMemoryFile` in `project-memory-service.ts`)
- *     silently ignores unknown frontmatter keys. Adding `metadata.artifactType`
- *     is therefore safe — it's additive, never breaks existing readers.
- *     But adding it consistently across all 4 writers means new files
- *     can be queried by artifactType in future tooling.
- *
- *   - **Why JSON envelope for machine-output?** Raw `.json` files at the
- *     top of `.peaks/memory/` are forbidden by the memory-shape guard.
- *     Wrapping JSON in a `.md` envelope (fenced ```json block) keeps
- *     the original bytes byte-for-byte intact while restoring compliance.
- *     The envelope also adds a human-readable H1 + summary table.
- *
- *   - **Out of scope:** index.json generation, warm-layer extraction, hot
- *     layer routing — the existing memory service handles those. We only
- *     write files; the service indexes them on next read.
- */
-import type { RedLineAudit } from './types.js';
-export type ArtifactKind = 'decision' | 'prompt' | 'machine-output' | 'narrative';
-export type ArtifactType = 'decision' | 'prompt' | 'machine-output' | 'narrative';
-export interface ArtifactWriterOptions {
-    readonly projectRoot: string;
-    /** ISO date (YYYY-MM-DD). Defaults to today (UTC). */
-    readonly date?: string;
-    /** Optional request id, used to disambiguate multiple artifacts on the same day. */
-    readonly rid?: string;
-    /** Override the auto-derived slug. Must be filename-safe (caller's responsibility). */
-    readonly slugOverride?: string;
-    /** Skip writing the file — used by tests + --dry-run. */
-    readonly dryRun?: boolean;
-}
-export interface ArtifactWriteRecord {
-    readonly kind: ArtifactKind;
-    readonly slug: string;
-    readonly title: string;
-    readonly date: string;
-    readonly filePath: string;
-    readonly memoryDir: string;
-    readonly indexPath: string;
-    readonly indexSynced: boolean;
-}
-export declare function writeDecision(audit: RedLineAudit, options: ArtifactWriterOptions): ArtifactWriteRecord;
-export interface PromptInput {
-    readonly name: string;
-    readonly description: string;
-    readonly body: string;
-}
-export declare function writePrompt(input: PromptInput, options: ArtifactWriterOptions): ArtifactWriteRecord;
-export interface MachineOutputInput {
-    readonly name: string;
-    readonly description: string;
-    /** JSON string OR { path } to a JSON file on disk. */
-    readonly json: string | {
-        path: string;
-    };
-}
-export declare function writeMachineOutput(input: MachineOutputInput, options: ArtifactWriterOptions): ArtifactWriteRecord;
-export interface NarrativeInput {
-    readonly name: string;
-    readonly description: string;
-    readonly body: string;
-}
-export declare function writeNarrative(input: NarrativeInput, options: ArtifactWriterOptions): ArtifactWriteRecord;

package/dist/src/services/audit/artifact-writer.js

@@ -1,303 +0,0 @@
-/**
- * Audit artifact writer — Slice 2026-06-26-audit-artifact-writer-generalization.
- *
- * Generalizes the original `decision-writer.ts` (which only knew how to
- * persist a `RedLineAudit` snapshot) into a polymorphic writer that
- * handles the 4 artifact types produced during a peaks-loop audit:
- *
- *   1. **decision**      — `RedLineAudit` snapshot             → audit-decisions/<slug>.md
- *   2. **prompt**        — methodology input (LLM-facing text) → audit-prompts/<slug>.md
- *   3. **machine-output** — JSON audit result                  → audit-<date>-<slug>.md (envelope)
- *   4. **narrative**     — free-form prose report              → <slug>.md (top level)
- *
- * Each writer enforces canonical frontmatter (`name` / `description` /
- * `metadata.type` ∈ ProjectMemoryKind / `metadata.artifactType`) so the
- * `.peaks/memory/` shape stays compliant with `memory-shape-guard.test.ts`.
- *
- * Back-compat: `writeAuditDecision` in `decision-writer.ts` re-exports
- * `writeDecision` so existing callers of `peaks audit static --record`
- * keep working unchanged.
- *
- * Design notes (Karpathy #1 Think Before Coding):
- *
- *   - **Why 4 writers instead of 1 polymorphic writer?** Each artifact
- *     type has a distinct subdir + envelope semantics. A single writer
- *     with a kind-flag would need conditional logic on every field. Four
- *     named writers are 4 × ~30 lines each vs. 1 × ~150 line monolith
- *     with nested if-trees. The cost of polymorphism here is lower
- *     clarity; the cost of 4 small writers is one extra import line at
- *     the call site.
- *
- *   - **Why a strict frontmatter contract on every writer?** The memory
- *     parser (`parseStoredMemoryFile` in `project-memory-service.ts`)
- *     silently ignores unknown frontmatter keys. Adding `metadata.artifactType`
- *     is therefore safe — it's additive, never breaks existing readers.
- *     But adding it consistently across all 4 writers means new files
- *     can be queried by artifactType in future tooling.
- *
- *   - **Why JSON envelope for machine-output?** Raw `.json` files at the
- *     top of `.peaks/memory/` are forbidden by the memory-shape guard.
- *     Wrapping JSON in a `.md` envelope (fenced ```json block) keeps
- *     the original bytes byte-for-byte intact while restoring compliance.
- *     The envelope also adds a human-readable H1 + summary table.
- *
- *   - **Out of scope:** index.json generation, warm-layer extraction, hot
- *     layer routing — the existing memory service handles those. We only
- *     write files; the service indexes them on next read.
- */
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { readMemoryIndex } from '../memory/project-memory-service.js';
-import { renderDecisionMarkdown } from './decision-writer.js';
-// ---------------------------------------------------------------------------
-// Private helpers (shared across the 4 writers)
-// ---------------------------------------------------------------------------
-function defaultDate() {
-    return new Date().toISOString().slice(0, 10);
-}
-function sanitizeDate(date) {
-    if (date === undefined)
-        return defaultDate();
-    if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) {
-        throw new Error(`Invalid date "${date}": must be YYYY-MM-DD format`);
-    }
-    return date;
-}
-/** Strip everything outside `[A-Za-z0-9-]` and cap length so the slug
- *  stays filename-safe regardless of the user's `--rid` input. */
-function sanitizeRid(rid) {
-    if (!rid)
-        return '';
-    const cleaned = rid.replace(/[^A-Za-z0-9-]/g, '');
-    return cleaned.length > 0 ? cleaned.slice(0, 64) : '';
-}
-function buildSlug(prefix, date, rid, override) {
-    if (override)
-        return override;
-    const safe = sanitizeRid(rid);
-    return safe ? `${prefix}-${date}-${safe}` : `${prefix}-${date}`;
-}
-function buildFrontmatter(args) {
-    const lines = ['---', `name: ${args.name}`, `description: ${args.description}`, 'metadata:'];
-    lines.push(`  type: ${args.kind}`);
-    lines.push(`  artifactType: ${args.extras.artifactType}`);
-    lines.push(`  sourceArtifact: ${args.extras.sourceArtifact}`);
-    lines.push(`  createdAt: ${args.extras.createdAt}`);
-    if (args.extras.extra) {
-        for (const [key, value] of Object.entries(args.extras.extra)) {
-            lines.push(`  ${key}: ${value}`);
-        }
-    }
-    lines.push('---');
-    return lines.join('\n');
-}
-function readInputContent(input) {
-    if (typeof input === 'string')
-        return input;
-    return readFileSync(input.path, 'utf8');
-}
-// ---------------------------------------------------------------------------
-// Subdir routing (single source of truth for "where does each kind go?")
-// ---------------------------------------------------------------------------
-const KIND_TO_SUBDIR = {
-    decision: 'audit-decisions',
-    prompt: 'audit-prompts',
-    'machine-output': null, // top-level (no subdir)
-    narrative: null, // top-level (no subdir)
-};
-const KIND_TO_SLUG_PREFIX = {
-    decision: 'audit-decision',
-    prompt: 'audit-prompt',
-    'machine-output': 'audit-output',
-    narrative: 'audit-narrative',
-};
-function resolvePath(args) {
-    const memoryDir = join(args.projectRoot, '.peaks', 'memory');
-    const subdir = KIND_TO_SUBDIR[args.kind];
-    const targetDir = subdir === null ? memoryDir : join(memoryDir, subdir);
-    return {
-        memoryDir,
-        filePath: join(targetDir, `${args.slug}.md`),
-    };
-}
-// ---------------------------------------------------------------------------
-// Writer 1: decision (back-compat with original decision-writer)
-// ---------------------------------------------------------------------------
-export function writeDecision(audit, options) {
-    const date = sanitizeDate(options.date);
-    const slug = buildSlug(KIND_TO_SLUG_PREFIX.decision, date, options.rid, options.slugOverride);
-    const { memoryDir, filePath } = resolvePath({
-        projectRoot: options.projectRoot,
-        kind: 'decision',
-        slug,
-        date,
-    });
-    const description = `Audit Decision ${date}${options.rid ? ` (${options.rid})` : ''}`;
-    const renderOpts = options.rid ? { date, rid: options.rid } : { date };
-    const markdown = renderDecisionMarkdown(audit, renderOpts);
-    if (!options.dryRun) {
-        mkdirSync(join(options.projectRoot, '.peaks', 'memory', KIND_TO_SUBDIR.decision ?? ''), {
-            recursive: true,
-        });
-        writeFileSync(filePath, markdown, { mode: 0o644 });
-    }
-    const index = readMemoryIndex(options.projectRoot);
-    const indexPath = join(memoryDir, 'index.json');
-    return {
-        kind: 'decision',
-        slug,
-        title: `Audit Decision ${date}${options.rid ? ` (${options.rid})` : ''}`,
-        date,
-        filePath,
-        memoryDir,
-        indexPath,
-        indexSynced: index !== null,
-    };
-}
-export function writePrompt(input, options) {
-    const date = sanitizeDate(options.date);
-    const slug = buildSlug(KIND_TO_SLUG_PREFIX.prompt, date, options.rid, options.slugOverride);
-    const { memoryDir, filePath } = resolvePath({
-        projectRoot: options.projectRoot,
-        kind: 'prompt',
-        slug,
-        date,
-    });
-    const frontmatter = buildFrontmatter({
-        name: slug,
-        description: input.description,
-        kind: 'reference',
-        extras: {
-            sourceArtifact: 'peaks audit artifact write --kind prompt',
-            createdAt: date,
-            artifactType: 'prompt',
-        },
-    });
-    const markdown = `${frontmatter}\n\n# ${input.name}\n\n${input.body}\n`;
-    if (!options.dryRun) {
-        mkdirSync(join(options.projectRoot, '.peaks', 'memory', KIND_TO_SUBDIR.prompt ?? ''), {
-            recursive: true,
-        });
-        writeFileSync(filePath, markdown, { mode: 0o644 });
-    }
-    const index = readMemoryIndex(options.projectRoot);
-    const indexPath = join(memoryDir, 'index.json');
-    return {
-        kind: 'prompt',
-        slug,
-        title: input.name,
-        date,
-        filePath,
-        memoryDir,
-        indexPath,
-        indexSynced: index !== null,
-    };
-}
-export function writeMachineOutput(input, options) {
-    const date = sanitizeDate(options.date);
-    const slug = buildSlug(KIND_TO_SLUG_PREFIX['machine-output'], date, options.rid, options.slugOverride);
-    const { memoryDir, filePath } = resolvePath({
-        projectRoot: options.projectRoot,
-        kind: 'machine-output',
-        slug,
-        date,
-    });
-    const rawJson = readInputContent(input.json);
-    // Validate that it's at least JSON-parseable; if not, fail loud.
-    try {
-        JSON.parse(rawJson);
-    }
-    catch (err) {
-        throw new Error(`writeMachineOutput: input.json is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    const frontmatter = buildFrontmatter({
-        name: slug,
-        description: input.description,
-        kind: 'project',
-        extras: {
-            sourceArtifact: 'peaks audit artifact write --kind machine-output',
-            createdAt: date,
-            artifactType: 'machine-output',
-        },
-    });
-    const title = input.name;
-    const summaryTable = [
-        '| Field | Value |',
-        '| --- | --- |',
-        `| Artifact kind | machine-output |`,
-        `| JSON bytes | ${rawJson.length} |`,
-        `| Captured at | ${date} |`,
-    ].join('\n');
-    const body = [
-        `# ${title}`,
-        '',
-        input.description,
-        '',
-        '## Summary',
-        '',
-        summaryTable,
-        '',
-        '## Raw JSON',
-        '',
-        '```json',
-        rawJson,
-        '```',
-        '',
-    ].join('\n');
-    const markdown = `${frontmatter}\n\n${body}`;
-    if (!options.dryRun) {
-        // machine-output goes to top-level (no subdir)
-        mkdirSync(memoryDir, { recursive: true });
-        writeFileSync(filePath, markdown, { mode: 0o644 });
-    }
-    const index = readMemoryIndex(options.projectRoot);
-    const indexPath = join(memoryDir, 'index.json');
-    return {
-        kind: 'machine-output',
-        slug,
-        title,
-        date,
-        filePath,
-        memoryDir,
-        indexPath,
-        indexSynced: index !== null,
-    };
-}
-export function writeNarrative(input, options) {
-    const date = sanitizeDate(options.date);
-    const slug = buildSlug(KIND_TO_SLUG_PREFIX.narrative, date, options.rid, options.slugOverride);
-    const { memoryDir, filePath } = resolvePath({
-        projectRoot: options.projectRoot,
-        kind: 'narrative',
-        slug,
-        date,
-    });
-    const frontmatter = buildFrontmatter({
-        name: slug,
-        description: input.description,
-        kind: 'project',
-        extras: {
-            sourceArtifact: 'peaks audit artifact write --kind narrative',
-            createdAt: date,
-            artifactType: 'narrative',
-        },
-    });
-    const markdown = `${frontmatter}\n\n# ${input.name}\n\n${input.body}\n`;
-    if (!options.dryRun) {
-        // narrative goes to top-level (no subdir)
-        mkdirSync(memoryDir, { recursive: true });
-        writeFileSync(filePath, markdown, { mode: 0o644 });
-    }
-    const index = readMemoryIndex(options.projectRoot);
-    const indexPath = join(memoryDir, 'index.json');
-    return {
-        kind: 'narrative',
-        slug,
-        title: input.name,
-        date,
-        filePath,
-        memoryDir,
-        indexPath,
-        indexSynced: index !== null,
-    };
-}