@tenphi/akno 0.1.0

package/dist/commands/init-prompts.js

@@ -0,0 +1,192 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+const OPERATIONAL_FOLDERS = new Set(['inbox', 'journal', 'node_modules', 'observations', 'timeline']);
+export function terminalInitPrompt(input = process.stdin, output = process.stdout) {
+    const terminal = createInterface({ input, output, terminal: true });
+    return {
+        ask: (question) => terminal.question(question),
+        say: (message) => output.write(`${message}\n`),
+        close: () => terminal.close(),
+    };
+}
+export async function collectInteractiveInitAnswers(prompt, options) {
+    prompt.say('Akno guided setup');
+    prompt.say('The recommended setup uses one OpenAI endpoint and credential with two model IDs.');
+    prompt.say('Setup writes only the machine configuration; it does not modify the knowledge base.');
+    const aknoPath = await knowledgeBasePath(prompt, options.aknoPath, options.readablePath);
+    let setup = options.setup;
+    if (!setup) {
+        prompt.say('Choose a model setup:');
+        prompt.say('  1. OpenAI minimum (recommended: embeddings + GPT-5.6 Luna)');
+        prompt.say('  2. No models (lexical retrieval; no content is sent to a model)');
+        prompt.say('  3. Specialist/manual roles (preserve them and configure the model blocks yourself)');
+        const selected = await choice(prompt, 'Model setup [1]: ', ['1', '2', '3'], '1');
+        setup = selected === '1' ? 'openai-luna' : selected === '2' ? 'no-model' : 'manual';
+    }
+    let maintenance;
+    if (options.maintenance) {
+        maintenance = options.maintenance;
+    }
+    else {
+        prompt.say('How will this memory be used?');
+        prompt.say('  1. Connected to a trusted agent (recommended: autonomous maintenance)');
+        prompt.say('  2. Standalone or human-reviewed (recommended: review maintenance)');
+        prompt.say('  3. Read-only evaluation (recommended: audit maintenance)');
+        const usage = await choice(prompt, 'Usage [1]: ', ['1', '2', '3'], '1');
+        const recommended = usage === '1' ? 'autonomous' : usage === '2' ? 'review' : 'audit';
+        maintenance = await choice(prompt, `Maintenance profile [${recommended}]: `, ['audit', 'review', 'autonomous'], recommended);
+    }
+    const folderSetup = await collectInteractiveFolderSetup(prompt, {
+        aknoPath,
+        maintenance,
+        configExists: options.configExists ?? false,
+    });
+    return { aknoPath, setup, maintenance, ...(folderSetup ? { folderSetup } : {}) };
+}
+/**
+ * Make fact-injection authority an explicit setup choice. Discovery reads only immediate directory names;
+ * it does not inspect page text, and setup writes only the machine configuration.
+ */
+export async function collectInteractiveFolderSetup(prompt, options) {
+    if (options.configExists &&
+        !(await confirmInitAction(prompt, 'Review folder write boundaries and remember fallback now?', false))) {
+        return undefined;
+    }
+    const folders = discoverSetupFolders(options.aknoPath);
+    prompt.say('Choose where remembered facts may be written. Setup reads folder names only.');
+    if (folders.length > 0) {
+        prompt.say('Top-level folders:');
+        folders.forEach((folder, index) => prompt.say(`  ${index + 1}. ${folder}/`));
+        prompt.say('Unselected folders become searchable read-only knowledge; their files stay intact.');
+    }
+    else {
+        prompt.say('No classifiable top-level folders were found; existing and future folders remain read-only.');
+    }
+    const managed = folders.length > 0
+        ? await folderSelection(prompt, 'Managed-memory folders (numbers; blank = none): ', folders)
+        : new Set();
+    const source = folders.length > 0
+        ? await folderSelection(prompt, 'Source/reference folders (remaining numbers; blank = none): ', folders, managed)
+        : new Set();
+    const rules = {};
+    const counts = { managed: 0, readOnly: 0, source: 0 };
+    folders.forEach((folder, index) => {
+        const key = `${folder}/**`;
+        if (managed.has(index)) {
+            rules[key] = { role: 'knowledge', remember: 'integrate' };
+            counts.managed++;
+        }
+        else if (source.has(index)) {
+            rules[key] = { role: 'source', remember: 'deny' };
+            counts.source++;
+        }
+        else {
+            rules[key] = { role: 'knowledge', remember: 'deny' };
+            counts.readOnly++;
+        }
+    });
+    prompt.say('A remember fallback is a last-resort managed page. It is used only after normal routing and cannot make other folders writable.');
+    const useFallback = await confirmInitAction(prompt, 'Configure a managed fallback page?', options.maintenance === 'autonomous');
+    if (!useFallback)
+        return { rules, fallbackPage: null, counts };
+    const fallbackPage = await fallbackPagePrompt(prompt);
+    const parent = fallbackPage.slice(0, fallbackPage.lastIndexOf('/'));
+    const parentGlob = `${parent}/**`;
+    const parentRule = rules[parentGlob];
+    if (!parentRule || parentRule.remember !== 'integrate') {
+        rules[parentGlob] = { role: 'knowledge', remember: 'integrate' };
+        counts.managed++;
+        if (parentRule?.role === 'source')
+            counts.source--;
+        else if (parentRule)
+            counts.readOnly--;
+        prompt.say(`${parent}/ is now an explicit managed-memory namespace for that fallback.`);
+    }
+    return { rules, fallbackPage, counts };
+}
+export async function confirmInitAction(prompt, question, defaultValue) {
+    const suffix = defaultValue ? ' [Y/n]: ' : ' [y/N]: ';
+    while (true) {
+        const answer = (await prompt.ask(`${question}${suffix}`)).trim().toLowerCase();
+        if (!answer)
+            return defaultValue;
+        if (answer === 'y' || answer === 'yes')
+            return true;
+        if (answer === 'n' || answer === 'no')
+            return false;
+        prompt.say('Enter yes or no.');
+    }
+}
+async function knowledgeBasePath(prompt, initialValue, readablePath) {
+    let candidate = initialValue?.trim() ?? '';
+    while (true) {
+        if (!candidate)
+            candidate = (await prompt.ask('Knowledge-base folder: ')).trim();
+        if (candidate && readablePath(candidate))
+            return candidate;
+        prompt.say(candidate ? `Folder is not readable: ${candidate}` : 'A knowledge-base folder is required.');
+        candidate = '';
+    }
+}
+async function choice(prompt, question, allowed, defaultValue) {
+    while (true) {
+        const answer = (await prompt.ask(question)).trim().toLowerCase();
+        if (!answer)
+            return defaultValue;
+        const selected = allowed.find((value) => value === answer);
+        if (selected)
+            return selected;
+        prompt.say(`Choose one of: ${allowed.join(', ')}.`);
+    }
+}
+/** Immediate visible directories only; hidden and Akno-owned operational paths are not policy candidates. */
+export function discoverSetupFolders(aknoPath) {
+    return fs
+        .readdirSync(aknoPath, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() &&
+        !entry.name.startsWith('.') &&
+        !OPERATIONAL_FOLDERS.has(entry.name.toLowerCase()))
+        .map((entry) => entry.name)
+        .sort((left, right) => left.localeCompare(right));
+}
+async function folderSelection(prompt, question, folders, unavailable = new Set()) {
+    while (true) {
+        const answer = (await prompt.ask(question)).trim().toLowerCase();
+        if (!answer || answer === 'none')
+            return new Set();
+        const values = answer === 'all'
+            ? folders.flatMap((_, index) => (unavailable.has(index) ? [] : [index + 1]))
+            : answer.split(',').map(Number);
+        const invalid = values.some((value) => !Number.isInteger(value) || value < 1 || value > folders.length || unavailable.has(value - 1));
+        if (!invalid)
+            return new Set(values.map((value) => value - 1));
+        prompt.say(unavailable.size > 0
+            ? 'Choose comma-separated remaining folder numbers, all, or none.'
+            : 'Choose comma-separated folder numbers, all, or none.');
+    }
+}
+async function fallbackPagePrompt(prompt) {
+    while (true) {
+        const answer = (await prompt.ask('Fallback page [memory/inbox]: ')).trim();
+        const value = answer || 'memory/inbox';
+        if (safeFallbackPage(value))
+            return value;
+        prompt.say('Use a relative page slug inside a folder, without an extension or dot segments.');
+    }
+}
+function safeFallbackPage(value) {
+    const segments = value.split('/');
+    return (value === value.trim() &&
+        value.includes('/') &&
+        !path.isAbsolute(value) &&
+        !value.startsWith('~') &&
+        !/^[a-zA-Z]:/.test(value) &&
+        !/\.(?:md|markdown)$/i.test(value) &&
+        !value.includes('\\') &&
+        !value.includes('\0') &&
+        value.length <= 512 &&
+        segments.every((segment) => segment.length > 0 && !segment.startsWith('.')) &&
+        !OPERATIONAL_FOLDERS.has(segments[0].toLowerCase()));
+}
+//# sourceMappingURL=init-prompts.js.map

