@tenphi/akno-core 0.1.0

package/dist/ops/list.js

@@ -0,0 +1,217 @@
+import { ListInput } from '@tenphi/akno-protocol';
+import { physicalFolders } from "../kb/folders.js";
+import { effectiveRule, matchRules } from "../rules/compile.js";
+/**
+ * Browse structure rather than search it. The point of this op is that an agent
+ * that knows what folders exist stops guessing slugs: choosing one and avoiding a duplicate
+ * page is much easier when the structure is legible.
+ */
+export async function list(ctx, rawInput) {
+    const input = ListInput.parse(rawInput);
+    const kind = input.kind ?? (input.folder || input.type || input.tag || input.role ? 'pages' : 'folders');
+    if (kind === 'tree')
+        return listTree(ctx, input);
+    if (kind === 'folders')
+        return listFolders(ctx, input);
+    return listPages(ctx, input);
+}
+function listPages(ctx, input) {
+    const clauses = ["role != 'ignored'"];
+    const params = [];
+    if (input.folder) {
+        clauses.push('(slug = ? OR slug LIKE ?)');
+        params.push(input.folder, `${input.folder}/%`);
+    }
+    if (input.type) {
+        clauses.push('type = ?');
+        params.push(input.type);
+    }
+    if (input.role) {
+        clauses.push('role = ?');
+        params.push(input.role);
+    }
+    const order = input.order === 'slug' ? 'slug ASC' : input.order === 'size' ? 'bytes DESC' : 'updated_at DESC';
+    const limit = input.limit ?? 100;
+    const rows = ctx.store.db
+        .prepare(`SELECT slug, title, type, role, tags, summary, updated_at, bytes
+         FROM pages WHERE ${clauses.join(' AND ')} ORDER BY ${order}`)
+        .all(...params);
+    // Tag filtering happens here rather than in SQL: tags are a JSON array, and a
+    // LIKE on serialized JSON matches `finance` inside `finance-review`.
+    const wanted = input.tag?.toLowerCase();
+    const filtered = wanted
+        ? rows.filter((row) => JSON.parse(row.tags).some((tag) => tag.toLowerCase() === wanted))
+        : rows;
+    return {
+        status: filtered.length === 0 ? 'empty' : 'ok',
+        pages: filtered.slice(0, limit).map((row) => ({
+            slug: row.slug,
+            title: row.title,
+            type: row.type,
+            role: row.role,
+            tags: JSON.parse(row.tags),
+            summary: row.summary,
+            ...(row.updated_at ? { updated: row.updated_at.slice(0, 10) } : {}),
+            bytes: row.bytes,
+        })),
+        total: filtered.length,
+    };
+}
+function listFolders(ctx, input) {
+    const prefix = input.folder ? `${input.folder}/` : '';
+    const rows = ctx.store.db.prepare("SELECT slug FROM pages WHERE role != 'ignored' ORDER BY slug").all();
+    const direct = new Map();
+    const deep = new Map();
+    const subfolders = new Map();
+    for (const { slug } of rows) {
+        if (prefix && !slug.startsWith(prefix))
+            continue;
+        const remainder = slug.slice(prefix.length);
+        const segments = remainder.split('/');
+        if (segments.length === 1) {
+            // A page sitting directly in this folder, not a child folder.
+            continue;
+        }
+        const child = segments[0];
+        const childPath = `${prefix}${child}`;
+        deep.set(childPath, (deep.get(childPath) ?? 0) + 1);
+        if (segments.length === 2)
+            direct.set(childPath, (direct.get(childPath) ?? 0) + 1);
+        else {
+            if (!subfolders.has(childPath))
+                subfolders.set(childPath, new Set());
+            subfolders.get(childPath).add(segments[1]);
+        }
+    }
+    // A folder that has been declared but holds no page yet is still somewhere to file
+    // something — it is, in fact, the folder most likely to be the right answer, because
+    // somebody has just said what it is for. Deriving structure from pages alone made a freshly
+    // declared folder invisible to the very caller that had declared it.
+    const declared = new Set();
+    for (const folderPath of declaredFolders(ctx, prefix)) {
+        if (folderPath.includes('/') && !prefix)
+            continue;
+        if (!deep.has(folderPath))
+            declared.add(folderPath);
+    }
+    // Directories are structure even before the first page exists. The index has no row capable of
+    // representing an empty folder, so include the user's on-disk taxonomy explicitly.
+    const physical = new Set(physicalFolders(ctx.config, { under: input.folder, depth: 1 }));
+    const folders = [...new Set([...deep.keys(), ...declared, ...physical])]
+        .sort()
+        .slice(0, input.limit ?? 200)
+        .map((folderPath) => {
+        // Reporting which rule governs a folder is what makes "default to visible" true for
+        // structure: a rule that quietly excludes half a knowledge base is worse than no rule.
+        // The fields come from `effectiveRule` and the attribution from the most specific match,
+        // so a `description` on `research/**` and a `rank` on `**` both show rather than one
+        // erasing the other.
+        const match = matchRules(`${folderPath}/x`, ctx.config.rules);
+        const effective = effectiveRule(`${folderPath}/x`, ctx.config.rules);
+        return {
+            path: folderPath,
+            pages: direct.get(folderPath) ?? 0,
+            pages_deep: deep.get(folderPath) ?? 0,
+            folders: subfolders.get(folderPath)?.size ?? 0,
+            ...(declared.has(folderPath) ? { declared: true } : {}),
+            ...(match.rule
+                ? {
+                    rule: {
+                        ...(effective.role ? { role: effective.role } : {}),
+                        ...(effective.remember ? { remember: effective.remember } : {}),
+                        ...(effective.description ? { description: effective.description } : {}),
+                        source: `${match.rule.glob} (${match.rule.source})`,
+                    },
+                }
+                : {}),
+        };
+    });
+    return { status: folders.length === 0 ? 'empty' : 'ok', folders, total: folders.length };
+}
+/**
+ * An indented outline, for the structure section of a `context` bundle. Cheap to
+ * produce and worth a lot: it is the difference between an agent that knows
+ * `documents/` exists and one that invents `docs/`.
+ */
+function listTree(ctx, input) {
+    const maxDepth = input.depth ?? 2;
+    const prefix = input.folder ? `${input.folder}/` : '';
+    const rows = ctx.store.db.prepare("SELECT slug FROM pages WHERE role != 'ignored' ORDER BY slug").all();
+    const counts = new Map();
+    for (const { slug } of rows) {
+        if (prefix && !slug.startsWith(prefix))
+            continue;
+        const segments = slug.slice(prefix.length).split('/');
+        for (let depth = 1; depth <= Math.min(maxDepth, segments.length - 1); depth++) {
+            const key = segments.slice(0, depth).join('/');
+            counts.set(key, (counts.get(key) ?? 0) + 1);
+        }
+    }
+    // Declared folders with nothing in them yet belong in the outline too — an agent choosing a
+    // destination should see the folder somebody just created for this, not conclude it has to
+    // invent one.
+    for (const folderPath of declaredFolders(ctx, prefix)) {
+        const key = folderPath.slice(prefix.length);
+        if (key.length === 0 || key.split('/').length > maxDepth)
+            continue;
+        if (!counts.has(key))
+            counts.set(key, 0);
+    }
+    for (const folderPath of physicalFolders(ctx.config, { under: input.folder, depth: maxDepth })) {
+        const key = prefix ? folderPath.slice(prefix.length) : folderPath;
+        if (key.length === 0 || key.split('/').length > maxDepth)
+            continue;
+        if (!counts.has(key))
+            counts.set(key, 0);
+    }
+    const lines = [...counts.keys()].sort().map((key) => {
+        const depth = key.split('/').length - 1;
+        const label = key.split('/').at(-1);
+        // The description, only at the top level and only in a clause. This outline is the whole
+        // of what a turn is told about structure, and `research/ (12)` does not say that research
+        // holds findings about the world while `household/` holds claims about this household —
+        // which is the distinction a caller gets wrong when nothing tells it.
+        const described = depth === 0 ? effectiveRule(`${prefix}${key}/x`, ctx.config.rules).description : undefined;
+        const note = described ? ` — ${truncate(described, 90)}` : '';
+        return `${'  '.repeat(depth)}${label}/ (${counts.get(key)})${note}`;
+    });
+    const rootPages = rows.filter((row) => !row.slug.slice(prefix.length).includes('/')).length;
+    if (rootPages > 0)
+        lines.unshift(`${input.folder ?? '.'}: ${rootPages} pages`);
+    return { status: 'ok', tree: lines.join('\n'), total: counts.size };
+}
+/**
+ * Folders named by a rule, under `prefix`, that a caller is allowed to see.
+ *
+ * A folder with a rule but no pages is still somewhere to file something — it is, in fact,
+ * the folder most likely to be right, because somebody has just said what it is for. Deriving
+ * structure from pages alone made a freshly declared folder invisible to the very caller that
+ * declared it.
+ *
+ * `ignored` is the exception, and not a small one: ignoring a folder is a statement that it
+ * should not be in the index at all, and listing it because it happens to have a rule would
+ * make the one role that means "do not look here" the one role that always appears.
+ */
+function declaredFolders(ctx, prefix) {
+    const out = [];
+    for (const rule of ctx.config.rules) {
+        const folderPath = rule.glob.replace(/\/\*+$/, '');
+        if (folderPath.length === 0 || folderPath.includes('*'))
+            continue;
+        if (!folderPath.startsWith(prefix))
+            continue;
+        if (effectiveRule(`${folderPath}/x`, ctx.config.rules).role === 'ignored')
+            continue;
+        out.push(folderPath);
+    }
+    return out;
+}
+/** Cut at a word boundary — half a word reads as a typo rather than as an elision. */
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    const cut = text.slice(0, max);
+    const space = cut.lastIndexOf(' ');
+    return `${(space > max * 0.6 ? cut.slice(0, space) : cut).replace(/[.,;:]$/, '')}…`;
+}
+//# sourceMappingURL=list.js.map

