@aipper/aiws 0.0.44 → 0.0.46

package/dist/commands/memory.js

@@ -0,0 +1,239 @@
+import { UserError } from "../errors.js";
+import { getWorkspaceRoot } from "../workspace.js";
+import { parseUri } from "../memory-bank/uri.js";
+import { readMemory, writeMemory } from "../memory-bank/store.js";
+import { loadIndex, saveIndex, rebuildIndex, updateIndex, } from "../memory-bank/index.js";
+import { searchMemories } from "../memory-bank/search.js";
+import { addLink, listLinks, removeLink } from "../memory-bank/link.js";
+import { listBootMemories } from "../memory-bank/disclosure.js";
+import { seedMemories } from "../memory-bank/seed.js";
+/**
+ * aiws memory read <uri>
+ */
+export async function memoryReadCommand(args) {
+    const uri = String(args.uri ?? "");
+    if (!uri)
+        throw new UserError("memory read requires <uri>", { details: "Usage: aiws memory read <uri>" });
+    const wsRoot = await getWorkspaceRoot();
+    const entry = await readMemory(wsRoot, uri);
+    console.log(`Title: ${entry.title}`);
+    console.log(`URI:   ${entry.uri}`);
+    console.log(`Path:  ${entry.path}`);
+    console.log(`Created: ${entry.created}`);
+    console.log(`Updated: ${entry.updated}`);
+    if (entry.disclosure)
+        console.log(`Disclosure: ${entry.disclosure}`);
+    if (entry.tags.length > 0)
+        console.log(`Tags:  ${entry.tags.join(", ")}`);
+    console.log("");
+    console.log(entry.body);
+}
+/**
+ * aiws memory write <uri> <text> [--title <title>] [--tags <tags>] [--disclosure <level>]
+ */
+export async function memoryWriteCommand(args) {
+    const uri = String(args.uri ?? "");
+    const text = String(args.text ?? "");
+    if (!uri || !text) {
+        throw new UserError("memory write requires <uri> <text>", {
+            details: "Usage: aiws memory write <uri> <text> [--title <title>] [--tags <tags>] [--disclosure <level>]",
+        });
+    }
+    const title = args.title ? String(args.title) : undefined;
+    const rawTags = args.tags ? String(args.tags) : undefined;
+    const tags = rawTags
+        ? rawTags.split(",").map((t) => t.trim()).filter(Boolean)
+        : undefined;
+    const disclosure = args.disclosure ? String(args.disclosure) : undefined;
+    const wsRoot = await getWorkspaceRoot();
+    await writeMemory(wsRoot, uri, text, { title, tags, disclosure });
+    // Update index
+    const parsed = parseUri(uri);
+    const entry = await readMemory(wsRoot, uri);
+    await updateIndex(wsRoot, uri, {
+        title: entry.title,
+        domain: entry.domain,
+        path: entry.path,
+        created: entry.created,
+        updated: entry.updated,
+        tags: entry.tags,
+        disclosure: entry.disclosure,
+    });
+    console.log(`✓ Memory written: ${uri}`);
+}
+/**
+ * aiws memory search <query>
+ */
+export async function memorySearchCommand(args) {
+    const query = String(args.query ?? "");
+    if (!query)
+        throw new UserError("memory search requires <query>", { details: "Usage: aiws memory search <query>" });
+    const wsRoot = await getWorkspaceRoot();
+    const results = await searchMemories(wsRoot, query);
+    if (results.length === 0) {
+        console.log("No results found.");
+        return;
+    }
+    for (const r of results) {
+        console.log(`\n${r.uri}`);
+        console.log(`  Title:   ${r.title}`);
+        console.log(`  Snippet: ${r.snippet}`);
+    }
+    console.log(`\n${results.length} result(s)`);
+}
+/**
+ * aiws memory list [domain]
+ */
+export async function memoryListCommand(args) {
+    const domainFilter = args.domain ? String(args.domain).trim() : undefined;
+    const wsRoot = await getWorkspaceRoot();
+    const index = await loadIndex(wsRoot);
+    const entries = Object.entries(index.memories)
+        .filter(([, entry]) => !domainFilter || entry.domain === domainFilter)
+        .sort(([a], [b]) => a.localeCompare(b));
+    if (entries.length === 0) {
+        console.log("No memories found.");
+        return;
+    }
+    // Determine column widths
+    let maxUri = 4; // "URI"
+    let maxTitle = 5; // "Title"
+    let maxTags = 4; // "Tags"
+    for (const [uri, entry] of entries) {
+        if (uri.length > maxUri)
+            maxUri = uri.length;
+        if (entry.title.length > maxTitle)
+            maxTitle = entry.title.length;
+        const tagsStr = entry.tags.join(", ");
+        if (tagsStr.length > maxTags)
+            maxTags = tagsStr.length;
+    }
+    // Clamp widths
+    if (maxUri > 50)
+        maxUri = 50;
+    if (maxTitle > 40)
+        maxTitle = 40;
+    if (maxTags > 30)
+        maxTags = 30;
+    const headerUri = "URI".padEnd(maxUri);
+    const headerTitle = "Title".padEnd(maxTitle);
+    const headerCreated = "Created";
+    const headerTags = "Tags".padEnd(maxTags);
+    const sep = "  ";
+    console.log(`${headerUri}${sep}${headerTitle}${sep}${headerCreated}${sep}${headerTags}`);
+    console.log(`${"-".repeat(maxUri)}${sep}${"-".repeat(maxTitle)}${sep}${"-".repeat(24)}${sep}${"-".repeat(maxTags)}`);
+    for (const [uri, entry] of entries) {
+        const dispUri = uri.length > 50 ? uri.slice(0, 47) + "..." : uri.padEnd(maxUri);
+        const dispTitle = entry.title.length > 40 ? entry.title.slice(0, 37) + "..." : entry.title.padEnd(maxTitle);
+        const dispCreated = (entry.created.slice(0, 10) ?? "").padEnd(24);
+        const dispTags = entry.tags.join(", ").length > 30
+            ? entry.tags.join(", ").slice(0, 27) + "..."
+            : entry.tags.join(", ").padEnd(maxTags);
+        console.log(`${dispUri}${sep}${dispTitle}${sep}${dispCreated}${sep}${dispTags}`);
+    }
+}
+/**
+ * aiws memory link add|list|rm
+ */
+export async function memoryLinkCommand(args) {
+    const action = String(args.action ?? "");
+    const wsRoot = await getWorkspaceRoot();
+    if (action === "add") {
+        const from = String(args.from ?? "");
+        const to = String(args.to ?? "");
+        if (!from || !to) {
+            throw new UserError("memory link add requires <from> <to>", {
+                details: "Usage: aiws memory link add <from-uri> <to-uri>",
+            });
+        }
+        await addLink(wsRoot, from, to);
+        console.log(`Link added: ${from} -> ${to}`);
+    }
+    else if (action === "list") {
+        const uri = String(args.uri ?? "");
+        if (!uri) {
+            throw new UserError("memory link list requires <uri>", {
+                details: "Usage: aiws memory link list <uri>",
+            });
+        }
+        const result = await listLinks(wsRoot, uri);
+        console.log(`Links for: ${uri}`);
+        if (result.outgoing.length > 0) {
+            console.log("  Outgoing:");
+            for (const link of result.outgoing) {
+                console.log(`    ${link.from} -> ${link.to} (${link.created.slice(0, 10)})`);
+            }
+        }
+        if (result.incoming.length > 0) {
+            console.log("  Incoming:");
+            for (const link of result.incoming) {
+                console.log(`    ${link.from} -> ${link.to} (${link.created.slice(0, 10)})`);
+            }
+        }
+        if (result.outgoing.length === 0 && result.incoming.length === 0) {
+            console.log("  (no links)");
+        }
+    }
+    else if (action === "rm") {
+        const from = String(args.from ?? "");
+        const to = String(args.to ?? "");
+        if (!from || !to) {
+            throw new UserError("memory link rm requires <from> <to>", {
+                details: "Usage: aiws memory link rm <from-uri> <to-uri>",
+            });
+        }
+        await removeLink(wsRoot, from, to);
+        console.log(`Link removed: ${from} -> ${to}`);
+    }
+}
+/**
+ * aiws memory boot
+ * Lists memories marked with disclosure: boot (or always).
+ * Scans index only — reads files only for snippet.
+ */
+export async function memoryBootCommand(_args) {
+    const wsRoot = await getWorkspaceRoot();
+    const entries = await listBootMemories(wsRoot);
+    if (entries.length === 0) {
+        console.log("No boot memories found. (Mark memories with --disclosure boot)");
+        return;
+    }
+    console.log(`Boot memories (${entries.length}):\n`);
+    for (const e of entries) {
+        console.log(`${e.uri}`);
+        console.log(`  Title:     ${e.title}`);
+        console.log(`  Disclosure: ${e.disclosure}`);
+        console.log(`  Snippet:   ${e.snippet}`);
+        console.log();
+    }
+}
+/**
+ * aiws memory seed [--dry-run] [--force]
+ * Seeds memory entries from project truth files and artifacts.
+ */
+export async function memorySeedCommand(args) {
+    const dryRun = args["dry-run"] === true || args.dryRun === true;
+    const force = args.force === true;
+    const wsRoot = await getWorkspaceRoot();
+    const result = await seedMemories(wsRoot, { dryRun, force });
+    if (dryRun) {
+        console.log(`Would seed ${result.uris.length} memories:`);
+        for (const uri of result.uris) {
+            console.log(`  ${uri}`);
+        }
+    }
+    else {
+        console.log(`Seeded ${result.written} memories (${result.skipped} skipped)`);
+    }
+}
+/**
+ * aiws memory rebuild-index
+ */
+export async function memoryRebuildIndexCommand(_args) {
+    const wsRoot = await getWorkspaceRoot();
+    const data = await rebuildIndex(wsRoot);
+    await saveIndex(wsRoot, data);
+    const count = Object.keys(data.memories).length;
+    console.log(`Index rebuilt: ${count} memory file(s) indexed`);
+}
+//# sourceMappingURL=memory.js.map

