@digital-lake/lognexus 1.0.0-alpha.1 → 1.0.0-alpha.4

package/README.md

@@ -117,9 +117,9 @@ An independent model inspects the PR diff, verifies task contracts, and signs of
 
 ## Installation & Setup
 
-### 1. Scaffold Rules in Your Repository
-Initialize `.lognexus/` rules, templates, and routing configuration with the CLI:
+### 1. Scaffold Rules & Manage State with the CLI
 
+Initialize `.lognexus/` rules, templates, and routing configuration:
 ```bash
 npx @digital-lake/lognexus init
 ```
@@ -134,7 +134,43 @@ Inspect active branch and tier advisory:
 npx @digital-lake/lognexus status
 ```
 
-### 2. Install Rules in Your Agent Environment
+Manage persistent agent state (`.lognexus/state.json`) and session recovery:
+```bash
+npx @digital-lake/lognexus state sync
+npx @digital-lake/lognexus state show
+npx @digital-lake/lognexus state set-task T1 "Add user schema"
+npx @digital-lake/lognexus state finish-task T1
+```
+
+Quiet Mode with Git Notes (`refs/notes/lognexus`, standard `git-ai` v3):
+```bash
+npx @digital-lake/lognexus note attach HEAD
+npx @digital-lake/lognexus note show HEAD
+npx @digital-lake/lognexus note push origin
+```
+
+### 2. Connect via Model Context Protocol (MCP)
+
+LogNexus includes a native, lightweight JSON-RPC 2.0 stdio server (`lognexus mcp`) with zero external SDK dependencies. Connect it to Claude Desktop, Cursor, Google Antigravity, or any MCP-compliant client:
+
+**`claude_desktop_config.json` or Cursor MCP settings:**
+```json
+{
+  "mcpServers": {
+    "lognexus": {
+      "command": "npx",
+      "args": ["-y", "@digital-lake/lognexus", "mcp"]
+    }
+  }
+}
+```
+
+**Exposed Capabilities:**
+- **Tools:** `lognexus_status`, `lognexus_state_get`, `lognexus_state_sync`, `lognexus_state_set_task`, `lognexus_state_finish_task`, `lognexus_state_clear`, `lognexus_note_show`, `lognexus_note_attach`
+- **Resources:** `lognexus://state`, `lognexus://routing`
+- **Prompts:** `lognexus-plan`, `lognexus-review`
+
+### 3. Install Rules in Your Agent Environment
 
 - **Claude Code:**
   ```bash

package/dist/cli.js

@@ -1,26 +1,58 @@
 #!/usr/bin/env node
 import { runDiagnostics } from "./doctor.js";
+import { startMcpServer } from "./mcp/server.js";
+import { attachCurrentStateToCommit } from "./notes/attach.js";
+import { fetchNotes, getNote, listNotes, pushNotes } from "./notes/notes.js";
 import { initProject } from "./scaffold.js";
+import { clearState, finishSubtask, loadState, setSubtask } from "./state/manager.js";
+import { syncStateFromGit } from "./state/sync.js";
 import { getProjectStatus } from "./status.js";
 function printHeader() {
     console.log("\n🔷 LogNexus CLI — Digital Lake");
-    console.log("   The Git-Powered Context & Rules Framework for Native AI Agents\n");
+    console.log("   The Universal Git-Powered Context & Rules Framework for Native AI Agents\n");
 }
 function printUsage() {
     printHeader();
     console.log(`Usage:
-  lognexus <command> [options]
+  lognexus <command> [subcommand] [options]
 
 Commands:
   init         Scaffold .lognexus/ configuration and rules in current repository
   doctor       Check Git, GitHub CLI authentication, and repository rules health
   status       Inspect current branch, active issue, and recommended tier
+  state        Manage persistent agent state (.lognexus/state.json)
+  note         Manage Git Notes under refs/notes/lognexus (git-ai standard)
+  mcp          Start the LogNexus MCP server (stdio JSON-RPC 2.0) for native AI agents
   help         Display this help message
 
