@mc1global/opencode-jarvis 0.1.0

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

@@ -0,0 +1,215 @@
+/**
+ * Domain Map — Value Objects
+ *
+ * Immutable value objects for the Domain Map bounded context.
+ * Zero external dependencies (pure domain).
+ *
+ * Supports two analysis paths:
+ * - Path A (Greenfield): DDD+SOLID codebases, <500 line files, path-based inference
+ * - Path B (Legacy): Monolithic codebases, 2000+ line files, LSP + LLM analysis
+ *
+ * SOLID: SRP — value object definitions only
+ * DDD: Value Objects compared by value, no identity
+ */
+/** All valid language IDs as a readonly array for runtime validation. */
+export const ALL_LANGUAGE_IDS = [
+    "typescript",
+    "javascript",
+    "python",
+    "swift",
+    "java",
+    "kotlin",
+    "csharp",
+    "go",
+    "c",
+    "cpp",
+    "objectivec",
+    "dart",
+    "html",
+    "json",
+    "yaml",
+    "shell",
+    "xml",
+    "rust",
+];
+/**
+ * Map from file extension to LanguageId.
+ * Used to determine which LSP server to spawn for a given file.
+ */
+export const LANGUAGE_EXTENSIONS = new Map([
+    // TypeScript / JavaScript
+    [".ts", "typescript"],
+    [".tsx", "typescript"],
+    [".js", "javascript"],
+    [".jsx", "javascript"],
+    [".mjs", "javascript"],
+    [".cjs", "javascript"],
+    // Python
+    [".py", "python"],
+    [".pyi", "python"],
+    // Swift / SwiftUI
+    [".swift", "swift"],
+    // Java
+    [".java", "java"],
+    // Kotlin
+    [".kt", "kotlin"],
+    [".kts", "kotlin"],
+    // C#
+    [".cs", "csharp"],
+    // Go
+    [".go", "go"],
+    // C / C++ / Objective-C
+    [".c", "c"],
+    [".h", "c"],
+    [".cpp", "cpp"],
+    [".cc", "cpp"],
+    [".cxx", "cpp"],
+    [".hpp", "cpp"],
+    [".hxx", "cpp"],
+    [".m", "objectivec"],
+    [".mm", "objectivec"],
+    // Dart / Flutter
+    [".dart", "dart"],
+    // Web / Config
+    [".html", "html"],
+    [".htm", "html"],
+    [".json", "json"],
+    [".jsonc", "json"],
+    [".yaml", "yaml"],
+    [".yml", "yaml"],
+    // Shell
+    [".sh", "shell"],
+    [".bash", "shell"],
+    [".zsh", "shell"],
+    [".fish", "shell"],
+    // XML
+    [".xml", "xml"],
+    [".xsd", "xml"],
+    [".xsl", "xml"],
+    [".xslt", "xml"],
+    [".plist", "xml"],
+    [".svg", "xml"],
+    // Rust
+    [".rs", "rust"],
+]);
+/** Check if a string is a valid LanguageId. */
+export function isValidLanguageId(value) {
+    return ALL_LANGUAGE_IDS.includes(value);
+}
+/**
+ * Mapping from LSP SymbolKind numeric values to our domain SymbolKind strings.
+ * LSP spec: https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#symbolKind
+ */
+export const LSP_SYMBOL_KIND_MAP = new Map([
+    [1, "file"],
+    [2, "module"],
+    [3, "namespace"],
+    [4, "package"],
+    [5, "class"],
+    [6, "method"],
+    [7, "property"],
+    [8, "field"],
+    [9, "constructor"],
+    [10, "enum"],
+    [11, "interface"],
+    [12, "function"],
+    [13, "variable"],
+    [14, "constant"],
+    [15, "string"],
+    [16, "number"],
+    [17, "boolean"],
+    [18, "array"],
+    [19, "object"],
+    [20, "key"],
+    [21, "null"],
+    [22, "enumMember"],
+    [23, "struct"],
+    [24, "event"],
+    [25, "operator"],
+    [26, "typeParameter"],
+]);
+/** Default analysis configuration. */
+export const DEFAULT_ANALYSIS_CONFIG = {
+    maxFileLines: 500,
+    maxFiles: 200,
+    legacyThresholdLines: 2000,
+    legacyRatio: 0.1,
+};
+// ── Directories & Extensions to Skip ──────────────────────────────────
+/** Directories that should be skipped during project scanning. */
+export const SCAN_SKIP_DIRECTORIES = new Set([
+    "node_modules",
+    "__pycache__",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    "venv",
+    ".venv",
+    "target",
+    ".tox",
+    "coverage",
+    ".nyc_output",
+    ".jarvis",
+    ".obsidian",
+    "Pods",
+    ".gradle",
+    ".idea",
+    ".vs",
+    ".vscode",
+    "DerivedData",
+    ".build",
+    "Packages",
+    "vendor",
+    ".bundle",
+    "_build",
+    "deps",
+    ".dart_tool",
+    ".pub-cache",
+]);
+/** Binary/non-source extensions to skip during scanning. */
+export const SCAN_SKIP_EXTENSIONS = new Set([
+    ".pyc",
+    ".pyo",
+    ".class",
+    ".o",
+    ".so",
+    ".dylib",
+    ".exe",
+    ".bin",
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".ico",
+    ".webp",
+    ".bmp",
+    ".woff",
+    ".woff2",
+    ".ttf",
+    ".eot",
+    ".lock",
+    ".map",
+    ".zip",
+    ".tar",
+    ".gz",
+    ".rar",
+    ".7z",
+    ".mp4",
+    ".avi",
+    ".mov",
+    ".mp3",
+    ".wav",
+    ".pdf",
+    ".doc",
+    ".docx",
+    ".xls",
+    ".xlsx",
+    ".mlmodel",
+    ".mlpackage",
+    ".pb",
+    ".h5",
+    ".db",
+    ".sqlite",
+]);
+//# sourceMappingURL=value-objects.js.map

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

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

