@mc1global/opencode-jarvis 0.13.1 → 0.14.0

package/dist/hooks/execution-journal.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Execution Journal Hooks
+ *
+ * Records tool execution lifecycle for crash detection:
+ * - tool.execute.before: Creates a Running entry in the journal
+ * - event (tool.execute.after): Updates entry to Success or Error
+ *
+ * Uses an in-memory pending entries map to correlate before/after events.
+ * On plugin init, detectCrashes() finds orphaned Running entries from
+ * prior sessions and surfaces them to the user.
+ *
+ * SOLID: SRP — execution journal recording only
+ * SOLID: DIP — depends on ExecutionJournalUseCases abstraction
+ */
+import type { ExecutionJournalUseCases } from "../application/context-memory/execution-journal-use-cases.js";
+import type { PluginEvent } from "./event-handlers.js";
+import type { PluginLogger } from "./logger.js";
+export interface ExecutionJournalHookDeps {
+    readonly journalUseCases: ExecutionJournalUseCases;
+    readonly workspace: string;
+    readonly log?: PluginLogger;
+}
+export interface ExecutionJournalHooks {
+    /** Hook for tool.execute.before — records start. */
+    readonly beforeHook: (input: {
+        tool: string;
+    }, output: {
+        args: Record<string, unknown>;
+    }) => Promise<void>;
+    /** Hook for event — records finish (success/error). */
+    readonly afterHook: (input: {
+        event: PluginEvent;
+    }) => Promise<void>;
+}
+/**
+ * Creates execution journal hooks.
+ * The beforeHook and afterHook share state via the PendingEntries tracker.
+ */
+export declare function createExecutionJournalHooks(deps: ExecutionJournalHookDeps): ExecutionJournalHooks;
+//# sourceMappingURL=execution-journal.d.ts.map

package/dist/hooks/execution-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-journal.d.ts","sourceRoot":"","sources":["../../src/hooks/execution-journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8DAA8D,CAAC;AAG7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,CACnB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EACvB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnB,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAwDD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,wBAAwB,GAC7B,qBAAqB,CA0DvB"}

package/dist/hooks/execution-journal.js

