spexcode 0.6.5 → 0.6.6

package/node_modules/@spexcode/spec-cli/dist/supervise.js

@@ -42,7 +42,7 @@ const childApiBase = `http://127.0.0.1:${proxyPort}`;
 // observe the source closure, compile it, then make the supervisor's normal zero-downtime swap. A source edit
 // must never cause a restart that still runs the old dist.
 const watchRoots = workspaceRoot
-    ? [sourceRoot, join(workspaceRoot, 'spec-forge', 'src'), join(workspaceRoot, 'spec-eval', 'src'), join(workspaceRoot, 'packages', 'spec-core', 'src')]
+    ? [sourceRoot, join(workspaceRoot, 'spec-forge', 'src'), join(workspaceRoot, 'spec-eval', 'src'), join(workspaceRoot, 'packages', 'spec-core', 'src'), join(workspaceRoot, 'packages', 'session-core', 'src')]
     : [here];
 function buildWorkspace() {
     if (!workspaceRoot)
@@ -246,11 +246,11 @@ catch { /* already gone */ } };
 if (publicCfg) {
     // public mode: the raw proxy stays on loopback; the password-gated gateway owns the public port.
     const distDir = resolveDistDir();
-    listenOrExit(proxy, proxyPort, { host: '127.0.0.1', label: 'supervisor (loopback proxy)', cleanup: reapChild, onListen: () => { recordEndpoint(childApiBase); console.log(`spec-cli supervisor on loopback :${proxyPort} (zero-downtime reloads, backend :${first.port})`); } });
+    listenOrExit(proxy, proxyPort, { host: '127.0.0.1', label: 'supervisor (loopback proxy)', cleanup: reapChild, onListen: () => recordEndpoint(childApiBase), ready: `spec-cli supervisor on loopback :${proxyPort} (zero-downtime reloads, backend :${first.port})` });
     startGateway({ publicPort, upstreamPort: proxyPort, password: publicCfg.password, tls: publicCfg.tls, distDir, onBindFail: reapChild });
 }
 else {
-    listenOrExit(proxy, publicPort, { label: 'supervisor', cleanup: reapChild, onListen: () => { recordEndpoint(childApiBase); console.log(`spec-cli supervisor serving on http://localhost:${publicPort} (zero-downtime reloads, backend :${first.port})`); } });
+    listenOrExit(proxy, publicPort, { label: 'supervisor', cleanup: reapChild, onListen: () => recordEndpoint(childApiBase), ready: `spec-cli supervisor serving on http://localhost:${publicPort} (zero-downtime reloads, backend :${first.port})` });
 }
 startResourceMonitor();
 // Watch the source closure in a workspace and the emitted directory in an installed package. Debounce a

package/node_modules/@spexcode/spec-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-cli",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "type": "module",
   "description": "SpexCode CLI + server. The root spexcode package delegates to this compiled package; dashboard assets live in @spexcode/spec-dashboard.",
   "bin": {
@@ -21,6 +21,7 @@
   ],
   "bundledDependencies": [
     "@spexcode/spec-core",
+    "@spexcode/session-core",
     "@spexcode/spec-eval",
     "@spexcode/spec-forge"
   ],
@@ -35,9 +36,10 @@
     "test": "tsx --import ../scripts/test-home.mjs --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/spec-core": "0.6.5",
-    "@spexcode/spec-eval": "0.6.5",
-    "@spexcode/spec-forge": "0.6.5"
+    "@spexcode/session-core": "0.6.6",
+    "@spexcode/spec-core": "0.6.6",
+    "@spexcode/spec-eval": "0.6.6",
+    "@spexcode/spec-forge": "0.6.6"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

package/node_modules/@spexcode/spec-core/dist/git.d.ts

@@ -51,6 +51,10 @@ export declare function gitRequiredA(args: string[], purpose: string, options?:
     input?: string;
     extraEnv?: Record<string, string | undefined>;
 }): Promise<string>;
+export declare class GitWorkspaceError extends Error {
+    constructor(root: string);
+}
+export declare function requireGitWorkspace(root: string): void;
 export declare function repoRoot(): string;
 export declare function headSha(root: string): string;
 export declare function worktreeSpecSig(wtPath: string): string;

package/node_modules/@spexcode/spec-core/dist/git.js

@@ -1212,6 +1212,32 @@ export async function gitRequiredA(args, purpose, options = {}) {
         throw new Error(`${purpose}: git ${args.slice(2).join(' ')} failed: ${String(error?.stderr || error?.message || 'unknown git error').trim()}`);
     }
 }
