@wastedcode/memex 0.1.0

package/dist/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { serveCommand } from './cli/commands/serve.js';
+import { createCommand } from './cli/commands/create.js';
+import { destroyCommand } from './cli/commands/destroy.js';
+import { configCommand } from './cli/commands/config.js';
+import { loginCommand } from './cli/commands/login.js';
+import { ingestCommand } from './cli/commands/ingest.js';
+import { queryCommand } from './cli/commands/query.js';
+import { lintCommand } from './cli/commands/lint.js';
+import { logsCommand } from './cli/commands/logs.js';
+import { listCommand } from './cli/commands/list.js';
+import { chownCommand } from './cli/commands/chown.js';
+import { statusCommand } from './cli/commands/status.js';
+const program = new Command();
+program
+    .name('memex')
+    .description('Isolated, queued claude -p runtime for persistent knowledge bases')
+    .version('0.1.0');
+program.addCommand(serveCommand);
+program.addCommand(createCommand);
+program.addCommand(destroyCommand);
+program.addCommand(configCommand);
+program.addCommand(loginCommand);
+program.addCommand(ingestCommand);
+program.addCommand(queryCommand);
+program.addCommand(lintCommand);
+program.addCommand(logsCommand);
+program.addCommand(listCommand);
+program.addCommand(chownCommand);
+program.addCommand(statusCommand);
+program.parseAsync().catch((err) => {
+    console.error(err.message ?? err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,mEAAmE,CAAC;KAChF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/constants.d.ts

@@ -0,0 +1,17 @@
+import type { JobType, JobLimits } from './types.js';
+export declare const DATA_DIR: string;
+export declare const RUN_DIR: string;
+export declare const SOCKET_PATH: string;
+export declare const DB_PATH: string;
+export declare const WIKIS_DIR: string;
+export declare const NS_DIR: string;
+export declare const WORKSPACE_MOUNT = "/workspace";
+export declare const JOB_LIMITS: Record<JobType, JobLimits>;
+export declare const SIGTERM_GRACE_MS = 5000;
+export declare const AUTO_LINT_INTERVAL = 10;
+export declare const JOB_POLL_INTERVAL_MS = 500;
+export declare const DEFAULT_MODEL = "sonnet";
+export declare const BASE_ALLOWED_TOOLS: string[];
+/** Tools that may be added via .tools/allowed-tools.txt. Bash and other shell/code tools are excluded. */
+export declare const ALLOWED_TOOLS_WHITELIST: Set<string>;
+export declare const WIKI_ID_PATTERN: RegExp;

package/dist/lib/constants.js

@@ -0,0 +1,30 @@
+// ── Paths (overridable via env) ──────────────────────────────────────────────
+export const DATA_DIR = process.env['MEMEX_DATA_DIR'] ?? '/var/lib/memex';
+export const RUN_DIR = process.env['MEMEX_RUN_DIR'] ?? '/run/memex';
+export const SOCKET_PATH = process.env['MEMEX_SOCKET_PATH'] ?? `${RUN_DIR}/memex.sock`;
+export const DB_PATH = `${DATA_DIR}/memex.db`;
+export const WIKIS_DIR = `${DATA_DIR}/wikis`;
+export const NS_DIR = `${RUN_DIR}/ns`;
+// Mount target inside namespaces — must exist on host as empty directory
+export const WORKSPACE_MOUNT = '/workspace';
+// ── Job limits ───────────────────────────────────────────────────────────────
+export const JOB_LIMITS = {
+    ingest: { timeout_ms: 5 * 60_000, max_turns: 25 },
+    query: { timeout_ms: 2 * 60_000, max_turns: 15 },
+    lint: { timeout_ms: 10 * 60_000, max_turns: 30 },
+};
+// ── Process management ───────────────────────────────────────────────────────
+export const SIGTERM_GRACE_MS = 5_000;
+export const AUTO_LINT_INTERVAL = 10;
+export const JOB_POLL_INTERVAL_MS = 500;
+// ── Claude defaults ──────────────────────────────────────────────────────────
+export const DEFAULT_MODEL = 'sonnet';
+export const BASE_ALLOWED_TOOLS = ['Read', 'Write', 'Edit', 'Glob', 'Grep'];
+/** Tools that may be added via .tools/allowed-tools.txt. Bash and other shell/code tools are excluded. */
+export const ALLOWED_TOOLS_WHITELIST = new Set([
+    'Read', 'Write', 'Edit', 'Glob', 'Grep',
+    'NotebookEdit', 'WebFetch', 'WebSearch',
+]);
+// ── Validation ───────────────────────────────────────────────────────────────
+export const WIKI_ID_PATTERN = /^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/;
+//# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAEhF,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,CAAC;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,YAAY,CAAC;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,GAAG,OAAO,aAAa,CAAC;AACvF,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,QAAQ,WAAW,CAAC;AAC9C,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,QAAQ,QAAQ,CAAC;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC;AAEtC,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C,gFAAgF;AAEhF,MAAM,CAAC,MAAM,UAAU,GAA+B;IACpD,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;IACjD,KAAK,EAAG,EAAE,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;IACjD,IAAI,EAAI,EAAE,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;CACnD,CAAC;AAEF,gFAAgF;AAEhF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,gFAAgF;AAEhF,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5E,0GAA0G;AAC1G,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IAC7C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IACvC,cAAc,EAAE,UAAU,EAAE,WAAW;CACxC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,MAAM,CAAC,MAAM,eAAe,GAAG,mCAAmC,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,32 @@
+export declare class MemexError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+export declare class WikiNotFoundError extends MemexError {
+    constructor(wikiId: string);
+}
+export declare class WikiExistsError extends MemexError {
+    constructor(wikiId: string);
+}
+export declare class JobNotFoundError extends MemexError {
+    constructor(jobId: number);
+}
+export declare class NamespaceError extends MemexError {
+    constructor(message: string);
+}
+export declare class CapabilityError extends MemexError {
+    constructor();
+}
+export declare class NoCredentialsError extends MemexError {
+    constructor(wikiId: string);
+}
+export declare class ForbiddenError extends MemexError {
+    constructor(wikiId: string);
+}
+export declare class ValidationError extends MemexError {
+    constructor(message: string);
+}
+export declare class DaemonNotRunningError extends MemexError {
+    constructor();
+}

package/dist/lib/errors.js

@@ -0,0 +1,64 @@
+export class MemexError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode = 500) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'MemexError';
+    }
+}
+export class WikiNotFoundError extends MemexError {
+    constructor(wikiId) {
+        super(`Wiki '${wikiId}' not found`, 'WIKI_NOT_FOUND', 404);
+    }
+}
+export class WikiExistsError extends MemexError {
+    constructor(wikiId) {
+        super(`Wiki '${wikiId}' already exists`, 'WIKI_EXISTS', 409);
+    }
+}
+export class JobNotFoundError extends MemexError {
+    constructor(jobId) {
+        super(`Job #${jobId} not found`, 'JOB_NOT_FOUND', 404);
+    }
+}
+export class NamespaceError extends MemexError {
+    constructor(message) {
+        super(message, 'NAMESPACE_ERROR', 500);
+    }
+}
+export class CapabilityError extends MemexError {
+    constructor() {
+        super('CAP_SYS_ADMIN is required for mount namespace isolation.\n' +
+            'Options:\n' +
+            '  1. Run the daemon as root: sudo memex serve\n' +
+            '  2. Use systemd with AmbientCapabilities=CAP_SYS_ADMIN\n' +
+            '  3. Grant capability: sudo setcap cap_sys_admin+ep $(which node)', 'NO_CAP_SYS_ADMIN', 500);
+    }
+}
+export class NoCredentialsError extends MemexError {
+    constructor(wikiId) {
+        super(`No credentials configured for wiki '${wikiId}'.\n` +
+            'Set credentials with:\n' +
+            `  memex login ${wikiId}          (OAuth)\n` +
+            `  memex config ${wikiId} --set-key  (API key)`, 'NO_CREDENTIALS', 400);
+    }
+}
+export class ForbiddenError extends MemexError {
+    constructor(wikiId) {
+        super(`Access denied to wiki '${wikiId}'`, 'FORBIDDEN', 403);
+    }
+}
+export class ValidationError extends MemexError {
+    constructor(message) {
+        super(message, 'VALIDATION_ERROR', 400);
+    }
+}
+export class DaemonNotRunningError extends MemexError {
+    constructor() {
+        super('Cannot connect to memex daemon.\n' +
+            'Start it with: memex serve', 'DAEMON_NOT_RUNNING', 502);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAG1B;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,aAAqB,GAAG;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAc;QAG/B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,MAAc;QACxB,KAAK,CAAC,SAAS,MAAM,aAAa,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,MAAc;QACxB,KAAK,CAAC,SAAS,MAAM,kBAAkB,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC9C,YAAY,KAAa;QACvB,KAAK,CAAC,QAAQ,KAAK,YAAY,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C;QACE,KAAK,CACH,4DAA4D;YAC5D,YAAY;YACZ,iDAAiD;YACjD,2DAA2D;YAC3D,mEAAmE,EACnE,kBAAkB,EAClB,GAAG,CACJ,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,MAAc;QACxB,KAAK,CACH,uCAAuC,MAAM,MAAM;YACnD,yBAAyB;YACzB,iBAAiB,MAAM,qBAAqB;YAC5C,kBAAkB,MAAM,uBAAuB,EAC/C,gBAAgB,EAChB,GAAG,CACJ,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,MAAc;QACxB,KAAK,CAAC,0BAA0B,MAAM,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD;QACE,KAAK,CACH,mCAAmC;YACnC,4BAA4B,EAC5B,oBAAoB,EACpB,GAAG,CACJ,CAAC;IACJ,CAAC;CACF"}

package/dist/lib/prompts/ingest.d.ts

@@ -0,0 +1,9 @@
+import type { IngestPayload } from '../types.js';
+/**
+ * Build the prompt for an ingest job.
+ *
+ * Claude reads the raw source files and integrates them into the wiki.
+ * This is not just filing — it's building understanding. The wiki should
+ * get richer with every ingest, not just wider.
+ */
+export declare function buildIngestPrompt(payload: IngestPayload): string;

package/dist/lib/prompts/ingest.js

@@ -0,0 +1,48 @@
+/**
+ * Build the prompt for an ingest job.
+ *
+ * Claude reads the raw source files and integrates them into the wiki.
+ * This is not just filing — it's building understanding. The wiki should
+ * get richer with every ingest, not just wider.
+ */
+export function buildIngestPrompt(payload) {
+    const fileList = payload.files
+        .map(f => `- raw/${f}`)
+        .join('\n');
+    return `New source documents have been added to the knowledge base.
+
+Source files to process:
+${fileList}
+
+Integrate these into the wiki:
+
+1. Read each source file listed above.
+2. Read _schema.md for current conventions (create it if it doesn't exist — this is a new knowledge base).
+3. Read _index.md to see what's already filed.
+4. Search existing wiki pages for related content (grep for names, topics, themes).
+5. For each source document:
+   a. Extract key facts, concepts, entities, and relationships.
+   b. Determine which existing pages should be updated and which new pages should be created.
+   c. Create or update wiki pages with the extracted information.
+   d. Maintain bidirectional links — if you link A→B, update B→A too.
+   e. Update _index.md with current summaries for all affected pages.
+6. Append a dated ingest entry to _log.md summarizing what was ingested and what pages were affected.
+
+Rules:
+- NEVER modify files in raw/ — they are immutable sources
+- Prefer updating existing pages over creating duplicates
+- If a source contradicts existing wiki content, UPDATE the existing page — resolve or flag the contradiction
+- Keep pages focused — one topic per page
+- Use descriptive kebab-case paths: themes/pricing-feedback.md, customers/acme-corp.md
+- Every page must have a ## Related section with labeled, bidirectional links
+- The "reason" for each change should articulate what it ADDS to the knowledge base — not mechanics
+
+After completing all file operations, output ONLY valid JSON (no markdown fences, no explanation):
+{
+  "summary": "one-line human summary of what you filed",
+  "operations": [
+    {"action": "create|update", "path": "relative/path.md", "reason": "what this adds to the knowledge base"}
+  ]
+}`;
+}
+//# sourceMappingURL=ingest.js.map

package/dist/lib/prompts/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../src/lib/prompts/ingest.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;SACtB,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;EAGP,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BR,CAAC;AACH,CAAC"}

package/dist/lib/prompts/lint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Build the prompt for a lint/maintenance job.
+ *
+ * Claude examines the knowledge base holistically. Finds contradictions,
+ * stale claims, orphan pages, missing connections. Applies confident fixes
+ * directly, flags everything else in a report.
+ */
+export declare function buildLintPrompt(): string;

package/dist/lib/prompts/lint.js

@@ -0,0 +1,62 @@
+/**
+ * Build the prompt for a lint/maintenance job.
+ *
+ * Claude examines the knowledge base holistically. Finds contradictions,
+ * stale claims, orphan pages, missing connections. Applies confident fixes
+ * directly, flags everything else in a report.
+ */
+export function buildLintPrompt() {
+    const date = new Date().toISOString().split('T')[0];
+    return `Perform a thorough health check on this knowledge base. Today is ${date}.
+
+Read all wiki files (glob **/*.md, excluding raw/) and check for:
+
+1. **Contradictions** — pages making conflicting claims about the same entity or fact
+2. **Stale claims** — date-stamped statements that may no longer be current
+3. **Orphan pages** — pages with no inbound links from other pages' ## Related sections
+4. **Missing pages** — concepts mentioned across multiple pages that deserve their own page
+5. **Duplicate pages** — topics covered by two pages that should be merged
+6. **Missing cross-references** — pages discussing entities with their own pages but not linking
+7. **Index accuracy** — _index.md entries that don't match file content, or missing entries
+8. **Schema drift** — actual patterns that don't match _schema.md conventions
+
+For issues you're CONFIDENT about, fix them directly:
+- Add missing cross-references and ## Related links (bidirectional)
+- Correct _index.md entries
+- Add ## Related sections to pages that lack them
+- Fix schema drift in _schema.md
+
+For issues requiring human judgment (contradictions, merges, stale facts), note them in your report but do NOT change the files.
+
+Do NOT rewrite pages for style — only fix semantic issues.
+
+After making fixes, append a lint entry to _log.md.
+
+Output a markdown health check report:
+
+# Knowledge Base Health Check — ${date}
+
+## Contradictions
+(numbered list with specific pages and quotes)
+
+## Stale Claims
+(numbered list with page, claim, and age)
+
+## Orphan Pages
+(list with page path and suggested connections)
+
+## Missing Cross-References
+(specific A→B links that should exist)
+
+## Auto-Fixes Applied
+(list of changes you made directly)
+
+## Flagged for Review
+(issues needing human judgment)
+
+## Statistics
+- Total pages: N
+- Pages with ## Related: N
+- Orphan pages: N`;
+}
+//# sourceMappingURL=lint.js.map

package/dist/lib/prompts/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../../src/lib/prompts/lint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,OAAO,oEAAoE,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA2B/C,IAAI;;;;;;;;;;;;;;;;;;;;;;;kBAuBpB,CAAC;AACnB,CAAC"}

package/dist/lib/prompts/query.d.ts

@@ -0,0 +1,8 @@
+import type { QueryPayload } from '../types.js';
+/**
+ * Build the prompt for a query job.
+ *
+ * Claude searches the wiki and synthesizes an answer grounded in the
+ * knowledge base. It's not a generic assistant — it's the voice of the wiki.
+ */
+export declare function buildQueryPrompt(payload: QueryPayload): string;

package/dist/lib/prompts/query.js

@@ -0,0 +1,37 @@
+/**
+ * Build the prompt for a query job.
+ *
+ * Claude searches the wiki and synthesizes an answer grounded in the
+ * knowledge base. It's not a generic assistant — it's the voice of the wiki.
+ */
+export function buildQueryPrompt(payload) {
+    let prompt = `You are the voice of a living knowledge base. Answer the user's question by searching the wiki files in this directory.
+
+Question: ${payload.question}
+
+RULES:
+1. ONLY reference information that exists in the wiki files. Never use training data for facts.
+2. Always cite the specific file path when referencing information (e.g. \`themes/pricing.md\`).
+3. If the wiki has no relevant information, say so clearly: "The knowledge base doesn't have information on that topic yet."
+4. If you notice contradictions between pages, mention them.
+5. If coverage is thin on a topic, note it: "Coverage on X is thin — only one source."
+6. If your answer synthesizes multiple pages into new insight, mention it could be saved to the wiki as a new page.
+7. Keep responses concise and specific. Cite evidence, don't summarize generically.
+
+To answer:
+- Read _index.md to understand what's in the knowledge base
+- Search for relevant files using grep and glob
+- Read the files that seem relevant
+- Synthesize an answer grounded in what you found
+
+Provide your answer as plain markdown. Be concise but thorough.`;
+    if (payload.history && payload.history.length > 0) {
+        prompt += '\n\nConversation so far:\n';
+        for (const turn of payload.history) {
+            prompt += `${turn}\n\n`;
+        }
+        prompt += 'Answer the last message.';
+    }
+    return prompt;
+}
+//# sourceMappingURL=query.js.map

package/dist/lib/prompts/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/lib/prompts/query.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,IAAI,MAAM,GAAG;;YAEH,OAAO,CAAC,QAAQ;;;;;;;;;;;;;;;;;gEAiBoC,CAAC;IAE/D,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,4BAA4B,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC;QAC1B,CAAC;QACD,MAAM,IAAI,0BAA0B,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/prompts/wiki.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wiki system prompt — injected via --append-system-prompt.
+ *
+ * This IS the product. Every sentence is a product decision.
+ * Not stored as CLAUDE.md (we don't rely on auto-discovery for core behavior).
+ * Passed explicitly to each claude -p invocation for full control.
+ *
+ * Users extend via .claude.md (auto-discovered by Claude Code).
+ * This prompt provides the baseline; .claude.md provides wiki-specific customization.
+ */
+export declare function getWikiSystemPrompt(): string;

package/dist/lib/prompts/wiki.js

@@ -0,0 +1,112 @@
+/**
+ * Wiki system prompt — injected via --append-system-prompt.
+ *
+ * This IS the product. Every sentence is a product decision.
+ * Not stored as CLAUDE.md (we don't rely on auto-discovery for core behavior).
+ * Passed explicitly to each claude -p invocation for full control.
+ *
+ * Users extend via .claude.md (auto-discovered by Claude Code).
+ * This prompt provides the baseline; .claude.md provides wiki-specific customization.
+ */
+// ---------------------------------------------------------------------------
+// The prompt is the product.
+//
+// This system prompt defines how Claude thinks about the knowledge base.
+// Every sentence is a product decision. Edit with the same care as a core
+// algorithm — test changes, review results, document iterations.
+// ---------------------------------------------------------------------------
+export function getWikiSystemPrompt() {
+    return `You are the curator of a living knowledge base. Your job is not just to file information — it's to build and maintain a persistent, compounding artifact where every conversation makes the whole richer.
+
+Think of yourself as the curator of a wiki, not a filing clerk. When you process a source, you're not just extracting facts — you're integrating new understanding into an evolving body of knowledge. The connections between documents are as valuable as the documents themselves.
+
+On every call, think about:
+1. What does this source add to what we already know?
+2. Does it confirm, extend, or contradict existing understanding?
+3. Which existing pages need to know about this? Which pages does this need to know about?
+4. Are there patterns emerging that deserve their own page?
+5. Should any conventions or filing rules be updated based on what we've learned?
+
+IMPORTANT: You are operating in a sandboxed wiki directory. Only read and write files within this directory using relative paths. Do not use absolute paths. Do not attempt to access files outside this directory.
+
+## Directory structure
+
+- \`_schema.md\` — Filing conventions, categories, domain vocabulary, filing heuristics. YOUR institutional memory.
+- \`_index.md\` — One-line summary of every wiki page, organized by category. The table of contents.
+- \`_log.md\` — Chronological activity log. You maintain this.
+- \`raw/\` — Immutable source documents. NEVER modify or delete these files.
+- Everything else — Wiki pages organized by entity and topic.
+
+## Your responsibilities
+
+### 1. Schema (_schema.md)
+You own the schema. Update it when you establish or refine conventions — new categories, naming patterns, domain vocabulary, filing heuristics, things to ignore.
+
+On the FIRST call for a new knowledge base (no _schema.md exists), CREATE it with the conventions you establish. Suggested starting categories (adapt to what fits):
+- customers/ — profiles and feedback per person or company
+- themes/ — cross-cutting topics
+- products/ — organized by product area
+- research/ — deep dives and analyses
+- reference/ — factual reference material
+
+### 2. Index (_index.md)
+ALWAYS keep _index.md current. Every wiki page gets a one-line summary: what it contains, how many connections, what matters most. Organize by category. A reader should understand the shape of the entire knowledge base by reading only the index.
+
+Format:
+\`\`\`
+## category
+- path/to/file.md — One-line semantic summary [N connections]
+\`\`\`
+
+### 3. Connections (## Related)
+Every wiki page you create or update MUST have a \`## Related\` section at the bottom with labeled, bidirectional links:
+
+\`\`\`
+## Related
+- **Topic:** [themes/pricing.md](themes/pricing.md) — related pricing analysis
+- **Entity:** [customers/acme.md](customers/acme.md) — mentioned in their feedback
+- **Contradicts:** [research/market-size.md](research/market-size.md) — conflicting data point
+\`\`\`
+
+Connection labels should be domain-appropriate: Topic, Entity, Source, Contradicts, See also, etc.
+
+CRITICAL: If you add a link from A to B, you MUST also update B to link back to A. Both sides of every connection. Always.
+
+### 4. Activity log (_log.md)
+After completing any operation, append an entry to _log.md:
+
+\`\`\`
+## [YYYY-MM-DD HH:MM] type | source
+Summary of what happened
+- Detail 1
+- Detail 2
+\`\`\`
+
+Types: ingest, lint, query. If _log.md doesn't exist, create it with a header.
+
+### 5. Contradictions
+When new information conflicts with an existing page, UPDATE the existing page — resolve the contradiction or flag it clearly. Never file contradictory claims in separate pages without acknowledging the conflict.
+
+### 6. Look up before writing
+ALWAYS read existing files before creating new ones. Search with grep and glob. Prefer updating existing pages over creating duplicates. The knowledge base should grow deeper, not just wider.
+
+### 7. Source references
+Each wiki page should reference its raw sources: \`*Source: [raw/filename.md](raw/filename.md)*\`
+
+### 8. Ongoing tuning
+As you process more sources, notice patterns:
+- Are certain categories getting too broad? Split them.
+- Are there clusters of related pages that need a synthesis page?
+- Is the schema still serving the content well? Evolve it.
+- Are naming conventions consistent? Fix drift.
+
+Update _schema.md to reflect what you learn.
+
+## Page format
+- Organize by entity and topic, not by date
+- kebab-case for all file paths
+- Self-contained and readable with no other context
+- Preserve key quotes verbatim with attribution and date
+- Include source references`;
+}
+//# sourceMappingURL=wiki.js.map

package/dist/lib/prompts/wiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.js","sourceRoot":"","sources":["../../../src/lib/prompts/wiki.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,6BAA6B;AAC7B,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,iEAAiE;AACjE,8EAA8E;AAE9E,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA2FmB,CAAC;AAC7B,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,76 @@
+export interface Wiki {
+    id: string;
+    name: string;
+    owner_uid: number;
+    default_model: string;
+    created_at: string;
+}
+export interface WikiConfig {
+    name?: string;
+    default_model?: string;
+    allowed_tools?: string[];
+}
+export type JobType = 'ingest' | 'query' | 'lint';
+export type JobStatus = 'pending' | 'running' | 'completed' | 'failed';
+export interface QueueJob {
+    id: number;
+    wiki_id: string;
+    type: JobType;
+    payload: string;
+    status: JobStatus;
+    retry_count: number;
+    created_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+    result: string | null;
+}
+export interface IngestPayload {
+    files: string[];
+}
+export interface QueryPayload {
+    question: string;
+    history?: string[];
+}
+export interface LintPayload {
+}
+export interface JobResult {
+    success: boolean;
+    output: string;
+    exit_code: number;
+    duration_ms: number;
+}
+export interface AuditEntry {
+    id: number;
+    wiki_id: string;
+    action: string;
+    detail: string | null;
+    created_at: string;
+}
+export interface ApiResponse<T = unknown> {
+    ok: boolean;
+    data?: T;
+    error?: string;
+}
+export interface CreateWikiRequest {
+    id: string;
+    name?: string;
+}
+export interface SubmitJobRequest {
+    type: JobType;
+    payload: IngestPayload | QueryPayload | LintPayload;
+    wait?: boolean;
+}
+export interface RouteResponse {
+    status: number;
+    body: ApiResponse;
+}
+export interface JobLimits {
+    timeout_ms: number;
+    max_turns: number;
+}
+export interface DaemonConfig {
+    socketPath: string;
+    dataDir: string;
+    runDir: string;
+    autoLintInterval: number;
+}

package/dist/lib/types.js

@@ -0,0 +1,3 @@
+// ── Wiki ─────────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,gFAAgF"}