+State Subcommands:
+  lognexus state [show]             Display current active issue and task state
+  lognexus state sync               Sync state from current Git branch & GitHub
+  lognexus state set-task <id> [t]  Set active subtask (e.g. lognexus state set-task T1 "Add schema")
+  lognexus state finish-task <id>   Mark subtask as completed (e.g. lognexus state finish-task T1)
+  lognexus state clear              Reset persistent state to empty
+
+Note Subcommands:
+  lognexus note [show] [commit]     Display LogNexus Git Note for commit (default: HEAD)
+  lognexus note attach [commit]     Attach current session state as Git Note to commit
+  lognexus note list                List all commits with LogNexus Git Notes
+  lognexus note push [remote]       Push refs/notes/lognexus to remote (default: origin)
+  lognexus note fetch [remote]      Fetch refs/notes/lognexus from remote
+
+MCP Server:
+  lognexus mcp                      Start MCP server on stdio (JSON-RPC 2.0) for Claude Code,
+                                    Cursor, VS Code, Antigravity or any MCP-compatible client
+  Tools:     lognexus_status, lognexus_state_get, lognexus_state_sync, lognexus_state_set_task,
+             lognexus_state_finish_task, lognexus_state_clear, lognexus_note_show, lognexus_note_attach
+  Resources: lognexus://state, lognexus://routing
+  Prompts:   lognexus-plan, lognexus-review
+
 Examples:
   npx @digital-lake/lognexus init
