@mc1global/opencode-jarvis 0.13.1 → 0.14.0

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

@@ -0,0 +1,312 @@
+/**
+ * Pipeline Domain — Value Objects
+ *
+ * Identifiers, enums, and constrained types for the pipeline bounded context.
+ * All value objects are immutable with value-based equality.
+ *
+ * SOLID: SRP — each type models a single domain concept
+ * DDD: Value Objects compared by value, no identity of their own
+ */
+import { EntityId } from "../shared/value-objects.js";
+// ─── Identifiers ──────────────────────────────────────────────────────────────
+/** Pipeline aggregate root identifier (format: PL-NNN). */
+export class PipelineId extends EntityId {
+    constructor(value) {
+        super(value);
+    }
+    static create(sequence) {
+        if (!Number.isInteger(sequence) || sequence < 1) {
+            throw new Error("PipelineId: sequence must be a positive integer");
+        }
+        return new PipelineId(`PL-${String(sequence).padStart(3, "0")}`);
+    }
+    static from(value) {
+        return new PipelineId(value);
+    }
+    get sequence() {
+        const parts = this.value.split("-");
+        return parseInt(parts[1] ?? "0", 10);
+    }
+}
+/** Gate child entity identifier (format: GT-NNN). */
+export class GateId extends EntityId {
+    constructor(value) {
+        super(value);
+    }
+    static create(sequence) {
+        if (!Number.isInteger(sequence) || sequence < 1) {
+            throw new Error("GateId: sequence must be a positive integer");
+        }
+        return new GateId(`GT-${String(sequence).padStart(3, "0")}`);
+    }
+    static from(value) {
+        return new GateId(value);
+    }
+    get sequence() {
+        const parts = this.value.split("-");
+        return parseInt(parts[1] ?? "0", 10);
+    }
+}
+// ─── Gate Type ────────────────────────────────────────────────────────────────
+/** Ordered gate types representing pipeline stages. */
+export const GATE_TYPES = [
+    "analyze",
+    "lint",
+    "test",
+    "build",
+    "tag",
+    "publish",
+    "deploy",
+];
+/** Gate types included in branch (CI) pipelines. */
+export const BRANCH_GATE_TYPES = [
+    "analyze",
+    "lint",
+    "test",
+    "build",
+];
+/** Gate types included in release (CD) pipelines. */
+export const RELEASE_GATE_TYPES = [...GATE_TYPES];
+/**
+ * Returns the ordinal position of a gate type.
+ * Used to enforce sequential gate progression.
+ */
+export function gateTypeOrder(type) {
+    return GATE_TYPES.indexOf(type);
+}
+export function isValidGateType(value) {
+    return GATE_TYPES.includes(value);
+}
+// ─── Gate Status ──────────────────────────────────────────────────────────────
+export const GATE_STATUSES = [
+    "pending",
+    "running",
+    "passed",
+    "failed",
+    "skipped",
+];
+/** Valid gate status transitions. */
+export const GATE_TRANSITIONS = {
+    pending: ["running", "skipped"],
+    running: ["passed", "failed"],
+    passed: [],
+    failed: ["pending"], // retry: failed -> pending
+    skipped: [],
+};
+export function isTerminalGateStatus(status) {
+    return status === "passed" || status === "failed" || status === "skipped";
+}
+export function isSuccessGateStatus(status) {
+    return status === "passed" || status === "skipped";
+}
+// ─── Pipeline Status ──────────────────────────────────────────────────────────
+export const PIPELINE_STATUSES = [
+    "draft",
+    "active",
+    "completed",
+    "failed",
+    "cancelled",
+];
+/** Valid pipeline status transitions. */
+export const PIPELINE_TRANSITIONS = {
+    draft: ["active", "cancelled"],
+    active: ["completed", "failed", "cancelled"],
+    completed: [],
+    failed: ["active"], // retry: failed -> active
+    cancelled: [],
+};
+export function isTerminalPipelineStatus(status) {
+    return (status === "completed" || status === "failed" || status === "cancelled");
+}
+// ─── Pipeline Scope ───────────────────────────────────────────────────────────
+export const PIPELINE_SCOPES = ["branch", "release"];
+export function isValidPipelineScope(value) {
+    return PIPELINE_SCOPES.includes(value);
+}
+// ─── Skip Policy ──────────────────────────────────────────────────────────────
+export const SKIP_POLICIES = [
+    "blocked",
+    "justification",
+    "approval_required",
+];
+export function isValidSkipPolicy(value) {
+    return SKIP_POLICIES.includes(value);
+}
+// ─── Stack Template ───────────────────────────────────────────────────────────
+export const STACK_TEMPLATES = [
+    "typescript-lib",
+    "typescript-app",
+    "python-lib",
+    "python-app",
+    "swift-ios",
+    "csharp-app",
+    "kotlin-android",
+    "generic",
+];
+export function isValidStackTemplate(value) {
+    return STACK_TEMPLATES.includes(value);
+}
+// ─── Dagger Function Reference ────────────────────────────────────────────────
+/**
+ * A validated reference to a Dagger function.
+ * Format: lowercase letters, digits, hyphens (e.g., "lint", "run-tests", "build-image").
+ */
+export class DaggerFunctionRef {
+    value;
+    static PATTERN = /^[a-z][a-z0-9-]*$/;
+    static MAX_LENGTH = 100;
+    constructor(value) {
+        this.value = value;
+    }
+    static create(ref) {
+        const trimmed = ref.trim();
+        if (trimmed.length === 0) {
+            throw new Error("DaggerFunctionRef: value cannot be empty");
+        }
+        if (trimmed.length > DaggerFunctionRef.MAX_LENGTH) {
+            throw new Error(`DaggerFunctionRef: value exceeds ${DaggerFunctionRef.MAX_LENGTH} characters`);
+        }
+        if (!DaggerFunctionRef.PATTERN.test(trimmed)) {
+            throw new Error(`DaggerFunctionRef: invalid format "${trimmed}" — must be lowercase alphanumeric with hyphens`);
+        }
+        return new DaggerFunctionRef(trimmed);
+    }
+    static from(value) {
+        return new DaggerFunctionRef(value);
+    }
+    equals(other) {
+        return this.value === other.value;
+    }
+    toString() {
+        return this.value;
+    }
+}
+// ─── Semantic Version ─────────────────────────────────────────────────────────
+/**
+ * Semantic version value object (major.minor.patch).
+ * Immutable, validated, with comparison support.
+ */
+export class SemanticVersion {
+    major;
+    minor;
+    patch;
+    static PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
+    constructor(major, minor, patch) {
+        this.major = major;
+        this.minor = minor;
+        this.patch = patch;
+    }
+    static create(major, minor, patch) {
+        if (!Number.isInteger(major) ||
+            !Number.isInteger(minor) ||
+            !Number.isInteger(patch)) {
+            throw new Error("SemanticVersion: all components must be integers");
+        }
+        if (major < 0 || minor < 0 || patch < 0) {
+            throw new Error("SemanticVersion: all components must be non-negative");
+        }
+        return new SemanticVersion(major, minor, patch);
+    }
+    static parse(version) {
+        const trimmed = version.trim();
+        const match = SemanticVersion.PATTERN.exec(trimmed);
+        if (!match) {
+            throw new Error(`SemanticVersion: invalid format "${trimmed}" — expected major.minor.patch`);
+        }
+        const majorStr = match[1];
+        const minorStr = match[2];
+        const patchStr = match[3];
+        if (!majorStr || !minorStr || !patchStr) {
+            throw new Error(`SemanticVersion: failed to parse "${trimmed}"`);
+        }
+        return new SemanticVersion(parseInt(majorStr, 10), parseInt(minorStr, 10), parseInt(patchStr, 10));
+    }
+    static from(value) {
+        return SemanticVersion.parse(value);
+    }
+    /** Compare: returns -1, 0, or 1. */
+    compareTo(other) {
+        if (this.major !== other.major)
+            return this.major > other.major ? 1 : -1;
+        if (this.minor !== other.minor)
+            return this.minor > other.minor ? 1 : -1;
+        if (this.patch !== other.patch)
+            return this.patch > other.patch ? 1 : -1;
+        return 0;
+    }
+    isGreaterThan(other) {
+        return this.compareTo(other) > 0;
+    }
+    equals(other) {
+        return this.compareTo(other) === 0;
+    }
+    bumpMajor() {
+        return new SemanticVersion(this.major + 1, 0, 0);
+    }
+    bumpMinor() {
+        return new SemanticVersion(this.major, this.minor + 1, 0);
+    }
+    bumpPatch() {
+        return new SemanticVersion(this.major, this.minor, this.patch + 1);
+    }
+    toString() {
+        return `${this.major}.${this.minor}.${this.patch}`;
+    }
+}
+// ─── Gate Output ──────────────────────────────────────────────────────────────
+/**
+ * Bounded-length execution output from a gate run.
+ * Truncates to max length to prevent unbounded storage.
+ */
+export class GateOutput {
+    value;
+    static MAX_LENGTH = 10_000;
+    constructor(value) {
+        this.value = value;
+    }
+    static create(output) {
+        if (output.length > GateOutput.MAX_LENGTH) {
+            const truncated = output.substring(0, GateOutput.MAX_LENGTH) + "\n... [truncated]";
+            return new GateOutput(truncated);
+        }
+        return new GateOutput(output);
+    }
+    static from(value) {
+        return new GateOutput(value);
+    }
+    equals(other) {
+        return this.value === other.value;
+    }
+    toString() {
+        return this.value;
+    }
+}
+// ─── Default Skip Policies per Gate Type ──────────────────────────────────────
+/**
+ * Default skip policies for each gate type.
+ * Can be overridden per pipeline template.
+ */
+export const DEFAULT_SKIP_POLICIES = {
+    analyze: "justification",
+    lint: "justification",
+    test: "blocked",
+    build: "blocked",
+    tag: "approval_required",
+    publish: "approval_required",
+    deploy: "approval_required",
+};
+// ─── Default Dagger Functions per Gate Type ───────────────────────────────────
+/**
+ * Default Dagger function names for each gate type.
+ * Infrastructure maps these to actual Dagger module functions.
+ */
+export const DEFAULT_DAGGER_FUNCTIONS = {
+    analyze: "analyze",
+    lint: "lint",
+    test: "test",
+    build: "build",
+    tag: "tag",
+    publish: "publish",
+    deploy: "deploy",
+};
+//# sourceMappingURL=value-objects.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"value-objects.js","sourceRoot":"","sources":["../../../src/domain/pipeline/value-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,iFAAiF;AAEjF,2DAA2D;AAC3D,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,YAAoB,KAAa;QAC/B,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,QAAgB;QAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,QAAQ;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,OAAO,MAAO,SAAQ,QAAQ;IAClC,YAAoB,KAAa;QAC/B,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,QAAgB;QAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,QAAQ;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;CACF;AAED,iFAAiF;AAEjF,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,SAAS;IACT,QAAQ;CACA,CAAC;AAIX,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAwB;IACpD,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;CACR,CAAC;AAEF,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAwB,CAAC,GAAG,UAAU,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAiB,CAAC,CAAC;AAChD,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS;IACT,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;CACD,CAAC;AAIX,qCAAqC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAA8C;IACzE,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;IAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC7B,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,2BAA2B;IAChD,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,CAAC;AACrD,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC;AAIX,yCAAyC;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAG7B;IACF,KAAK,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC9B,MAAM,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC5C,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,0BAA0B;IAC9C,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAAsB;IAC7D,OAAO,CACL,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CACxE,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AAI9D,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAsB,CAAC,CAAC;AAC1D,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS;IACT,eAAe;IACf,mBAAmB;CACX,CAAC;AAIX,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,aAAa,CAAC,QAAQ,CAAC,KAAmB,CAAC,CAAC;AACrD,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,gBAAgB;IAChB,SAAS;CACD,CAAC;AAIX,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAsB,CAAC,CAAC;AAC1D,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACnB,KAAK,CAAS;IACf,MAAM,CAAU,OAAO,GAAG,mBAAmB,CAAC;IAC9C,MAAM,CAAU,UAAU,GAAG,GAAG,CAAC;IAEzC,YAAoB,KAAa;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,iBAAiB,CAAC,UAAU,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,oCAAoC,iBAAiB,CAAC,UAAU,aAAa,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CACb,sCAAsC,OAAO,iDAAiD,CAC/F,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,KAAwB;QAC7B,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;;AAGH,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,OAAO,eAAe;IACjB,KAAK,CAAS;IACd,KAAK,CAAS;IACd,KAAK,CAAS;IACf,MAAM,CAAU,OAAO,GAAG,uBAAuB,CAAC;IAE1D,YAAoB,KAAa,EAAE,KAAa,EAAE,KAAa;QAC7D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,MAAM,CACX,KAAa,EACb,KAAa,EACb,KAAa;QAEb,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;YACxB,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;YACxB,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EACxB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,sDAAsD,CACvD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAe;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,oCAAoC,OAAO,gCAAgC,CAC5E,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,eAAe,CACxB,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,EACtB,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,EACtB,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CACvB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,oCAAoC;IACpC,SAAS,CAAC,KAAsB;QAC9B,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC5B,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC5B,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC5B,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,aAAa,CAAC,KAAsB;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,KAAsB;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,SAAS;QACP,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS;QACP,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;IACrD,CAAC;;AAGH,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,OAAO,UAAU;IACZ,KAAK,CAAS;IACvB,MAAM,CAAU,UAAU,GAAG,MAAM,CAAC;IAEpC,YAAoB,KAAa;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAAc;QAC1B,IAAI,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,SAAS,GACb,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,mBAAmB,CAAC;YACnE,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,KAAiB;QACtB,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;;AAGH,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiC;IACjE,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,mBAAmB;IACxB,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,mBAAmB;CAC5B,CAAC;AAEF,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA6B;IAChE,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACjB,CAAC"}

