@mc1global/opencode-jarvis 0.9.0 → 0.11.0

package/dist/domain/context-memory/repositories.d.ts

@@ -6,8 +6,8 @@
  * SOLID: ISP - one interface per aggregate root
  */
 import type { WorkspaceId } from "../shared/value-objects.js";
-import type { Session, Todo, Note } from "./entities.js";
-import type { SessionId, TodoId, TodoStatus } from "./value-objects.js";
+import type { Session, Todo, Note, ExecutionEntry } from "./entities.js";
+import type { SessionId, TodoId, TodoStatus, ExecutionEntryId } from "./value-objects.js";
 /** Persistence port for Session aggregate root. */
 export interface SessionRepository {
     save(session: Session): Promise<void>;
@@ -43,4 +43,17 @@ export interface ContextSearchResult {
     readonly content: string;
     readonly relevance: number;
 }
+/** Persistence port for ExecutionEntry (execution journal). */
+export interface ExecutionJournalRepository {
+    /** Save a new entry; returns entry with persistence-assigned ID. */
+    save(entry: ExecutionEntry): Promise<ExecutionEntry>;
+    /** Find entry by ID. */
+    findById(id: ExecutionEntryId): Promise<ExecutionEntry | null>;
+    /** Update an existing entry (state, finishedAt, errorMessage). */
+    update(entry: ExecutionEntry): Promise<void>;
+    /** Find all entries in Running state for a workspace (orphaned = crash). */
+    findRunning(workspace: WorkspaceId): Promise<readonly ExecutionEntry[]>;
+    /** Delete entries older than the given date for a workspace. */
+    pruneOlderThan(workspace: WorkspaceId, before: Date): Promise<number>;
+}
 //# sourceMappingURL=repositories.d.ts.map

package/dist/domain/context-memory/repositories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../../../src/domain/context-memory/repositories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAExE,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACjD,eAAe,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IACrE,UAAU,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5D,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC3C,eAAe,CACb,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC5B,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,eAAe,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAClE,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC9D,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;CACzE;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,SAAS,CACP,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,WAAW,GACrB,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../../../src/domain/context-memory/repositories.ts"],"names":[],"mappings":"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"}

package/dist/domain/context-memory/value-objects.d.ts

@@ -1,7 +1,7 @@
 /**
  * Context Memory Value Objects
  *
- * Identity types for Session, Todo, and Note entities.
+ * Identity types for Session, Todo, Note, and ExecutionEntry entities.
  * All are immutable, compared by value.
  *
  * DDD: Value Objects - no identity lifecycle, equality by value
@@ -62,4 +62,21 @@ export declare class NoteId extends EntityId {
 export declare const MIN_PRIORITY = 1;
 export declare const MAX_PRIORITY = 5;
 export declare function isValidPriority(priority: number): boolean;
+/** Execution entry lifecycle states. */
+export declare enum ExecutionState {
+    Running = "running",
+    Success = "success",
+    Error = "error",
+    Crashed = "crashed"
+}
+export declare function isTerminalExecutionState(state: ExecutionState): boolean;
+/**
+ * Execution entry identifier. Auto-increment integer (assigned by persistence).
+ */
+export declare class ExecutionEntryId extends EntityId {
+    private constructor();
+    static create(id: number): ExecutionEntryId;
+    static from(value: string): ExecutionEntryId;
+    get numericValue(): number;
+}
 //# sourceMappingURL=value-objects.d.ts.map

package/dist/domain/context-memory/value-objects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value-objects.d.ts","sourceRoot":"","sources":["../../../src/domain/context-memory/value-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEjE,gCAAgC;AAChC,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED,+BAA+B;AAC/B,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED,iCAAiC;AACjC,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,QAAQ;IACrC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS;IAQrE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAIrC,IAAI,SAAS,IAAI,MAAM,CAGtB;IAED,IAAI,SAAS,IAAI,MAAM,CAGtB;CACF;AAED;;GAEG;AACH,qBAAa,MAAO,SAAQ,QAAQ;IAClC,OAAO;IAIP,MAAM,CAAC,MAAM,IAAI,MAAM;IAIvB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAGnC;AAED;;GAEG;AACH,qBAAa,MAAO,SAAQ,QAAQ;IAClC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAOjC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIlC,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF;AAED,mDAAmD;AACnD,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMzD"}
+{"version":3,"file":"value-objects.d.ts","sourceRoot":"","sources":["../../../src/domain/context-memory/value-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEjE,gCAAgC;AAChC,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED,+BAA+B;AAC/B,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED,iCAAiC;AACjC,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,QAAQ;IACrC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS;IAQrE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAIrC,IAAI,SAAS,IAAI,MAAM,CAGtB;IAED,IAAI,SAAS,IAAI,MAAM,CAGtB;CACF;AAED;;GAEG;AACH,qBAAa,MAAO,SAAQ,QAAQ;IAClC,OAAO;IAIP,MAAM,CAAC,MAAM,IAAI,MAAM;IAIvB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAGnC;AAED;;GAEG;AACH,qBAAa,MAAO,SAAQ,QAAQ;IAClC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAOjC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIlC,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF;AAED,mDAAmD;AACnD,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMzD;AAID,wCAAwC;AACxC,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AASD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB;IAO3C,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAI5C,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF"}

package/dist/domain/context-memory/value-objects.js

@@ -1,7 +1,7 @@
 /**
  * Context Memory Value Objects
  *
- * Identity types for Session, Todo, and Note entities.
+ * Identity types for Session, Todo, Note, and ExecutionEntry entities.
  * All are immutable, compared by value.
  *
  * DDD: Value Objects - no identity lifecycle, equality by value
@@ -102,4 +102,42 @@ export function isValidPriority(priority) {
         priority >= MIN_PRIORITY &&
         priority <= MAX_PRIORITY);
 }
+// ── Execution Journal ─────────────────────────────────────────────────
+/** Execution entry lifecycle states. */
+export var ExecutionState;
+(function (ExecutionState) {
+    ExecutionState["Running"] = "running";
+    ExecutionState["Success"] = "success";
+    ExecutionState["Error"] = "error";
+    ExecutionState["Crashed"] = "crashed";
+})(ExecutionState || (ExecutionState = {}));
+/** Terminal states — an entry in one of these states cannot transition. */
+const TERMINAL_EXECUTION_STATES = new Set([
+    ExecutionState.Success,
+    ExecutionState.Error,
+    ExecutionState.Crashed,
+]);
+export function isTerminalExecutionState(state) {
+    return TERMINAL_EXECUTION_STATES.has(state);
+}
+/**
+ * Execution entry identifier. Auto-increment integer (assigned by persistence).
+ */
+export class ExecutionEntryId extends EntityId {
+    constructor(value) {
+        super(value);
+    }
+    static create(id) {
+        if (id <= 0) {
+            throw new Error("ExecutionEntryId: must be a positive integer");
+        }
+        return new ExecutionEntryId(String(id));
+    }
+    static from(value) {
+        return new ExecutionEntryId(value);
+    }
+    get numericValue() {
+        return Number(this.value);
+    }
+}
 //# sourceMappingURL=value-objects.js.map

package/dist/domain/context-memory/value-objects.js.map

@@ -1 +1 @@
-{"version":3,"file":"value-objects.js","sourceRoot":"","sources":["../../../src/domain/context-memory/value-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEjE,gCAAgC;AAChC,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,2BAAW,CAAA;IACX,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;AACzB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,+BAA+B;AAC/B,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,wCAA0B,CAAA;IAC1B,qCAAuB,CAAA;IACvB,qCAAuB,CAAA;AACzB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,iCAAiC;AACjC,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,iCAAqB,CAAA;IACrB,mCAAuB,CAAA;IACvB,+BAAmB,CAAA;AACrB,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAED;;;;GAIG;AACH,MAAM,OAAO,SAAU,SAAQ,QAAQ;IACrC,YAAoB,KAAa;QAC/B,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,aAAqB,EAAE,SAAoB;QACvD,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,KAAK,SAAS,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,SAAS;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;IAChC,CAAC;IAED,IAAI,SAAS;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,QAAQ;IAClC,YAAoB,KAAa;QAC/B,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,QAAQ;IAClC,YAAoB,KAAa;QAC/B,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,EAAU;QACtB,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,CACL,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;QAC1B,QAAQ,IAAI,YAAY;QACxB,QAAQ,IAAI,YAAY,CACzB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"value-objects.js","sourceRoot":"","sources":["../../../src/domain/context-memory/value-objects.ts"],"names":[],"mappings":"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"}

package/dist/hooks/config-command.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Config Command Hook
+ *
+ * Intercepts the `/config` slash command in OpenCode sessions.
+ * Injects a system prompt that instructs the agent to use the
+ * config-read and config-write tools for agent-guided configuration.
+ *
+ * Hook: "command.execute.before"
+ * Signature: (input: { command, sessionID, arguments }, output: { parts: Part[] }) => Promise<void>
+ *
+ * When the user types `/config` or `/config <section>`, this hook
+ * pushes a TextPart instructing the agent on how to proceed.
+ *
+ * SOLID: SRP — /config command interception only
+ */
+interface CommandHookInput {
+    command: string;
+    sessionID: string;
+    arguments: string;
+}
+interface CommandHookOutput {
+    parts: Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+}
+export interface ConfigCommandHookDeps {
+    /** Readable list of writable config sections for the prompt. */
+    readonly writableContexts: readonly string[];
+}
+/**
+ * Creates the command hook for /config.
+ * Returns undefined for non-/config commands (no-op).
+ */
+export declare function createConfigCommandHook(deps: ConfigCommandHookDeps): (input: CommandHookInput, output: CommandHookOutput) => Promise<void>;
+export {};
+//# sourceMappingURL=config-command.d.ts.map

package/dist/hooks/config-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-command.d.ts","sourceRoot":"","sources":["../../src/hooks/config-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,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;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;CACxD;AAID,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAsCD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAkBvE"}

package/dist/hooks/config-command.js

@@ -0,0 +1,68 @@
+/**
+ * Config Command Hook
+ *
+ * Intercepts the `/config` slash command in OpenCode sessions.
+ * Injects a system prompt that instructs the agent to use the
+ * config-read and config-write tools for agent-guided configuration.
+ *
+ * Hook: "command.execute.before"
+ * Signature: (input: { command, sessionID, arguments }, output: { parts: Part[] }) => Promise<void>
+ *
+ * When the user types `/config` or `/config <section>`, this hook
+ * pushes a TextPart instructing the agent on how to proceed.
+ *
+ * SOLID: SRP — /config command interception only
+ */
+// ── Prompt Templates ──────────────────────────────────────────────────
+function buildAllSectionsPrompt(contexts) {
+    return `[JARVIS /config COMMAND]
+
+The user wants to view or modify JARVIS configuration.
+
+INSTRUCTIONS:
+1. Use the "config-read" tool (no arguments) to read ALL current configuration sections
+2. Present the configuration to the user in a clear, organized format
+3. Ask the user which section they want to modify
+4. When the user tells you what to change, use the "config-write" tool with:
+   - section: the section name (e.g., "azure-sync")
+   - values: a JSON string with ONLY the keys to change
+
+Available sections: ${contexts.join(", ")}
+
+IMPORTANT: Only include changed values in the config-write call. The system automatically computes minimal overrides against defaults.`;
+}
+function buildSectionPrompt(section) {
+    return `[JARVIS /config COMMAND — section: ${section}]
+
+The user wants to view or modify the "${section}" configuration section.
+
+INSTRUCTIONS:
+1. Use the "config-read" tool with section="${section}" to read current values
+2. Present the configuration to the user
+3. Ask what they want to change
+4. Use the "config-write" tool to apply changes
+
+IMPORTANT: Only include changed values in the config-write call.`;
+}
+// ── Hook Factory ──────────────────────────────────────────────────────
+/**
+ * Creates the command hook for /config.
+ * Returns undefined for non-/config commands (no-op).
+ */
+export function createConfigCommandHook(deps) {
+    return async (input, output) => {
+        if (input.command !== "config") {
+            return;
+        }
+        const sectionArg = input.arguments.trim();
+        const prompt = sectionArg
+            ? buildSectionPrompt(sectionArg)
+            : buildAllSectionsPrompt(deps.writableContexts);
+        const textPart = {
+            type: "text",
+            text: prompt,
+        };
+        output.parts.push(textPart);
+    };
+}
+//# sourceMappingURL=config-command.js.map

package/dist/hooks/config-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-command.js","sourceRoot":"","sources":["../../src/hooks/config-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4BH,yEAAyE;AAEzE,SAAS,sBAAsB,CAAC,QAA2B;IACzD,OAAO;;;;;;;;;;;;sBAYa,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;;uIAE8F,CAAC;AACxI,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO,sCAAsC,OAAO;;wCAEd,OAAO;;;8CAGD,OAAO;;;;;iEAKY,CAAC;AAClE,CAAC;AAED,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAA2B;IAE3B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC7B,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,UAAU;YACvB,CAAC,CAAC,kBAAkB,CAAC,UAAU,CAAC;YAChC,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAElD,MAAM,QAAQ,GAAa;YACzB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM;SACb,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC"}

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;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8DAA8D,CAAC;AAI7G,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;AAmDD,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;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,wBAAwB,GAC7B,qBAAqB,CA0DvB"}

package/dist/hooks/execution-journal.js

@@ -0,0 +1,102 @@
+import { ExecutionEntryId as ExecutionEntryIdClass } from "../domain/context-memory/value-objects.js";
+import { WorkspaceId } from "../domain/shared/value-objects.js";
+/** 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;
+    }
+}
+/**
+ * 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

@@ -17,6 +17,8 @@ export interface FirstRunGuideState {
     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.

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

@@ -1 +1 @@
-{"version":3,"file":"first-run-guide.d.ts","sourceRoot":"","sources":["../../src/hooks/first-run-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;CACnB;AA4BD;;;;;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,CAejB"}
+{"version":3,"file":"first-run-guide.d.ts","sourceRoot":"","sources":["../../src/hooks/first-run-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,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

@@ -22,11 +22,44 @@ This project was just bootstrapped by JARVIS. The following steps are critical f
 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
-5. Load the jarvis-onboarding skill for a complete orientation
 
 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.`;
+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 (31): 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 (11): vault-manage (smart facade), vault-doc-create, vault-doc-search...
+- Data (3): data-yaml-get, data-json-get, data-csv-query
+- Bootstrap (3): jarvis-bootstrap, jarvis-healthcheck, jarvis-terminal-commands
+- Token Metrics (7): metrics-summary, metrics-agent-report, metrics-card-report...
+- Agent (8): agent-sessions, agent-send, agent-spawn, agent-dispatch...
+- Pipeline (10): pipeline-init, pipeline-run, pipeline-status...
+- Environment (6): env-create, env-status, env-merge, env-delete...
+
+### 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:
@@ -34,6 +67,11 @@ The RAG semantic search index has 0 documents. The agent should suggest 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.
@@ -53,6 +91,10 @@ export function createFirstRunGuideHook(state) {
         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

@@ -1 +1 @@
-{"version":3,"file":"first-run-guide.js","sourceRoot":"","sources":["../../src/hooks/first-run-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,iFAAiF;AASjF,iFAAiF;AAEjF,MAAM,kBAAkB,GAAG;;;;;;;;;;;;wJAY6H,CAAC;AAEzJ,MAAM,kBAAkB,GAAG;;;;;;oEAMyC,CAAC;AAErE,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;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"first-run-guide.js","sourceRoot":"","sources":["../../src/hooks/first-run-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,iFAAiF;AAWjF,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/slash-commands.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Slash Commands Hook
+ *
+ * Intercepts custom slash commands (/healthcheck, /sync-azure, /start-card)
+ * 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.
+ * 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;AAWH,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;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;CACxD;AAwGD;;;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"}