-  npx @digital-lake/lognexus doctor
-  npx @digital-lake/lognexus status
+  npx @digital-lake/lognexus state sync
+  npx @digital-lake/lognexus note attach HEAD
+  npx @digital-lake/lognexus note show HEAD
+  npx @digital-lake/lognexus mcp
 `);
 }
 async function handleInit() {
@@ -63,6 +95,168 @@ async function handleStatus() {
     console.log(`Rules Routing Mode: ${st.routingMode}`);
     console.log(`Recommended Tier:   ${st.recommendedTier}\n`);
 }
+async function handleState(args) {
+    const sub = args[0]?.toLowerCase() || "show";
+    switch (sub) {
+        case "show": {
+            printHeader();
+            const state = loadState();
+            console.log("Persistent Agent State (.lognexus/state.json):\n");
+            if (state.activeIssue) {
+                console.log(`Active Issue:      #${state.activeIssue.id} — ${state.activeIssue.title}`);
+                console.log(`Branch:            ${state.activeIssue.branch}`);
+                console.log(`Phase:             ${state.activeIssue.phase}`);
+                console.log(`Tier:              ${state.activeIssue.tier}`);
+                console.log(`Readiness:         ${state.activeIssue.readiness}`);
+            }
+            else {
+                console.log("Active Issue:      (none)");
+            }
+            console.log("");
+            if (state.currentSubtask) {
+                console.log(`Current Subtask:   ${state.currentSubtask.id} (${state.currentSubtask.status})`);
+                if (state.currentSubtask.title) {
+                    console.log(`  Title:           ${state.currentSubtask.title}`);
+                }
+                if (state.currentSubtask.contract) {
+                    console.log(`  Allowed Files:   ${state.currentSubtask.contract.allowedFiles.join(", ") || "(all)"}`);
+                    console.log(`  Decision Budget: ${state.currentSubtask.contract.decisionBudget}`);
+                    if (state.currentSubtask.contract.verificationCmd) {
+                        console.log(`  Verify Command:  ${state.currentSubtask.contract.verificationCmd}`);
+                    }
+                }
+            }
+            else {
+                console.log("Current Subtask:   (none)");
+            }
+            console.log(`Completed Tasks:   ${state.completedSubtasks.length > 0 ? state.completedSubtasks.join(", ") : "(none)"}`);
+            console.log(`Last Synchronized: ${state.lastSync}\n`);
+            break;
+        }
+        case "sync": {
+            printHeader();
+            console.log("Synchronizing state from current Git branch and GitHub...\n");
+            const synced = syncStateFromGit();
+            if (synced.activeIssue) {
+                console.log(`[OK] Synchronized with Issue #${synced.activeIssue.id} (${synced.activeIssue.title})`);
+                console.log(`     Branch: ${synced.activeIssue.branch}`);
+            }
+            else {
+                console.log("[OK] Synchronized. No active issue detected on current branch.");
+            }
+            console.log("");
+            break;
+        }
+        case "set-task": {
+            const taskId = args[1];
+            const title = args.slice(2).join(" ");
+            if (!taskId) {
+                console.error("Error: Subtask ID is required (e.g. lognexus state set-task T1 'Add schema')\n");
+                process.exit(1);
+            }
+            printHeader();
+            setSubtask(taskId, title);
+            console.log(`[OK] Active subtask set to: ${taskId}${title ? ` — ${title}` : ""}\n`);
+            break;
+        }
+        case "finish-task": {
+            const taskId = args[1];
+            if (!taskId) {
+                console.error("Error: Subtask ID is required (e.g. lognexus state finish-task T1)\n");
+                process.exit(1);
+            }
+            printHeader();
+            finishSubtask(taskId);
+            console.log(`[OK] Subtask ${taskId} marked as completed.\n`);
+            break;
+        }
+        case "clear": {
+            printHeader();
+            clearState();
+            console.log("[OK] Persistent state cleared.\n");
+            break;
+        }
+        default:
+            console.error(`Unknown state subcommand: ${sub}\n`);
+            printUsage();
+            process.exit(1);
+    }
+}
+async function handleNote(args) {
+    const sub = args[0]?.toLowerCase() || "show";
+    switch (sub) {
+        case "show": {
+            const commit = args[1] || "HEAD";
+            printHeader();
+            const note = getNote(commit);
+            if (note) {
+                console.log(`Git Note for commit [${commit}] (refs/notes/lognexus):\n`);
+                console.log(note);
+            }
+            else {
+                console.log(`No LogNexus note found attached to commit [${commit}].`);
+                console.log("Tip: Run 'lognexus note attach' to attach current state to this commit.");
+            }
+            console.log("");
+            break;
+        }
+        case "attach": {
+            const commit = args[1] || "HEAD";
+            printHeader();
+            const payload = attachCurrentStateToCommit(commit);
+            console.log(`[OK] Attached LogNexus note to commit [${commit}] (refs/notes/lognexus):`);
+            console.log(`     Issue:   ${payload.issue ? `#${payload.issue.id} — ${payload.issue.title}` : "(none)"}`);
+            console.log(`     Subtask: ${payload.subtask ? `${payload.subtask.id} (${payload.subtask.title})` : "(none)"}`);
+            console.log(`     Tier:    ${payload.tier}\n`);
+            break;
+        }
+        case "list": {
+            printHeader();
+            const notes = listNotes();
+            console.log(`LogNexus Notes (refs/notes/lognexus) — ${notes.length} note(s):\n`);
+            if (notes.length === 0) {
+                console.log("No notes recorded yet.");
+            }
+            else {
+                for (const n of notes) {
+                    console.log(`  • Commit: ${n.commitSha} (blob: ${n.noteBlob})`);
+                }
+            }
+            console.log("");
+            break;
+        }
+        case "push": {
+            const remote = args[1] || "origin";
+            printHeader();
+            console.log(`Pushing refs/notes/lognexus to ${remote}...`);
+            const ok = pushNotes(remote);
+            if (ok) {
+                console.log(`[OK] Notes pushed to ${remote} successfully.\n`);
+            }
+            else {
+                console.error(`[FAIL] Could not push notes to ${remote}.\n`);
+            }
+            break;
+        }
+        case "fetch": {
+            const remote = args[1] || "origin";
+            printHeader();
+            console.log(`Fetching refs/notes/lognexus from ${remote}...`);
+            const ok = fetchNotes(remote);
+            if (ok) {
+                console.log(`[OK] Notes fetched from ${remote} successfully.\n`);
+            }
+            else {
+                console.error(`[FAIL] Could not fetch notes from ${remote}.\n`);
+            }
+            break;
+        }
+        default:
+            console.error(`Unknown note subcommand: ${sub}\n`);
+            printUsage();
+            process.exit(1);
+    }
+}
 async function main() {
     const args = process.argv.slice(2);
     const command = args[0]?.toLowerCase();
@@ -76,6 +270,16 @@ async function main() {
         case "status":
             await handleStatus();
             break;
+        case "state":
+            await handleState(args.slice(1));
+            break;
+        case "note":
+            await handleNote(args.slice(1));
+            break;
+        case "mcp":
+            // stdout is reserved for JSON-RPC frames: never print the banner here.
+            await startMcpServer();
+            break;
         case "help":
         case "--help":
         case "-h":

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,13 @@
 export { checkGit, checkGitHubCli, checkRulesConfig, runDiagnostics } from "./doctor.js";
-export { initProject } from "./scaffold.js";
+export { getMcpPrompt, listMcpPrompts, type PromptDefinition, type PromptMessage, type PromptResult, } from "./mcp/prompts.js";
+export { listMcpResources, MCP_RESOURCE_PREFIX, type ResourceDefinition, readMcpResource, } from "./mcp/resources.js";
+export { MCP_PROTOCOL_VERSION, MCP_SERVER_VERSION, processMcpMessage, startMcpServer, } from "./mcp/server.js";
+export { callMcpTool, listMcpTools, MCP_SERVER_NAME, type ToolCallResult, type ToolDefinition, } from "./mcp/tools.js";
+export { attachCurrentStateToCommit, buildStateNotePayload, type GitNotePayload, } from "./notes/attach.js";
+export { attachNote, DEFAULT_NOTES_REF, fetchNotes, getNote, listNotes, type NoteOptions, pushNotes, } from "./notes/notes.js";
+export { DEFAULT_ROUTING_TEMPLATE, initProject } from "./scaffold.js";
+export { clearState, createEmptyState, finishSubtask, getStatePath, loadState, saveState, setSubtask, } from "./state/manager.js";
+export * from "./state/schema.js";
+export { fetchIssueMeta, getBranchName, syncStateFromGit } from "./state/sync.js";
 export { getProjectStatus } from "./status.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EACL,YAAY,EACZ,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,OAAO,EACP,SAAS,EACT,KAAK,WAAW,EAChB,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,4 +1,13 @@
 export { checkGit, checkGitHubCli, checkRulesConfig, runDiagnostics } from "./doctor.js";
-export { initProject } from "./scaffold.js";
+export { getMcpPrompt, listMcpPrompts, } from "./mcp/prompts.js";
+export { listMcpResources, MCP_RESOURCE_PREFIX, readMcpResource, } from "./mcp/resources.js";
+export { MCP_PROTOCOL_VERSION, MCP_SERVER_VERSION, processMcpMessage, startMcpServer, } from "./mcp/server.js";
+export { callMcpTool, listMcpTools, MCP_SERVER_NAME, } from "./mcp/tools.js";
+export { attachCurrentStateToCommit, buildStateNotePayload, } from "./notes/attach.js";
+export { attachNote, DEFAULT_NOTES_REF, fetchNotes, getNote, listNotes, pushNotes, } from "./notes/notes.js";
+export { DEFAULT_ROUTING_TEMPLATE, initProject } from "./scaffold.js";
+export { clearState, createEmptyState, finishSubtask, getStatePath, loadState, saveState, setSubtask, } from "./state/manager.js";
+export * from "./state/schema.js";
+export { fetchIssueMeta, getBranchName, syncStateFromGit } from "./state/sync.js";
 export { getProjectStatus } from "./status.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EACL,YAAY,EACZ,cAAc,GAIf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EAEnB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,GAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,GAEtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,OAAO,EACP,SAAS,EAET,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp/prompts.d.ts

@@ -0,0 +1,30 @@
+export declare const MCP_PROMPT_PLAN = "lognexus-plan";
+export declare const MCP_PROMPT_REVIEW = "lognexus-review";
+export interface PromptArgument {
+    name: string;
+    description: string;
+    required: boolean;
+}
+export interface PromptDefinition {
+    name: string;
+    title: string;
+    description: string;
+    arguments: PromptArgument[];
+}
+export interface PromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: "text";
+        text: string;
+    };
+}
+export interface PromptResult {
+    description: string;
+    messages: PromptMessage[];
+}
+export declare class McpPromptError extends Error {
+    constructor(message: string);
+}
+export declare function listMcpPrompts(): PromptDefinition[];
+export declare function getMcpPrompt(name: string, args?: Record<string, string>): PromptResult;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/mcp/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/mcp/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAsDD,wBAAgB,cAAc,IAAI,gBAAgB,EAAE,CAEnD;AAyFD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,YAAY,CAc1F"}

package/dist/mcp/prompts.js

@@ -0,0 +1,150 @@
+export const MCP_PROMPT_PLAN = "lognexus-plan";
+export const MCP_PROMPT_REVIEW = "lognexus-review";
+export class McpPromptError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "McpPromptError";
+    }
+}
+const PROMPT_DEFINITIONS = [
+    {
+        name: MCP_PROMPT_PLAN,
+        title: "Plan an issue into tier-scoped subtasks",
+        description: "Break a LogNexus issue down into ordered, verifiable subtasks with strict closed-delegation contracts delegated to the appropriate model tier.",
+        arguments: [
+            {
+                name: "issue",
+                description: "Issue identifier or URL, e.g. '#7' or a GitHub issue link.",
+                required: false,
+            },
+            {
+                name: "context",
+                description: "Extra architectural context, constraints or acceptance criteria.",
+                required: false,
+            },
+        ],
+    },
+    {
+        name: MCP_PROMPT_REVIEW,
+        title: "Run the LogNexus review gate",
+        description: "Audit a diff or pull request against the LogNexus review gate before merging into main: contracts, verification, traceability and cross-model attribution.",
+        arguments: [
+            {
+                name: "target",
+                description: "Branch, pull request number or commit range under review.",
+                required: false,
+            },
+            {
+                name: "diff",
+                description: "The diff or changed-files summary to audit.",
+                required: false,
+            },
+        ],
+    },
+];
+const CONTRACT_FORMAT = `### Contract
+- **Allowed files:** \`path/to/file.ts\`, \`tests/file.test.ts\`
+- **Must not change:** \`package.json\` dependencies, public interfaces
+- **Stop and ask if:** the compiler requires new third-party dependencies
+- **Verification required:** \`npm run build && npm run lint && npm test\` must pass
+- **Decision budget:** \`none\``;
+const TIER_TABLE = `| Tier | Role | Example models | Typical work |
+| --- | --- | --- | --- |
+| tier-1 | Reasoning, architecture, review | Claude Opus, OpenAI o3, Gemini Pro, DeepSeek R1 | Issue decomposition, architectural decisions, review gate |
+| tier-2 | Large-context discovery and triage | Claude Sonnet, GPT-4.1, Gemini Pro (1M), DeepSeek V3 | Repository exploration, discovery triage |
+| tier-3 | Scoped execution | Claude Haiku, GPT-4o-mini, Gemini Flash, DeepSeek Chat | Single-contract subtasks, atomic commits |`;
+export function listMcpPrompts() {
+    return PROMPT_DEFINITIONS;
+}
+function textPrompt(description, text) {
+    return {
+        description,
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text },
+            },
+        ],
+    };
+}
+function buildPlanPrompt(issue, context) {
+    const issueLine = issue ? `Target issue: ${issue}` : "Target issue: (the issue currently open)";
+    const contextBlock = context ? `\nAdditional context provided by the user:\n\n${context}\n` : "";
+    const text = `You are the tier-1 orchestrator for a LogNexus-governed repository. Plan the work described below as small, independently verifiable subtasks that a cheaper execution model can complete without improvising.
+
+${issueLine}
+${contextBlock}
+## Rules
+
+1. Decompose the work into ordered subtasks, each named \`[tier-X]\` according to the model tier suited to it.
+2. Every subtask must carry a closed delegation contract. Never leave a subtask open-ended.
+3. Subtasks must not overlap in the files they touch. If they would, split further or sequence them.
+4. Each subtask must end in a state where the verification command passes.
+5. Prefer the lowest tier that can safely complete the subtask. Escalate to tier-1 only for decisions the executor must not make.
+6. Do not invent dependencies or APIs. If a capability is missing, the subtask must say "stop and ask".
+
+## Tier taxonomy
+
+${TIER_TABLE}
+
+## Contract format (mandatory)
+
+${CONTRACT_FORMAT}
+
+## Output format
+
+For each subtask emit exactly:
+
+### [tier-X] <short imperative title>
+- **Branch / commit:** \`feat(#<issue>/T<n>)\` or \`fix(#<issue>/T<n>)\`
+- **Scope:** one or two sentences describing the exact change.
+
+${CONTRACT_FORMAT}
+
+Finally, propose the single verification command that gates the whole issue.`;
+    return textPrompt("Breakdown of an issue into tier-scoped subtasks with strict closed-delegation contracts.", text);
+}
+function buildReviewPrompt(target, diff) {
+    const targetLine = target ? `Under review: ${target}` : "Under review: the current branch diff";
+    const diffBlock = diff ? `\nDiff to audit:\n\n\`\`\`diff\n${diff}\n\`\`\`\n` : "";
+    const text = `You are the LogNexus review gate (tier-1). Your job is to decide whether the change below may be merged into \`main\`. Be strict and evidence-driven.
+
+${targetLine}
+${diffBlock}
+## Gate checklist
+
+1. **Contract compliance**: every changed file is inside the subtask's allowed files, and no file listed as forbidden was touched.
+2. **Verification**: \`npm run build\`, \`npm run lint\` and \`npm test\` pass on the delivered code. Ask for the actual command output if it is missing.
+3. **Scope**: no unrelated refactor, no unrequested dependency in \`package.json\`, no dead code or commented-out blocks.
+4. **Correctness**: edge cases, error paths, encoding/line-ending handling and platform differences (Windows vs POSIX) are addressed.
+5. **Traceability**: commits follow \`feat(#N/Tk)\` / \`fix(#N/Tk)\`, and the PR links the issue and the subtask contracts.
+6. **Attribution**: authorship trailers (\`Authored-by\`, \`Reviewed-by\`, \`Last-code-by\`) are present and the reviewer differs from the code author.
+7. **Tests**: new behaviour is covered by tests that fail when the behaviour is reverted. Tests must not be weakened to make them pass.
+
+## Output format
+
+Emit a verdict first, then the evidence:
+
+- **Verdict:** APPROVE | REQUEST CHANGES
+- **Blocking findings:** numbered list, each with \`path/to/file.ts:line\` and the concrete fix.
+- **Non-blocking findings:** numbered list, or "none".
+- **Verification observed:** which commands were run and their result.
+
+Never approve on partial evidence. If a check cannot be verified from what you were given, list it as blocking.`;
+    return textPrompt("Review gate checklist for merging a branch into main.", text);
+}
+export function getMcpPrompt(name, args = {}) {
+    const issue = args.issue?.trim() || undefined;
+    const context = args.context?.trim() || undefined;
+    const target = args.target?.trim() || undefined;
+    const diff = args.diff?.trim() || undefined;
+    switch (name) {
+        case MCP_PROMPT_PLAN:
+            return buildPlanPrompt(issue, context);
+        case MCP_PROMPT_REVIEW:
+            return buildReviewPrompt(target, diff);
+        default:
+            throw new McpPromptError(`Unknown LogNexus prompt: '${name}'.`);
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/mcp/prompts.js.map

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

package/dist/mcp/resources.d.ts

@@ -0,0 +1,25 @@
+export declare const MCP_RESOURCE_PREFIX = "lognexus://";
+export declare const STATE_RESOURCE_URI = "lognexus://state";
+export declare const ROUTING_RESOURCE_URI = "lognexus://routing";
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+export interface ResourceContent {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export interface ResourceReadResult {
+    contents: ResourceContent[];
+}
+export declare class McpResourceError extends Error {
+    constructor(message: string);
+}
+export declare function listMcpResources(): ResourceDefinition[];
+export declare function readStateResource(targetDir?: string): ResourceReadResult;
+export declare function readRoutingResource(targetDir?: string): ResourceReadResult;
+export declare function readMcpResource(uri: string, targetDir?: string): ResourceReadResult;
+//# sourceMappingURL=resources.d.ts.map

package/dist/mcp/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,kBAAkB,qBAAgC,CAAC;AAChE,eAAO,MAAM,oBAAoB,uBAAkC,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAmBD,wBAAgB,gBAAgB,IAAI,kBAAkB,EAAE,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,MAAsB,GAAG,kBAAkB,CAUvF;AAED,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,MAAsB,GAAG,kBAAkB,CAwBzF;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAsB,GAChC,kBAAkB,CASpB"}