package/dist/domain/rag/enum-values.d.ts

@@ -0,0 +1,19 @@
+/**
+ * RAG Enum Value Arrays
+ *
+ * Framework-agnostic string arrays for RAG domain concepts.
+ * Zero external dependencies — pure TypeScript.
+ *
+ * Usage in a Zod adapter:   z.enum(ORACLE_DOMAIN_VALUES)
+ * Usage in plain validator: ORACLE_DOMAIN_VALUES.includes(value)
+ *
+ * DDD:  Domain layer — single source of truth for RAG enum values.
+ * SOLID: OCP — new domain values propagate automatically to all consumers.
+ * SOLID: DIP — adapters depend on these constants, not on inline string literals.
+ */
+/**
+ * Valid ORACLE knowledge domains.
+ * Must match the directory structure detected by inferOracleDomain().
+ */
+export declare const ORACLE_DOMAIN_VALUES: ["governance", "workflows", "patterns", "quick_reference"];
+//# sourceMappingURL=enum-values.d.ts.map

package/dist/domain/rag/enum-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-values.d.ts","sourceRoot":"","sources":["../../../src/domain/rag/enum-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,4DAKS,CAAC"}

package/dist/domain/rag/enum-values.js

@@ -0,0 +1,24 @@
+/**
+ * RAG Enum Value Arrays
+ *
+ * Framework-agnostic string arrays for RAG domain concepts.
+ * Zero external dependencies — pure TypeScript.
+ *
+ * Usage in a Zod adapter:   z.enum(ORACLE_DOMAIN_VALUES)
+ * Usage in plain validator: ORACLE_DOMAIN_VALUES.includes(value)
+ *
+ * DDD:  Domain layer — single source of truth for RAG enum values.
+ * SOLID: OCP — new domain values propagate automatically to all consumers.
+ * SOLID: DIP — adapters depend on these constants, not on inline string literals.
+ */
+/**
+ * Valid ORACLE knowledge domains.
+ * Must match the directory structure detected by inferOracleDomain().
+ */
+export const ORACLE_DOMAIN_VALUES = [
+    "governance",
+    "workflows",
+    "patterns",
+    "quick_reference",
+];
+//# sourceMappingURL=enum-values.js.map

