@tenphi/akno-core 0.1.0

package/dist/open.js

@@ -0,0 +1,382 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { AknoError, OPS, } from '@tenphi/akno-protocol';
+import { loadConfig } from "./config/load.js";
+import { acquireWriteLock, openStore } from "./store/db.js";
+import { DeferredDerive } from "./index/defer.js";
+import { ModelClient } from "./models/client.js";
+import { resolveAutoProviderApis } from "./models/provider-api.js";
+import { Assembler } from "./recall/assemble.js";
+import { Indexer } from "./index/indexer.js";
+import { Watcher } from "./watch/watcher.js";
+import { doctor } from "./doctor.js";
+import { effectiveRule, matchRules } from "./rules/compile.js";
+import { looksLikeLedger } from "./reserved.js";
+import { Journal } from "./write/journal.js";
+import { Gate } from "./write/gate.js";
+import { recall } from "./ops/recall.js";
+import { answer as answerOp } from "./ops/answer.js";
+import { read } from "./ops/read.js";
+import { list } from "./ops/list.js";
+import { timeline } from "./ops/timeline.js";
+import { context as contextOp } from "./ops/context.js";
+import { graph as graphOp } from "./ops/graph.js";
+import { write as writeOp } from "./ops/write.js";
+import { folder as folderOp } from "./ops/folder.js";
+import { remember as rememberOp } from "./ops/remember.js";
+import { forget as forgetOp } from "./ops/forget.js";
+import { undo as undoOp } from "./ops/undo.js";
+import { move as moveOp } from "./ops/move.js";
+import { ingest as ingestOp } from "./ops/ingest.js";
+import { adopt as adoptOp } from "./ops/adopt.js";
+import { isInInbox, processInbox } from "./ingest/inbox.js";
+import { dream } from "./maintenance/dream.js";
+import { applyMaintenancePlan, decideMaintenanceItem, getMaintenancePlan, listMaintenancePlans, maintenanceStatus, pruneMaintenancePlans, renderStoredMaintenanceDiff, reviseMaintenanceItem, supersedeMaintenancePlan, } from "./maintenance/plans.js";
+import { recoverInterruptedDreamRuns } from "./maintenance/runs.js";
+import { explainMaintenancePath } from "./maintenance/path-policy.js";
+import { resumeMaintenanceRecovery, } from "./maintenance/recovery.js";
+/**
+ * One sentence for each way a handle can be read-only. Kept in one place because the same
+ * explanation belongs in a thrown error, in `doctor`, and in the CLI, and three copies
+ * would drift into three different claims about what is happening.
+ */
+export function readOnlyExplanation(reason, heldByPid) {
+    switch (reason) {
+        case 'held':
+            return `pid ${heldByPid} holds it. Do not run two Aknos against one knowledge base.`;
+        case 'unwritable':
+            return 'the lock file could not be written — check the permissions on the state directory.';
+        case 'requested':
+            return 'this handle was opened read-only.';
+        default:
+            return 'this handle cannot write.';
+    }
+}
+/**
+ * **The library is the product.** One op registry, one schema per op, three
+ * transports over it — so the doors cannot drift into different behaviour.
+ *
+ *   import { open } from '@tenphi/akno-core';
+ *   const mem = await open({ aknoPath: '~/Notes' });
+ *   const { results } = await mem.recall({ query: 'car insurance renewal' });
+ *
+ * Swapping `open()` for `connect()` from `@tenphi/akno-client` is the only difference
+ * between embedding and connecting to a running service, so the decision is
+ * reversible and nothing above the call site knows which is in use.
+ */
+export async function open(options = {}) {
+    const config = loadConfig(options);
+    fs.mkdirSync(config.stateDir, { recursive: true });
+    fs.mkdirSync(config.logDir, { recursive: true });
+    if (options.resolveProviderApis !== false) {
+        await resolveAutoProviderApis(config, { refresh: options.refreshProviderApis });
+    }
+    // Exactly one process may hold the write handle. A second one opens read-only
+    // and says so, rather than racing two watchers over one directory.
+    let lock = null;
+    let writable = options.writable !== false;
+    let lockHeldBy = null;
+    let readOnlyReason = writable ? null : 'requested';
+    if (writable) {
+        lock = acquireWriteLock(config.lockPath, options.writeLockWaitMs ?? 0);
+        if (!lock.acquired) {
+            writable = false;
+            lockHeldBy = lock.heldByPid;
+            readOnlyReason = lock.failure ?? 'held';
+        }
+    }
+    const dimensions = config.models.embedding.dimensions ?? 1024;
+    const store = openStore({ dbPath: config.dbPath, embeddingDimensions: dimensions, readOnly: !writable });
+    const models = {
+        embedding: new ModelClient(config.models.embedding),
+        reranker: new ModelClient(config.models.reranker),
+        derive: new ModelClient(config.models.derive),
+        expansion: new ModelClient(config.models.expansion),
+        answer: new ModelClient(config.models.answer),
+        vision: new ModelClient(config.models.vision),
+    };
+    const indexer = new Indexer(config, store, { embedding: models.embedding, derive: models.derive });
+    const deferredDerive = new DeferredDerive(indexer, (err) => {
+        // After the caller has gone, so there is nobody to throw at. A lost derivation costs a summary
+        // and some facts until the next pass over the page; it never costs the write.
+        options.watchEvents?.onError?.(err instanceof Error ? err : new Error(String(err)));
+    });
+    const ctx = {
+        config,
+        store,
+        models,
+        derive: deferredDerive,
+        assembler: new Assembler(config, store),
+        indexer,
+        journal: new Journal(store, config.aknoPath, config.trashDir),
+        gate: new Gate(store, config),
+        actor: options.actor ?? 'agent',
+        writable,
+        lockHeldBy,
+        readOnlyReason,
+    };
+    // The write handle proves that no predecessor is still applying. Finalize its unfinished
+    // lifecycle rows before status or scheduling can mistake a crashed run for a live one.
+    recoverInterruptedDreamRuns(ctx);
+    if (writable && config.createReservedPaths)
+        ensureReservedPaths(config);
+    let watcher = null;
+    if (options.watch && writable && config.watch.enabled) {
+        watcher = new Watcher(config, indexer, {
+            ...(options.watchEvents ?? {}),
+            // Dropping a file in the inbox is the whole interface. Indexing it where it
+            // landed would leave it sitting there forever, which is the one thing an inbox
+            // must not do.
+            onArrival: async (changed) => {
+                const arrivals = changed.filter((relPath) => isInInbox(ctx, relPath));
+                if (arrivals.length === 0)
+                    return;
+                const result = await processInbox(ctx, { only: arrivals });
+                options.watchEvents?.onInbox?.(result);
+            },
+        });
+        watcher.start();
+    }
+    const implementations = {
+        recall,
+        answer: answerOp,
+        read,
+        list,
+        timeline,
+        context: contextOp,
+        graph: graphOp,
+        write: writeOp,
+        folder: folderOp,
+        remember: rememberOp,
+        forget: forgetOp,
+        undo: undoOp,
+        move: moveOp,
+        ingest: ingestOp,
+        adopt: adoptOp,
+    };
+    async function call(op, input, callOptions = {}) {
+        const definition = OPS[op];
+        if (!definition)
+            throw new AknoError('invalid', `unknown op: ${String(op)}`);
+        // Every door validates against the same schema, so a bad call fails the same
+        // way whether it came in-process, over a socket, or from MCP.
+        const parsed = definition.input.safeParse(input);
+        if (!parsed.success) {
+            throw new AknoError('invalid', `invalid input for ${op}`, {
+                issues: parsed.error.issues.map((issue) => ({
+                    path: issue.path.join('.'),
+                    message: issue.message,
+                })),
+            });
+        }
+        if (definition.kind === 'write' && !writable) {
+            throw new AknoError('read_only', `${op} needs the write handle — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+        }
+        const implementation = implementations[op];
+        if (!implementation || !definition.implemented) {
+            throw new AknoError('not_implemented', `${op} is not implemented in this build. Its schema is final; the body lands with the write path.`);
+        }
+        // One call, one actor. The gate reads it, and the journal records it for undo attribution, so
+        // shadowing the context here is the whole mechanism — the same one `approve` uses to replay a
+        // proposal as the person who answered it.
+        const forCall = callOptions.actor && callOptions.actor !== ctx.actor ? { ...ctx, actor: callOptions.actor } : ctx;
+        return implementation(forCall, parsed.data);
+    }
+    const akno = {
+        config,
+        writable,
+        lockHeldBy,
+        recall: (input) => call('recall', input),
+        answer: (input) => call('answer', input),
+        read: (input) => call('read', input),
+        list: (input) => call('list', input),
+        timeline: (input) => call('timeline', input),
+        context: (input) => call('context', input),
+        graph: (input) => call('graph', input),
+        write: (input) => call('write', input),
+        folder: (input) => call('folder', input),
+        remember: (input) => call('remember', input),
+        forget: (input) => call('forget', input),
+        undo: (input) => call('undo', input),
+        move: (input) => call('move', input),
+        ingest: (input) => call('ingest', input),
+        adopt: (input) => call('adopt', input),
+        call,
+        async index(indexOptions = {}) {
+            if (!writable) {
+                throw new AknoError('read_only', `cannot index — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+            }
+            return indexer.run(indexOptions);
+        },
+        doctor: (doctorOptions) => doctor(ctx, doctorOptions ?? {}),
+        rules(slug) {
+            const match = matchRules(slug, config.rules);
+            return {
+                effective: effectiveRule(slug, config.rules),
+                candidates: match.candidates.map((rule) => ({ glob: rule.glob, source: rule.source })),
+            };
+        },
+        maintenancePolicy: (slug, mode) => explainMaintenancePath(ctx, slug, mode),
+        changes: (limit) => ctx.journal.list(limit),
+        proposals: () => ctx.gate.pending(),
+        plans: (limit, statuses) => listMaintenancePlans(ctx, limit, statuses),
+        plan: (planId) => getMaintenancePlan(ctx, planId),
+        maintenanceDiff: (planId, itemId, revision) => renderStoredMaintenanceDiff(ctx, planId, itemId, revision),
+        async revisePlan(planId, itemId, input) {
+            if (!writable) {
+                throw new AknoError('read_only', `revising a maintenance plan needs the write handle — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+            }
+            return reviseMaintenanceItem(ctx, planId, itemId, input);
+        },
+        decidePlan(planId, itemId, outcome, reason = '', actionOptions = {}) {
+            if (!writable) {
+                throw new AknoError('read_only', `deciding a maintenance plan needs the write handle — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+            }
+            return decideMaintenanceItem(ctx, planId, itemId, outcome, 'human', reason, actionOptions);
+        },
+        async applyPlan(planId, actionOptions = {}) {
+            if (!writable) {
+                throw new AknoError('read_only', `applying a maintenance plan needs the write handle — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+            }
+            return applyMaintenancePlan(ctx, planId, undefined, actionOptions);
+        },
+        supersedePlan(planId, reason) {
+            if (!writable) {
+                throw new AknoError('read_only', `superseding a maintenance plan needs the write handle — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+            }
+            return supersedeMaintenancePlan(ctx, planId, reason);
+        },
+        prunePlans(retentionOptions = {}) {
+            if (retentionOptions.apply && !writable) {
+                throw new AknoError('read_only', `pruning maintenance plans needs the write handle — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+            }
+            return pruneMaintenancePlans(ctx, retentionOptions);
+        },
+        maintenanceStatus: (query) => maintenanceStatus(ctx, query),
+        resumeMaintenance(scope) {
+            if (!writable) {
+                throw new AknoError('read_only', `resuming automatic maintenance needs the write handle — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+            }
+            return resumeMaintenanceRecovery(ctx, scope);
+        },
+        async approve(proposalId, answer = {}) {
+            const proposal = ctx.gate.get(proposalId);
+            if (!proposal)
+                throw new AknoError('not_found', `no proposal with id ${proposalId}`);
+            if (proposal.status !== 'pending') {
+                throw new AknoError('invalid', `${proposalId} was already ${proposal.status}`);
+            }
+            // Replayed as the *user*, which is what makes approval work: the gate that
+            // stopped the agent does not apply to the person answering it.
+            const asUser = { ...ctx, actor: 'user' };
+            // An ingest proposal holds the source, not a page write. Treat the answer as its folder and
+            // run ingest again with that explicit destination. Replaying every proposal through `write`
+            // stripped the source path and made file-placement proposals impossible to resolve.
+            if (proposal.kind === 'ingest') {
+                const folder = answer.slug?.trim();
+                if (!folder) {
+                    const nearest = JSON.parse(proposal.nearest);
+                    const candidates = nearest.length > 0 ? ` Nearest: ${nearest.join(', ')}.` : '';
+                    throw new AknoError('invalid', `${proposalId} has no destination — approve it with a folder.${candidates}`);
+                }
+                const held = JSON.parse(proposal.payload);
+                const result = await ingestOp(asUser, { ...held, folder });
+                if (result.outcome === 'ok' || result.outcome === 'duplicate') {
+                    ctx.gate.resolve(proposalId, 'approved', result.change_id);
+                }
+                return { subject: proposal.subject, ingest: result };
+            }
+            const held = JSON.parse(proposal.payload);
+            const payload = answer.slug ? { ...held, slug: answer.slug } : held;
+            // A `route` proposal holds a claim and no destination — that *is* the question it asks. Left
+            // unanswered the replay fails deep inside `write` with "requires a slug", which reads as a bug
+            // in the approval rather than a missing answer, so it is refused here with the fix in the
+            // message. The nearest pages travel on the proposal for exactly this choice.
+            if (!payload.slug && !payload.propose_slug && !payload.event) {
+                const nearest = JSON.parse(proposal.nearest);
+                const candidates = nearest.length > 0 ? ` Nearest: ${nearest.join(', ')}.` : '';
+                throw new AknoError('invalid', `${proposalId} has no destination — approve it with a page to write to.${candidates}`);
+            }
+            const result = await writeOp(asUser, proposal.kind === 'conflict' ? { ...payload, resolve_conflict: true } : payload);
+            ctx.gate.resolve(proposalId, 'approved', result.change_id);
+            return { subject: proposal.subject, write: result };
+        },
+        async decline(proposalId) {
+            const proposal = ctx.gate.get(proposalId);
+            if (!proposal)
+                throw new AknoError('not_found', `no proposal with id ${proposalId}`);
+            ctx.gate.resolve(proposalId, 'declined');
+            return { subject: proposal.subject };
+        },
+        inbox: (inboxOptions) => processInbox(ctx, inboxOptions ?? {}),
+        async dream(dreamOptions = {}) {
+            // A dry run reads and reports; only a real one needs the handle. Refusing both would
+            // make "what would the cycle write?" unanswerable from a second process.
+            if (!writable && !dreamOptions.dryRun) {
+                throw new AknoError('read_only', `dream needs the write handle — ${readOnlyExplanation(readOnlyReason, lockHeldBy)}`);
+            }
+            return dream(ctx, dreamOptions);
+        },
+        async reconcile() {
+            if (watcher)
+                await watcher.reconcileNow();
+            else
+                await indexer.run({ verify: true });
+        },
+        async close() {
+            // A one-shot command would otherwise exit with its own write still underived.
+            await deferredDerive.flush();
+            await watcher?.stop();
+            store.close();
+            lock?.release();
+        },
+    };
+    return akno;
+}
+/**
+ * On startup Akno creates `timeline.md` (with a header and the current
+ * year) and `inbox/` (with a short README) **if they are missing** — and only
+ * when the user has opted in. Nothing else is created ahead of need.
+ *
+ * If a reserved path already exists and isn't what Akno expects, it is left
+ * completely alone; `doctor` reports it and points at the config key.
+ */
+function ensureReservedPaths(config) {
+    const timelineAbs = path.join(config.aknoPath, config.paths.timeline);
+    // The rule here is absolute: if a reserved path already exists and isn't what Akno
+    // expects — a `timeline.md` that is somebody's project plan — Akno warns,
+    // points at the config key, and **refuses to start** rather than adopting a file
+    // the user meant something else by. Silently treating it as a ledger would start
+    // appending event lines into the middle of their document.
+    if (fs.existsSync(timelineAbs) && !looksLikeLedger(timelineAbs)) {
+        throw new AknoError('invalid', `${config.paths.timeline} already exists and does not look like an event ledger — it has no ` +
+            '`- **YYYY-MM-DD** | …` lines. Akno will not adopt a file you meant something else by. ' +
+            'Point it elsewhere with `paths.timeline`, or set `create_reserved_paths: false`.');
+    }
+    if (!fs.existsSync(timelineAbs)) {
+        const year = new Date().getFullYear();
+        fs.mkdirSync(path.dirname(timelineAbs), { recursive: true });
+        fs.writeFileSync(timelineAbs, `---\ntype: timeline\ntitle: Timeline\n---\n\n# Timeline\n\n` +
+            `What actually happened, newest first. One line per event; the detail lives on the linked\n` +
+            `page, so this stays an index and never a second copy of a fact.\n\n` +
+            `Append-only: never edit or remove a line, correct it with a new one. Each line reads\n` +
+            `\`- **YYYY-MM-DD** | what happened. [[page/with/detail]]\` — that exact shape is what\n` +
+            `makes a line an event, and prose Akno cannot match is invisible to search.\n\n` +
+            `## ${year}\n`, 'utf8');
+    }
+    const inboxAbs = path.join(config.aknoPath, config.paths.inbox);
+    if (fs.existsSync(inboxAbs) && !fs.statSync(inboxAbs).isDirectory()) {
+        throw new AknoError('invalid', `${config.paths.inbox} exists and is not a directory. Remap it with \`paths.inbox\`.`);
+    }
+    if (!fs.existsSync(inboxAbs)) {
+        fs.mkdirSync(inboxAbs, { recursive: true });
+        fs.writeFileSync(path.join(inboxAbs, 'README.md'), `---\ntitle: Inbox\n---\n\n# Inbox\n\n` +
+            `Drop anything here and it files itself: Akno extracts the text, OCRs it if there is no\n` +
+            `text layer, gives it a name from its contents, summarizes it, and moves it to where it\n` +
+            `belongs.\n\n` +
+            `If it cannot work out where that is, the file **stays here** with a proposal attached —\n` +
+            `deliberately. An inbox with three things in it is a to-do list. A misfiled document is a\n` +
+            `lost one.\n`, 'utf8');
+    }
+}
+//# sourceMappingURL=open.js.map

package/dist/open.js.map

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

package/dist/ops/adopt.d.ts

@@ -0,0 +1,12 @@
+import { type AdoptOutput } from '@tenphi/akno-protocol';
+import type { AknoContext } from '../context.ts';
+/**
+ * Plan one document group's filing page through the configured trust policy.
+ *
+ * This is intentionally separate from the bulk dream phase. A recall card names one stable
+ * document, and invoking its action must not turn every other orphan in the knowledge base into
+ * an implicit batch. Review decisions remain outside the op surface, so an agent can propose a
+ * guarded change but cannot approve its own review-mode plan.
+ */
+export declare function adopt(ctx: AknoContext, rawInput: unknown): Promise<AdoptOutput>;
+//# sourceMappingURL=adopt.d.ts.map

package/dist/ops/adopt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/ops/adopt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAqBjD;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAuGrF"}

package/dist/ops/adopt.js

@@ -0,0 +1,138 @@
+import { AdoptInput, AknoError } from '@tenphi/akno-protocol';
+import { planOrphanAdoptions } from "../maintenance/adopt.js";
+import { applyMaintenancePlan, createAdoptionPlan, decideMaintenancePlanWithCurator, } from "../maintenance/plans.js";
+import { captureMaintenanceSnapshot } from "../maintenance/runs.js";
+import { effectiveTransformPolicy, policyMode } from "../maintenance/profile.js";
+/**
+ * Plan one document group's filing page through the configured trust policy.
+ *
+ * This is intentionally separate from the bulk dream phase. A recall card names one stable
+ * document, and invoking its action must not turn every other orphan in the knowledge base into
+ * an implicit batch. Review decisions remain outside the op surface, so an agent can propose a
+ * guarded change but cannot approve its own review-mode plan.
+ */
+export async function adopt(ctx, rawInput) {
+    const input = AdoptInput.parse(rawInput);
+    const document = ctx.store.db
+        .prepare(`SELECT d.id, d.page_id, d.text IS NOT NULL AS readable, p.slug AS page_slug,
+              d.availability,
+              EXISTS(
+                SELECT 1 FROM documents peer
+                 WHERE peer.renders IS NULL
+                   AND COALESCE(peer.group_key, peer.rel_path) = COALESCE(d.group_key, d.rel_path)
+                   AND peer.availability = 'missing'
+              ) AS group_missing
+         FROM documents d LEFT JOIN pages p ON p.id = d.page_id
+        WHERE d.id = ?`)
+        .get(input.documentId);
+    if (!document)
+        throw new AknoError('not_found', `no document with id ${input.documentId}`);
+    if (document.page_id) {
+        return {
+            status: 'ok',
+            outcome: 'noop',
+            document_id: document.id,
+            ...(document.page_slug ? { slug: document.page_slug } : {}),
+            reason: 'the document already belongs to a page',
+        };
+    }
+    if (document.availability !== 'available' || document.group_missing === 1) {
+        return {
+            status: 'ok',
+            outcome: 'blocked',
+            document_id: document.id,
+            reason: 'one or more original document files are missing; restore them before creating a filing page',
+        };
+    }
+    if (document.readable !== 1) {
+        return {
+            status: 'ok',
+            outcome: 'blocked',
+            document_id: document.id,
+            reason: 'the document has no readable indexed text from which to make a filing page',
+        };
+    }
+    const itemPolicy = policyMode(effectiveTransformPolicy(ctx.config, 'adopt'));
+    const mode = itemPolicy;
+    if (!mode) {
+        return {
+            status: 'ok',
+            outcome: 'disabled',
+            document_id: document.id,
+            reason: 'document adoption policy is off',
+        };
+    }
+    const planned = await planOrphanAdoptions(ctx, { limit: 1, documentId: document.id });
+    const report = planned.adopted[0];
+    const draft = planned.drafts[0];
+    if (!report || !draft) {
+        return {
+            status: 'ok',
+            outcome: report?.action === 'rejected' ? 'rejected' : 'blocked',
+            document_id: document.id,
+            ...(report?.slug ? { slug: report.slug } : {}),
+            reason: report?.reason ?? 'the selected document is no longer an eligible readable orphan',
+        };
+    }
+    const modelId = ctx.config.maintenance.model?.id ?? ctx.config.models.derive.id;
+    let plan = createAdoptionPlan(ctx, mode, [draft], captureMaintenanceSnapshot(ctx, ['adopt'], modelId), itemPolicy);
+    if (!plan) {
+        throw new AknoError('internal', 'the selected adoption produced no maintenance plan');
+    }
+    if (mode === 'auto' && plan.items.some((item) => item.status === 'proposed' && item.policy === 'auto')) {
+        plan = await decideMaintenancePlanWithCurator(ctx, plan.id);
+    }
+    if (mode === 'auto' &&
+        plan.items.some((item) => ['approved', 'applying', 'verification_pending'].includes(item.status))) {
+        plan = (await applyMaintenancePlan(ctx, plan.id)).plan;
+    }
+    const item = plan.items.find((candidate) => candidate.evidence.some((evidence) => evidence.type === 'document' && evidence.documentId === document.id));
+    if (!item)
+        throw new AknoError('internal', 'the adoption plan lost the selected document identity');
+    return adoptionResult(document.id, draft.documents.map((entry) => entry.id), draft.relPath, plan, item);
+}
+function adoptionResult(documentId, documentIds, relPath, plan, item) {
+    const common = {
+        status: 'ok',
+        document_id: documentId,
+        document_ids: documentIds,
+        slug: item.subject,
+        rel_path: relPath,
+        ...(item.changeId ? { change_id: item.changeId } : {}),
+        plan: {
+            id: plan.id,
+            mode: plan.mode,
+            status: plan.status,
+            item_id: item.id,
+            item_status: item.status,
+        },
+    };
+    const reason = item.verification?.detail ?? item.decision?.reason ?? item.statusReason ?? undefined;
+    switch (item.status) {
+        case 'applied':
+            return { ...common, outcome: 'created', ...(reason ? { reason } : {}) };
+        case 'verification_pending':
+            return { ...common, outcome: 'verification_pending', ...(reason ? { reason } : {}) };
+        case 'rejected':
+            return { ...common, outcome: 'rejected', ...(reason ? { reason } : {}) };
+        case 'blocked':
+        case 'stale':
+        case 'verification_failed':
+            return {
+                ...common,
+                outcome: 'blocked',
+                reason: reason ?? `the maintenance item is ${item.status}`,
+            };
+        case 'proposed':
+            return plan.mode === 'review'
+                ? { ...common, outcome: 'requires_review' }
+                : { ...common, outcome: 'planned' };
+        default:
+            return {
+                ...common,
+                outcome: 'blocked',
+                reason: reason ?? `the maintenance item is ${item.status}`,
+            };
+    }
+}
+//# sourceMappingURL=adopt.js.map

package/dist/ops/adopt.js.map

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

package/dist/ops/answer.d.ts

@@ -0,0 +1,29 @@
+import { type AnswerOutput } from '@tenphi/akno-protocol';
+import type { AknoContext } from '../context.ts';
+import { type ModelClient, type ModelUsage } from '../models/client.ts';
+export declare const ANSWER_PROMPT_VERSION = "answer-generation-v3";
+export declare const ANSWER_VERIFIER_PROMPT_VERSION = "answer-verifier-v1";
+export interface AnswerCapabilityCheck {
+    status: 'ok' | 'failed' | 'skipped';
+    latencyMs: number | null;
+    usage: ModelUsage | null;
+    error: string | null;
+}
+export interface AnswerCapabilityProbe {
+    generation: AnswerCapabilityCheck;
+    verification: AnswerCapabilityCheck;
+}
+/**
+ * Direct answering composes over recall; it never owns a second search path.
+ *
+ * Answer retrieval deliberately skips reranking unless the caller opts in. The answer model already has to
+ * select evidence, while a second generative ranking request is the dominant interactive latency cost. Recall
+ * keeps reranking by default because ordering and qualification are its actual output.
+ */
+export declare function answer(ctx: AknoContext, rawInput: unknown): Promise<AnswerOutput>;
+/**
+ * Exercises both production answer contracts without reading the configured knowledge base.
+ * The prompt and evidence are intentionally tiny, wholly invented, and stable across runs.
+ */
+export declare function probeAnswerModel(model: ModelClient): Promise<AnswerCapabilityProbe>;
+//# sourceMappingURL=answer.d.ts.map

package/dist/ops/answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../src/ops/answer.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,YAAY,EAGlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,WAAW,EAAqB,KAAK,UAAU,EAAkB,MAAM,qBAAqB,CAAC;AAG3G,eAAO,MAAM,qBAAqB,yBAAyB,CAAC;AAC5D,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AAkCnE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,qBAAqB,CAAC;IAClC,YAAY,EAAE,qBAAqB,CAAC;CACrC;AA2BD;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAuMvF;AA0ED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAwDzF"}