@@ -0,0 +1,118 @@
+/**
+ * Execution Journal Hooks
+ *
+ * Records tool execution lifecycle for crash detection:
+ * - tool.execute.before: Creates a Running entry in the journal
+ * - event (tool.execute.after): Updates entry to Success or Error
+ *
+ * Uses an in-memory pending entries map to correlate before/after events.
+ * On plugin init, detectCrashes() finds orphaned Running entries from
+ * prior sessions and surfaces them to the user.
+ *
+ * SOLID: SRP — execution journal recording only
+ * SOLID: DIP — depends on ExecutionJournalUseCases abstraction
+ */
+import { ExecutionEntryId as ExecutionEntryIdClass } from "../domain/context-memory/value-objects.js";
+import { WorkspaceId } from "../domain/shared/value-objects.js";
+// ── Helper Functions ──────────────────────────────────────────────────
+/** Summarize tool args for the journal (truncated key list). */
+function summarizeArgs(args) {
+    const keys = Object.keys(args);
+    if (keys.length === 0)
+        return "";
+    const parts = [];
+    for (const key of keys) {
+        const val = args[key];
+        if (val === undefined)
+            continue;
+        const str = typeof val === "string"
+            ? val.length > 80 ? val.slice(0, 80) + "..." : val
+            : JSON.stringify(val);
+        parts.push(`${key}=${str}`);
+    }
+    return parts.join(", ");
+}
+// ── Pending Entries Tracker ───────────────────────────────────────────
+/**
+ * Tracks pending (running) execution entries for correlation.
+ * Uses a stack per tool name since tool invocations are sequential.
+ * If multiple calls to the same tool overlap, they stack LIFO.
+ */
+class PendingEntries {
+    stacks = new Map();
+    push(toolName, entryId) {
+        let stack = this.stacks.get(toolName);
+        if (stack === undefined) {
+            stack = [];
+            this.stacks.set(toolName, stack);
+        }
+        stack.push(entryId);
+    }
+    pop(toolName) {
+        const stack = this.stacks.get(toolName);
+        if (stack === undefined || stack.length === 0)
+            return undefined;
+        const id = stack.pop();
+        if (stack.length === 0) {
+            this.stacks.delete(toolName);
+        }
+        return id;
+    }
+}
+// ── Hook Factory ──────────────────────────────────────────────────────
+/**
+ * Creates execution journal hooks.
+ * The beforeHook and afterHook share state via the PendingEntries tracker.
+ */
+export function createExecutionJournalHooks(deps) {
+    const pending = new PendingEntries();
+    const beforeHook = async (input, output) => {
+        try {
+            const result = await deps.journalUseCases.recordStart({
+                toolName: input.tool,
+                argsSummary: summarizeArgs(output.args),
+                workspace: WorkspaceId.from(deps.workspace),
+            });
+            pending.push(input.tool, ExecutionEntryIdClass.from(result.entryId));
+        }
+        catch (err) {
+            // Journal recording must NEVER block tool execution
+            deps.log?.warn("Execution journal recordStart failed", {
+                tool: input.tool,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    };
+    const afterHook = async (input) => {
+        if (input.event.type !== "tool.execute.after")
+            return;
+        const toolName = typeof input.event.properties["tool"] === "string"
+            ? input.event.properties["tool"]
+            : typeof input.event.properties["toolName"] === "string"
+                ? input.event.properties["toolName"]
+                : undefined;
+        if (toolName === undefined)
+            return;
+        const entryId = pending.pop(toolName);
+        if (entryId === undefined)
+            return; // No pending entry for this tool
+        try {
+            const error = input.event.properties["error"];
+            if (typeof error === "string" && error.length > 0) {
+                await deps.journalUseCases.recordError({ entryId }, error.length > 500 ? error.slice(0, 500) + "..." : error);
+            }
+            else {
+                await deps.journalUseCases.recordSuccess({ entryId });
+            }
+        }
+        catch (err) {
+            // Journal recording must NEVER block event processing
+            deps.log?.warn("Execution journal recordFinish failed", {
+                tool: toolName,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    };
+    return { beforeHook, afterHook };
+}
+//# sourceMappingURL=execution-journal.js.map

package/dist/hooks/execution-journal.js.map

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

package/dist/hooks/first-run-guide.d.ts

@@ -0,0 +1,35 @@
+/**
+ * First-Run Guide Hook
+ *
+ * Injects quick-start instructions into the system prompt when the plugin
+ * detects a first-run scenario (AGENTS.md and config were just auto-created).
+ *
+ * Hook: "experimental.chat.system.transform"
+ * Signature: (input: { sessionID?, model }, output: { system: string[] }) => Promise<void>
+ *
+ * The injection happens only once per plugin load — after the first session
+ * receives the guidance, the flag is cleared.
+ *
+ * SOLID: SRP — first-run system prompt injection only
+ */
+export interface FirstRunGuideState {
+    /** True when auto-bootstrap created AGENTS.md on this plugin load. */
+    isFirstRun: boolean;
+    /** True when RAG index has 0 documents (needs indexing). */
+    ragEmpty: boolean;
+    /** Crash report summary from execution journal, if any orphaned entries detected. */
+    crashReport?: string;
+}
+/**
+ * Creates the system prompt injection hook for first-run guidance.
+ *
+ * @param state - Mutable state object; isFirstRun is set by the bootstrap
+ *   result in index.ts. The hook clears the flag after first injection.
+ */
+export declare function createFirstRunGuideHook(state: FirstRunGuideState): (input: {
+    sessionID?: string;
+    model: unknown;
+}, output: {
+    system: string[];
+}) => Promise<void>;
+//# sourceMappingURL=first-run-guide.d.ts.map

package/dist/hooks/first-run-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run-guide.d.ts","sourceRoot":"","sources":["../../src/hooks/first-run-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;IAEpB,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAElB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,GACxB,CACD,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EAC7C,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,KACzB,OAAO,CAAC,IAAI,CAAC,CAoBjB"}

package/dist/hooks/first-run-guide.js

@@ -0,0 +1,99 @@
+/**
+ * First-Run Guide Hook
+ *
+ * Injects quick-start instructions into the system prompt when the plugin
+ * detects a first-run scenario (AGENTS.md and config were just auto-created).
+ *
+ * Hook: "experimental.chat.system.transform"
+ * Signature: (input: { sessionID?, model }, output: { system: string[] }) => Promise<void>
+ *
+ * The injection happens only once per plugin load — after the first session
+ * receives the guidance, the flag is cleared.
+ *
+ * SOLID: SRP — first-run system prompt injection only
+ */
+// ── First-Run Guidance Content ────────────────────────────────────────────────
+const FIRST_RUN_GUIDANCE = `[JARVIS FIRST-RUN DETECTED]
+
+This project was just bootstrapped by JARVIS. The following steps are critical for a productive session:
+
+1. Run the /healthcheck command to verify all subsystems are operational
+2. If Ollama is available, index the codebase: use the rag-index tool
+3. Index the documentation for ORACLE search: use rag-oracle-index with directory="obsidian-vault"
+4. Review the kanban board state: use kanban-board-view
+
+Tell the user: "JARVIS was just set up for this project. I'm running initial diagnostics to ensure everything is configured correctly."
+
+IMPORTANT: After completing these steps, the project will be fully operational. This message only appears on the first session after project bootstrap.
+
+## JARVIS Onboarding Reference
+
+JARVIS is an OpenCode plugin providing a multi-agent development framework with:
+- Kanban governance (full card lifecycle with grooming, gate tasks, WIP limits)
+- Context memory (sessions, TODOs, notes persisted across conversations)
+- Azure DevOps sync (bidirectional sync with Azure Boards)
+- Obsidian vault (structured documentation management)
+- RAG search (semantic code search via embeddings)
+- CI/CD pipelines (Dagger-based gate execution)
+- Token metrics (usage tracking per agent/card/sprint)
+- Governance (runtime policy enforcement on every tool invocation)
+
+### Key Tool Groups
+- Context Memory (8): context-session-start, context-todo-add, context-note-add, context-search...
+- Kanban (27): kanban-card-create, kanban-card-move, kanban-board-view, kanban-sprint-create...
+- Governance (2): governance-validate, governance-policies
+- RAG (8): rag-search, rag-snippet, rag-index, rag-oracle-search...
+- Vault (12): vault-manage (smart facade), vault-create-document, vault-search...
+- Data (3): data-yaml-get, data-json-get, data-csv-query
+- Bootstrap (3): bootstrap, healthcheck, terminal-commands
+- Token Metrics (6): token-summary, token-agent-report, token-card-report...
+- Agent (7): agent-list, agent-send, agent-spawn, agent-register, agent-handoff...
+- Pipeline (9): pipeline-init, pipeline-activate, gate-run, gate-pass...
+- Environment (5): env-create, env-status, env-merge, env-list, env-init...
+
+### Available Slash Commands
+- /healthcheck — Run diagnostics and get actionable fix guidance
+- /sync-azure — Execute Azure DevOps sync workflow
+- /start-card CD-XXX — Start working on a specific kanban card
+- /config — View or modify JARVIS configuration
+
+### Configuration
+All settings live in config/jarvis.yaml. Use the /config command or data-yaml-get to read values. Never read YAML files directly.`;
+const RAG_EMPTY_GUIDANCE = `[JARVIS RAG INDEX EMPTY]
+
+The RAG semantic search index has 0 documents. The agent should suggest running:
+- rag-index (to index the codebase — requires Ollama running)
+- rag-oracle-index directory="obsidian-vault" (to index documentation)
+
+Without RAG indexing, semantic code search will not return results.`;
+const CRASH_REPORT_PREFIX = `[JARVIS CRASH RECOVERY]
+
+The previous session ended unexpectedly. The execution journal detected interrupted tool invocations:
+
+`;
+// ── Hook Factory ──────────────────────────────────────────────────────────────
+/**
+ * Creates the system prompt injection hook for first-run guidance.
+ *
+ * @param state - Mutable state object; isFirstRun is set by the bootstrap
+ *   result in index.ts. The hook clears the flag after first injection.
+ */
+export function createFirstRunGuideHook(state) {
+    let injected = false;
+    return async (_input, output) => {
+        // First-run guidance: inject once, then clear
+        if (state.isFirstRun && !injected) {
+            output.system.push(FIRST_RUN_GUIDANCE);
+            injected = true;
+        }
+        // RAG empty warning: inject every session until indexing happens
+        if (state.ragEmpty) {
+            output.system.push(RAG_EMPTY_GUIDANCE);
+        }
+        // Crash recovery report: inject every session until crashReport is cleared
+        if (state.crashReport !== undefined && state.crashReport.length > 0) {
+            output.system.push(CRASH_REPORT_PREFIX + state.crashReport);
+        }
+    };
+}
+//# sourceMappingURL=first-run-guide.js.map

package/dist/hooks/first-run-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run-guide.js","sourceRoot":"","sources":["../../src/hooks/first-run-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,iFAAiF;AAEjF,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kIA6CuG,CAAC;AAEnI,MAAM,kBAAkB,GAAG;;;;;;oEAMyC,CAAC;AAErE,MAAM,mBAAmB,GAAG;;;;CAI3B,CAAC;AAEF,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAyB;IAKzB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QAC9B,8CAA8C;QAC9C,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACvC,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QAED,iEAAiE;QACjE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACzC,CAAC;QAED,2EAA2E;QAC3E,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/hooks/guardrails.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Guardrails Hook
+ *
+ * Intercepts tool invocations before execution to enforce governance
+ * policies. Blocks operations that violate error-severity rules.
+ * Warnings are logged but do not block execution.
+ *
+ * Hook: "tool.execute.before"
+ * Signature: (input: { tool, args }, output: { args }) => Promise<void>
+ *
+ * On violation: throws Error to abort the tool execution.
+ * The error message includes all violations for agent feedback.
+ *
+ * SOLID: SRP - pre-execution governance enforcement only
+ * SOLID: DIP - depends on PolicyValidationService interface
+ */
+import type { PolicyValidationService } from "../domain/governance/services.js";
+export interface GuardrailsHookDeps {
+    readonly validationService: PolicyValidationService;
+}
+/**
+ * Creates the tool.execute.before hook for governance enforcement.
+ *
+ * When a tool is invoked, this hook evaluates all governance policies.
+ * If any error-severity violations are found, the hook throws an Error
+ * which OpenCode surfaces to the LLM as a tool failure.
+ */
+export declare function createGuardrailsHook(deps: GuardrailsHookDeps): (input: {
+    tool: string;
+}, output: {
+    args: Record<string, unknown>;
+}) => Promise<void>;
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/hooks/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/hooks/guardrails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;CACrD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,kBAAkB,GACvB,CACD,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACvB,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KACtC,OAAO,CAAC,IAAI,CAAC,CAejB"}

package/dist/hooks/guardrails.js

@@ -0,0 +1,38 @@
+/**
+ * Guardrails Hook
+ *
+ * Intercepts tool invocations before execution to enforce governance
+ * policies. Blocks operations that violate error-severity rules.
+ * Warnings are logged but do not block execution.
+ *
+ * Hook: "tool.execute.before"
+ * Signature: (input: { tool, args }, output: { args }) => Promise<void>
+ *
+ * On violation: throws Error to abort the tool execution.
+ * The error message includes all violations for agent feedback.
+ *
+ * SOLID: SRP - pre-execution governance enforcement only
+ * SOLID: DIP - depends on PolicyValidationService interface
+ */
+/**
+ * Creates the tool.execute.before hook for governance enforcement.
+ *
+ * When a tool is invoked, this hook evaluates all governance policies.
+ * If any error-severity violations are found, the hook throws an Error
+ * which OpenCode surfaces to the LLM as a tool failure.
+ */
+export function createGuardrailsHook(deps) {
+    return async (input, output) => {
+        const result = deps.validationService.validate({
+            toolName: input.tool,
+            args: output.args,
+        });
+        if (!result.allowed) {
+            const messages = result.errors.map((v) => `[${v.rule}] ${v.message}`);
+            throw new Error(`GOVERNANCE VIOLATION:\n${messages.join("\n")}`);
+        }
+        // Warnings are non-blocking but could be logged
+        // In a future phase, we could push warnings to an audit trail
+    };
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/hooks/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../../src/hooks/guardrails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAwB;IAKxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC;YAC7C,QAAQ,EAAE,KAAK,CAAC,IAAI;YACpB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,gDAAgD;QAChD,8DAA8D;IAChE,CAAC,CAAC;AACJ,CAAC"}

package/dist/hooks/logger.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Plugin Logger
+ *
+ * Structured diagnostic logging via OpenCode's `client.app.log()` API.
+ * Only logs what is necessary to diagnose silent failures — NOT verbose.
+ *
+ * Usage: create a logger instance at plugin init, pass it to subsystems.
+ * Falls back to no-op if the client is unavailable (never throws).
+ *
+ * SOLID: SRP — logging adapter only
+ */
+/** Minimal subset of the OpenCode SDK client used for logging. */
+export interface LogClient {
+    app: {
+        log(options: {
+            body: {
+                service: string;
+                level: "debug" | "info" | "warn" | "error";
+                message: string;
+                extra?: Record<string, unknown>;
+            };
+        }): Promise<unknown>;
+    };
+}
+/** Log levels for filtering. */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+ * Lightweight structured logger that writes to OpenCode server logs.
+ * All methods are fire-and-forget — logging never blocks or throws.
+ */
+export declare class PluginLogger {
+    private readonly client;
+    private readonly service;
+    private readonly minLevel;
+    constructor(client: LogClient, service?: string, minLevel?: LogLevel);
+    /** Create a child logger with a sub-service prefix. */
+    child(subsystem: string): PluginLogger;
+    debug(message: string, extra?: Record<string, unknown>): void;
+    info(message: string, extra?: Record<string, unknown>): void;
+    warn(message: string, extra?: Record<string, unknown>): void;
+    error(message: string, extra?: Record<string, unknown>): void;
+    /** Log an caught error with stack trace in extra. */
+    exception(message: string, err: unknown, extra?: Record<string, unknown>): void;
+    private emit;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/hooks/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/hooks/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE;QACH,GAAG,CAAC,OAAO,EAAE;YACX,IAAI,EAAE;gBACJ,OAAO,EAAE,MAAM,CAAC;gBAChB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;gBAC3C,OAAO,EAAE,MAAM,CAAC;gBAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;aACjC,CAAC;SACH,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACtB,CAAC;CACH;AAED,gCAAgC;AAChC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAa3D;;;GAGG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,MAAiB,EAC1B,QAAQ,GAAE,QAAiB;IAG9C,uDAAuD;IACvD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAQtC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D,qDAAqD;IACrD,SAAS,CACP,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,OAAO,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI;IAeP,OAAO,CAAC,IAAI;CAqBb"}

package/dist/hooks/logger.js

@@ -0,0 +1,81 @@
+/**
+ * Plugin Logger
+ *
+ * Structured diagnostic logging via OpenCode's `client.app.log()` API.
+ * Only logs what is necessary to diagnose silent failures — NOT verbose.
+ *
+ * Usage: create a logger instance at plugin init, pass it to subsystems.
+ * Falls back to no-op if the client is unavailable (never throws).
+ *
+ * SOLID: SRP — logging adapter only
+ */
+// ── Level Ordering ────────────────────────────────────────────────────
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// ── Logger Class ──────────────────────────────────────────────────────
+/**
+ * Lightweight structured logger that writes to OpenCode server logs.
+ * All methods are fire-and-forget — logging never blocks or throws.
+ */
+export class PluginLogger {
+    client;
+    service;
+    minLevel;
+    constructor(client, service = "jarvis", minLevel = "info") {
+        this.client = client;
+        this.service = service;
+        this.minLevel = minLevel;
+    }
+    /** Create a child logger with a sub-service prefix. */
+    child(subsystem) {
+        return new PluginLogger(this.client, `${this.service}.${subsystem}`, this.minLevel);
+    }
+    debug(message, extra) {
+        this.emit("debug", message, extra);
+    }
+    info(message, extra) {
+        this.emit("info", message, extra);
+    }
+    warn(message, extra) {
+        this.emit("warn", message, extra);
+    }
+    error(message, extra) {
+        this.emit("error", message, extra);
+    }
+    /** Log an caught error with stack trace in extra. */
+    exception(message, err, extra) {
+        const errorInfo = { ...extra };
+        if (err instanceof Error) {
+            errorInfo["error"] = err.message;
+            if (err.stack !== undefined) {
+                errorInfo["stack"] = err.stack;
+            }
+        }
+        else {
+            errorInfo["error"] = String(err);
+        }
+        this.emit("error", message, errorInfo);
+    }
+    emit(level, message, extra) {
+        if (LEVEL_ORDER[level] < LEVEL_ORDER[this.minLevel])
+            return;
+        // Fire-and-forget — never block, never throw
+        this.client.app
+            .log({
+            body: {
+                service: this.service,
+                level,
+                message,
+                ...(extra !== undefined ? { extra } : {}),
+            },
+        })
+            .catch(() => {
+            // Last resort: if even logging fails, silently drop
+        });
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/hooks/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/hooks/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,yEAAyE;AAEzE,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,OAAO,YAAY;IAEJ;IACA;IACA;IAHnB,YACmB,MAAiB,EACjB,UAAkB,QAAQ,EAC1B,WAAqB,MAAM;QAF3B,WAAM,GAAN,MAAM,CAAW;QACjB,YAAO,GAAP,OAAO,CAAmB;QAC1B,aAAQ,GAAR,QAAQ,CAAmB;IAC3C,CAAC;IAEJ,uDAAuD;IACvD,KAAK,CAAC,SAAiB;QACrB,OAAO,IAAI,YAAY,CACrB,IAAI,CAAC,MAAM,EACX,GAAG,IAAI,CAAC,OAAO,IAAI,SAAS,EAAE,EAC9B,IAAI,CAAC,QAAQ,CACd,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAA+B;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,KAA+B;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,KAA+B;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAA+B;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,qDAAqD;IACrD,SAAS,CACP,OAAe,EACf,GAAY,EACZ,KAA+B;QAE/B,MAAM,SAAS,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;QAExD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;YACjC,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC5B,SAAS,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;YACjC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAEO,IAAI,CACV,KAAe,EACf,OAAe,EACf,KAA+B;QAE/B,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO;QAE5D,6CAA6C;QAC7C,IAAI,CAAC,MAAM,CAAC,GAAG;aACZ,GAAG,CAAC;YACH,IAAI,EAAE;gBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,KAAK;gBACL,OAAO;gBACP,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C;SACF,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,oDAAoD;QACtD,CAAC,CAAC,CAAC;IACP,CAAC;CACF"}

package/dist/hooks/shell-env.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shell Environment Hook
+ *
+ * Injects JARVIS-related environment variables into shell commands
+ * executed by OpenCode. This allows external scripts (e.g., Python RAG)
+ * to discover the workspace, database path, and session context.
+ *
+ * Hook: "shell.env"
+ * Signature: (input: { cwd }, output: { env }) => Promise<void>
+ *
+ * SOLID: SRP - environment variable injection only
+ */
+import type { SessionUseCases } from "../application/context-memory/session-use-cases.js";
+export interface ShellEnvHookDeps {
+    readonly sessionUseCases: SessionUseCases;
+    readonly getWorkspace: (directory: string) => string;
+    readonly dbPath: string;
+}
+/**
+ * Creates the shell.env hook.
+ * Injects environment variables for external tool consumption.
+ */
+export declare function createShellEnvHook(deps: ShellEnvHookDeps): (input: {
+    cwd: string;
+}, output: {
+    env: Record<string, string>;
+}) => Promise<void>;
+//# sourceMappingURL=shell-env.d.ts.map

package/dist/hooks/shell-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.d.ts","sourceRoot":"","sources":["../../src/hooks/shell-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AAE1F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,GACrB,CACD,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EACtB,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KACpC,OAAO,CAAC,IAAI,CAAC,CAYjB"}

package/dist/hooks/shell-env.js

@@ -0,0 +1,29 @@
+/**
+ * Shell Environment Hook
+ *
+ * Injects JARVIS-related environment variables into shell commands
+ * executed by OpenCode. This allows external scripts (e.g., Python RAG)
+ * to discover the workspace, database path, and session context.
+ *
+ * Hook: "shell.env"
+ * Signature: (input: { cwd }, output: { env }) => Promise<void>
+ *
+ * SOLID: SRP - environment variable injection only
+ */
+/**
+ * Creates the shell.env hook.
+ * Injects environment variables for external tool consumption.
+ */
+export function createShellEnvHook(deps) {
+    return async (input, output) => {
+        const workspace = deps.getWorkspace(input.cwd);
+        output.env["JARVIS_WORKSPACE"] = workspace;
+        output.env["JARVIS_DB_PATH"] = deps.dbPath;
+        // Inject active session ID if one exists
+        const result = await deps.sessionUseCases.getActiveSession({ workspace });
+        if (result.success && result.data !== null) {
+            output.env["JARVIS_SESSION_ID"] = result.data.id;
+        }
+    };
+}
+//# sourceMappingURL=shell-env.js.map

package/dist/hooks/shell-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.js","sourceRoot":"","sources":["../../src/hooks/shell-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAsB;IAKtB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3C,yCAAyC;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/hooks/slash-commands.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Slash Commands Hook
+ *
+ * Intercepts custom slash commands (/healthcheck, /sync-azure, /start-card,
+ * /jarvis-agents-md-file) via the plugin SDK "command.execute.before" hook point.
+ *
+ * These commands were previously defined as .opencode/commands/*.md files,
+ * which only work when OpenCode runs in the plugin dev directory. By
+ * registering them as plugin hooks, they work in any project that installs
+ * the plugin via npm.
+ *
+ * Hook: "command.execute.before"
+ * Signature: (input: { command, sessionID, arguments }, output: { parts: Part[] }) => Promise<void>
+ *
+ * SOLID: SRP — slash command prompt injection only
+ */
+interface CommandHookInput {
+    command: string;
+    sessionID: string;
+    arguments: string;
+}
+interface CommandHookOutput {
+    parts: Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+}
+/**
+ * Creates the slash commands hook for /healthcheck, /sync-azure, /start-card, /jarvis-agents-md-file.
+ * Returns a no-op for unrecognized commands (allows composition with other hooks).
+ */
+export declare function createSlashCommandsHook(): (input: CommandHookInput, output: CommandHookOutput) => Promise<void>;
+/** Exported for testing — returns the set of registered command names. */
+export declare function getRegisteredCommands(): ReadonlySet<string>;
+export {};
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/hooks/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/hooks/slash-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;CACJ;AA2ID;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,CACzC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,iBAAiB,KACtB,OAAO,CAAC,IAAI,CAAC,CAWjB;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,IAAI,WAAW,CAAC,MAAM,CAAC,CAE3D"}