package/dist/commands/memory.js.map

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

package/dist/memory-bank/disclosure.d.ts

@@ -0,0 +1,24 @@
+import { RelatedEntry } from "./types.js";
+/**
+ * Resolve related memories for a given URI based on disclosure rules.
+ *
+ * Disclosure rules (evaluated per linked target):
+ * - `always`   → injected on every read
+ * - `boot`     → injected on session boot (use listBootMemories instead)
+ * - `parent`   → target注入 when source URI is read (A→B, B has `parent` → inject B when A read)
+ * - `tag:<kw>` → injected when kw is in the context token set
+ *
+ * @param wsRoot  workspace root
+ * @param uri    source URI being read
+ * @param context optional context string (e.g. source memory tags + title)
+ * @returns array of related entries, capped at MAX_RELATED
+ */
+export declare function resolveRelated(wsRoot: string, uri: string, context?: string): Promise<RelatedEntry[]>;
+/**
+ * List memories marked with `disclosure: boot`.
+ * Scan index only — zero file reads for match decision.
+ * Read file only for snippet when matched.
+ *
+ * @returns array of boot memories with snippets, capped at MAX_RELATED
+ */
+export declare function listBootMemories(wsRoot: string): Promise<RelatedEntry[]>;

package/dist/memory-bank/disclosure.js

