dsh-tacit 0.2.0

package/lib/store.js

@@ -0,0 +1,219 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026 hackernotfound — https://github.com/hackernotfound/dsh-tacit
+/**
+ * dsh-tacit — local storage (plugin-owned only).
+ *
+ * Everything lives under $DSH_HOME/storages/tacit/:
+ *   config.patch.json            UI-written config fields (loader/YAML config is the base)
+ *   profile.json                 persistent user mistake profile
+ *   reports/<sessionId>/<turn>.json  analysis reports
+ *
+ * Safety rules (hard constraints):
+ *  - writes are atomic (temp file + rename) and never truncate an existing
+ *    file in place;
+ *  - the ONLY deletion this plugin ever performs is `clearReports()`, which
+ *    unlinks files matching /^\d+\.json$/ inside its own reports directory
+ *    (then removes that directory only if empty) — nothing else on disk;
+ *  - session ids are sanitized before touching the filesystem (no traversal).
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+
+export function emptyProfile() {
+  return {
+    analyzedCount: 0,
+    patterns: [],
+    updatedAt: 0,
+    styleRules: [],
+    feedbackLog: [],
+    pendingDistill: 0,
+    directives: [],
+    analysesSinceDirectives: 0,
+  }
+}
+
+export class CoachStore {
+  constructor(root) {
+    this.root = root
+  }
+
+  ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true })
+  }
+
+  readJson(file, fallback) {
+    try {
+      return JSON.parse(fs.readFileSync(file, 'utf8'))
+    } catch {
+      return fallback
+    }
+  }
+
+  writeJsonAtomic(file, value) {
+    this.ensureDir(path.dirname(file))
+    const tmp = `${file}.tmp-${process.pid}-${Date.now()}`
+    fs.writeFileSync(tmp, JSON.stringify(value, null, 2), 'utf8')
+    fs.renameSync(tmp, file)
+  }
+
+  /** Filesystem-safe session id (the browser id never reaches a path verbatim). */
+  safeSessionId(sessionId) {
+    const value = String(sessionId ?? '').replace(/[^A-Za-z0-9._-]/g, '_').slice(0, 128)
+    return value.length > 0 ? value : 'unknown'
+  }
+
+  configPatch() {
+    const value = this.readJson(path.join(this.root, 'config.patch.json'), {})
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {}
+  }
+
+  saveConfigPatch(patch) {
+    this.writeJsonAtomic(path.join(this.root, 'config.patch.json'), patch)
+    return patch
+  }
+
+  profile() {
+    const value = this.readJson(path.join(this.root, 'profile.json'), emptyProfile())
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+      ? { ...emptyProfile(), ...value }
+      : emptyProfile()
+  }
+
+  saveProfile(profile) {
+    this.writeJsonAtomic(path.join(this.root, 'profile.json'), profile)
+  }
+
+  /** {date: 'YYYY-MM-DD', count} of automatic analyses spent today. */
+  autoLedger(date) {
+    const value = this.readJson(path.join(this.root, 'auto.json'), null)
+    if (value !== null && typeof value === 'object' && value.date === date && typeof value.count === 'number') {
+      return { date, count: Math.max(0, Math.round(value.count)) }
+    }
+    return { date, count: 0 }
+  }
+
+  bumpAuto(date) {
+    const ledger = this.autoLedger(date)
+    const next = { date, count: ledger.count + 1 }
+    this.writeJsonAtomic(path.join(this.root, 'auto.json'), next)
+    return next
+  }
+
+  reportFile(sessionId, turn) {
+    return path.join(this.root, 'reports', this.safeSessionId(sessionId), `${turn}.json`)
+  }
+
+  report(sessionId, turn) {
+    const value = this.readJson(this.reportFile(sessionId, turn), null)
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : null
+  }
+
+  saveReport(sessionId, turn, report) {
+    this.writeJsonAtomic(this.reportFile(sessionId, turn), report)
+  }
+
+  /**
+   * Latest analysis reports across EVERY session (for the settings/sidebar
+   * panel), newest first, capped at `limit`. Only the plugin's own
+   * /^\d+\.json$/ files are read.
+   */
+  listAllReports(limit = 50) {
+    const root = path.join(this.root, 'reports')
+    let sessionDirs = []
+    try {
+      sessionDirs = fs.readdirSync(root)
+    } catch {
+      return []
+    }
+    const entries = []
+    for (const name of sessionDirs) {
+      if (!/^[A-Za-z0-9._-]{1,128}$/.test(name)) continue
+      const sessionDir = path.join(root, name)
+      let files = []
+      try {
+        files = fs.readdirSync(sessionDir)
+      } catch {
+        continue
+      }
+      for (const file of files) {
+        const match = /^(\d+)\.json$/.exec(file)
+        if (match === null) continue
+        const report = this.readJson(path.join(sessionDir, file), null)
+        if (report === null || typeof report !== 'object' || Array.isArray(report)) continue
+        entries.push({
+          sessionId: name,
+          turn: Number(match[1]),
+          time: typeof report.time === 'number' ? report.time : 0,
+          model: typeof report.model === 'string' ? report.model : '',
+          promptExcerpt: typeof report.promptExcerpt === 'string' ? report.promptExcerpt : '',
+          improvedPrompt: typeof report.improvedPrompt === 'string' ? report.improvedPrompt : '',
+          trigger: typeof report.trigger === 'string' ? report.trigger : 'manual',
+        })
+      }
+    }
+    entries.sort((a, b) => b.time - a.time)
+    return entries.slice(0, Math.max(0, Math.min(500, Math.floor(Number(limit) || 50))))
+  }
+
+  listReports(sessionId) {
+    const dir = path.join(this.root, 'reports', this.safeSessionId(sessionId))
+    let names = []
+    try {
+      names = fs.readdirSync(dir)
+    } catch {
+      return []
+    }
+    const out = []
+    for (const name of names) {
+      const match = /^(\d+)\.json$/.exec(name)
+      if (match === null) continue
+      const report = this.readJson(path.join(dir, name), null)
+      if (report !== null && typeof report === 'object' && !Array.isArray(report)) {
+        out.push({ turn: Number(match[1]), report })
+      }
+    }
+    return out
+  }
+
+  /**
+   * Remove only plugin-created report files (strict /^\d+\.json$/ naming)
+   * inside the plugin's own reports directory; the per-session directory is
+   * removed only when empty. Returns the number of files removed.
+   */
+  clearReports() {
+    const root = path.join(this.root, 'reports')
+    let removed = 0
+    let sessionDirs = []
+    try {
+      sessionDirs = fs.readdirSync(root)
+    } catch {
+      return 0
+    }
+    for (const name of sessionDirs) {
+      if (!/^[A-Za-z0-9._-]{1,128}$/.test(name)) continue
+      const sessionDir = path.join(root, name)
+      let files = []
+      try {
+        files = fs.readdirSync(sessionDir)
+      } catch {
+        continue
+      }
+      for (const file of files) {
+        if (!/^\d+\.json$/.test(file)) continue
+        try {
+          fs.unlinkSync(path.join(sessionDir, file))
+          removed += 1
+        } catch {
+          // Keep going: one unreadable file must not block the rest.
+        }
+      }
+      try {
+        fs.rmdirSync(sessionDir)
+      } catch {
+        // Only removed when empty; any leftover means the directory stays.
+      }
+    }
+    return removed
+  }
+}

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "dsh-tacit",
+  "version": "0.2.0",
+  "description": "Tacit learns what you leave unsaid in your prompts — from messy turns and your own corrections, with zero clicks — and tells the agent how to compensate, on every turn, via a system-prompt section you can read and edit.",
+  "author": "hackernotfound",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hackernotfound/dsh-tacit.git"
+  },
+  "homepage": "https://github.com/hackernotfound/dsh-tacit#readme",
+  "bugs": {
+    "url": "https://github.com/hackernotfound/dsh-tacit/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./client/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "client",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "smoke": "node scripts/smoke.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "dshhub": {
+    "schemaVersion": 1,
+    "displayName": "Tacit",
+    "summary": "Learns what you leave unsaid (auto-analysis of messy turns and your corrections) and steers the agent for you through an editable system-prompt section. Optional ✨ Improve rewrite and opt-in pre-send context.",
+    "categories": [
+      "prompt",
+      "workflow",
+      "web-ui"
+    ],
+    "surfaces": [
+      "host",
+      "web"
+    ],
+    "capabilities": {
+      "provides": [
+        "service:tacit"
+      ]
+    },
+    "compatibility": {
+      "dsh": ">=0.1.1-rc.1",
+      "node": ">=22"
+    },
+    "permissions": {
+      "network": [
+        "https://api.deepseek.com"
+      ],
+      "filesystem": [
+        "filesystem:read",
+        "filesystem:write"
+      ]
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-home-paths": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "prompt",
+    "prompt-engineering",
+    "system-prompt",
+    "personalization",
+    "tacit"
+  ]
+}