+const checkedGitWorkspaces = new Set();
+// A Git-backed read needs a repository before it can derive history. This is not a Git transport failure:
+// it is the product precondition, shared by every history entrance.
+export class GitWorkspaceError extends Error {
+    constructor(root) {
+        super(`workspace is not a Git repository: ${resolve(root)}. Run \`git init\` in that directory, then retry.`);
+        this.name = 'GitWorkspaceError';
+    }
+}
+export function requireGitWorkspace(root) {
+    const workspace = resolve(root);
+    if (checkedGitWorkspaces.has(workspace))
+        return;
+    try {
+        if (git(['-C', workspace, 'rev-parse', '--git-dir']).trim()) {
+            checkedGitWorkspaces.add(workspace);
+            return;
+        }
+    }
+    catch (error) {
+        // Exit 128 is Git's repository-discovery rejection. Spawn and timeout failures keep their own cause.
+        if (error?.status !== 128 || !String(error?.stderr ?? '').includes('not a git repository'))
+            throw error;
+    }
+    throw new GitWorkspaceError(workspace);
+}
 // memoized: repoRoot is constant per process, but resolveLayout() calls it per request — avoid a git fork each time.
 let repoRootCache = null;
 export function repoRoot() {
@@ -1451,6 +1477,7 @@ function pendingParent(root, tip) {
     }
 }
 export function historyIndex(root, tip = 'HEAD') {
+    requireGitWorkspace(root);
     if (tip !== 'HEAD') {
         const resolved = git(['-C', root, 'rev-parse', `${tip}^{commit}`]).trim();
         // An issue-only candidate changes no governed content, but its lint result still includes the
@@ -2123,6 +2150,7 @@ async function buildDriftIndex(root, tip, transient, useCache = true, shared) {
     return idx;
 }
 export function driftIndex(root, tip = 'HEAD') {
+    requireGitWorkspace(root);
     if (tip !== 'HEAD') {
         const resolved = git(['-C', root, 'rev-parse', `${tip}^{commit}`]).trim();
         if (pendingOnlyIssues(root, resolved)) {
@@ -2199,6 +2227,7 @@ async function buildIndexPair(root, tip, transient, useCache = true) {
 }
 // Standing correctness oracle: same projection, but every immutable stream comes from Git root history.
 export function sourceIndexesFull(root, tip = 'HEAD') {
+    requireGitWorkspace(root);
     const head = tip === 'HEAD' ? headOrEmpty(root) : '';
     const resolved = tip === 'HEAD'
         ? (head || 'HEAD')
@@ -2208,6 +2237,7 @@ export function sourceIndexesFull(root, tip = 'HEAD') {
 // History and drift are one product projection. Building them together is what gives one lint one ledger
 // transaction; the public single-index functions remain for consumers that genuinely need only one side.
 export function sourceIndexes(root, tip = 'HEAD') {
+    requireGitWorkspace(root);
     if (tip !== 'HEAD') {
         const resolved = git(['-C', root, 'rev-parse', `${tip}^{commit}`]).trim();
         if (pendingOnlyIssues(root, resolved)) {
@@ -2249,6 +2279,7 @@ export function resetHistoryCachesForTests() {
     driftRoots.clear();
     eventPathMemo.clear();
     gitObjectFormatMemo.clear();
+    checkedGitWorkspaces.clear();
 }
 export function historyEventCachePathForTests(root) { return eventCacheLocation(root).path; }
 // @@@ one ordinary ancestry memo, with a batch entrance - every closure below has exactly the same dense
@@ -2366,6 +2397,7 @@ export function inAncestors(idx, bits, sha) {
 // structure, never a graft into the shared index: making off-history tips reachable there would silently
 // switch every ancestry-vs-content decision that keys on `undefined`.
 export async function unionTopology(root, revisions) {
+    requireGitWorkspace(root);
     const roster = [...new Set(revisions)].filter(Boolean);
     const reach = { ord: new Map(), parents: new Map(), anc: new Map() };
     if (!roster.length)

package/node_modules/@spexcode/spec-core/dist/layout.d.ts

@@ -120,6 +120,10 @@ export type RawRecord = {
     create_request_id?: string;
     create_payload_hash?: string;
     zcode_child_session_ids?: string[];
+    runtime_owner?: string;
+    runtime_state?: string;
+    runtime_revision?: string;
+    runtime_metadata?: Record<string, string>;
     base?: string;
     launch_readiness_pending?: '' | RawLaunchReadinessPending;
 };

package/node_modules/@spexcode/spec-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-core",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "type": "module",
   "description": "SpexCode's dependency-minimal spec graph core.",
   "files": [

package/node_modules/@spexcode/spec-eval/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-eval",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "type": "module",
   "exports": {
     ".": "./dist/index.js",
@@ -26,7 +26,7 @@
     "test": "tsx --import ../scripts/test-home.mjs --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/spec-core": "0.6.5"
+    "@spexcode/spec-core": "0.6.6"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

package/node_modules/@spexcode/spec-forge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-forge",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "type": "module",
   "exports": {
     ".": "./dist/index.js",
@@ -22,7 +22,7 @@
     "test": "tsx --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/spec-core": "0.6.5"
+    "@spexcode/spec-core": "0.6.6"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spexcode",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "type": "module",
   "description": "SpexCode — a spec-driven, self-developing dev tool. The `spex` CLI + spec server reads the .spec tree and its git history, and serves the dashboard.",
   "license": "MIT",
@@ -21,7 +21,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "npm run build --workspace=@spexcode/spec-core && npm run build --workspace=@spexcode/spec-eval && npm run build --workspace=@spexcode/spec-forge && npm run build --workspace=@spexcode/spec-cli",
+    "build": "npm run build --workspace=@spexcode/spec-core && npm run build --workspace=@spexcode/session-core && npm run build --workspace=@spexcode/spec-eval && npm run build --workspace=@spexcode/spec-forge && npm run build --workspace=@spexcode/spec-cli",
     "api": "npm run build && node bin/spex.mjs serve",
     "web": "cd spec-dashboard && npm run dev",
     "build:public": "node scripts/public-graph-build.mjs",
@@ -38,7 +38,7 @@
     "prepack": "node scripts/sync-init-plugins.mjs --check && node scripts/prepack.mjs"
   },
   "dependencies": {
-    "@spexcode/spec-cli": "0.6.5"
+    "@spexcode/spec-cli": "0.6.6"
   },
   "publishConfig": {
     "access": "public"