@@ -0,0 +1,143 @@
+import { loadIndex } from "./index.js";
+import { listLinks } from "./link.js";
+import { readMemory } from "./store.js";
+const MAX_RELATED = 10;
+const BOOT_SNIPPET_LEN = 200;
+/**
+ * Tokenize a string for token-set matching.
+ * Splits on whitespace and punctuation, lowercases all tokens.
+ */
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/[\s,.;:!?'"`/\\()[\]{}|&^*+=~%@#$<>-]+/)
+        .filter((t) => t.length > 0));
+}
+/**
+ * Check if a `tag:keyword` disclosure rule matches the context.
+ * Uses token-set membership (NOT substring) to avoid false positives
+ * like `tag:rust` matching "frustrated".
+ */
+function tagMatches(disclosure, contextTokens) {
+    const kw = disclosure.slice(4).trim().toLowerCase(); // "tag:rust" → "rust"
+    if (!kw)
+        return false;
+    const kwTokens = tokenize(kw);
+    // Match if ALL kw tokens are present in context
+    for (const t of kwTokens) {
+        if (!contextTokens.has(t))
+            return false;
+    }
+    return true;
+}
+/**
+ * Resolve related memories for a given URI based on disclosure rules.
+ *
+ * Disclosure rules (evaluated per linked target):
+ * - `always`   → injected on every read
+ * - `boot`     → injected on session boot (use listBootMemories instead)
+ * - `parent`   → target注入 when source URI is read (A→B, B has `parent` → inject B when A read)
+ * - `tag:<kw>` → injected when kw is in the context token set
+ *
+ * @param wsRoot  workspace root
+ * @param uri    source URI being read
+ * @param context optional context string (e.g. source memory tags + title)
+ * @returns array of related entries, capped at MAX_RELATED
+ */
+export async function resolveRelated(wsRoot, uri, context) {
+    const index = await loadIndex(wsRoot);
+    const { outgoing } = await listLinks(wsRoot, uri);
+    // Build context token set from:
+    //   1. source memory's tags + title (if exists in index)
+    //   2. caller-provided context string
+    const sourceEntry = index.memories[uri];
+    const contextParts = [];
+    if (sourceEntry) {
+        contextParts.push(sourceEntry.title);
+        contextParts.push(...sourceEntry.tags);
+    }
+    if (context) {
+        contextParts.push(context);
+    }
+    const contextTokens = tokenize(contextParts.join(" "));
+    const results = [];
+    const seen = new Set();
+    for (const link of outgoing) {
+        if (results.length >= MAX_RELATED)
+            break;
+        const targetUri = link.to;
+        if (seen.has(targetUri))
+            continue;
+        seen.add(targetUri);
+        const targetEntry = index.memories[targetUri];
+        if (!targetEntry)
+            continue; // dangling link — skip
+        const disclosure = targetEntry.disclosure;
+        if (!disclosure)
+            continue;
+        const matched = disclosure === "always" ||
+            disclosure === "parent" ||
+            (disclosure.startsWith("tag:") && tagMatches(disclosure, contextTokens));
+        if (!matched)
+            continue;
+        // Read file for snippet (index already gave us title)
+        let snippet = "";
+        try {
+            const mem = await readMemory(wsRoot, targetUri);
+            snippet = mem.body.slice(0, BOOT_SNIPPET_LEN).trim();
+            if (mem.body.length > BOOT_SNIPPET_LEN)
+                snippet += "...";
+        }
+        catch {
+            // Dangling link or unreadable file — skip
+            continue;
+        }
+        results.push({
+            uri: targetUri,
+            title: targetEntry.title,
+            disclosure,
+            snippet,
+        });
+    }
+    return results;
+}
+/**
+ * List memories marked with `disclosure: boot`.
+ * Scan index only — zero file reads for match decision.
+ * Read file only for snippet when matched.
+ *
+ * @returns array of boot memories with snippets, capped at MAX_RELATED
+ */
+export async function listBootMemories(wsRoot) {
+    const index = await loadIndex(wsRoot);
+    const results = [];
+    // Sort by updated desc for deterministic ordering
+    const candidates = Object.entries(index.memories)
+        .filter(([, entry]) => {
+        const d = entry.disclosure;
+        return d === "boot" || d === "always";
+    })
+        .sort(([, a], [, b]) => (b.updated || "").localeCompare(a.updated || ""));
+    for (const [uri, entry] of candidates) {
+        if (results.length >= MAX_RELATED)
+            break;
+        let snippet = "";
+        try {
+            const mem = await readMemory(wsRoot, uri);
+            snippet = mem.body.slice(0, BOOT_SNIPPET_LEN).trim();
+            if (mem.body.length > BOOT_SNIPPET_LEN)
+                snippet += "...";
+        }
+        catch {
+            continue;
+        }
+        results.push({
+            uri,
+            title: entry.title,
+            disclosure: entry.disclosure || "boot",
+            snippet,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=disclosure.js.map

package/dist/memory-bank/disclosure.js.map

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

package/dist/memory-bank/index.d.ts

@@ -0,0 +1,24 @@
+import { IndexData, IndexEntry } from "./types.js";
+/**
+ * Load the memory index from .index.yaml.
+ * Returns an empty IndexData if the file doesn't exist or is invalid.
+ */
+export declare function loadIndex(wsRoot: string): Promise<IndexData>;
+/**
+ * Save the memory index to .index.yaml.
+ */
+export declare function saveIndex(wsRoot: string, data: IndexData): Promise<void>;
+/**
+ * Update or insert a single entry in the index.
+ */
+export declare function updateIndex(wsRoot: string, uri: string, entry: IndexEntry): Promise<void>;
+/**
+ * Remove an entry from the index.
+ */
+export declare function removeFromIndex(wsRoot: string, uri: string): Promise<void>;
+/**
+ * Rebuild the entire index by scanning all MD files in memory-bank/.
+ * For existing files without frontmatter, it auto-generates metadata
+ * and writes updated frontmatter back with the 'updated' timestamp.
+ */
+export declare function rebuildIndex(wsRoot: string): Promise<IndexData>;

package/dist/memory-bank/index.js

@@ -0,0 +1,137 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import yaml from "js-yaml";
+import { getMemoryBankDir, readMemory, collectMemoryFiles } from "./store.js";
+import { pathExists } from "../fs.js";
+const INDEX_FILENAME = ".index.yaml";
+/**
+ * Get the absolute path to the index file.
+ */
+function getIndexPath(wsRoot) {
+    return path.join(getMemoryBankDir(wsRoot), INDEX_FILENAME);
+}
+/**
+ * Load the memory index from .index.yaml.
+ * Returns an empty IndexData if the file doesn't exist or is invalid.
+ */
+export async function loadIndex(wsRoot) {
+    const indexPath = getIndexPath(wsRoot);
+    if (!(await pathExists(indexPath))) {
+        return { memories: {} };
+    }
+    try {
+        const raw = await fs.readFile(indexPath, "utf8");
+        const parsed = yaml.load(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            const data = parsed;
+            const memories = data.memories;
+            if (memories && typeof memories === "object" && !Array.isArray(memories)) {
+                const result = { memories: {} };
+                for (const [key, val] of Object.entries(memories)) {
+                    if (val && typeof val === "object") {
+                        const entry = val;
+                        result.memories[key] = {
+                            title: String(entry.title ?? ""),
+                            domain: String(entry.domain ?? ""),
+                            path: String(entry.path ?? ""),
+                            created: String(entry.created ?? ""),
+                            updated: String(entry.updated ?? ""),
+                            tags: Array.isArray(entry.tags) ? entry.tags.map(String) : [],
+                            disclosure: entry.disclosure ? String(entry.disclosure) : undefined,
+                        };
+                    }
+                }
+                return result;
+            }
+        }
+        return { memories: {} };
+    }
+    catch {
+        return { memories: {} };
+    }
+}
+/**
+ * Save the memory index to .index.yaml.
+ */
+export async function saveIndex(wsRoot, data) {
+    const indexPath = getIndexPath(wsRoot);
+    const yamlStr = yaml.dump(data, { lineWidth: 120, noRefs: true });
+    await fs.writeFile(indexPath, yamlStr, "utf8");
+}
+/**
+ * Update or insert a single entry in the index.
+ */
+export async function updateIndex(wsRoot, uri, entry) {
+    const data = await loadIndex(wsRoot);
+    data.memories[uri] = entry;
+    await saveIndex(wsRoot, data);
+}
+/**
+ * Remove an entry from the index.
+ */
+export async function removeFromIndex(wsRoot, uri) {
+    const data = await loadIndex(wsRoot);
+    delete data.memories[uri];
+    await saveIndex(wsRoot, data);
+}
+/**
+ * Rebuild the entire index by scanning all MD files in memory-bank/.
+ * For existing files without frontmatter, it auto-generates metadata
+ * and writes updated frontmatter back with the 'updated' timestamp.
+ */
+export async function rebuildIndex(wsRoot) {
+    const files = await collectMemoryFiles(wsRoot);
+    const data = { memories: {} };
+    for (const relPath of files) {
+        // Derive URI from relative path:
+        //   domain/path.md -> domain://path (file in subdirectory)
+        //   filename.md   -> general://filename (flat file, backward compat)
+        const parts = relPath.replaceAll(path.sep, "/").split("/");
+        let domain;
+        let name;
+        if (parts.length > 1) {
+            domain = parts[0] ?? "general";
+            name = (parts[parts.length - 1] ?? "").replace(/\.md$/, "");
+        }
+        else {
+            domain = "general";
+            name = (parts[0] ?? "").replace(/\.md$/, "");
+        }
+        const uri = `${domain}://${name}`;
+        try {
+            const entry = await readMemory(wsRoot, uri);
+            // If the file had no frontmatter (auto-inferred), write it back
+            if (!entry.frontmatter || Object.keys(entry.frontmatter).length === 0) {
+                const frontmatter = {
+                    title: entry.title,
+                    created: entry.created,
+                    updated: new Date().toISOString(),
+                };
+                if (entry.tags.length > 0)
+                    frontmatter.tags = entry.tags;
+                if (entry.disclosure)
+                    frontmatter.disclosure = entry.disclosure;
+                const memDir = getMemoryBankDir(wsRoot);
+                const absPath = path.join(memDir, relPath);
+                const yamlStr = yaml.dump(frontmatter, { lineWidth: 120, noRefs: true });
+                const content = `---\n${yamlStr}---\n${entry.body}\n`;
+                await fs.writeFile(absPath, content, "utf8");
+            }
+            data.memories[uri] = {
+                title: entry.title,
+                domain: entry.domain,
+                path: entry.path,
+                created: entry.created,
+                updated: entry.updated,
+                tags: entry.tags,
+                disclosure: entry.disclosure,
+            };
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    await saveIndex(wsRoot, data);
+    return data;
+}
+//# sourceMappingURL=index.js.map

package/dist/memory-bank/index.js.map

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

package/dist/memory-bank/link.d.ts

@@ -0,0 +1,21 @@
+import { Link } from "./types.js";
+/**
+ * Get the absolute path to the links database file.
+ */
+export declare function getLinksDbPath(wsRoot: string): string;
+/**
+ * Add a directed link from `from` to `to`.
+ * Validates both URIs. Warns if either URI is not in the index.
+ */
+export declare function addLink(wsRoot: string, from: string, to: string): Promise<void>;
+/**
+ * List outgoing and incoming links for a URI.
+ */
+export declare function listLinks(wsRoot: string, uri: string): Promise<{
+    outgoing: Link[];
+    incoming: Link[];
+}>;
+/**
+ * Remove a specific link entry.
+ */
+export declare function removeLink(wsRoot: string, from: string, to: string): Promise<void>;