package/dist/commands/init-prompts.js.map

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

package/dist/commands/list-cmd.d.ts

@@ -0,0 +1,2 @@
+export declare function listCommand(argv: string[]): Promise<number>;
+//# sourceMappingURL=list-cmd.d.ts.map

package/dist/commands/list-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/list-cmd.ts"],"names":[],"mappings":"AAkBA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA8EjE"}

package/dist/commands/list-cmd.js

@@ -0,0 +1,77 @@
+import { openOptionsFrom, parse } from "../args.js";
+import { heading, json, line, style, truncate } from "../output.js";
+import { resolveOps } from "../ops-handle.js";
+const LIST_HELP = `akno list [options]
+
+  Browse structure. Folders by default; pages when a filter is given.
+
+  --kind <k>          folders | pages | tree
+  --folder <path>     Scope to a folder.
+  --type <t>          Filter pages by frontmatter type.
+  --tag <t>           Filter pages by tag.
+  --role <r>          knowledge | source | inference | ignored
+  --order <o>         recent | slug | size
+  --depth <n>         Tree depth.
+  --limit <n>
+  --json`;
+export async function listCommand(argv) {
+    const { values } = parse(argv, {
+        kind: { type: 'string' },
+        folder: { type: 'string' },
+        type: { type: 'string' },
+        tag: { type: 'string' },
+        role: { type: 'string' },
+        order: { type: 'string' },
+        depth: { type: 'string' },
+        limit: { type: 'string' },
+    });
+    if (values.help) {
+        line(LIST_HELP);
+        return 0;
+    }
+    const handle = await resolveOps(values, openOptionsFrom(values));
+    try {
+        const result = await handle.ops.list({
+            ...(values.kind ? { kind: values.kind } : {}),
+            ...(values.folder ? { folder: values.folder } : {}),
+            ...(values.type ? { type: values.type } : {}),
+            ...(values.tag ? { tag: values.tag } : {}),
+            ...(values.role ? { role: values.role } : {}),
+            ...(values.order ? { order: values.order } : {}),
+            ...(values.depth ? { depth: Number(values.depth) } : {}),
+            ...(values.limit ? { limit: Number(values.limit) } : {}),
+        });
+        if (values.json) {
+            json(result);
+            return 0;
+        }
+        if (result.tree) {
+            line(result.tree);
+            return 0;
+        }
+        if (result.folders) {
+            heading(`${result.total} folder${result.total === 1 ? '' : 's'}`);
+            const width = Math.max(8, ...result.folders.map((f) => f.path.length));
+            for (const folder of result.folders) {
+                const rule = folder.rule ? style.grey(`  ${folder.rule.role ?? ''} ← ${folder.rule.source}`) : '';
+                line(`  ${folder.path.padEnd(width)}  ${style.grey(`${folder.pages_deep} pages`)}` +
+                    `${folder.folders > 0 ? style.grey(`, ${folder.folders} folders`) : ''}${rule}`);
+            }
+            return 0;
+        }
+        const pages = result.pages ?? [];
+        heading(`${result.total} page${result.total === 1 ? '' : 's'}${pages.length < result.total ? ` (showing ${pages.length})` : ''}`);
+        const width = Math.max(8, ...pages.map((p) => p.slug.length));
+        for (const page of pages) {
+            line(`  ${page.slug.padEnd(width)}  ${style.grey(page.role.padEnd(9))}` +
+                `${style.grey((page.updated ?? '').padEnd(11))}${truncate(page.summary ?? page.title, 70)}`);
+        }
+        if (result.status === 'empty')
+            line(style.yellow('  nothing matched'));
+        return 0;
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=list-cmd.js.map

package/dist/commands/list-cmd.js.map

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

package/dist/commands/maintenance-policy-output.d.ts

@@ -0,0 +1,4 @@
+import type { MaintenancePathPolicy } from '@tenphi/akno-core';
+/** Human view of the same typed explanation returned by --json and the service. */
+export declare function printMaintenancePathPolicy(policy: MaintenancePathPolicy): void;
+//# sourceMappingURL=maintenance-policy-output.d.ts.map

package/dist/commands/maintenance-policy-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-policy-output.d.ts","sourceRoot":"","sources":["../../src/commands/maintenance-policy-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAkC,MAAM,mBAAmB,CAAC;AAG/F,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAyC9E"}

package/dist/commands/maintenance-policy-output.js

@@ -0,0 +1,72 @@
+import { heading, kv, line, style } from "../output.js";
+/** Human view of the same typed explanation returned by --json and the service. */
+export function printMaintenancePathPolicy(policy) {
+    heading(`Maintenance policy — ${policy.slug}`);
+    kv([
+        ['profile', policy.profile],
+        ['run ceiling', policy.runMode],
+        ['path state', policy.state.replaceAll('_', ' ')],
+        ['page role', `${policy.page.role} (${policy.page.roleSource.replaceAll('_', ' ')})`],
+        ['dream opt-in', `${policy.page.dream} (${policy.page.dreamSource})`],
+        ['remember', `${policy.page.remember} (${policy.page.rememberSource.replaceAll('_', ' ')})`],
+        ['reserved', policy.page.reserved ? 'yes' : 'no'],
+        [
+            'maintenance model',
+            policy.maintenanceModel.configured
+                ? `${policy.maintenanceModel.id ?? 'configured'} (configured; health not probed)`
+                : 'not configured',
+        ],
+    ]);
+    line('\n  page-targeted transformations');
+    const width = Math.max(...policy.transformations.map((entry) => entry.kind.length));
+    for (const entry of policy.transformations)
+        printTransform(entry, width);
+    line('\n  path-independent transformations');
+    for (const entry of policy.pathIndependent) {
+        const enabled = entry.enabled && entry.policy !== 'off';
+        line(`    ${entry.kind.padEnd(width)}  ${enabled ? entry.policy : 'off'}  ${style.grey(entry.reason)}`);
+    }
+    line('\n  whole-run apply limits');
+    kv([
+        ['items', policy.limits.maxItems],
+        ['changed files', policy.limits.maxFilesChanged],
+        ['written bytes', policy.limits.maxBytesWritten],
+        ['high-risk items', policy.limits.maxHighRiskItems],
+    ], '    ');
+    line(`\n  ${style.grey('still required for any proposal:')}`);
+    for (const check of policy.remainingChecks)
+        line(`    ${style.grey(`• ${check}`)}`);
+}
+function printTransform(entry, width) {
+    const outcome = outcomeLabel(entry);
+    const color = entry.outcome === 'curator_then_apply'
+        ? style.green
+        : entry.outcome === 'awaiting_human' || entry.outcome === 'audit_only'
+            ? style.cyan
+            : entry.outcome === 'apply_blocked'
+                ? style.yellow
+                : style.grey;
+    line(`    ${entry.kind.padEnd(width)}  ${entry.effectivePolicy.padEnd(6)}  ${color(outcome)}`);
+    for (const blocker of entry.blockers)
+        line(`      ${style.grey(`blocked: ${blocker.message}`)}`);
+    for (const blocker of entry.applyBlockers) {
+        line(`      ${style.grey(`apply blocked: ${blocker.message}`)}`);
+    }
+}
+function outcomeLabel(entry) {
+    switch (entry.outcome) {
+        case 'off':
+            return 'not inspected';
+        case 'ineligible':
+            return 'not eligible';
+        case 'audit_only':
+            return 'plan and report only';
+        case 'awaiting_human':
+            return 'plan, then wait for human approval';
+        case 'curator_then_apply':
+            return 'plan, independent curator, verified apply';
+        case 'apply_blocked':
+            return 'plan, but automatic apply is currently blocked';
+    }
+}
+//# sourceMappingURL=maintenance-policy-output.js.map

package/dist/commands/maintenance-policy-output.js.map

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

package/dist/commands/mutate-cmd.d.ts

@@ -0,0 +1,5 @@
+export declare function forgetCommand(argv: string[]): Promise<number>;
+export declare function undoCommand(argv: string[]): Promise<number>;
+export declare function moveCommand(argv: string[]): Promise<number>;
+export declare function approveCommand(argv: string[], decline?: boolean): Promise<number>;
+//# sourceMappingURL=mutate-cmd.d.ts.map

package/dist/commands/mutate-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/mutate-cmd.ts"],"names":[],"mappings":"AAiBA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCnE;AAYD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDjE;AAaD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BjE;AAoBD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ErF"}

package/dist/commands/mutate-cmd.js

@@ -0,0 +1,224 @@
+import { openOptionsFrom, parse } from "../args.js";
+import { heading, json, kv, line, statusLabel, style, truncate } from "../output.js";
+import { printWriteOutcome } from "./write-cmd.js";
+import { resolveOps, runMaintenance } from "../ops-handle.js";
+const FORGET_HELP = `akno forget <--fact <id> | --slug <slug> | --document <id>>
+
+  Retract a fact by removing the sentence that produced it, or move a page or a
+  document to trash. Always journalled, always reversible with undo for the
+  retention window.
+
+  Removing a fact removes a line from a file. Expiring a row while the sentence
+  stays would mean forgetting it today and reading it again tomorrow.
+
+  --actor <who>   user | agent
+  --json`;
+export async function forgetCommand(argv) {
+    const { values } = parse(argv, {
+        fact: { type: 'string' },
+        slug: { type: 'string' },
+        document: { type: 'string' },
+        actor: { type: 'string' },
+    });
+    if (values.help || [values.fact, values.slug, values.document].filter(Boolean).length !== 1) {
+        line(FORGET_HELP);
+        return values.help ? 0 : 1;
+    }
+    const handle = await resolveOps(values, openOptionsFrom(values), {
+        write: true,
+        ...(values.actor === 'user' || values.actor === 'agent' ? { actor: values.actor } : {}),
+    });
+    try {
+        const result = await handle.ops.forget({
+            ...(values.fact ? { fact: values.fact } : {}),
+            ...(values.slug ? { slug: values.slug } : {}),
+            ...(values.document ? { document: values.document } : {}),
+        });
+        if (values.json) {
+            json(result);
+            return 0;
+        }
+        line(`${statusLabel(result.status)} ${style.grey(`change ${result.change_id}`)}`);
+        kv([
+            ['from', result.removed_from],
+            ['removed', result.removed ? truncate(result.removed, 84) : null],
+            ['trashed to', result.trashed],
+        ]);
+        line(`\n  ${style.grey(`reverse with`)} ${style.bold(`akno undo ${result.change_id}`)}`);
+        return 0;
+    }
+    finally {
+        await handle.close();
+    }
+}
+const UNDO_HELP = `akno undo <change_id>
+akno undo --list
+
+  Reverse a change. The id outlives the session, the process, and a full rebuild of
+  every table except the journal — which holds the previous bytes rather than a
+  pointer to them.
+
+  --list          Recent changes, newest first.
+  --json`;
+export async function undoCommand(argv) {
+    const { values, positionals } = parse(argv, {
+        list: { type: 'boolean', default: false },
+        limit: { type: 'string' },
+    });
+    if (values.help || (!values.list && positionals.length === 0)) {
+        line(UNDO_HELP);
+        return values.help ? 0 : 1;
+    }
+    if (values.list) {
+        // `changes` is not an op — an agent has no business reading the journal — so it travels on the
+        // command channel, which is also how it reaches a running service instead of failing beside it.
+        const changes = await runMaintenance('changes', { limit: values.limit ? Number(values.limit) : 20 }, values, openOptionsFrom(values), async (akno) => akno.changes(values.limit ? Number(values.limit) : 20), { writable: false });
+        {
+            if (values.json) {
+                json(changes);
+                return 0;
+            }
+            heading(`${changes.length} change${changes.length === 1 ? '' : 's'}`);
+            for (const change of changes) {
+                const state = change.status === 'undone' ? style.grey('undone ') : style.green('applied');
+                line(`  ${style.bold(change.id)}  ${state}  ${change.at.slice(0, 19).replace('T', ' ')}  ${change.summary}`);
+                line(style.grey(`    ${change.actor}/${change.op}  ${change.files.map((f) => `${f.action} ${f.relPath}`).join(', ')}`));
+            }
+            return 0;
+        }
+    }
+    const handle = await resolveOps(values, openOptionsFrom(values), { write: true });
+    try {
+        const result = await handle.ops.undo({ change_id: positionals[0] });
+        if (values.json) {
+            json(result);
+            return 0;
+        }
+        line(`${statusLabel(result.status)} reversed ${style.bold(result.reversed ?? '')}`);
+        for (const file of result.restored ?? [])
+            line(`  ${style.green('restored')}  ${file}`);
+        for (const file of result.removed ?? [])
+            line(`  ${style.yellow('removed ')}  ${file}`);
+        return 0;
+    }
+    finally {
+        await handle.close();
+    }
+}
+const MOVE_HELP = `akno move <from> <to>
+
+  Relocate a page with its documents, rewriting the page's own embeds. Inbound
+  links from other pages are reported, never rewritten — editing half a dozen
+  other pages is a bigger change than the one you asked for.
+
+  The page keeps its id, so facts, events and journal history stay attached.
+
+  --actor <who>   user | agent
+  --json`;
+export async function moveCommand(argv) {
+    const { values, positionals } = parse(argv, { actor: { type: 'string' } });
+    if (values.help || positionals.length !== 2) {
+        line(MOVE_HELP);
+        return values.help ? 0 : 1;
+    }
+    const handle = await resolveOps(values, openOptionsFrom(values), {
+        write: true,
+        ...(values.actor === 'user' || values.actor === 'agent' ? { actor: values.actor } : {}),
+    });
+    try {
+        const result = await handle.ops.move({ from: positionals[0], to: positionals[1] });
+        if (values.json) {
+            json(result);
+            return result.outcome === 'ok' ? 0 : 2;
+        }
+        if (result.outcome === 'requires_folder')
+            return printWriteOutcome(result);
+        line(`${statusLabel(result.status)} ${style.grey(`change ${result.change_id}`)}`);
+        for (const file of result.moved ?? [])
+            line(`  ${style.green('moved')}  ${file}`);
+        for (const slug of result.broken_inbound ?? []) {
+            line(`  ${style.yellow('still links to the old slug')}  ${slug}`);
+        }
+        if (result.note)
+            line(style.grey(`\n  ${result.note}`));
+        return 0;
+    }
+    finally {
+        await handle.close();
+    }
+}
+const APPROVE_HELP = `akno approve <proposal_id> [--slug <page>]
+akno approve --list
+akno decline <proposal_id>
+
+  Resolve a gated proposal. Approving applies the write that was held with it, so
+  the caller does not have to repeat it.
+
+  --slug <page>   Where to write it. Required for a \`route\` proposal, which exists
+                  because nothing scored high enough to choose a page — "approved"
+                  with no destination is not an answer to that question. \`--list\`
+                  shows the nearest candidates; naming a page that does not exist
+                  yet creates it, which is often the right answer.
+
+  A declined proposal is remembered: an agent that asks for the same folder again
+  gets the refusal back instead of a second question.
+
+  --json`;
+export async function approveCommand(argv, decline = false) {
+    const { values, positionals } = parse(argv, {
+        list: { type: 'boolean', default: false },
+        slug: { type: 'string' },
+    });
+    if (values.help || (!values.list && positionals.length === 0)) {
+        line(APPROVE_HELP);
+        return values.help ? 0 : 1;
+    }
+    // Approving is the user speaking, by definition — it is the answer to a gate that only exists for
+    // agents. It travels on the command channel rather than the op surface for the same reason: an
+    // agent that could call `approve` could wave through its own gated proposal.
+    if (values.list) {
+        const pending = await runMaintenance('proposals', {}, values, openOptionsFrom(values), async (akno) => akno.proposals(), { writable: false });
+        {
+            if (values.json) {
+                json(pending);
+                return 0;
+            }
+            if (pending.length === 0) {
+                line(style.grey('nothing waiting'));
+                return 0;
+            }
+            heading(`${pending.length} waiting`);
+            for (const proposal of pending) {
+                line(`  ${style.bold(proposal.id)}  ${style.grey(proposal.kind)}  ${proposal.reason}`);
+                const nearest = JSON.parse(proposal.nearest);
+                if (nearest.length > 0)
+                    line(style.grey(`    could go instead: ${nearest.join(', ')}`));
+            }
+            return 0;
+        }
+    }
+    {
+        if (decline) {
+            const result = await runMaintenance('decline', { proposal_id: positionals[0] }, values, openOptionsFrom(values), async (akno) => akno.decline(positionals[0]));
+            if (values.json) {
+                json(result);
+                return 0;
+            }
+            line(`${statusLabel('ok')} declined ${style.grey(result.subject)}`);
+            line(style.grey('  remembered, so an agent asking again gets the refusal rather than a second question'));
+            return 0;
+        }
+        const result = await runMaintenance('approve', { proposal_id: positionals[0], ...(values.slug ? { slug: values.slug } : {}) }, values, openOptionsFrom(values), async (akno) => akno.approve(positionals[0], values.slug ? { slug: values.slug } : {}));
+        if (values.json) {
+            json(result);
+            return 0;
+        }
+        line(`${statusLabel('ok')} approved ${style.grey(result.subject)}`);
+        // The write that was held with the proposal has just run, so report it the
+        // same way `akno write` would.
+        if (result.write)
+            return printWriteOutcome(result.write);
+        return 0;
+    }
+}
+//# sourceMappingURL=mutate-cmd.js.map