package/dist/domain/rag/enum-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-values.js","sourceRoot":"","sources":["../../../src/domain/rag/enum-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,YAAY;IACZ,WAAW;IACX,UAAU;IACV,iBAAiB;CACuB,CAAC"}

package/dist/domain/rag/repositories.d.ts

@@ -0,0 +1,194 @@
+/**
+ * RAG Domain — Repository Interfaces
+ *
+ * Defines the ports (interfaces) that infrastructure must implement.
+ * Domain depends on these abstractions, never on concrete implementations.
+ *
+ * SOLID: DIP — domain defines interfaces, infra implements them
+ * SOLID: ISP — separate interfaces for vector store and embeddings
+ * DDD: Repository interfaces in domain layer
+ */
+import type { ChunkMetadata, OracleChunkMetadata, SearchResult, OracleSearchResult, IndexStats, ChunkConfig, SupportedLanguage } from "./value-objects.js";
+/**
+ * Port for generating embedding vectors from text.
+ * Infrastructure implements this with Ollama, OpenAI, or any provider.
+ */
+export interface EmbeddingProvider {
+    /**
+     * Generate an embedding vector for a single text.
+     * @returns Float array representing the text in vector space.
+     */
+    embed(text: string): Promise<readonly number[]>;
+    /**
+     * Generate embedding vectors for multiple texts in a batch.
+     * More efficient than calling embed() in a loop.
+     * @returns Array of float arrays, one per input text.
+     */
+    embedBatch(texts: readonly string[]): Promise<readonly (readonly number[])[]>;
+    /** The dimensionality of the embedding vectors (e.g., 768). */
+    readonly dimensions: number;
+}
+/** Options for similarity search. */
+export interface SearchOptions {
+    readonly topK: number;
+    readonly workspace?: string;
+    readonly domainFilter?: string;
+    readonly typeFilter?: string;
+}
+/** Options for Oracle similarity search. */
+export interface OracleSearchOptions {
+    readonly topK: number;
+    readonly domainFilter?: string;
+}
+/**
+ * Port for vector storage and retrieval.
+ * Infrastructure implements this with Vectra, ChromaDB, or any store.
+ *
+ * Each workspace gets its own isolated index.
+ * The ORACLE index is a separate, shared index.
+ */
+export interface VectorRepository {
+    /** Ensure the workspace index exists, create if not. */
+    ensureIndex(workspace: string): Promise<void>;
+    /** Add document chunks to the workspace index. */
+    addChunks(workspace: string, chunks: readonly {
+        readonly vector: readonly number[];
+        readonly metadata: ChunkMetadata;
+    }[]): Promise<void>;
+    /** Delete all chunks from a specific source file. */
+    deleteBySource(workspace: string, source: string): Promise<number>;
+    /** Semantic similarity search within a workspace. */
+    search(vector: readonly number[], options: SearchOptions): Promise<readonly SearchResult[]>;
+    /** Get index statistics for a workspace. */
+    getStats(workspace: string): Promise<IndexStats>;
+    /** Clear (delete and recreate) the workspace index. */
+    clearIndex(workspace: string): Promise<void>;
+    /** Ensure the Oracle index exists, create if not. */
+    ensureOracleIndex(): Promise<void>;
+    /** Add Oracle document chunks to the shared Oracle index. */
+    addOracleChunks(chunks: readonly {
+        readonly vector: readonly number[];
+        readonly metadata: OracleChunkMetadata;
+    }[]): Promise<void>;
+    /** Semantic similarity search in the Oracle index. */
+    searchOracle(vector: readonly number[], options: OracleSearchOptions): Promise<readonly OracleSearchResult[]>;
+    /** Get Oracle index statistics. */
+    getOracleStats(): Promise<IndexStats>;
+    /** Clear the Oracle index. */
+    clearOracleIndex(): Promise<void>;
+    /** Check if Oracle index already exists and has documents. */
+    oracleIndexExists(): Promise<boolean>;
+}
+/** A single chunk produced by text splitting. */
+export interface TextChunk {
+    readonly content: string;
+    readonly index: number;
+}
+/**
+ * Port for splitting text into chunks for embedding.
+ * Infrastructure implements this with @langchain/textsplitters or custom.
+ */
+export interface TextSplitterPort {
+    /**
+     * Split text into chunks using language-aware splitting.
+     * @param text - The full text content to split
+     * @param language - Programming language for syntax-aware splitting
+     * @param config - Chunk size and overlap configuration
+     * @returns Array of text chunks with indices
+     */
+    split(text: string, language: SupportedLanguage | undefined, config: ChunkConfig): Promise<readonly TextChunk[]>;
+    /**
+     * Split markdown by headers, preserving heading context.
+     * Used for Oracle governance documentation.
+     * @param text - Markdown content
+     * @returns Chunks with header hierarchy metadata
+     */
+    splitByHeaders(text: string): readonly {
+        readonly content: string;
+        readonly header1: string;
+        readonly header2: string;
+        readonly header3: string;
+    }[];
+}
+/** A discovered file ready for indexing. */
+export interface DiscoveredFile {
+    readonly absolutePath: string;
+    readonly relativePath: string;
+    readonly extension: string;
+    readonly sizeBytes: number;
+    /** File modification time in milliseconds since epoch. */
+    readonly mtimeMs: number;
+}
+/** Result of project analysis. */
+export interface ProjectAnalysis {
+    readonly projectType: string;
+    readonly files: readonly DiscoveredFile[];
+    readonly excludedCount: number;
+    readonly totalSizeMb: number;
+}
+/**
+ * Port for discovering files to index.
+ * Infrastructure implements this with Node.js fs operations.
+ */
+export interface FileDiscoveryPort {
+    /**
+     * Analyze a directory and discover indexable files.
+     * Applies .ragignore rules, binary filtering, and skip directories.
+     * @param directory - Root directory to scan
+     * @returns Analysis with discovered files and statistics
+     */
+    discover(directory: string): Promise<ProjectAnalysis>;
+    /**
+     * Read the content of a file as UTF-8 text.
+     * @param absolutePath - Full path to the file
+     * @returns File content or null if unreadable
+     */
+    readFile(absolutePath: string): Promise<string | null>;
+    /**
+     * Create or update a .ragignore file with recommended patterns.
+     * @param directory - Target directory
+     * @param projectType - Detected project type for type-specific patterns
+     */
+    createRagignore(directory: string, projectType: string): Promise<void>;
+}
+/**
+ * A record of a previously indexed file.
+ * Persisted by the registry to track what was indexed and when.
+ */
+export interface FileIndexRecord {
+    /** Relative path of the source file (stable across re-indexing). */
+    readonly relativePath: string;
+    /** Absolute path at last index time. */
+    readonly absolutePath: string;
+    /** File modification time (ms since epoch) at last index time. */
+    readonly mtimeMs: number;
+    /** Number of chunks created for this file. */
+    readonly chunkCount: number;
+}
+/**
+ * Result of computing the delta between discovered files and indexed files.
+ */
+export interface IndexDelta {
+    /** Files not in the registry — need full indexing. */
+    readonly toAdd: readonly DiscoveredFile[];
+    /** Files in the registry but with a newer mtime — need re-indexing. */
+    readonly toUpdate: readonly DiscoveredFile[];
+    /** Relative paths in the registry but no longer on disk — need removal. */
+    readonly toRemove: readonly string[];
+    /** Files in the registry with matching mtime — skip. */
+    readonly unchanged: readonly string[];
+}
+/**
+ * Port for persisting the file index registry.
+ * Tracks which files have been indexed with their modification times.
+ * Infrastructure implements with JSON file, SQLite, or other storage.
+ */
+export interface FileIndexRegistryPort {
+    /** Load all indexed file records for a workspace. */
+    loadRecords(workspace: string): Promise<readonly FileIndexRecord[]>;
+    /** Save all indexed file records for a workspace (replaces all). */
+    saveRecords(workspace: string, records: readonly FileIndexRecord[]): Promise<void>;
+    /** Clear all records for a workspace. */
+    clearRecords(workspace: string): Promise<void>;
+}
+//# sourceMappingURL=repositories.d.ts.map

