linksee-memory 0.16.1 → 0.17.0

package/dist/bin/setup.js

@@ -49,20 +49,20 @@ const noGuard = args.includes('--no-guard');
 const projectGuard = args.includes('--project-guard');
 const showHelp = args.includes('--help') || args.includes('-h');
 if (showHelp) {
-    console.log(`linksee-memory-setup — One-command setup for Linksee Memory
-
-Usage:
-  npx linksee-memory setup          Interactive setup
-  npx linksee-memory setup --yes    Accept all defaults, no prompts
-  npx linksee-memory setup --dry-run Show what would happen
-
-What it does:
-  1. Registers linksee-memory MCP server with Claude Code
-  2. Installs SKILL.md (teaches the agent when to recall/remember)
-  3. Configures Stop hook (auto-captures every session)
-  4. Offers to wire the re-injection guard into THIS project's .claude/settings.json
-
-After setup, just chat with Claude Code normally.
+    console.log(`linksee-memory-setup — One-command setup for Linksee Memory
+
+Usage:
+  npx linksee-memory setup          Interactive setup
+  npx linksee-memory setup --yes    Accept all defaults, no prompts
+  npx linksee-memory setup --dry-run Show what would happen
+
+What it does:
+  1. Registers linksee-memory MCP server with Claude Code
+  2. Installs SKILL.md (teaches the agent when to recall/remember)
+  3. Configures Stop hook (auto-captures every session)
+  4. Offers to wire the re-injection guard into THIS project's .claude/settings.json
+
+After setup, just chat with Claude Code normally.
 Add "Use Linksee" to any prompt to trigger memory recall.`);
     process.exit(0);
 }

package/dist/bin/share-draft.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/share-draft.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+// linksee-memory share-draft — print a link to KanseiLINK's reviewed draft page for a field note.
+// Same checks and the same builder as the MCP tool `share_draft` (src/lib/share-draft.ts).
+// Makes no network call and writes nothing: it prints a URL, and you open it yourself.
+//
+//   npx -y linksee-memory share-draft --help
+//   npx -y linksee-memory share-draft --service freee --task "..." --symptom "..." \
+//     --tried "..." --result "..." --kind execution [--conditions "..."] [--runtime claude] [--json]
+import { buildShareDraft, ALLOWED_KEYS, KINDS, RUNTIMES, NOTICE, NOTICE_EN, DRAFT_PAGE, URL_MAX } from '../lib/share-draft.js';
+const HELP = `linksee-memory share-draft — make a link to a reviewed draft of a fix, for other agents
+
+Linksee sends nothing. This prints a URL to ${DRAFT_PAGE}
+The page opens with the fields filled; you read them there, and only your click sends.
+If you never run this (or the MCP tool share_draft), nothing happens.
+
+Usage:
+  npx -y linksee-memory share-draft --service <id> --task <text> --symptom <text> \\
+    --tried <text> --result <text> --kind <${KINDS.join('|')}> \\
+    [--conditions <text>] [--runtime <${RUNTIMES.join('|')}>] [--json]
+
+Fields (nothing else is accepted):
+  --service     KanseiLINK service_id, lowercase: ^[a-z0-9_.-]{1,160}$   (required)
+  --task        what you were trying to do, ≤300 chars                     (required)
+  --symptom     the KIND of error, no values, ≤600 chars                   (required)
+  --tried       steps you tried, ≤2,000 chars                              (required)
+  --result      how it was solved / that it was not, ≤1,000 chars          (required)
+  --conditions  tool + version, kind of environment, ≤600 chars
+  --kind        execution | documentation | hypothesis                     (required)
+  --runtime     claude | codex | gpt | gemini | other
+
+Stops (no link) when a field looks like a token / API key / JWT / Bearer value, an e-mail,
+a tenant URL (acme.slack.com …), an IP address, a local path (C:\\, /Users/, /home/), or a
+long hex / base64 run (32+), and says which field. The whole URL must be ≤${URL_MAX} chars
+(one Japanese character takes 9) — it asks you to shorten; it never cuts.
+
+${NOTICE[0]}
+${NOTICE[1]}
+`;
+function parse(argv) {
+    const fields = {};
+    const bad = [];
+    let json = false;
+    let help = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '-h' || a === '--help') {
+            help = true;
+            continue;
+        }
+        if (a === '--json') {
+            json = true;
+            continue;
+        }
+        const m = /^--([a-z_]+)(?:=(.*))?$/s.exec(a);
+        if (!m) {
+            bad.push(a);
+            continue;
+        }
+        const key = m[1];
+        const value = m[2] ?? argv[++i];
+        if (value === undefined) {
+            bad.push(a);
+            continue;
+        }
+        fields[key] = value; // unknown keys are reported by the builder
+    }
+    return { fields, json, help, bad };
+}
+const { fields, json, help, bad } = parse(process.argv.slice(2));
+if (help || (Object.keys(fields).length === 0 && bad.length === 0)) {
+    process.stdout.write(HELP);
+    process.exit(0);
+}
+if (bad.length) {
+    process.stderr.write(`Could not read: ${bad.join(' ')}\nFields: ${ALLOWED_KEYS.map((k) => '--' + k).join(' ')}\n`);
+    process.exit(2);
+}
+const r = buildShareDraft(fields);
+if (json) {
+    process.stdout.write(JSON.stringify(r, null, 2) + '\n');
+    process.exit(r.ok ? 0 : 1);
+}
+if (!r.ok) {
+    process.stderr.write('No link made.\n');
+    for (const p of r.problems)
+        process.stderr.write(`  ${p.field}: ${p.reason}\n`);
+    process.exit(1);
+}
+process.stdout.write(`${r.url}\n\n${NOTICE[0]}\n${NOTICE[1]}\n${NOTICE_EN[0]}\n${NOTICE_EN[1]}\n`);
+//# sourceMappingURL=share-draft.js.map

package/dist/db/migrate.js

@@ -70,11 +70,11 @@ export function runMigrations(db) {
     // v3 → v4: rebuild memories_fts with trigram tokenizer for JP/CJK support.
     // Only runs when upgrading an existing DB from schema v1-3.
     if (currentVersion > 0 && currentVersion < 4) {
-        db.exec(`
-      DROP TRIGGER IF EXISTS trg_memories_fts_ai;
-      DROP TRIGGER IF EXISTS trg_memories_fts_ad;
-      DROP TRIGGER IF EXISTS trg_memories_fts_au;
-      DROP TABLE IF EXISTS memories_fts;
+        db.exec(`
+      DROP TRIGGER IF EXISTS trg_memories_fts_ai;
+      DROP TRIGGER IF EXISTS trg_memories_fts_ad;
+      DROP TRIGGER IF EXISTS trg_memories_fts_au;
+      DROP TABLE IF EXISTS memories_fts;
     `);
     }
     // v4 → v5: add normalized_name column BEFORE schema.sql runs,
@@ -118,9 +118,9 @@ export function runMigrations(db) {
             db.exec('ALTER TABLE memories ADD COLUMN thread_id TEXT');
         }
         // Backfill thread_id from content JSON session_id for existing memories
-        db.exec(`
-      UPDATE memories SET thread_id = json_extract(content, '$.session_id')
-      WHERE thread_id IS NULL AND json_valid(content) AND json_extract(content, '$.session_id') IS NOT NULL
+        db.exec(`
+      UPDATE memories SET thread_id = json_extract(content, '$.session_id')
+      WHERE thread_id IS NULL AND json_valid(content) AND json_extract(content, '$.session_id') IS NOT NULL
     `);
     }
     // v8 → v9: ProjectCoreNode — extend drift_anchors into the Current Truth Map node.
@@ -221,12 +221,12 @@ function migrateV5EntityNormalization(db) {
         }
     })();
     // 4. Auto-merge duplicate entities (same kind + normalized_name)
-    const dupes = db.prepare(`
-    SELECT kind, normalized_name, GROUP_CONCAT(id) as ids
-    FROM entities
-    WHERE normalized_name IS NOT NULL
-    GROUP BY kind, normalized_name
-    HAVING COUNT(*) > 1
+    const dupes = db.prepare(`
+    SELECT kind, normalized_name, GROUP_CONCAT(id) as ids
+    FROM entities
+    WHERE normalized_name IS NOT NULL
+    GROUP BY kind, normalized_name
+    HAVING COUNT(*) > 1
   `).all();
     if (dupes.length > 0) {
         console.log(`[linksee-memory] v5 migration: merging ${dupes.length} duplicate entity clusters`);
@@ -247,12 +247,12 @@ function mergeEntityCluster(db, ids) {
     if (ids.length < 2)
         return;
     // Score each entity: prefer most memories, then has canonical_key, then lowest id
-    const rows = db.prepare(`
-    SELECT e.id, e.name, e.canonical_key, COUNT(m.id) as mem_count
-    FROM entities e LEFT JOIN memories m ON m.entity_id = e.id
-    WHERE e.id IN (${ids.map(() => '?').join(',')})
-    GROUP BY e.id
-    ORDER BY mem_count DESC, (e.canonical_key IS NOT NULL) DESC, e.id ASC
+    const rows = db.prepare(`
+    SELECT e.id, e.name, e.canonical_key, COUNT(m.id) as mem_count
+    FROM entities e LEFT JOIN memories m ON m.entity_id = e.id
+    WHERE e.id IN (${ids.map(() => '?').join(',')})
+    GROUP BY e.id
+    ORDER BY mem_count DESC, (e.canonical_key IS NOT NULL) DESC, e.id ASC
   `).all(...ids);
     const keep = rows[0];
     const mergeIds = rows.slice(1).map(r => r.id);
@@ -273,16 +273,16 @@ function mergeEntityCluster(db, ids) {
         db.prepare('UPDATE events SET entity_id = ? WHERE entity_id = ?').run(keep.id, mid);
         // Reassign edges (both directions)
         // Handle UNIQUE constraint: delete duplicates first
-        db.prepare(`
-      DELETE FROM edges WHERE from_id = ? AND EXISTS (
-        SELECT 1 FROM edges e2 WHERE e2.from_id = ? AND e2.to_id = edges.to_id AND e2.relation = edges.relation
-      )
+        db.prepare(`
+      DELETE FROM edges WHERE from_id = ? AND EXISTS (
+        SELECT 1 FROM edges e2 WHERE e2.from_id = ? AND e2.to_id = edges.to_id AND e2.relation = edges.relation
+      )
     `).run(mid, keep.id);
         db.prepare('UPDATE edges SET from_id = ? WHERE from_id = ?').run(keep.id, mid);
-        db.prepare(`
-      DELETE FROM edges WHERE to_id = ? AND EXISTS (
-        SELECT 1 FROM edges e2 WHERE e2.to_id = ? AND e2.from_id = edges.from_id AND e2.relation = edges.relation
-      )
+        db.prepare(`
+      DELETE FROM edges WHERE to_id = ? AND EXISTS (
+        SELECT 1 FROM edges e2 WHERE e2.to_id = ? AND e2.from_id = edges.from_id AND e2.relation = edges.relation
+      )
     `).run(mid, keep.id);
         db.prepare('UPDATE edges SET to_id = ? WHERE to_id = ?').run(keep.id, mid);
         // Reassign consolidations

package/dist/lib/drift-anchors.js

@@ -74,9 +74,9 @@ export function declareAnchor(db, input) {
         throw new Error(`${input.kind} anchors need at least one violation_signal term (the forbidden act / rejected alternative) — otherwise the detector can never deduce a contradiction`);
     }
     const info = db
-        .prepare(`INSERT INTO drift_anchors
-         (kind, statement, rationale, affects, detect_terms, violation_signal, tier, source, source_memory_id)
-       VALUES
+        .prepare(`INSERT INTO drift_anchors
+         (kind, statement, rationale, affects, detect_terms, violation_signal, tier, source, source_memory_id)
+       VALUES
          (@kind, @statement, @rationale, @affects, @detect_terms, @violation_signal, @tier, @source, @source_memory_id)`)
         .run({
         kind: input.kind,

package/dist/lib/drift-detection.js

@@ -110,7 +110,7 @@ export function detectDrift(db, opts = {}) {
         samples: [],
     };
     const anchors = db
-        .prepare(`SELECT id, kind, statement, affects, detect_terms, violation_signal, tier, created_at
+        .prepare(`SELECT id, kind, statement, affects, detect_terms, violation_signal, tier, created_at
          FROM drift_anchors WHERE status = 'active'`)
         .all();
     res.anchorsScanned = anchors.length;
@@ -120,8 +120,8 @@ export function detectDrift(db, opts = {}) {
     // the "why this edit" text, not just path + snippet. (session_file_edits.memory_id →
     // memories.id; memories_fts.rowid = memories.id.)
     const edits = db
-        .prepare(`SELECT e.id, e.file_path, e.context_snippet, e.memory_id, m.content AS memory_content, e.occurred_at
-         FROM session_file_edits e
+        .prepare(`SELECT e.id, e.file_path, e.context_snippet, e.memory_id, m.content AS memory_content, e.occurred_at
+         FROM session_file_edits e
          LEFT JOIN memories m ON m.id = e.memory_id`)
         .all();
     res.editsScanned = edits.length;
@@ -137,19 +137,19 @@ export function detectDrift(db, opts = {}) {
     // Write paths prepared only when persisting — keeps dryRun safe on a readonly connection.
     const upsertContradicts = opts.dryRun
         ? null
-        : db.prepare(`
-        INSERT INTO drift_edges (anchor_id, edit_id, verdict, confidence, evidence, status)
-        VALUES (@anchor_id, @edit_id, 'contradicts', @confidence, @evidence, 'open')
-        ON CONFLICT(anchor_id, edit_id, verdict) DO UPDATE SET
-          confidence = excluded.confidence,
-          evidence   = excluded.evidence
-        WHERE drift_edges.status = 'open'
+        : db.prepare(`
+        INSERT INTO drift_edges (anchor_id, edit_id, verdict, confidence, evidence, status)
+        VALUES (@anchor_id, @edit_id, 'contradicts', @confidence, @evidence, 'open')
+        ON CONFLICT(anchor_id, edit_id, verdict) DO UPDATE SET
+          confidence = excluded.confidence,
+          evidence   = excluded.evidence
+        WHERE drift_edges.status = 'open'
       `);
     const insertAbsent = opts.dryRun
         ? null
-        : db.prepare(`
-        INSERT OR IGNORE INTO drift_edges (anchor_id, edit_id, verdict, confidence, evidence, status)
-        VALUES (@anchor_id, NULL, 'absent', @confidence, @evidence, 'open')
+        : db.prepare(`
+        INSERT OR IGNORE INTO drift_edges (anchor_id, edit_id, verdict, confidence, evidence, status)
+        VALUES (@anchor_id, NULL, 'absent', @confidence, @evidence, 'open')
       `);
     const apply = () => {
         for (const a of anchors) {
@@ -351,13 +351,13 @@ export function detectFileViolations(db, opts = {}) {
         .all();
     const upsert = opts.dryRun
         ? null
-        : db.prepare(`
-        INSERT INTO drift_edges (anchor_id, edit_id, verdict, confidence, evidence, status)
-        VALUES (@anchor_id, @edit_id, 'contradicts', @confidence, @evidence, 'open')
-        ON CONFLICT(anchor_id, edit_id, verdict) DO UPDATE SET
-          confidence = excluded.confidence,
-          evidence   = excluded.evidence
-        WHERE drift_edges.status = 'open'
+        : db.prepare(`
+        INSERT INTO drift_edges (anchor_id, edit_id, verdict, confidence, evidence, status)
+        VALUES (@anchor_id, @edit_id, 'contradicts', @confidence, @evidence, 'open')
+        ON CONFLICT(anchor_id, edit_id, verdict) DO UPDATE SET
+          confidence = excluded.confidence,
+          evidence   = excluded.evidence
+        WHERE drift_edges.status = 'open'
       `);
     const apply = () => {
         for (const a of anchors) {

package/dist/lib/drift-view.js

@@ -27,14 +27,14 @@ function parseEvidence(s) {
 export function getDriftHeadline(db, opts = {}) {
     const limit = opts.limit ?? 3;
     const rows = db
-        .prepare(`SELECT d.id AS edge_id, d.anchor_id, a.kind, a.statement, a.rationale,
-              e.file_path, e.context_snippet, e.occurred_at,
-              d.confidence, d.evidence
-         FROM drift_edges d
-         JOIN drift_anchors a ON a.id = d.anchor_id
-         JOIN session_file_edits e ON e.id = d.edit_id
-        WHERE d.verdict = 'contradicts' AND d.status = 'open' AND a.status = 'active'
-        ORDER BY d.confidence DESC, (a.tier = 'human') DESC, e.occurred_at DESC
+        .prepare(`SELECT d.id AS edge_id, d.anchor_id, a.kind, a.statement, a.rationale,
+              e.file_path, e.context_snippet, e.occurred_at,
+              d.confidence, d.evidence
+         FROM drift_edges d
+         JOIN drift_anchors a ON a.id = d.anchor_id
+         JOIN session_file_edits e ON e.id = d.edit_id
+        WHERE d.verdict = 'contradicts' AND d.status = 'open' AND a.status = 'active'
+        ORDER BY d.confidence DESC, (a.tier = 'human') DESC, e.occurred_at DESC
         LIMIT ?`)
         .all(limit);
     return rows.map((r) => {
@@ -61,12 +61,12 @@ export function getDriftHeadline(db, opts = {}) {
 export function getDriftAbsences(db, opts = {}) {
     const limit = opts.limit ?? 10;
     const rows = db
-        .prepare(`SELECT d.id AS edge_id, d.anchor_id, a.kind, a.statement, a.rationale,
-              d.confidence, d.evidence, d.detected_at
-         FROM drift_edges d
-         JOIN drift_anchors a ON a.id = d.anchor_id
-        WHERE d.verdict = 'absent' AND d.status = 'open' AND a.status = 'active'
-        ORDER BY a.created_at ASC
+        .prepare(`SELECT d.id AS edge_id, d.anchor_id, a.kind, a.statement, a.rationale,
+              d.confidence, d.evidence, d.detected_at
+         FROM drift_edges d
+         JOIN drift_anchors a ON a.id = d.anchor_id
+        WHERE d.verdict = 'absent' AND d.status = 'open' AND a.status = 'active'
+        ORDER BY a.created_at ASC
         LIMIT ?`)
         .all(limit);
     return rows.map((r) => {
@@ -85,8 +85,8 @@ export function getDriftAbsences(db, opts = {}) {
 }
 function countOpen(db, verdict) {
     return db
-        .prepare(`SELECT COUNT(*) AS n
-           FROM drift_edges d JOIN drift_anchors a ON a.id = d.anchor_id
+        .prepare(`SELECT COUNT(*) AS n
+           FROM drift_edges d JOIN drift_anchors a ON a.id = d.anchor_id
           WHERE d.verdict = ? AND d.status = 'open' AND a.status = 'active'`)
         .get(verdict).n;
 }

package/dist/lib/map-import.js

@@ -71,13 +71,13 @@ export function importMap(db, map) {
     const anchorExists = db.prepare('SELECT 1 FROM drift_anchors WHERE id = ?');
     let linked = 0;
     const tx = db.transaction(() => {
-        db.prepare(`
-      INSERT INTO map_projects (project, job, audience, product_status, template, stages, related_projects, updated_at)
-      VALUES (@project, @job, @audience, @product_status, @template, @stages, @related_projects, unixepoch())
-      ON CONFLICT(project) DO UPDATE SET
-        job=excluded.job, audience=excluded.audience, product_status=excluded.product_status,
-        template=excluded.template, stages=excluded.stages, related_projects=excluded.related_projects,
-        updated_at=unixepoch()
+        db.prepare(`
+      INSERT INTO map_projects (project, job, audience, product_status, template, stages, related_projects, updated_at)
+      VALUES (@project, @job, @audience, @product_status, @template, @stages, @related_projects, unixepoch())
+      ON CONFLICT(project) DO UPDATE SET
+        job=excluded.job, audience=excluded.audience, product_status=excluded.product_status,
+        template=excluded.template, stages=excluded.stages, related_projects=excluded.related_projects,
+        updated_at=unixepoch()
     `).run({
             project: map.project,
             job: map.job ?? null,
@@ -89,13 +89,13 @@ export function importMap(db, map) {
         });
         db.prepare('DELETE FROM map_edges WHERE project = ?').run(map.project);
         db.prepare('DELETE FROM map_nodes WHERE project = ?').run(map.project);
-        const insNode = db.prepare(`
-      INSERT INTO map_nodes
-        (id, project, layer, stage, statement, status, facets, role, note, due,
-         paused_reason, related_project, spinout_candidate, anchor_id, review_by, revival_condition, reality, extra, updated_at)
-      VALUES
-        (@id, @project, @layer, @stage, @statement, @status, @facets, @role, @note, @due,
-         @paused_reason, @related_project, @spinout_candidate, @anchor_id, @review_by, @revival_condition, @reality, @extra, unixepoch())
+        const insNode = db.prepare(`
+      INSERT INTO map_nodes
+        (id, project, layer, stage, statement, status, facets, role, note, due,
+         paused_reason, related_project, spinout_candidate, anchor_id, review_by, revival_condition, reality, extra, updated_at)
+      VALUES
+        (@id, @project, @layer, @stage, @statement, @status, @facets, @role, @note, @due,
+         @paused_reason, @related_project, @spinout_candidate, @anchor_id, @review_by, @revival_condition, @reality, @extra, unixepoch())
     `);
         for (const n of map.nodes) {
             if (!n.id)
@@ -134,9 +134,9 @@ export function importMap(db, map) {
                 extra: JSON.stringify(extra),
             });
         }
-        const insEdge = db.prepare(`
-      INSERT OR IGNORE INTO map_edges (project, from_id, to_id, type, strength, note)
-      VALUES (?, ?, ?, ?, ?, ?)
+        const insEdge = db.prepare(`
+      INSERT OR IGNORE INTO map_edges (project, from_id, to_id, type, strength, note)
+      VALUES (?, ?, ?, ?, ?, ?)
     `);
         for (const e of map.edges)
             insEdge.run(map.project, e.from, e.to, e.type, e.strength ?? null, e.note ?? null);

package/dist/lib/share-draft.d.ts

@@ -0,0 +1,56 @@
+export declare const DRAFT_PAGE = "https://kansei-link.com/agents/note/new.html";
+export declare const URL_MAX = 2000;
+export declare const KINDS: readonly ["execution", "documentation", "hypothesis"];
+export declare const RUNTIMES: readonly ["claude", "codex", "gpt", "gemini", "other"];
+/** Text fields in URL order, with the page's caps (same numbers as the page's maxlength). */
+export declare const TEXT_FIELDS: readonly [{
+    readonly key: "task";
+    readonly max: 300;
+    readonly required: true;
+}, {
+    readonly key: "symptom";
+    readonly max: 600;
+    readonly required: true;
+}, {
+    readonly key: "tried";
+    readonly max: 2000;
+    readonly required: true;
+}, {
+    readonly key: "result";
+    readonly max: 1000;
+    readonly required: true;
+}, {
+    readonly key: "conditions";
+    readonly max: 600;
+    readonly required: false;
+}];
+export declare const ALLOWED_KEYS: readonly ["service", ...("task" | "symptom" | "tried" | "result" | "conditions")[], "kind", "runtime"];
+export declare const SERVICE_RE: RegExp;
+export declare const NOTICE: readonly ["この内容は、開いた画面で確認してから送られます。送るまでどこにも出ていません。", "URL の中身は KanseiLINK の通信の記録（Cloudflare）を通ります。秘密は入れないでください。"];
+export declare const NOTICE_EN: readonly ["Nothing is sent yet: the page opens with these fields filled, and only your click there sends them.", "The URL passes through KanseiLINK's request logs (Cloudflare). Do not put secrets in it."];
+/** Which secret shapes a text contains (kinds, in check order). Empty = clean. */
+export declare function findSecretShapes(text: string): Array<{
+    kind: string;
+    ja: string;
+}>;
+export interface ShareDraftProblem {
+    field: string;
+    reason: string;
+    kinds?: string[];
+}
+export type ShareDraftResult = {
+    ok: true;
+    url: string;
+    length: number;
+    notice: readonly string[];
+    notice_en: readonly string[];
+} | {
+    ok: false;
+    problems: ShareDraftProblem[];
+    hint: string;
+};
+/**
+ * Check the fields and build the draft URL. Pure: no I/O, no network, no DB.
+ * Returns problems (field + reason) instead of a URL when anything is off.
+ */
+export declare function buildShareDraft(input: unknown): ShareDraftResult;