@tenphi/akno 0.1.0

package/dist/commands/recall-cmd.js

@@ -0,0 +1,176 @@
+import { openOptionsFrom, parse } from "../args.js";
+import { heading, json, line, statusLabel, style, truncate } from "../output.js";
+import { resolveOps } from "../ops-handle.js";
+const RECALL_HELP = `akno recall <query> [options]
+
+  Search memory. Returns cited page and standalone document results.
+
+  --mode <m>          lookup | question | explore. Inferred from the query by
+                      default; passing it explicitly always wins.
+  --depth <d>         summary | lines | full
+  --limit <n>         Maximum results.
+  --budget <n>        Token budget for the whole response.
+  --include <r,...>   Page roles to include, e.g. source. With --depth full
+                      this lifts the source quote cap.
+  --folder <path>     Restrict to a folder.
+  --type <t>          Restrict to a frontmatter type.
+  --tag <t,...>       Restrict to pages carrying all of these tags.
+  --source <s>        page | document | both
+  --ownership <o>     orphan | owned | any
+  --no-expand         Search the exact words given; useful for filenames.
+  --no-graph          Disable bounded graph-assisted candidate discovery.
+  --json              Machine-readable response.`;
+export async function recallCommand(argv) {
+    const { values, positionals } = parse(argv, {
+        mode: { type: 'string' },
+        depth: { type: 'string' },
+        limit: { type: 'string' },
+        budget: { type: 'string' },
+        include: { type: 'string' },
+        folder: { type: 'string' },
+        type: { type: 'string' },
+        tag: { type: 'string' },
+        source: { type: 'string' },
+        ownership: { type: 'string' },
+        expand: { type: 'boolean', default: true },
+        graph: { type: 'boolean', default: true },
+    });
+    if (values.help || positionals.length === 0) {
+        line(RECALL_HELP);
+        return values.help ? 0 : 1;
+    }
+    const query = positionals.join(' ');
+    const handle = await resolveOps(values, openOptionsFrom(values));
+    try {
+        const filter = {
+            ...(values.folder ? { folder: values.folder } : {}),
+            ...(values.type ? { type: values.type } : {}),
+            ...(values.tag ? { tags: values.tag.split(',').map((t) => t.trim()) } : {}),
+            ...(values.source ? { source: values.source } : {}),
+            ...(values.ownership ? { ownership: values.ownership } : {}),
+        };
+        const result = await handle.ops.recall({
+            query,
+            ...(values.mode ? { mode: values.mode } : {}),
+            ...(values.depth ? { depth: values.depth } : {}),
+            ...(values.limit ? { limit: Number(values.limit) } : {}),
+            ...(values.budget ? { budget: Number(values.budget) } : {}),
+            ...(values.include
+                ? {
+                    include: values.include.split(',').map((c) => c.trim()),
+                }
+                : {}),
+            expand: values.expand,
+            graph: values.graph,
+            ...(Object.keys(filter).length > 0 ? { filter } : {}),
+        });
+        if (values.json) {
+            json(result);
+            return 0;
+        }
+        printRecall(result);
+        return result.status === 'unavailable' ? 1 : 0;
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * The output deliberately foregrounds the three things a reader needs and a
+ * pile of ranked chunks cannot give: the status, the coverage, and a line address
+ * on every quoted line.
+ */
+function printRecall(result) {
+    line(`${statusLabel(result.status)} ${style.grey(`mode=${result.mode}`)} ` +
+        `${style.grey(`${result.results.length} result${result.results.length === 1 ? '' : 's'}`)} ` +
+        `${style.grey(`${result.budget_used} tokens`)}`);
+    if (result.degraded?.length)
+        line(style.yellow(`  degraded: ${result.degraded.join(', ')}`));
+    if (result.note)
+        line(style.grey(`  ${result.note}`));
+    if (result.coverage && Object.keys(result.coverage).length > 0) {
+        const parts = Object.entries(result.coverage).map(([concept, covered]) => covered ? style.green(`✓ ${concept}`) : style.red(`✗ ${concept}`));
+        line(`  ${style.grey('coverage')} ${parts.join('  ')}`);
+        const missing = Object.entries(result.coverage).filter(([, covered]) => !covered);
+        if (missing.length > 0) {
+            // This line is the whole point of coverage: it tells the reader what they
+            // are *not* allowed to conclude from what came back.
+            line(style.yellow(`  nothing returned covers ${missing.map(([c]) => `"${c}"`).join(', ')} — do not answer that part`));
+        }
+    }
+    for (const resultCard of result.results) {
+        if (resultCard.type === 'document') {
+            heading(`${resultCard.path} ${style.grey(`(unfiled document, ${resultCard.score.toFixed(3)})`)}`);
+            printMatchMetadata(resultCard);
+            if (resultCard.summary)
+                line(`  ${truncate(resultCard.summary, 150)}`);
+            const where = resultCard.matched_page ? `page ${resultCard.matched_page}` : 'extracted text';
+            line(`  ${style.grey(`${resultCard.source.kind} via ${resultCard.source.via}; ${where}`)}`);
+            for (const quoted of resultCard.quote?.split('\n') ?? [])
+                line(`  ${truncate(quoted, 110)}`);
+            if (resultCard.parts?.length) {
+                line(style.grey(`  parts: ${resultCard.parts.map((part) => part.path).join(', ')}`));
+            }
+            line(style.grey(`  read: akno read --document ${resultCard.id}`));
+            continue;
+        }
+        const card = resultCard;
+        heading(`${card.slug} ${style.grey(`(${card.role}, ${card.score.toFixed(3)})`)}`);
+        printMatchMetadata(card);
+        if (card.breadcrumb)
+            line(`  ${style.cyan(card.breadcrumb)}`);
+        if (card.summary)
+            line(`  ${truncate(card.summary, 150)}`);
+        for (const bodyLine of card.lines) {
+            const confidence = bodyLine.confidence !== undefined ? style.grey(` ~${bodyLine.confidence}`) : '';
+            line(`  ${style.grey(`${card.slug}:${bodyLine.n}`)}  ${truncate(bodyLine.text, 110)}${confidence}`);
+        }
+        if (card.truncated)
+            line(style.grey('  … quote window capped (source page)'));
+        for (const entry of card.superseded ?? []) {
+            line(style.yellow(`  superseded: ${truncate(entry.claim, 90)} (until ${entry.valid_to})`));
+        }
+        if (card.documents?.length) {
+            const matched = card.documents.filter((doc) => doc.quote);
+            const rest = card.documents.filter((doc) => !doc.quote);
+            // A document that matched is quoted with the page inside it, because that is the
+            // citation a reader checks. The rest are listed as what else is attached.
+            for (const doc of matched) {
+                const where = doc.matched_page ? `p${doc.matched_page}` : 'text';
+                const parts = doc.parts ? style.grey(` (${doc.parts} files, ${doc.pages ?? '?'}p)`) : '';
+                line(`  ${style.grey(`${doc.rel_path ?? doc.id} ${where}`)}${parts}`);
+                if (doc.summary)
+                    line(`    ${style.grey(truncate(doc.summary, 106))}`);
+                for (const quoted of doc.quote.split('\n'))
+                    line(`    ${truncate(quoted, 106)}`);
+            }
+            if (rest.length > 0) {
+                line(style.grey(`  documents: ${rest.map((doc) => `${doc.rel_path ?? doc.id}${doc.pages ? ` (${doc.pages}p)` : ''}`).join(', ')}`));
+            }
+        }
+        if (card.links?.length)
+            line(style.grey(`  links: ${card.links.slice(0, 8).join(', ')}`));
+    }
+    if (result.searched.length > 1 || result.results.length === 0) {
+        line(`\n${style.grey(`searched: ${result.searched.map((q) => `"${q}"`).join(', ')}`)}`);
+    }
+}
+function printMatchMetadata(result) {
+    if (result.matched_by?.length)
+        line(style.grey(`  matched: ${result.matched_by.join(' + ')}`));
+    for (const graphPath of result.graph_paths ?? []) {
+        line(style.grey(`  graph: ${formatGraphPath(graphPath)}`));
+    }
+}
+function formatGraphPath(path) {
+    const parts = [];
+    for (let index = 0; index < path.nodes.length; index++) {
+        const node = path.nodes[index];
+        parts.push(node.slug ?? node.document ?? node.label ?? node.id);
+        const relation = path.relations[index];
+        if (relation)
+            parts.push(`-${relation}->`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=recall-cmd.js.map

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

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

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

@@ -0,0 +1,43 @@
+export interface RedeployWaitPolicy {
+    fastMs: number;
+    maximumMs: number;
+}
+/** An explicit timeout is a hard operator choice; the default has a fast and slow handoff tier. */
+export declare function redeployWaitPolicy(timeoutSeconds?: string): RedeployWaitPolicy;
+/** Content-safe launchctl output parser used only after the fast socket deadline expires. */
+export declare function launchdServiceIsRunning(output: string): boolean;
+export interface SocketIdentity {
+    device: number;
+    inode: number;
+    changedAtMs: number;
+}
+/** A pre-restart listener is not evidence that the replacement is ready. */
+export declare function socketWasReplaced(previous: SocketIdentity | null, current: SocketIdentity | null): boolean;
+/**
+ * What a redeploy will actually do, before it does any of it.
+ *
+ * Split out because the interesting part of this command is a decision table, and a decision table
+ * that only exists inside a function that shells out to `pnpm` and `launchctl` is a decision table
+ * nothing checks. Two of its rows are load-bearing:
+ *
+ * - **A failed build restarts nothing.** Restarting anyway puts the *previous* code back into
+ *   service and reports success, which is worse than stopping — the deploy looks done and the
+ *   change is not there.
+ * - **No service installed is not a failure.** A checkout that talks to Akno in-process has
+ *   nothing to restart, and a launchctl error about an unfamiliar label is not an improvement on
+ *   saying so.
+ */
+export interface RedeployPlan {
+    build: boolean;
+    restart: boolean;
+    /** Why the restart is not happening, when it is not. Null when it is. */
+    skipped: 'asked' | 'not-darwin' | 'no-service' | null;
+}
+export declare function redeployPlan(input: {
+    build: boolean;
+    restart: boolean;
+    darwin: boolean;
+    serviceInstalled: boolean;
+}): RedeployPlan;
+export declare function redeployCommand(argv: string[]): Promise<number>;
+//# sourceMappingURL=redeploy-cmd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redeploy-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/redeploy-cmd.ts"],"names":[],"mappings":"AAgEA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mGAAmG;AACnG,wBAAgB,kBAAkB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAU9E;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAQ1G;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC;CACvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,GAAG,YAAY,CAKf;AAQD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+GrE"}

package/dist/commands/redeploy-cmd.js

@@ -0,0 +1,270 @@
+import fs from 'node:fs';
+import net from 'node:net';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { once } from 'node:events';
+import { AknoError } from '@tenphi/akno-protocol';
+import { openOptionsFrom, parse } from "../args.js";
+import { heading, json, kv, line, style } from "../output.js";
+/**
+ * `akno redeploy` — one command to apply local changes end-to-end.
+ *
+ * The thing to run after editing Akno, so nobody has to remember the sequence. Two steps:
+ *
+ *  1. `tsc --build`. **The service needs this too, and that is easy to get wrong.** launchd runs
+ *     `packages/cli/src/bin.ts` and Node strips the types, so the CLI's own files are live at the
+ *     next start — but everything under `packages/core` reaches it as a *package*: `serve-cmd.ts`
+ *     imports `@tenphi/akno-core`, whose `exports` field points at `dist/index.js`. So a source edit
+ *     inside core is invisible to the running service until it is built, however many times the
+ *     agent is restarted. Hosts need the build for their own reason: anything importing
+ *     `@tenphi/akno-client` imports the built JavaScript, and skipping it leaves a host calling the previous
+ *     op registry, where a new op is simply not there and the failure is `unknown op`.
+ *
+ *     This comment used to say the service did not need the build. It cost an afternoon: a fix to
+ *     `models/client.ts` was committed, the agent restarted, the identical failure reproduced, and
+ *     the code looked wrong when it was merely not loaded. `vitest` imports `./client.ts` directly,
+ *     so the tests passed throughout and proved nothing about what was running.
+ *  2. Restart the `dev.akno` launchd agent, which holds the index, the watcher and the models, and
+ *     outlives every host that talks to it. A built change reaches it only here.
+ *
+ * Then it **waits for the socket**. `launchctl kickstart` returns as soon as launchd has spawned the
+ * process, not when the process is listening — so the obvious next command fails with "no Akno
+ * service at …", which reads like a broken deploy rather than an impatient one. A normal start gets
+ * a 30-second fast path. If launchd says the replacement is still running, redeploy keeps waiting up
+ * to a bounded three minutes instead of reporting a false failure during a slow live handoff.
+ *
+ *   akno redeploy
+ *   akno redeploy --no-build     # restart only
+ *   akno redeploy --no-restart   # build only, for a host that has no service installed
+ */
+const REDEPLOY_HELP = `akno redeploy [options]
+
+  Apply local changes: build, then restart the service, then wait for its socket.
+
+  The build is not optional for the service either: launchd runs the CLI's TypeScript
+  directly, but core reaches it as @tenphi/akno-core, whose exports point at dist. A change
+  under packages/core is invisible to a restarted service until it is built.
+
+  Hosts need it for their own reason — anything importing @tenphi/akno-client imports
+  packages/*/dist, and skipping it is how a host ends up calling an op registry one
+  version behind.
+
+  --no-build          Restart only.
+  --no-restart        Build only. For a checkout with no service installed.
+  --timeout <s>       Hard socket deadline. By default wait 30s, then up to 180s
+                      while the launchd replacement is still running.
+  --json`;
+const LABEL = 'dev.akno';
+const DEFAULT_FAST_SOCKET_WAIT_MS = 30_000;
+const DEFAULT_MAX_SOCKET_WAIT_MS = 180_000;
+/** An explicit timeout is a hard operator choice; the default has a fast and slow handoff tier. */
+export function redeployWaitPolicy(timeoutSeconds) {
+    if (timeoutSeconds !== undefined) {
+        const seconds = Number(timeoutSeconds);
+        if (!Number.isFinite(seconds) || seconds <= 0) {
+            throw new AknoError('invalid', '--timeout must be a positive number of seconds');
+        }
+        const milliseconds = Math.max(1, seconds) * 1000;
+        return { fastMs: milliseconds, maximumMs: milliseconds };
+    }
+    return { fastMs: DEFAULT_FAST_SOCKET_WAIT_MS, maximumMs: DEFAULT_MAX_SOCKET_WAIT_MS };
+}
+/** Content-safe launchctl output parser used only after the fast socket deadline expires. */
+export function launchdServiceIsRunning(output) {
+    return /^\s*state = running\s*$/m.test(output) && /^\s*pid = \d+\s*$/m.test(output);
+}
+/** A pre-restart listener is not evidence that the replacement is ready. */
+export function socketWasReplaced(previous, current) {
+    if (!current)
+        return false;
+    if (!previous)
+        return true;
+    return (current.device !== previous.device ||
+        current.inode !== previous.inode ||
+        current.changedAtMs !== previous.changedAtMs);
+}
+export function redeployPlan(input) {
+    if (!input.restart)
+        return { build: input.build, restart: false, skipped: 'asked' };
+    if (!input.darwin)
+        return { build: input.build, restart: false, skipped: 'not-darwin' };
+    if (!input.serviceInstalled)
+        return { build: input.build, restart: false, skipped: 'no-service' };
+    return { build: input.build, restart: true, skipped: null };
+}
+const SKIP_NOTE = {
+    asked: 'the service was left alone',
+    'not-darwin': 'restarting a service is macOS-only for now — restart it yourself',
+    'no-service': `no service installed (${LABEL}) — nothing to restart. \`akno service install\` sets one up.`,
+};
+export async function redeployCommand(argv) {
+    const { values } = parse(argv, {
+        build: { type: 'boolean', default: true },
+        restart: { type: 'boolean', default: true },
+        timeout: { type: 'string' },
+    });
+    if (values.help) {
+        line(REDEPLOY_HELP);
+        return 0;
+    }
+    const result = { built: false, restarted: false, socket: null, ready: false };
+    // ── Build ─────────────────────────────────────────────────────────────────
+    if (values.build) {
+        const root = repoRoot();
+        if (!root) {
+            fail(values.json, result, 'cannot find the repo root — run this from inside an Akno checkout');
+            return 1;
+        }
+        if (!values.json)
+            heading('building');
+        const build = spawnSync('pnpm', ['run', 'build'], {
+            cwd: root,
+            stdio: values.json ? 'pipe' : 'inherit',
+            encoding: 'utf8',
+        });
+        if (build.status !== 0) {
+            // Nothing is restarted after a failed build. Restarting anyway would put the *old* code back
+            // into service and report success, which is the one outcome worse than stopping.
+            fail(values.json, result, `build failed (exit ${build.status ?? 'unknown'})${buildTail(build.stderr)}`);
+            return 1;
+        }
+        result.built = true;
+    }
+    // ── Restart ───────────────────────────────────────────────────────────────
+    const { loadConfig } = await import('@tenphi/akno-core');
+    const config = loadConfig(openOptionsFrom(values));
+    result.socket = config.socketPath;
+    const plist = path.join(process.env.HOME ?? '', 'Library', 'LaunchAgents', `${LABEL}.plist`);
+    const plan = redeployPlan({
+        build: values.build,
+        restart: values.restart,
+        darwin: process.platform === 'darwin',
+        serviceInstalled: fs.existsSync(plist),
+    });
+    if (plan.skipped) {
+        result.ready = await socketAcceptsConnections(config.socketPath);
+        report(values.json, result, SKIP_NOTE[plan.skipped]);
+        return 0;
+    }
+    const previousSocket = socketIdentity(config.socketPath);
+    if (!values.json)
+        heading('restarting');
+    const kick = spawnSync('launchctl', ['kickstart', '-k', `gui/${process.getuid?.() ?? ''}/${LABEL}`], {
+        stdio: values.json ? 'pipe' : 'inherit',
+        encoding: 'utf8',
+    });
+    if (kick.status !== 0) {
+        fail(values.json, result, `launchctl kickstart failed (exit ${kick.status ?? 'unknown'})${buildTail(kick.stderr)}`);
+        return 1;
+    }
+    result.restarted = true;
+    // ── Wait ──────────────────────────────────────────────────────────────────
+    const waitPolicy = redeployWaitPolicy(values.timeout);
+    result.ready = await waitForSocket(config.socketPath, waitPolicy.fastMs, previousSocket);
+    let waitedMs = waitPolicy.fastMs;
+    if (!result.ready && waitPolicy.maximumMs > waitPolicy.fastMs && launchdReplacementIsRunning()) {
+        if (!values.json) {
+            line(style.grey(`replacement is still starting after ${waitPolicy.fastMs / 1000}s; ` +
+                `waiting up to ${waitPolicy.maximumMs / 1000}s`));
+        }
+        result.ready = await waitForSocket(config.socketPath, waitPolicy.maximumMs - waitPolicy.fastMs, previousSocket);
+        waitedMs = waitPolicy.maximumMs;
+    }
+    if (!result.ready) {
+        // The restart happened; the process did not come up. Reported as a failure rather than a
+        // success with a caveat, because everything the caller does next will fail.
+        fail(values.json, result, `restarted, but nothing is listening on ${config.socketPath} after ${waitedMs / 1000}s — ` +
+            'check `akno service status` and the log');
+        return 1;
+    }
+    report(values.json, result, null);
+    return 0;
+}
+/**
+ * Readiness requires a replacement socket that accepts connections. Existence alone can be the
+ * outgoing service's still-live path during a launchd handoff.
+ */
+async function waitForSocket(socketPath, timeoutMs, previous) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (socketWasReplaced(previous, socketIdentity(socketPath)) &&
+            (await socketAcceptsConnections(socketPath))) {
+            return true;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 200));
+    }
+    return (socketWasReplaced(previous, socketIdentity(socketPath)) && (await socketAcceptsConnections(socketPath)));
+}
+function socketIdentity(socketPath) {
+    try {
+        const stat = fs.statSync(socketPath);
+        if (!stat.isSocket())
+            return null;
+        return { device: stat.dev, inode: stat.ino, changedAtMs: stat.ctimeMs };
+    }
+    catch {
+        return null;
+    }
+}
+async function socketAcceptsConnections(socketPath) {
+    if (!fs.existsSync(socketPath))
+        return false;
+    const socket = net.createConnection(socketPath);
+    try {
+        await once(socket, 'connect', { signal: AbortSignal.timeout(500) });
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        socket.destroy();
+    }
+}
+function launchdReplacementIsRunning() {
+    const inspected = spawnSync('launchctl', ['print', `gui/${process.getuid?.() ?? ''}/${LABEL}`], {
+        encoding: 'utf8',
+    });
+    return inspected.status === 0 && launchdServiceIsRunning(inspected.stdout ?? '');
+}
+/** Walks up for the workspace marker, so this works from any directory in the checkout. */
+function repoRoot() {
+    let dir = import.meta.dirname;
+    for (let i = 0; i < 12; i++) {
+        if (fs.existsSync(path.join(dir, 'pnpm-workspace.yaml')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+    return null;
+}
+function buildTail(stderr) {
+    const tail = (stderr ?? '').trim().split('\n').slice(-3).join('\n');
+    return tail ? `\n${tail}` : '';
+}
+function report(asJson, result, note) {
+    if (note)
+        result.note = note;
+    if (asJson) {
+        json({ ok: true, ...result });
+        return;
+    }
+    line();
+    kv([
+        ['built', result.built ? 'yes' : 'skipped'],
+        ['restarted', result.restarted ? LABEL : 'no'],
+        ['socket', result.ready ? `${result.socket} (up)` : (result.socket ?? null)],
+    ]);
+    if (note)
+        line(style.grey(`\n  ${note}`));
+}
+function fail(asJson, result, message) {
+    if (asJson) {
+        json({ ok: false, ...result, error: message });
+        return;
+    }
+    line(`\n${style.red('redeploy failed')}  ${message}`);
+}
+//# sourceMappingURL=redeploy-cmd.js.map

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

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

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

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

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

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

package/dist/commands/rules-cmd.js

@@ -0,0 +1,72 @@
+import { openOptionsFrom, parse } from "../args.js";
+import { heading, json, kv, line, style } from "../output.js";
+import { open } from '@tenphi/akno-core';
+import { printMaintenancePathPolicy } from "./maintenance-policy-output.js";
+const RULES_HELP = `akno rules [path]
+
+  With a path: which rule governs it, why, and the resulting page-specific
+  maintenance authority. Without: every rule, most specific first. Specificity
+  comes from the shape of the glob, not from declaration order, so reordering
+  the config cannot change what applies.`;
+export async function rulesCommand(argv) {
+    const { values, positionals } = parse(argv);
+    if (values.help) {
+        line(RULES_HELP);
+        return 0;
+    }
+    const mem = await open({ ...openOptionsFrom(values), writable: false });
+    try {
+        if (positionals.length === 0) {
+            const rules = mem.config.rules;
+            if (values.json) {
+                json({ gate: mem.config.gate, rules });
+                return 0;
+            }
+            heading(`${rules.length} rule${rules.length === 1 ? '' : 's'}  ${style.grey(`gate=${mem.config.gate}`)}`);
+            if (rules.length === 0) {
+                line(style.grey('  none — every page defaults to searchable `knowledge`, with fact injection denied.'));
+                return 0;
+            }
+            const width = Math.max(...rules.map((r) => r.glob.length));
+            for (const rule of rules) {
+                const fields = Object.entries(rule)
+                    // `description` is a sentence, not a setting. Inline it and the column alignment
+                    // that makes this list scannable is gone; it gets its own line below instead.
+                    .filter(([key]) => !['glob', 'source', 'specificity', 'description'].includes(key))
+                    .map(([key, value]) => `${key}=${String(value)}`)
+                    .join(' ');
+                line(`  ${rule.glob.padEnd(width)}  ${fields}  ${style.grey(rule.source)}`);
+                if (rule.description)
+                    line(`  ${' '.repeat(width)}  ${style.grey(rule.description)}`);
+            }
+            return 0;
+        }
+        const slug = positionals[0].replace(/\.(md|markdown)$/i, '');
+        const result = mem.rules(slug);
+        const maintenance = mem.maintenancePolicy(positionals[0]);
+        if (values.json) {
+            json({ slug, ...result, maintenance });
+            return 0;
+        }
+        heading(slug);
+        const entries = Object.entries(result.effective);
+        if (entries.length === 0) {
+            line(style.grey('  no rule matches — defaults apply: role=knowledge, remember=deny, dream=none'));
+        }
+        else {
+            kv(entries.map(([key, value]) => [key, String(value)]));
+        }
+        if (result.candidates.length > 0) {
+            line(`\n  ${style.grey('matched, most specific first:')}`);
+            for (const candidate of result.candidates) {
+                line(`    ${candidate.glob}  ${style.grey(candidate.source)}`);
+            }
+        }
+        printMaintenancePathPolicy(maintenance);
+        return 0;
+    }
+    finally {
+        await mem.close();
+    }
+}
+//# sourceMappingURL=rules-cmd.js.map

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

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

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

@@ -0,0 +1,23 @@
+export declare function serveCommand(argv: string[]): Promise<number>;
+export declare function serviceCommand(argv: string[]): Promise<number>;
+export declare function serviceTargetArgs(values: {
+    'akno-path'?: string;
+    'state-dir'?: string;
+}): string[];
+export interface PlistOptions {
+    label: string;
+    node: string;
+    script: string;
+    args: string[];
+    logDir: string;
+    /** Log basename, so the nightly cycle does not interleave with the service's log. */
+    logName?: string;
+    /** The service: restarted whenever it stops. */
+    keepAlive?: boolean;
+    /** The nightly cycle: run once a day at this hour. */
+    calendarHour?: number;
+    calendarMinute?: number;
+}
+/** Exported for exact scheduler fixture tests; service installation is the only production caller. */
+export declare function plist(options: PlistOptions): string;
+//# sourceMappingURL=serve-cmd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/serve-cmd.ts"],"names":[],"mappings":"AA2BA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuIlE;AAgFD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgJpE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAKlG;AAYD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sGAAsG;AACtG,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA0BnD"}