@latchet/core 0.1.0

package/dist/src/utils.js

@@ -0,0 +1,78 @@
+import { mkdirSync, readFileSync, writeFileSync, existsSync, readdirSync, appendFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function createId(prefix = "evt") {
+    return `${prefix}_${randomUUID()}`;
+}
+export function ensureDir(path) {
+    mkdirSync(path, { recursive: true });
+}
+export function writeJson(path, value) {
+    ensureDir(dirname(path));
+    writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+export function readJson(path) {
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+export function appendJsonLine(path, value) {
+    ensureDir(dirname(path));
+    appendFileSync(path, `${JSON.stringify(value)}\n`, "utf8");
+}
+export function readJsonLines(path) {
+    if (!existsSync(path)) {
+        return [];
+    }
+    const raw = readFileSync(path, "utf8").trim();
+    if (!raw) {
+        return [];
+    }
+    return raw
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+export function listDirectories(path) {
+    if (!existsSync(path)) {
+        return [];
+    }
+    return readdirSync(path, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name);
+}
+export function fileExists(path) {
+    return existsSync(path);
+}
+export function cleanString(value) {
+    if (!value) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+export function uniqueBy(items, getKey) {
+    const seen = new Set();
+    const result = [];
+    for (const item of items) {
+        const key = getKey(item);
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        result.push(item);
+    }
+    return result;
+}
+export function resolvePath(...parts) {
+    return join(...parts);
+}
+export function computeFileHash(path) {
+    if (!existsSync(path)) {
+        return "";
+    }
+    const content = readFileSync(path);
+    return createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/utils.js.map

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

package/dist/src/verify.d.ts

@@ -0,0 +1,3 @@
+import type { FreshnessReport, TaskState } from "@latchet/spec";
+export declare function verifyTaskFreshness(cwd: string, state: TaskState): FreshnessReport;
+//# sourceMappingURL=verify.d.ts.map

package/dist/src/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/verify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAkB,SAAS,EAAE,MAAM,eAAe,CAAC;AAQhF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,eAAe,CAyDlF"}

package/dist/src/verify.js

@@ -0,0 +1,33 @@
+import { resolve } from "node:path";
+import { getGitSnapshot } from "./git.js";
+import { fileExists } from "./utils.js";
+function buildCheck(kind, ok, message) {
+    return { kind, ok, message };
+}
+export function verifyTaskFreshness(cwd, state) {
+    const checks = [];
+    const currentGit = getGitSnapshot(cwd);
+    const expectedGit = state.task.git;
+    if (!expectedGit) {
+        checks.push(buildCheck("workspace_git", true, "Task was created outside a git repository."));
+    }
+    else if (!currentGit) {
+        checks.push(buildCheck("workspace_git", false, "Task expects a git repository but none is available now."));
+    }
+    else {
+        checks.push(buildCheck("git_branch", currentGit.branch === expectedGit.branch, `Expected branch ${expectedGit.branch ?? "unknown"}, current branch is ${currentGit.branch ?? "unknown"}.`));
+        checks.push(buildCheck("git_commit", currentGit.commit === expectedGit.commit, `Expected commit ${expectedGit.commit ?? "unknown"}, current commit is ${currentGit.commit ?? "unknown"}.`));
+        checks.push(buildCheck("git_dirty", currentGit.dirty === expectedGit.dirty, `Expected workspace to be ${expectedGit.dirty ? "dirty" : "clean"}, current workspace is ${currentGit.dirty ? "dirty" : "clean"}.`));
+    }
+    const workspaceRoot = state.task.workspace_root ?? cwd;
+    checks.push(buildCheck("workspace_root", fileExists(workspaceRoot), `Workspace root ${workspaceRoot} ${fileExists(workspaceRoot) ? "is available" : "is missing"}.`));
+    for (const artifact of state.artifact_refs) {
+        const path = resolve(workspaceRoot, artifact.payload.path);
+        checks.push(buildCheck("artifact_exists", fileExists(path), `Artifact ${artifact.payload.path} ${fileExists(path) ? "exists" : "is missing"}.`));
+    }
+    return {
+        ok: checks.every((check) => check.ok),
+        checks
+    };
+}
+//# sourceMappingURL=verify.js.map

package/dist/src/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,SAAS,UAAU,CAAC,IAA4B,EAAE,EAAW,EAAE,OAAe;IAC5E,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,KAAgB;IAC/D,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IAEnC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,IAAI,EAAE,4CAA4C,CAAC,CAAC,CAAC;IAC/F,CAAC;SAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,KAAK,EAAE,0DAA0D,CAAC,CAAC,CAAC;IAC9G,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CACT,UAAU,CACR,YAAY,EACZ,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EACxC,mBAAmB,WAAW,CAAC,MAAM,IAAI,SAAS,uBAAuB,UAAU,CAAC,MAAM,IAAI,SAAS,GAAG,CAC3G,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CACT,UAAU,CACR,YAAY,EACZ,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EACxC,mBAAmB,WAAW,CAAC,MAAM,IAAI,SAAS,uBAAuB,UAAU,CAAC,MAAM,IAAI,SAAS,GAAG,CAC3G,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CACT,UAAU,CACR,WAAW,EACX,UAAU,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,EACtC,4BAA4B,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,0BAA0B,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,CACnI,CACF,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,GAAG,CAAC;IACvD,MAAM,CAAC,IAAI,CACT,UAAU,CACR,gBAAgB,EAChB,UAAU,CAAC,aAAa,CAAC,EACzB,kBAAkB,aAAa,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,GAAG,CAChG,CACF,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,CACT,UAAU,CACR,iBAAiB,EACjB,UAAU,CAAC,IAAI,CAAC,EAChB,YAAY,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,GAAG,CACnF,CACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM;KACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@latchet/core",
+  "version": "0.1.0",
+  "description": "Core local-first ledger store, projection, import, export, verification, and redaction logic for Latchet.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist/src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "dependencies": {
+    "@latchet/spec": "0.1.0",
+    "ajv": "^8.20.0"
+  }
+}