package/dist/domain/environment/entities.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Environment Management - Entities
+ *
+ * Environment is the aggregate root of the environment bounded context.
+ * It represents an isolated containerized development environment
+ * powered by container-use (git worktree + Docker container).
+ *
+ * The plugin tracks environment metadata and card linkage.
+ * The actual container lifecycle is managed by the agent via
+ * container-use MCP tools — the plugin does NOT shell out to container-use.
+ *
+ * DDD: Aggregate Root with identity (EnvironmentId)
+ * SOLID: SRP - entity state and invariants only
+ */
+import { Timestamp } from "../shared/value-objects.js";
+import type { EnvironmentId, EnvironmentName, EnvironmentStatus, EnvironmentPurpose, ContainerConfig, MergeStrategy, EnvironmentCreationData, EnvironmentData } from "./value-objects.js";
+export declare class Environment {
+    readonly id: EnvironmentId;
+    readonly name: EnvironmentName;
+    private _cardId;
+    private _purpose;
+    private _description;
+    private _status;
+    private _containerConfig;
+    private _mergeStrategy;
+    private _mergeCommitSha;
+    private _errorMessage;
+    private _metadata;
+    readonly createdAt: Timestamp;
+    private _updatedAt;
+    private constructor();
+    /**
+     * Creates a new Environment from creation data.
+     * Initial status is always "creating".
+     */
+    static create(data: EnvironmentCreationData): Environment;
+    /**
+     * Reconstitutes an Environment from persisted data.
+     * No validation — assumes data integrity from the repository.
+     */
+    static reconstitute(data: EnvironmentData): Environment;
+    get cardId(): string | undefined;
+    get purpose(): EnvironmentPurpose;
+    get description(): string;
+    get status(): EnvironmentStatus;
+    get containerConfig(): ContainerConfig;
+    get mergeStrategy(): MergeStrategy;
+    get mergeCommitSha(): string | undefined;
+    get errorMessage(): string | undefined;
+    get metadata(): Readonly<Record<string, unknown>>;
+    get updatedAt(): Timestamp;
+    /** The git branch created by container-use: cu-{name} */
+    get branchName(): string;
+    get isActive(): boolean;
+    get isTerminal(): boolean;
+    get hasCard(): boolean;
+    /**
+     * Transitions to a new status with validation.
+     * Throws if the transition is not allowed.
+     */
+    private transitionTo;
+    /** Mark environment as active (creation succeeded). */
+    markActive(): void;
+    /** Mark environment as failed (creation or operation error). */
+    markFailed(errorMessage: string): void;
+    /** Start merge process. */
+    startMerge(): void;
+    /**
+     * Mark merge as completed.
+     * @param commitSha - The merge commit SHA (optional, depends on strategy)
+     */
+    completeMerge(commitSha?: string): void;
+    /**
+     * Revert from merging back to active (e.g., merge conflict).
+     * @param reason - Why the merge was reverted
+     */
+    revertMerge(reason: string): void;
+    /** Start deletion process. */
+    startDelete(): void;
+    /** Mark environment as deleted. */
+    markDeleted(): void;
+    linkCard(cardId: string): void;
+    unlinkCard(): void;
+    updateDescription(description: string): void;
+    updatePurpose(purpose: EnvironmentPurpose): void;
+    updateMergeStrategy(strategy: MergeStrategy): void;
+    updateContainerConfig(config: ContainerConfig): void;
+    setMetadata(key: string, value: unknown): void;
+    removeMetadata(key: string): void;
+    equals(other: Environment): boolean;
+    private touch;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/domain/environment/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/domain/environment/entities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAK5B,qBAAa,WAAW;aAEJ,EAAE,EAAE,aAAa;aACjB,IAAI,EAAE,eAAe;IACrC,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,SAAS;aACD,SAAS,EAAE,SAAS;IACpC,OAAO,CAAC,UAAU;IAbpB,OAAO;IAkBP;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,uBAAuB,GAAG,WAAW;IAmBzD;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW;IAoBvD,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED,IAAI,OAAO,IAAI,kBAAkB,CAEhC;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED,IAAI,eAAe,IAAI,eAAe,CAErC;IAED,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhD;IAED,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,yDAAyD;IACzD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAID;;;OAGG;IACH,OAAO,CAAC,YAAY;IAUpB,uDAAuD;IACvD,UAAU,IAAI,IAAI;IAKlB,gEAAgE;IAChE,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAKtC,2BAA2B;IAC3B,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvC;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjC,8BAA8B;IAC9B,WAAW,IAAI,IAAI;IAInB,mCAAmC;IACnC,WAAW,IAAI,IAAI;IAMnB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ9B,UAAU,IAAI,IAAI;IAKlB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAS5C,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKhD,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAKlD,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAKpD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAK9C,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQjC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAMnC,OAAO,CAAC,KAAK;CAGd"}

package/dist/domain/environment/entities.js

@@ -0,0 +1,207 @@
+/**
+ * Environment Management - Entities
+ *
+ * Environment is the aggregate root of the environment bounded context.
+ * It represents an isolated containerized development environment
+ * powered by container-use (git worktree + Docker container).
+ *
+ * The plugin tracks environment metadata and card linkage.
+ * The actual container lifecycle is managed by the agent via
+ * container-use MCP tools — the plugin does NOT shell out to container-use.
+ *
+ * DDD: Aggregate Root with identity (EnvironmentId)
+ * SOLID: SRP - entity state and invariants only
+ */
+import { Timestamp } from "../shared/value-objects.js";
+import { isValidTransition } from "./value-objects.js";
+// ── Environment Entity ───────────────────────────────────────────────
+export class Environment {
+    id;
+    name;
+    _cardId;
+    _purpose;
+    _description;
+    _status;
+    _containerConfig;
+    _mergeStrategy;
+    _mergeCommitSha;
+    _errorMessage;
+    _metadata;
+    createdAt;
+    _updatedAt;
+    constructor(id, name, _cardId, _purpose, _description, _status, _containerConfig, _mergeStrategy, _mergeCommitSha, _errorMessage, _metadata, createdAt, _updatedAt) {
+        this.id = id;
+        this.name = name;
+        this._cardId = _cardId;
+        this._purpose = _purpose;
+        this._description = _description;
+        this._status = _status;
+        this._containerConfig = _containerConfig;
+        this._mergeStrategy = _mergeStrategy;
+        this._mergeCommitSha = _mergeCommitSha;
+        this._errorMessage = _errorMessage;
+        this._metadata = _metadata;
+        this.createdAt = createdAt;
+        this._updatedAt = _updatedAt;
+    }
+    // ── Factories ────────────────────────────────────────────────────
+    /**
+     * Creates a new Environment from creation data.
+     * Initial status is always "creating".
+     */
+    static create(data) {
+        const now = Timestamp.now();
+        return new Environment(data.id, data.name, data.cardId, data.purpose, data.description.trim(), "creating", data.containerConfig, data.mergeStrategy, undefined, undefined, {}, now, now);
+    }
+    /**
+     * Reconstitutes an Environment from persisted data.
+     * No validation — assumes data integrity from the repository.
+     */
+    static reconstitute(data) {
+        return new Environment(data.id, data.name, data.cardId, data.purpose, data.description, data.status, data.containerConfig, data.mergeStrategy, data.mergeCommitSha, data.errorMessage, data.metadata, data.createdAt, data.updatedAt);
+    }
+    // ── Getters ──────────────────────────────────────────────────────
+    get cardId() {
+        return this._cardId;
+    }
+    get purpose() {
+        return this._purpose;
+    }
+    get description() {
+        return this._description;
+    }
+    get status() {
+        return this._status;
+    }
+    get containerConfig() {
+        return this._containerConfig;
+    }
+    get mergeStrategy() {
+        return this._mergeStrategy;
+    }
+    get mergeCommitSha() {
+        return this._mergeCommitSha;
+    }
+    get errorMessage() {
+        return this._errorMessage;
+    }
+    get metadata() {
+        return this._metadata;
+    }
+    get updatedAt() {
+        return this._updatedAt;
+    }
+    /** The git branch created by container-use: cu-{name} */
+    get branchName() {
+        return this.name.toBranchName();
+    }
+    get isActive() {
+        return this._status === "active";
+    }
+    get isTerminal() {
+        return this._status === "deleted" || this._status === "merged";
+    }
+    get hasCard() {
+        return this._cardId !== undefined;
+    }
+    // ── State Transitions ────────────────────────────────────────────
+    /**
+     * Transitions to a new status with validation.
+     * Throws if the transition is not allowed.
+     */
+    transitionTo(newStatus) {
+        if (!isValidTransition(this._status, newStatus)) {
+            throw new Error(`Invalid environment transition: ${this._status} -> ${newStatus}`);
+        }
+        this._status = newStatus;
+        this.touch();
+    }
+    /** Mark environment as active (creation succeeded). */
+    markActive() {
+        this.transitionTo("active");
+        this._errorMessage = undefined;
+    }
+    /** Mark environment as failed (creation or operation error). */
+    markFailed(errorMessage) {
+        this.transitionTo("failed");
+        this._errorMessage = errorMessage.trim();
+    }
+    /** Start merge process. */
+    startMerge() {
+        this.transitionTo("merging");
+    }
+    /**
+     * Mark merge as completed.
+     * @param commitSha - The merge commit SHA (optional, depends on strategy)
+     */
+    completeMerge(commitSha) {
+        this.transitionTo("merged");
+        this._mergeCommitSha = commitSha?.trim();
+    }
+    /**
+     * Revert from merging back to active (e.g., merge conflict).
+     * @param reason - Why the merge was reverted
+     */
+    revertMerge(reason) {
+        this.transitionTo("active");
+        this._errorMessage = reason.trim();
+    }
+    /** Start deletion process. */
+    startDelete() {
+        this.transitionTo("deleting");
+    }
+    /** Mark environment as deleted. */
+    markDeleted() {
+        this.transitionTo("deleted");
+    }
+    // ── Commands (state mutations) ───────────────────────────────────
+    linkCard(cardId) {
+        if (cardId.trim().length === 0) {
+            throw new Error("Environment: cardId cannot be empty");
+        }
+        this._cardId = cardId.trim();
+        this.touch();
+    }
+    unlinkCard() {
+        this._cardId = undefined;
+        this.touch();
+    }
+    updateDescription(description) {
+        const trimmed = description.trim();
+        if (trimmed.length === 0) {
+            throw new Error("Environment: description cannot be empty");
+        }
+        this._description = trimmed;
+        this.touch();
+    }
+    updatePurpose(purpose) {
+        this._purpose = purpose;
+        this.touch();
+    }
+    updateMergeStrategy(strategy) {
+        this._mergeStrategy = strategy;
+        this.touch();
+    }
+    updateContainerConfig(config) {
+        this._containerConfig = config;
+        this.touch();
+    }
+    setMetadata(key, value) {
+        this._metadata = { ...this._metadata, [key]: value };
+        this.touch();
+    }
+    removeMetadata(key) {
+        const { [key]: _, ...rest } = this._metadata;
+        this._metadata = rest;
+        this.touch();
+    }
+    // ── Equality ─────────────────────────────────────────────────────
+    equals(other) {
+        return this.id.equals(other.id);
+    }
+    // ── Private ──────────────────────────────────────────────────────
+    touch() {
+        this._updatedAt = Timestamp.now();
+    }
+}
+//# sourceMappingURL=entities.js.map

package/dist/domain/environment/entities.js.map

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

package/dist/domain/environment/renderers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Environment Management - Renderers
+ *
+ * Pure formatting functions for environment display and MCP instruction generation.
+ * Extracted from EnvironmentDomainService to respect the 500-line file limit.
+ *
+ * These are stateless functions that take an Environment entity and produce
+ * formatted strings for tool output.
+ *
+ * SOLID: SRP - rendering/formatting only
+ */
+import type { Environment } from "./entities.js";
+/**
+ * Generates container-use MCP tool instructions for creating an environment.
+ * The agent should execute these instructions via the container-use MCP server.
+ */
+export declare function renderCreateInstructions(environment: Environment): string;
+/**
+ * Generates instructions for merging an environment back.
+ */
+export declare function renderMergeInstructions(environment: Environment): string;
+/**
+ * Renders a summary of an environment for display.
+ */
+export declare function renderEnvironmentSummary(environment: Environment): string;
+/**
+ * Renders a compact list of environments for display.
+ */
+export declare function renderEnvironmentList(environments: readonly Environment[]): string;
+//# sourceMappingURL=renderers.d.ts.map

package/dist/domain/environment/renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../src/domain/environment/renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CA0DzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CA0CxE;AAID;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CA+CzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,MAAM,CAiBR"}