daftari 1.0.0

package/dist/utils/git.js

@@ -0,0 +1,114 @@
+// Git is Daftari's version-control layer: every write operation auto-commits,
+// so the markdown files' history *is* the document history. There is no
+// separate versioning system.
+//
+// This module shells out to the `git` CLI via execFile (argument array, no
+// shell) rather than taking a dependency. The vault directory is the git work
+// tree; `git -C <vaultRoot>` scopes every command to it.
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { err, ok } from "../frontmatter/types.js";
+const run = promisify(execFile);
+export function gitIdentity(identity) {
+    const slug = identity.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+    return {
+        name: identity,
+        email: `${slug || "unknown"}@daftari.local`,
+    };
+}
+async function git(vaultRoot, args) {
+    try {
+        const { stdout } = await run("git", ["-C", vaultRoot, ...args], {
+            maxBuffer: 16 * 1024 * 1024,
+        });
+        return ok(stdout);
+    }
+    catch (e) {
+        const reason = e instanceof Error && "stderr" in e && typeof e.stderr === "string"
+            ? e.stderr.trim() || e.message
+            : e instanceof Error
+                ? e.message
+                : String(e);
+        return err(new Error(`git ${args[0]} failed: ${reason}`));
+    }
+}
+export async function isGitRepo(vaultRoot) {
+    const result = await git(vaultRoot, ["rev-parse", "--is-inside-work-tree"]);
+    return result.ok && result.value.trim() === "true";
+}
+// Initializes a git repo at the vault root if one does not already exist.
+// Idempotent — safe to call on every write.
+export async function ensureGitRepo(vaultRoot) {
+    if (await isGitRepo(vaultRoot))
+        return ok(undefined);
+    const init = await git(vaultRoot, ["init", "--quiet"]);
+    if (!init.ok)
+        return init;
+    return ok(undefined);
+}
+// Stages the given vault-relative paths and creates a commit authored by
+// `identity`. The commit's committer is also set to `identity` (via `-c`
+// overrides) so commits land even in a repo with no configured user. Returns
+// the new commit's short hash.
+export async function commit(vaultRoot, paths, message, identity) {
+    const ready = await ensureGitRepo(vaultRoot);
+    if (!ready.ok)
+        return ready;
+    if (paths.length === 0) {
+        return err(new Error("commit requires at least one path"));
+    }
+    const staged = await git(vaultRoot, ["add", "--", ...paths]);
+    if (!staged.ok)
+        return staged;
+    const id = gitIdentity(identity);
+    const committed = await git(vaultRoot, [
+        "-c",
+        `user.name=${id.name}`,
+        "-c",
+        `user.email=${id.email}`,
+        "commit",
+        `--author=${id.name} <${id.email}>`,
+        "-m",
+        message,
+    ]);
+    if (!committed.ok)
+        return committed;
+    const hash = await git(vaultRoot, ["rev-parse", "--short", "HEAD"]);
+    if (!hash.ok)
+        return hash;
+    return ok({ hash: hash.value.trim() });
+}
+// Returns the most recent commits, newest first. `path`, when given, scopes
+// the log to a single file's history.
+export async function log(vaultRoot, opts = {}) {
+    if (!(await isGitRepo(vaultRoot))) {
+        return err(new Error("not a git repository"));
+    }
+    const limit = opts.limit && opts.limit > 0 ? Math.floor(opts.limit) : 20;
+    // \x1f (unit separator) splits fields; \x1e (record separator) splits commits.
+    const format = "%H%x1f%an%x1f%ae%x1f%aI%x1f%s%x1e";
+    const args = ["log", `--pretty=format:${format}`, `-n`, String(limit)];
+    if (opts.path)
+        args.push("--", opts.path);
+    const result = await git(vaultRoot, args);
+    if (!result.ok)
+        return result;
+    const commits = [];
+    for (const record of result.value.split("\x1e")) {
+        const trimmed = record.trim();
+        if (!trimmed)
+            continue;
+        const [hash, author, email, date, subject] = trimmed.split("\x1f");
+        if (!hash)
+            continue;
+        commits.push({
+            hash,
+            author: author ?? "",
+            email: email ?? "",
+            date: date ?? "",
+            subject: subject ?? "",
+        });
+    }
+    return ok(commits);
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wEAAwE;AACxE,8BAA8B;AAC9B,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,yDAAyD;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,yBAAyB,CAAC;AAE/D,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAkBhC,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChF,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,GAAG,IAAI,IAAI,SAAS,gBAAgB;KAC5C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,SAAiB,EAAE,IAAc;IAClD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE;YAC9D,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QACH,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,MAAM,GACV,CAAC,YAAY,KAAK,IAAI,QAAQ,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;YACjE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO;YAC9B,CAAC,CAAC,CAAC,YAAY,KAAK;gBAClB,CAAC,CAAC,CAAC,CAAC,OAAO;gBACX,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClB,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC5E,OAAO,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;AACrD,CAAC;AAED,0EAA0E;AAC1E,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,IAAI,MAAM,SAAS,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC;AAED,yEAAyE;AACzE,yEAAyE;AACzE,6EAA6E;AAC7E,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,SAAiB,EACjB,KAAe,EACf,OAAe,EACf,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAE9B,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE;QACrC,IAAI;QACJ,aAAa,EAAE,CAAC,IAAI,EAAE;QACtB,IAAI;QACJ,cAAc,EAAE,CAAC,KAAK,EAAE;QACxB,QAAQ;QACR,YAAY,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,KAAK,GAAG;QACnC,IAAI;QACJ,OAAO;KACR,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAEpC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,4EAA4E;AAC5E,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,SAAiB,EACjB,OAA0C,EAAE;IAE5C,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,+EAA+E;IAC/E,MAAM,MAAM,GAAG,mCAAmC,CAAC;IACnD,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,mBAAmB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAE9B,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,KAAK,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,EAAE,IAAI,IAAI,EAAE;YAChB,OAAO,EAAE,OAAO,IAAI,EAAE;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "daftari",
+  "version": "1.0.0",
+  "description": "An open-source, multi-user knowledge vault exposed to AI agents via an MCP server.",
+  "license": "MIT",
+  "author": "Mihir Wagle / mavaali",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "daftari": "./dist/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mavaali/daftari.git"
+  },
+  "homepage": "https://github.com/mavaali/daftari#readme",
+  "bugs": {
+    "url": "https://github.com/mavaali/daftari/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "dev": "tsx watch src/index.ts --vault ./test/fixtures/sample-vault",
+    "lint": "biome check src test",
+    "lint:fix": "biome check --write src test",
+    "format": "biome format --write src test",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "mcp",
+    "knowledge-vault",
+    "markdown",
+    "agents"
+  ],
+  "lint-staged": {
+    "src/**/*.{ts,tsx}": ["biome check --write --no-errors-on-unmatched"],
+    "test/**/*.{ts,tsx}": ["biome check --write --no-errors-on-unmatched"]
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^4.2.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.10.0",
+    "glob": "^13.0.6",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.8.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "tsx": "^4.22.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  }
+}

package/templates/config.yaml

@@ -0,0 +1,31 @@
+# .daftari/config.yaml — vault configuration template.
+#
+# Copied into a new vault's .daftari/ directory by `daftari --init`. RBAC is
+# config-driven: roles and their per-collection permissions are declared here,
+# and the server is started with --role <name> to select one.
+#
+#   read    — collections whose documents the role may read/search
+#   write   — collections the role may create/append/deprecate documents in
+#   promote — whether the role may promote a draft to canonical (default false)
+#
+# "*" in a read or write list is a wildcard matching every collection. A role
+# that is not started with --role, or a name not listed here, falls back to an
+# implicit "guest" with no permissions — every tool is denied.
+#
+# The roles below are scoped to the collections `daftari --init` scaffolds
+# (competitive-intel, pricing, moonshot, _drafts). Edit them to match your own
+# collections — they are examples, not a fixed schema.
+version: 1
+vault_name: my-vault
+
+roles:
+  analyst:
+    read: [competitive-intel, pricing]
+    write: [competitive-intel, _drafts]
+  researcher:
+    read: ["*"]
+    write: [moonshot, _drafts]
+  admin:
+    read: ["*"]
+    write: ["*"]
+    promote: true