package/dist/ops/list.js.map

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

package/dist/ops/move.d.ts

@@ -0,0 +1,20 @@
+import { type MoveOutput } from '@tenphi/akno-protocol';
+import type { AknoContext } from '../context.ts';
+/**
+ * Relocate a page with its documents, rewriting embeds and **reporting**
+ * inbound links.
+ *
+ * The asymmetry between rewriting and reporting is deliberate:
+ *
+ * - The moved page's own links to its attachments are rewritten, because the move
+ *   renamed those files and leaving them would break the page Akno just moved.
+ * - Links *into* the page from elsewhere are reported, never rewritten. Editing
+ *   half a dozen other people's pages as a side effect of moving one is a much
+ *   bigger action than the caller asked for, and inbound links are already treated
+ *   that now point nowhere as something to report.
+ *
+ * Identity survives regardless: the page keeps its `id`, so facts, events and
+ * journal history stay attached.
+ */
+export declare function move(ctx: AknoContext, rawInput: unknown): Promise<MoveOutput>;
+//# sourceMappingURL=move.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"move.d.ts","sourceRoot":"","sources":["../../src/ops/move.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAuInF"}

package/dist/ops/move.js

@@ -0,0 +1,173 @@
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import { AknoError, MoveInput } from '@tenphi/akno-protocol';
+import { ATTACHMENT_NAME } from "../kb/page.js";
+import { recordOwnWrite, writeFileAtomic } from "../write/atomic.js";
+import { normalizeSlug } from "./write.js";
+/**
+ * Relocate a page with its documents, rewriting embeds and **reporting**
+ * inbound links.
+ *
+ * The asymmetry between rewriting and reporting is deliberate:
+ *
+ * - The moved page's own links to its attachments are rewritten, because the move
+ *   renamed those files and leaving them would break the page Akno just moved.
+ * - Links *into* the page from elsewhere are reported, never rewritten. Editing
+ *   half a dozen other people's pages as a side effect of moving one is a much
+ *   bigger action than the caller asked for, and inbound links are already treated
+ *   that now point nowhere as something to report.
+ *
+ * Identity survives regardless: the page keeps its `id`, so facts, events and
+ * journal history stay attached.
+ */
+export async function move(ctx, rawInput) {
+    const input = MoveInput.parse(rawInput);
+    const from = normalizeSlug(input.from);
+    const to = normalizeSlug(input.to);
+    if (from === to)
+        return { status: 'ok', outcome: 'ok', note: 'source and destination are the same' };
+    const page = ctx.store.db.prepare('SELECT id, rel_path FROM pages WHERE slug = ?').get(from);
+    if (!page)
+        throw new AknoError('not_found', `no page at ${from}`);
+    if (ctx.store.db.prepare('SELECT 1 FROM pages WHERE slug = ?').get(to)) {
+        throw new AknoError('invalid', `${to} already exists — move it or pick another slug`);
+    }
+    // The destination folder is checked exactly as a new page's would be: moving a
+    // page into `medical/` creates `medical/` just as surely as writing one there.
+    const decision = ctx.gate.check(to, ctx.actor);
+    if (!decision.allowed) {
+        return {
+            status: 'ok',
+            outcome: 'requires_folder',
+            requires_folder: decision.requiresFolder,
+            note: `'${decision.requiresFolder.folder}' has not been declared. Call \`folder\` with a ` +
+                'description of what belongs there, then repeat the move.',
+        };
+    }
+    const files = [];
+    const moved = [];
+    const toRelPath = `${to}.md`;
+    // ── Attachments first ───────────────────────────────────────────────────
+    // Content-addressed names are derived from the page basename, so a move
+    // renames them too. Doing these before the page means a crash leaves the page
+    // still pointing at files that exist.
+    const documents = ctx.store.db
+        .prepare('SELECT id, rel_path, renders FROM documents WHERE page_id = ?')
+        .all(page.id);
+    const destinations = new Map();
+    for (const document of documents)
+        destinations.set(document.rel_path, movedAttachmentPath(document.rel_path, from, to));
+    // A rendition is named after the file it renders, so it goes wherever that file goes.
+    // Deriving it from the page name instead would mean teaching the content-addressing rule
+    // about double extensions and then keeping two derivations agreeing with each other.
+    for (const document of documents) {
+        if (!document.renders)
+            continue;
+        destinations.set(document.rel_path, movedRenditionPath(document.rel_path, document.renders, destinations));
+    }
+    const rewrites = [];
+    for (const document of documents) {
+        const next = destinations.get(document.rel_path);
+        if (next === document.rel_path)
+            continue;
+        await fsp.mkdir(path.dirname(path.join(ctx.config.aknoPath, next)), { recursive: true });
+        await fsp.rename(path.join(ctx.config.aknoPath, document.rel_path), path.join(ctx.config.aknoPath, next));
+        // One entry naming the destination, not a `moved`/`created` pair. Reversing that pair
+        // deleted the new file and then tried to restore a path holding nothing — an attachment
+        // has no text in `before` to put back — so undoing a move used to eat the binary.
+        files.push({ relPath: document.rel_path, action: 'moved', before: null, after: null, movedTo: next });
+        moved.push(next);
+        rewrites.push([path.basename(document.rel_path), path.basename(next)]);
+    }
+    // ── The page ────────────────────────────────────────────────────────────
+    const original = await fsp.readFile(path.join(ctx.config.aknoPath, page.rel_path), 'utf8');
+    let content = original;
+    for (const [oldName, newName] of rewrites) {
+        content = content.split(oldName).join(newName);
+    }
+    await fsp.mkdir(path.dirname(path.join(ctx.config.aknoPath, toRelPath)), { recursive: true });
+    const written = await writeFileAtomic(ctx.config.aknoPath, toRelPath, content);
+    await fsp.rm(path.join(ctx.config.aknoPath, page.rel_path), { force: true });
+    files.push({ relPath: page.rel_path, action: 'moved', before: original, after: null });
+    files.push({ relPath: toRelPath, action: 'created', before: null, after: written.after });
+    moved.push(toRelPath);
+    // ── Inbound links ───────────────────────────────────────────────────────
+    const inbound = ctx.store.db
+        .prepare(`SELECT DISTINCT p.slug FROM links l JOIN pages p ON p.id = l.from_page
+        WHERE l.to_slug = ? AND p.id != ?`)
+        .all(from, page.id);
+    const changeId = ctx.journal.record({
+        actor: ctx.actor,
+        op: 'move',
+        summary: `${from} -> ${to}${documents.length > 0 ? ` with ${documents.length} attachment(s)` : ''}`,
+        files,
+    });
+    ctx.store.transaction(() => {
+        // Follow the id rather than retiring it — the same rule the watcher uses for a
+        // hand rename.
+        ctx.store.db.prepare('UPDATE pages SET slug = ?, rel_path = ? WHERE id = ?').run(to, toRelPath, page.id);
+        ctx.store.db.prepare('DELETE FROM files WHERE rel_path = ?').run(page.rel_path);
+        for (const document of documents) {
+            const next = destinations.get(document.rel_path);
+            // `renders` is a path, so it follows the file it points at — a rendition still naming
+            // the old folder is a rendition of nothing.
+            const renders = document.renders ? (destinations.get(document.renders) ?? null) : null;
+            ctx.store.db
+                .prepare('UPDATE documents SET rel_path = ?, renders = ? WHERE id = ?')
+                .run(next, renders, document.id);
+            ctx.store.db.prepare('DELETE FROM files WHERE rel_path = ?').run(document.rel_path);
+        }
+        recordOwnWrite(ctx.store, ctx.config.aknoPath, toRelPath, content, page.id);
+    });
+    // The page kept its id and its body, so nothing needs re-deriving — only the
+    // structural walk to notice the paths moved.
+    await ctx.indexer.runForeground({ modelPaths: [] });
+    return {
+        status: 'ok',
+        outcome: 'ok',
+        change_id: changeId,
+        moved,
+        ...(inbound.length > 0
+            ? {
+                broken_inbound: inbound.map((row) => row.slug),
+                note: `${inbound.length} page(s) still link to '${from}'. They are reported rather than rewritten — ` +
+                    'editing them is a bigger change than the one you asked for.',
+            }
+            : {}),
+    };
+}
+/**
+ * `documents/passport-ada-3f8c1a2b.jpg` moving with `documents/passport-ada`
+ * becomes `archive/id/passport-ada-3f8c1a2b.jpg` — the hash is content-addressing
+ * and must not change, since the bytes did not.
+ */
+function movedAttachmentPath(relPath, from, to) {
+    const base = path.posix.basename(relPath.replace(/\\/g, '/'));
+    const fromBase = from.split('/').pop();
+    const toBase = to.split('/').pop();
+    const toDir = to.includes('/') ? to.slice(0, to.lastIndexOf('/')) : '';
+    const addressed = ATTACHMENT_NAME.exec(base);
+    const nextBase = addressed && addressed[1] === fromBase
+        ? `${toBase}-${addressed[2]}.${addressed[3]}`
+        : base.startsWith(`${fromBase}.`)
+            ? `${toBase}${base.slice(fromBase.length)}`
+            : base;
+    return toDir ? `${toDir}/${nextBase}` : nextBase;
+}
+/**
+ * Where the text beside a document goes when that document moves.
+ *
+ * Both spellings follow the same principle — the rendition is named after what it renders,
+ * not after the page — so both are answered from the source's destination rather than from
+ * a second reading of the page name.
+ */
+function movedRenditionPath(relPath, renders, destinations) {
+    const source = destinations.get(renders);
+    if (!source)
+        return relPath;
+    // `contract.pdf.txt` keeps its suffix; `contract.txt` swaps the source's extension for it.
+    if (relPath === `${renders}.txt`)
+        return `${source}.txt`;
+    return `${source.slice(0, -path.posix.extname(source).length)}.txt`;
+}
+//# sourceMappingURL=move.js.map

package/dist/ops/move.js.map

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

package/dist/ops/read.d.ts

@@ -0,0 +1,9 @@
+import { type ReadOutput } from '@tenphi/akno-protocol';
+import type { AknoContext } from '../context.ts';
+/**
+ * `read({slug})` returns the full body of a `source` page every time.
+ * The role governs only what recall pulls in unprompted — **this is a relevance
+ * policy, not access control.**
+ */
+export declare function read(ctx: AknoContext, rawInput: unknown): Promise<ReadOutput>;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/ops/read.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAInF"}