@descryy/core 0.7.0 → 0.9.0

package/dist/workspace/graph-layout.js

@@ -0,0 +1,90 @@
+/**
+ * Where a workspace's shared graph lives, and the migration off the old
+ * one-graph-per-repository layout — Gap 1 of
+ * `documents/plans/site-claims-closure-production-plan.md`.
+ *
+ * Ported from `descry-desktop`'s `packages/session/src/indexing/graph-layout.ts`
+ * (H-2, "one graph per workspace, not per repository"), which solved the same
+ * problem for the desktop app's single, central engine root. The layout differs
+ * here because `descry-core` has no such root: every repository owns its own
+ * `.descry/` directory and its own `graph` path in `.descry/config.json`
+ * (`session.ts`'s `DescryConfig.graph`), so there is no `graph/${repositoryId}.db`
+ * convention to reuse. Two adaptations follow from that:
+ *
+ * 1. `workspaceGraphPath` keeps the desktop version's shape —
+ *    `join(rootDir, "graph", "workspace-<id>.db")` — but `rootDir` here is a
+ *    directory the caller chooses per invocation (the MCP `analyze_workspace`
+ *    tool uses the initiating repository's `.descry/` directory), not a
+ *    single app-wide engine root. That is a disclosed design choice, not an
+ *    inferred one: the shared graph physically lives inside whichever
+ *    repository's session first asked for it.
+ * 2. `migrateToWorkspaceGraph` takes each repository's *actual* existing graph
+ *    path directly (`RepoGraphLocation.graphPath`, read from that repo's own
+ *    config) rather than deriving one from a `repositoryId` the way the
+ *    desktop version does — `descry-core` already knows the real path per
+ *    repo without having to reconstruct it.
+ *
+ * The reasoning for *why* a migration is a move-and-reindex rather than a
+ * merge is unchanged from the desktop original: every node id in a
+ * pre-workspace graph was computed with `workspace` absent
+ * (`IdentityScope.workspace`, `packages/ir/src/identity.ts`), so
+ * workspace-scoped node types (`API_ENDPOINT`, `DATABASE_TABLE`,
+ * `DATABASE_COLUMN`, `INCIDENT`, `FIX_PATTERN`) in it carry repo-scoped ids —
+ * copying those rows into the shared store would populate it with ids nothing
+ * will ever produce again, which is worse than an empty graph because it looks
+ * full. So the honest handling is: move the stale database aside (never
+ * delete it), name the repository whose graph status must be treated as
+ * needing a fresh index, and let `indexWorkspace` (`../../  ../mcp/src
+ * /workspace-index.ts`) produce correct ids by reading the repository again.
+ */
+import { existsSync, mkdirSync, renameSync } from "node:fs";
+import { join } from "node:path";
+/** Sidecars `node:sqlite` may leave next to a database. A `-wal` orphaned beside a moved db is a corrupt pair, not a leftover. */
+const SQLITE_SIDECAR_SUFFIXES = ["-wal", "-shm", "-journal"];
+const LEGACY_BACKUP_DIRNAME = "legacy-per-repository";
+/** The one graph every repository in a workspace is indexed into. */
+export function workspaceGraphPath(rootDir, workspaceId) {
+    return join(rootDir, "graph", `workspace-${workspaceId}.db`);
+}
+/**
+ * Move every pre-workspace graph aside and report what has to be re-indexed.
+ *
+ * Idempotent: a second call finds nothing at the recorded paths (because the
+ * first call already moved them) and reports `migrated: false`. A path that
+ * does not exist — the common case for a repository that has simply never
+ * been analysed yet — is skipped without comment; there is nothing stale to
+ * move.
+ */
+export function migrateToWorkspaceGraph(options) {
+    const now = options.now ?? Date.now;
+    const backupDir = join(options.rootDir, "graph", LEGACY_BACKUP_DIRNAME);
+    const moved = [];
+    for (const repository of options.repositories) {
+        const from = repository.graphPath;
+        if (from === ":memory:" || !existsSync(from))
+            continue;
+        mkdirSync(backupDir, { recursive: true });
+        const to = join(backupDir, `${repository.repo}-${now()}.db`);
+        renameSync(from, to);
+        for (const suffix of SQLITE_SIDECAR_SUFFIXES) {
+            if (existsSync(`${from}${suffix}`))
+                renameSync(`${from}${suffix}`, `${to}${suffix}`);
+        }
+        moved.push({ repo: repository.repo, from, to });
+    }
+    if (moved.length === 0) {
+        return { migrated: false, movedDatabases: [], reposToReindex: [], disclosure: null };
+    }
+    return {
+        migrated: true,
+        movedDatabases: moved,
+        reposToReindex: moved.map((m) => m.repo),
+        disclosure: `This workspace now keeps one graph shared by every linked repository instead of one per ` +
+            `repository, so a frontend and a backend can share a map (DEC-054). ${moved.length} existing ` +
+            `per-repository graph database(s) were built under the old, repository-only identity scope, so ` +
+            `every node id in them is wrong for the shared graph and they cannot be merged into it. They ` +
+            `have been moved to "${backupDir}" — nothing was deleted — and the affected repositories will be ` +
+            "re-indexed into the workspace graph.",
+    };
+}
+//# sourceMappingURL=graph-layout.js.map

package/dist/workspace/graph-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-layout.js","sourceRoot":"","sources":["../../src/workspace/graph-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,kIAAkI;AAClI,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAEtE,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD,qEAAqE;AACrE,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,WAAmB;IACrE,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,WAAW,KAAK,CAAC,CAAC;AAC/D,CAAC;AAuCD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAuC;IAC7E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;IACxE,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC;QAClC,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAEvD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7D,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrB,KAAK,MAAM,MAAM,IAAI,uBAAuB,EAAE,CAAC;YAC7C,IAAI,UAAU,CAAC,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;gBAAE,UAAU,CAAC,GAAG,IAAI,GAAG,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACvF,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxC,UAAU,EACR,0FAA0F;YAC1F,sEAAsE,KAAK,CAAC,MAAM,YAAY;YAC9F,gGAAgG;YAChG,8FAA8F;YAC9F,uBAAuB,SAAS,kEAAkE;YAClG,sCAAsC;KACzC,CAAC;AACJ,CAAC"}

package/dist/workspace/index.d.ts

@@ -0,0 +1,3 @@
+export { workspaceGraphPath, migrateToWorkspaceGraph } from "./graph-layout.ts";
+export type { GraphLayoutMigration, MigrateToWorkspaceGraphOptions, MovedGraphDatabase, RepoGraphLocation, } from "./graph-layout.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/workspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EACV,oBAAoB,EACpB,8BAA8B,EAC9B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/workspace/index.js

@@ -0,0 +1,2 @@
+export { workspaceGraphPath, migrateToWorkspaceGraph } from "./graph-layout.js";
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@descryy/core",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "type": "module",
   "description": "Descry graph engine: storage, graph builder, query layer, traversal, diff scoping, git source, MCP server.",
   "license": "MIT",
@@ -33,6 +33,6 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/ir": "0.7.0"
+    "@descryy/ir": "0.10.0"
   }
 }