package/dist/domain/rag/repositories.d.ts.map

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

package/dist/domain/rag/repositories.js

@@ -0,0 +1,12 @@
+/**
+ * RAG Domain — Repository Interfaces
+ *
+ * Defines the ports (interfaces) that infrastructure must implement.
+ * Domain depends on these abstractions, never on concrete implementations.
+ *
+ * SOLID: DIP — domain defines interfaces, infra implements them
+ * SOLID: ISP — separate interfaces for vector store and embeddings
+ * DDD: Repository interfaces in domain layer
+ */
+export {};
+//# sourceMappingURL=repositories.js.map

package/dist/domain/rag/repositories.js.map

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

package/dist/domain/rag/services.d.ts

@@ -0,0 +1,67 @@
+/**
+ * RAG Domain — Services
+ *
+ * Stateless domain services for RAG operations.
+ * Zero external dependencies (pure domain logic).
+ *
+ * SOLID: SRP — each service has a single responsibility
+ * DDD: Domain Services — stateless operations on domain concepts
+ */
+/**
+ * A markdown section split by headers with heading context.
+ * Used for Oracle governance document chunking.
+ */
+export interface HeaderSection {
+    readonly content: string;
+    readonly header1: string;
+    readonly header2: string;
+    readonly header3: string;
+}
+/**
+ * Split markdown content by headers (H1, H2, H3), preserving
+ * heading hierarchy context for each resulting section.
+ *
+ * This replaces Python's `MarkdownHeaderTextSplitter` from LangChain.
+ * The algorithm tracks the current heading at each level and attaches
+ * the heading context to each text block found under those headings.
+ *
+ * @param markdown - Raw markdown content
+ * @returns Array of sections with heading metadata
+ */
+export declare function splitMarkdownByHeaders(markdown: string): readonly HeaderSection[];
+/**
+ * Extract a code snippet with surrounding context from a file.
+ *
+ * Given a chunk of text and the full file content, attempts to locate
+ * the chunk within the file and return it with surrounding context lines.
+ * Falls back to the raw chunk content if the chunk cannot be found.
+ *
+ * @param fileContent - Full content of the source file
+ * @param chunkContent - The matched chunk text
+ * @param contextLines - Number of lines of context to include after the match
+ * @returns Formatted snippet with line numbers
+ */
+export declare function extractSnippet(fileContent: string, chunkContent: string, contextLines: number): string;
+/**
+ * Detect the project type based on indicator files present in a directory.
+ * Returns the most specific type found (TypeScript > Node.js, etc.).
+ *
+ * @param fileNames - Set of file names present in the root directory
+ * @returns Detected project type or "Unknown"
+ */
+export declare function detectProjectType(fileNames: ReadonlySet<string>): string;
+import type { DiscoveredFile, FileIndexRecord, IndexDelta } from "./repositories.js";
+/**
+ * Compute the delta between discovered files and previously indexed files.
+ * Pure domain logic — no I/O, no side effects.
+ *
+ * @param discovered - Files found on disk by file discovery
+ * @param indexed - File records from the persistent registry
+ * @returns Delta with toAdd, toUpdate, toRemove, and unchanged lists
+ */
+export declare function computeIndexDelta(discovered: readonly DiscoveredFile[], indexed: readonly FileIndexRecord[]): IndexDelta;
+/** Universal patterns that should always be in .ragignore. */
+export declare const UNIVERSAL_RAGIGNORE: readonly string[];
+/** Per-project-type ragignore patterns. */
+export declare const PROJECT_RAGIGNORE: ReadonlyMap<string, readonly string[]>;
+//# sourceMappingURL=services.d.ts.map

package/dist/domain/rag/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/domain/rag/services.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAgDjF;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CAgCR;AAoBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAQxE;AAED,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,cAAc,EAAE,EACrC,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,UAAU,CAgCZ;AAID,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EA4BhD,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAoDnE,CAAC"}