@mc1global/opencode-jarvis 0.13.1 → 0.14.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/domain/context-memory/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AAShD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,QAAQ,CAAqB;IAErC,OAAO;IAWP,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,IAAI,UAAU,IAAI,SAAS,GAAG,SAAS,CAEtC;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,WAAW,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO;IAmBX,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAIjD,SAAS,IAAI,IAAI;IAIjB,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAM9B,MAAM,IAAI,IAAI;IAKd,IAAI,QAAQ,IAAI,OAAO,CAItB;IAED,OAAO,CAAC,YAAY;CASrB"}

package/dist/domain/context-memory/session.js

@@ -0,0 +1,81 @@
+import { WorkspaceId, Timestamp } from "../shared/value-objects.js";
+import { SessionId, SessionState } from "./value-objects.js";
+export { SessionId, SessionState, WorkspaceId };
+const SESSION_TRANSITIONS = {
+    [SessionState.Planning]: [SessionState.Wip, SessionState.Cancelled],
+    [SessionState.Wip]: [SessionState.Completed, SessionState.Cancelled],
+    [SessionState.Completed]: [],
+    [SessionState.Cancelled]: [],
+};
+export class Session {
+    id;
+    workspace;
+    purpose;
+    agentName;
+    startedAt;
+    _state;
+    _finishedAt;
+    _summary;
+    constructor(props) {
+        this.id = props.id;
+        this.workspace = props.workspace;
+        this.purpose = props.purpose;
+        this._state = props.state;
+        this.agentName = props.agentName;
+        this.startedAt = props.startedAt;
+        this._finishedAt = props.finishedAt;
+        this._summary = props.summary;
+    }
+    get state() {
+        return this._state;
+    }
+    get finishedAt() {
+        return this._finishedAt;
+    }
+    get summary() {
+        return this._summary;
+    }
+    static create(params) {
+        const trimmed = params.purpose.trim();
+        if (trimmed.length === 0) {
+            throw new Error("Session: purpose cannot be empty");
+        }
+        const now = Timestamp.now();
+        return new Session({
+            id: SessionId.create(params.workspace.value, now),
+            workspace: params.workspace,
+            purpose: trimmed,
+            state: SessionState.Planning,
+            ...(params.agentName !== undefined
+                ? { agentName: params.agentName }
+                : {}),
+            startedAt: now,
+        });
+    }
+    static reconstitute(props) {
+        return new Session(props);
+    }
+    beginWork() {
+        this.transitionTo(SessionState.Wip);
+    }
+    finish(summary) {
+        this.transitionTo(SessionState.Completed);
+        this._finishedAt = Timestamp.now();
+        this._summary = summary;
+    }
+    cancel() {
+        this.transitionTo(SessionState.Cancelled);
+        this._finishedAt = Timestamp.now();
+    }
+    get isActive() {
+        return (this._state === SessionState.Planning || this._state === SessionState.Wip);
+    }
+    transitionTo(newState) {
+        const allowed = SESSION_TRANSITIONS[this._state];
+        if (!allowed.includes(newState)) {
+            throw new Error(`Session: invalid transition from "${this._state}" to "${newState}"`);
+        }
+        this._state = newState;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/domain/context-memory/session.js.map

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

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

@@ -0,0 +1,46 @@
+import { WorkspaceId, Timestamp } from "../shared/value-objects.js";
+import { TodoId, SessionId, TodoStatus } from "./value-objects.js";
+export { TodoId, TodoStatus };
+export interface TodoProps {
+    readonly id: TodoId;
+    readonly content: string;
+    readonly status: TodoStatus;
+    readonly priority: number;
+    readonly workspace: WorkspaceId;
+    readonly sessionId?: SessionId;
+    readonly tags: readonly string[];
+    readonly createdAt: Timestamp;
+    readonly updatedAt?: Timestamp;
+    readonly completedAt?: Timestamp;
+}
+export declare class Todo {
+    readonly id: TodoId;
+    readonly content: string;
+    readonly workspace: WorkspaceId;
+    readonly sessionId: SessionId | undefined;
+    readonly tags: readonly string[];
+    readonly createdAt: Timestamp;
+    private _status;
+    private _priority;
+    private _updatedAt;
+    private _completedAt;
+    private constructor();
+    get status(): TodoStatus;
+    get priority(): number;
+    get updatedAt(): Timestamp | undefined;
+    get completedAt(): Timestamp | undefined;
+    static create(params: {
+        content: string;
+        priority?: number;
+        workspace: WorkspaceId;
+        sessionId?: SessionId;
+        tags?: readonly string[];
+    }): Todo;
+    static reconstitute(props: TodoProps): Todo;
+    start(): void;
+    complete(): void;
+    cancel(): void;
+    reopen(): void;
+    private transitionTo;
+}
+//# sourceMappingURL=todo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../../src/domain/context-memory/todo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACL,MAAM,EACN,SAAS,EACT,UAAU,EAIX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAa9B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;CAClC;AAED,qBAAa,IAAI;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,YAAY,CAAwB;IAE5C,OAAO;IAaP,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,SAAS,IAAI,SAAS,GAAG,SAAS,CAErC;IAED,IAAI,WAAW,IAAI,SAAS,GAAG,SAAS,CAEvC;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,WAAW,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KAC1B,GAAG,IAAI;IAyBR,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI3C,KAAK,IAAI,IAAI;IAIb,QAAQ,IAAI,IAAI;IAKhB,MAAM,IAAI,IAAI;IAId,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,YAAY;CAUrB"}

package/dist/domain/context-memory/todo.js

@@ -0,0 +1,96 @@
+import { Timestamp } from "../shared/value-objects.js";
+import { TodoId, TodoStatus, isValidPriority, MIN_PRIORITY, MAX_PRIORITY, } from "./value-objects.js";
+export { TodoId, TodoStatus };
+const TODO_TRANSITIONS = {
+    [TodoStatus.Pending]: [TodoStatus.InProgress, TodoStatus.Cancelled],
+    [TodoStatus.InProgress]: [
+        TodoStatus.Completed,
+        TodoStatus.Cancelled,
+        TodoStatus.Pending,
+    ],
+    [TodoStatus.Completed]: [],
+    [TodoStatus.Cancelled]: [],
+};
+export class Todo {
+    id;
+    content;
+    workspace;
+    sessionId;
+    tags;
+    createdAt;
+    _status;
+    _priority;
+    _updatedAt;
+    _completedAt;
+    constructor(props) {
+        this.id = props.id;
+        this.content = props.content;
+        this._status = props.status;
+        this._priority = props.priority;
+        this.workspace = props.workspace;
+        this.sessionId = props.sessionId;
+        this.tags = props.tags;
+        this.createdAt = props.createdAt;
+        this._updatedAt = props.updatedAt;
+        this._completedAt = props.completedAt;
+    }
+    get status() {
+        return this._status;
+    }
+    get priority() {
+        return this._priority;
+    }
+    get updatedAt() {
+        return this._updatedAt;
+    }
+    get completedAt() {
+        return this._completedAt;
+    }
+    static create(params) {
+        const trimmed = params.content.trim();
+        if (trimmed.length === 0) {
+            throw new Error("Todo: content cannot be empty");
+        }
+        const priority = params.priority ?? 3;
+        if (!isValidPriority(priority)) {
+            throw new Error(`Todo: priority must be ${MIN_PRIORITY}-${MAX_PRIORITY}`);
+        }
+        return new Todo({
+            id: TodoId.create(),
+            content: trimmed,
+            status: TodoStatus.Pending,
+            priority,
+            workspace: params.workspace,
+            ...(params.sessionId !== undefined
+                ? { sessionId: params.sessionId }
+                : {}),
+            tags: params.tags ?? [],
+            createdAt: Timestamp.now(),
+        });
+    }
+    static reconstitute(props) {
+        return new Todo(props);
+    }
+    start() {
+        this.transitionTo(TodoStatus.InProgress);
+    }
+    complete() {
+        this.transitionTo(TodoStatus.Completed);
+        this._completedAt = Timestamp.now();
+    }
+    cancel() {
+        this.transitionTo(TodoStatus.Cancelled);
+    }
+    reopen() {
+        this.transitionTo(TodoStatus.Pending);
+    }
+    transitionTo(newStatus) {
+        const allowed = TODO_TRANSITIONS[this._status];
+        if (!allowed.includes(newStatus)) {
+            throw new Error(`Todo: invalid transition from "${this._status}" to "${newStatus}"`);
+        }
+        this._status = newStatus;
+        this._updatedAt = Timestamp.now();
+    }
+}
+//# sourceMappingURL=todo.js.map

package/dist/domain/context-memory/todo.js.map

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

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

@@ -0,0 +1,82 @@
+/**
+ * Context Memory Value Objects
+ *
+ * Identity types for Session, Todo, Note, and ExecutionEntry entities.
+ * All are immutable, compared by value.
+ *
+ * DDD: Value Objects - no identity lifecycle, equality by value
+ * SOLID: SRP - each class handles one identity type
+ */
+import { EntityId, Timestamp } from "../shared/value-objects.js";
+/** Session lifecycle states. */
+export declare enum SessionState {
+    Planning = "planning",
+    Wip = "wip",
+    Completed = "completed",
+    Cancelled = "cancelled"
+}
+/** Todo status progression. */
+export declare enum TodoStatus {
+    Pending = "pending",
+    InProgress = "in_progress",
+    Completed = "completed",
+    Cancelled = "cancelled"
+}
+/** Note categorization types. */
+export declare enum NoteType {
+    Note = "note",
+    Decision = "decision",
+    Discovery = "discovery",
+    Blocker = "blocker"
+}
+/**
+ * Session identifier.
+ * Format: {WORKSPACE}--{YYYYMMDD_HHMMSS}
+ * Encodes workspace and creation time for human readability and sorting.
+ */
+export declare class SessionId extends EntityId {
+    private constructor();
+    static create(workspaceName: string, timestamp: Timestamp): SessionId;
+    static from(value: string): SessionId;
+    get workspace(): string;
+    get timestamp(): string;
+}
+/**
+ * Todo identifier. UUID v4 format.
+ */
+export declare class TodoId extends EntityId {
+    private constructor();
+    static create(): TodoId;
+    static from(value: string): TodoId;
+}
+/**
+ * Note identifier. Auto-increment integer (assigned by persistence).
+ */
+export declare class NoteId extends EntityId {
+    private constructor();
+    static create(id: number): NoteId;
+    static from(value: string): NoteId;
+    get numericValue(): number;
+}
+/** Priority range: 1 (critical) to 5 (trivial). */
+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

@@ -0,0 +1 @@
+{"version":3,"file":"value-objects.d.ts","sourceRoot":"","sources":["../../../src/domain/context-memory/value-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,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

@@ -0,0 +1,143 @@
+/**
+ * Context Memory Value Objects
+ *
+ * Identity types for Session, Todo, Note, and ExecutionEntry entities.
+ * All are immutable, compared by value.
+ *
+ * DDD: Value Objects - no identity lifecycle, equality by value
+ * SOLID: SRP - each class handles one identity type
+ */
+import { EntityId } from "../shared/value-objects.js";
+/** Session lifecycle states. */
+export var SessionState;
+(function (SessionState) {
+    SessionState["Planning"] = "planning";
+    SessionState["Wip"] = "wip";
+    SessionState["Completed"] = "completed";
+    SessionState["Cancelled"] = "cancelled";
+})(SessionState || (SessionState = {}));
+/** Todo status progression. */
+export var TodoStatus;
+(function (TodoStatus) {
+    TodoStatus["Pending"] = "pending";
+    TodoStatus["InProgress"] = "in_progress";
+    TodoStatus["Completed"] = "completed";
+    TodoStatus["Cancelled"] = "cancelled";
+})(TodoStatus || (TodoStatus = {}));
+/** Note categorization types. */
+export var NoteType;
+(function (NoteType) {
+    NoteType["Note"] = "note";
+    NoteType["Decision"] = "decision";
+    NoteType["Discovery"] = "discovery";
+    NoteType["Blocker"] = "blocker";
+})(NoteType || (NoteType = {}));
+/**
+ * Session identifier.
+ * Format: {WORKSPACE}--{YYYYMMDD_HHMMSS}
+ * Encodes workspace and creation time for human readability and sorting.
+ */
+export class SessionId extends EntityId {
+    constructor(value) {
+        super(value);
+    }
+    static create(workspaceName, timestamp) {
+        const ws = workspaceName.trim().toUpperCase();
+        if (ws.length === 0) {
+            throw new Error("SessionId: workspace name cannot be empty");
+        }
+        return new SessionId(`${ws}--${timestamp.toCompactString()}`);
+    }
+    static from(value) {
+        return new SessionId(value);
+    }
+    get workspace() {
+        const parts = this.value.split("--");
+        return parts[0] ?? this.value;
+    }
+    get timestamp() {
+        const parts = this.value.split("--");
+        return parts[1] ?? "";
+    }
+}
+/**
+ * Todo identifier. UUID v4 format.
+ */
+export class TodoId extends EntityId {
+    constructor(value) {
+        super(value);
+    }
+    static create() {
+        return new TodoId(crypto.randomUUID());
+    }
+    static from(value) {
+        return new TodoId(value);
+    }
+}
+/**
+ * Note identifier. Auto-increment integer (assigned by persistence).
+ */
+export class NoteId extends EntityId {
+    constructor(value) {
+        super(value);
+    }
+    static create(id) {
+        if (id <= 0) {
+            throw new Error("NoteId: must be a positive integer");
+        }
+        return new NoteId(String(id));
+    }
+    static from(value) {
+        return new NoteId(value);
+    }
+    get numericValue() {
+        return Number(this.value);
+    }
+}
+/** Priority range: 1 (critical) to 5 (trivial). */
+export const MIN_PRIORITY = 1;
+export const MAX_PRIORITY = 5;
+export function isValidPriority(priority) {
+    return (Number.isInteger(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

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

package/dist/domain/data/ports.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Data Domain — Ports
+ *
+ * Abstractions for structured data file I/O (YAML, JSON, CSV).
+ * Infrastructure implements; application and tools consume.
+ *
+ * DDD: Port interfaces defined in domain layer
+ * SOLID: DIP — callers depend on abstractions, not fs/js-yaml
+ */
+/** Read the raw text content of a file. Returns null if the file does not exist. */
+export interface DataFileReader {
+    readText(absolutePath: string): string | null;
+}
+/** Write raw text to a file, creating parent directories as needed. */
+export interface DataFileWriter {
+    writeText(absolutePath: string, content: string): void;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/domain/data/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/domain/data/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD"}

package/dist/domain/data/ports.js

@@ -0,0 +1,11 @@
+/**
+ * Data Domain — Ports
+ *
+ * Abstractions for structured data file I/O (YAML, JSON, CSV).
+ * Infrastructure implements; application and tools consume.
+ *
+ * DDD: Port interfaces defined in domain layer
+ * SOLID: DIP — callers depend on abstractions, not fs/js-yaml
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/domain/data/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/domain/data/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/domain/domain-map/ports.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Domain Map — Port Interfaces
+ *
+ * Hexagonal architecture ports for the Domain Map bounded context.
+ * Domain defines WHAT operations are needed; infrastructure implements HOW.
+ *
+ * SOLID: DIP — application layer depends on these abstractions, not infra classes
+ * SOLID: ISP — separate port interfaces per capability
+ * DDD: Port/Adapter — domain-layer contracts with zero external dependencies
+ */
+import type { AnalysisConfig, CodeSymbol, LanguageId, ProjectScanResult, SemanticAnalysis, StructuralGraph } from "./value-objects.js";
+/**
+ * A representative code sample from a scanned file.
+ * Used as input to LLM semantic analysis.
+ */
+export interface CodeSample {
+    readonly filePath: string;
+    readonly content: string;
+    readonly lineCount: number;
+}
+/**
+ * Port interface for scanning a project directory.
+ *
+ * Discovers source files, detects language distribution, and computes
+ * structural indicators needed for mode detection and domain analysis.
+ *
+ * Infrastructure implements using Node.js fs operations.
+ */
+export interface ProjectScannerPort {
+    /**
+     * Recursively scan a directory and return a structured scan result.
+     * Respects skip directories/extensions and the maxFiles config limit.
+     */
+    scanProject(directory: string, config: AnalysisConfig): Promise<ProjectScanResult>;
+    /**
+     * Read the full text content of a source file.
+     * Returns null if the file cannot be read (permission error, binary, etc.).
+     */
+    readFile(absolutePath: string): Promise<string | null>;
+}
+/**
+ * Port interface for Language Server Protocol operations.
+ *
+ * Provides structural code analysis via LSP: symbol extraction and
+ * cross-file reference resolution. Used in legacy analysis (Path B).
+ *
+ * Infrastructure spawns the appropriate LSP server binary and maps
+ * LSP protocol responses to domain value objects.
+ */
+export interface LspClientPort {
+    /**
+     * Check whether an LSP server is available for the given language.
+     * Returns false if the server binary is not installed.
+     */
+    isAvailable(language: LanguageId): Promise<boolean>;
+    /**
+     * Initialize the LSP server for a project root.
+     * Must be called before documentSymbols/references.
+     */
+    initialize(rootUri: string, language: LanguageId): Promise<void>;
+    /**
+     * Extract symbols (classes, functions, interfaces, etc.) from a file.
+     * Returns an empty array if the file has no symbols or LSP fails.
+     */
+    documentSymbols(fileUri: string): Promise<readonly CodeSymbol[]>;
+    /**
+     * Shut down the LSP server and release resources.
+     * Must be called after analysis is complete (even on error).
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Optional model preference for LLM calls.
+ * When provided, overrides the default model configured in the plugin.
+ */
+export interface ModelPreference {
+    readonly providerID: string;
+    readonly modelID: string;
+}
+/**
+ * Port interface for LLM-based semantic analysis.
+ *
+ * Sends a structural graph and code samples to an LLM and receives
+ * a proposed DDD decomposition (bounded contexts + recommendations).
+ *
+ * Infrastructure builds the prompt, invokes the LLM provider, and
+ * parses the structured JSON response.
+ */
+export interface LlmAnalysisPort {
+    /**
+     * Analyze the structural graph and code samples using an LLM.
+     * Returns a semantic analysis with bounded contexts and recommendations.
+     * May use modelPreference to override the default LLM provider/model.
+     */
+    analyzeStructure(graph: StructuralGraph, codeSamples: readonly CodeSample[], modelPreference?: ModelPreference): Promise<SemanticAnalysis>;
+}
+/**
+ * Constructor dependencies for DomainMapUseCases.
+ * Injected at composition root.
+ */
+export interface DomainMapDeps {
+    readonly lspClient: LspClientPort;
+    readonly llmAnalyzer: LlmAnalysisPort;
+    readonly projectScanner: ProjectScannerPort;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/domain/domain-map/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/domain/domain-map/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAI5B;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEnF;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACxD;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpD;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IAEjE;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAID;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,gBAAgB,CACd,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAID;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;CAC7C"}

package/dist/domain/domain-map/ports.js

@@ -0,0 +1,12 @@
+/**
+ * Domain Map — Port Interfaces
+ *
+ * Hexagonal architecture ports for the Domain Map bounded context.
+ * Domain defines WHAT operations are needed; infrastructure implements HOW.
+ *
+ * SOLID: DIP — application layer depends on these abstractions, not infra classes
+ * SOLID: ISP — separate port interfaces per capability
+ * DDD: Port/Adapter — domain-layer contracts with zero external dependencies
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/domain/domain-map/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/domain/domain-map/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}