@mc1global/opencode-jarvis 0.4.0 → 0.7.0

package/dist/application/bootstrap/use-cases.js

@@ -0,0 +1,355 @@
+/**
+ * Bootstrap Application — Use Cases
+ *
+ * Generates AGENTS.md with config-adaptive content and ensures
+ * the full JARVIS project structure exists (.jarvis/, config/, vault).
+ *
+ * SOLID: SRP — bootstrap orchestration only
+ * SOLID: OCP — new sections can be added without modifying existing ones
+ * SOLID: DIP — depends on ConfigService abstraction for config reading
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+// ── Vault Skeleton Folders ────────────────────────────────────────────────────
+const VAULT_SKELETON_DIRS = [
+    "obsidian-vault",
+    "obsidian-vault/09-Dashboards",
+    "obsidian-vault/11-Domain-Reference",
+    "obsidian-vault/12-Scope-Docs",
+];
+// ── Default jarvis.yaml Content ───────────────────────────────────────────────
+const DEFAULT_YAML_CONTENT = `# JARVIS Configuration
+# Tunable settings per bounded context. ConfigService deep-merges
+# these overrides over hardcoded defaults.
+
+azure-sync:
+  organization: ""
+  project: ""
+  repository: ""
+  authMethod: "az-cli"
+  defaultSyncDirection: "push"
+  autoDetectTemplate: true
+  pollEnabled: false
+  pollIntervalSecs: 60
+
+kanban:
+  minTransitionIntervalSecs: 30
+  gateTasks:
+    doing:
+      - description: "Code changes committed to feature branch"
+        required: true
+        autoVerify: "none"
+      - description: "tsc --noEmit passes with zero errors"
+        required: true
+        autoVerify: "none"
+      - description: "All tests pass"
+        required: true
+        autoVerify: "none"
+    review:
+      - description: "All acceptance criteria met"
+        required: true
+        autoVerify: "ac-met"
+      - description: "Code reviewed or self-reviewed with evidence"
+        required: true
+        autoVerify: "none"
+    tested:
+      - description: "All acceptance criteria met"
+        required: true
+        autoVerify: "ac-met"
+      - description: "Merged to main or PR approved"
+        required: true
+        autoVerify: "none"
+
+mcp-server:
+  transport: "stdio"
+  enabledTools: null
+`;
+// ── Bootstrap Use Cases ───────────────────────────────────────────────────────
+/**
+ * Orchestrates project bootstrap: AGENTS.md generation + directory structure.
+ */
+export class BootstrapUseCases {
+    /**
+     * Bootstrap a project directory.
+     * Creates AGENTS.md (if missing), .jarvis/, config/jarvis.yaml, and vault skeleton.
+     *
+     * @param directory - Project root directory
+     * @param config - Config snapshot for adaptive content
+     * @param force - If true, regenerate AGENTS.md even if it exists
+     */
+    bootstrap(directory, config, force = false) {
+        const agentsMdPath = join(directory, "AGENTS.md");
+        const createdDirs = [];
+        // 1. Ensure .jarvis/ exists
+        const jarvisDir = join(directory, ".jarvis");
+        if (!existsSync(jarvisDir)) {
+            mkdirSync(jarvisDir, { recursive: true });
+            createdDirs.push(".jarvis/");
+        }
+        // 2. Ensure config/jarvis.yaml exists
+        const configDir = join(directory, "config");
+        const configPath = join(configDir, "jarvis.yaml");
+        let configCreated = false;
+        if (!existsSync(configPath)) {
+            mkdirSync(configDir, { recursive: true });
+            writeFileSync(configPath, DEFAULT_YAML_CONTENT, "utf-8");
+            configCreated = true;
+            createdDirs.push("config/jarvis.yaml");
+        }
+        // 3. Ensure vault skeleton exists
+        for (const relDir of VAULT_SKELETON_DIRS) {
+            const absDir = join(directory, relDir);
+            if (!existsSync(absDir)) {
+                mkdirSync(absDir, { recursive: true });
+                createdDirs.push(relDir + "/");
+            }
+        }
+        // 4. Generate AGENTS.md
+        const agentsMdExists = existsSync(agentsMdPath);
+        let agentsMdCreated = false;
+        if (!agentsMdExists || force) {
+            const content = generateAgentsMd(config);
+            writeFileSync(agentsMdPath, content, "utf-8");
+            agentsMdCreated = true;
+        }
+        return {
+            agentsMdCreated,
+            agentsMdPath,
+            directoriesCreated: createdDirs,
+            configCreated,
+        };
+    }
+    /**
+     * Build a BootstrapConfig from an AzureSyncConfig (or defaults).
+     */
+    buildConfig(azureSyncConfig) {
+        const hasAzure = Boolean(azureSyncConfig?.organization && azureSyncConfig?.project);
+        return {
+            azureSyncEnabled: hasAzure,
+            azureOrg: azureSyncConfig?.organization ?? "",
+            azureProject: azureSyncConfig?.project ?? "",
+            pipelineEnabled: true,
+            containerUseEnabled: true,
+        };
+    }
+}
+// ── AGENTS.md Template Generator ──────────────────────────────────────────────
+/**
+ * Generate config-adaptive AGENTS.md content.
+ * Sections for Azure DevOps, Dagger, and container-use only appear when enabled.
+ */
+export function generateAgentsMd(config) {
+    const sections = [];
+    sections.push(SECTION_HEADER);
+    sections.push(SECTION_KANBAN_LIFECYCLE);
+    sections.push(SECTION_GUARDRAILS);
+    sections.push(SECTION_GOVERNANCE);
+    if (config.containerUseEnabled) {
+        sections.push(SECTION_CONTAINER_USE);
+    }
+    if (config.azureSyncEnabled) {
+        sections.push(generateAzureSyncSection(config));
+    }
+    if (config.pipelineEnabled) {
+        sections.push(SECTION_PIPELINE_DAGGER);
+    }
+    sections.push(SECTION_VAULT);
+    sections.push(SECTION_GIT_STRATEGY);
+    sections.push(SECTION_CONFIG_SYSTEM);
+    sections.push(SECTION_TOOL_QUICK_REFERENCE);
+    sections.push(SECTION_SKILLS_AND_COMMANDS);
+    sections.push(SECTION_RAG_ORACLE);
+    return sections.join("\n\n") + "\n";
+}
+// ── Static Sections ───────────────────────────────────────────────────────────
+const SECTION_HEADER = `# AGENTS.md — JARVIS Plugin Operational Guide
+
+This file instructs agentic coding agents operating in this repository.
+JARVIS is an OpenCode plugin implementing a multi-agent development framework
+with kanban governance, context memory, and CI/CD pipeline support.`;
+const SECTION_KANBAN_LIFECYCLE = `## Mandatory Workflow — Kanban Lifecycle
+
+ALL non-trivial work (>15 minutes) MUST follow the full kanban pipeline.
+Do NOT skip steps. Do NOT commit directly to \`main\`.
+
+\`\`\`
+backlog -> grooming -> ready -> doing -> review -> tested -> done
+\`\`\`
+
+### Before coding anything:
+
+1. **Create or pick a card** — \`kanban-card-create\`, assign to epic and sprint
+2. **Groom it** — Write a scope doc in \`obsidian-vault/12-Scope-Docs/\`, define
+   acceptance criteria (min 2), estimate story points (Fibonacci), assign epic
+3. **Move to ready** — Card cannot leave grooming without: scope doc, AC, points, epic
+4. **Assign agent + sprint** — Then move to \`doing\`
+5. **Start a session** — \`context-session-start\` before any card work
+
+### Grooming rules — CRITICAL:
+
+Grooming defines **problem, value, and boundaries**. It does NOT prescribe
+implementation details (no class names, method signatures, field names, code
+snippets). The implementing agent decides those during the \`doing\` phase.
+
+### After coding:
+
+6. **Run tests + linter** — All must pass, zero errors
+7. **Commit** — Imperative mood, reference card: \`Add X (CD-XXX)\` or \`Fix Y (CD-XXX)\`
+8. **Move card** — \`doing -> review -> tested -> done\`, meet all AC and gate tasks first
+9. **Update vault** — Dashboard + domain reference doc at end of every phase`;
+const SECTION_GUARDRAILS = `## Guardrails — Hard Rules
+
+### NEVER:
+- Use fallback/mock behavior to mask errors — errors must throw with proper handling
+- Use a "simpler approach" to bypass the real solution
+- Read \`.csv\` directly — use \`data-csv-query\` tool
+- Read \`.yaml/.yml\` directly — use \`data-yaml-get\` tool
+- Read \`.env\`, \`.pem\`, \`.key\`, credentials files — blocked by governance
+- Run \`git push --force\` on main/master
+- Run \`sqlite3\` CLI — use repository methods
+- Create \`TODO.md\`, \`PLAN.md\`, or \`ROADMAP.md\` — use kanban tools
+- Bypass the kanban pipeline for trackable work
+- Push to git without explicit user approval
+- Start the app from the agent session — ask the user to do it in another terminal
+
+### ALWAYS:
+- Search RAG (\`rag-search\` / \`rag-snippet\`) before creating or modifying files
+- Use specialized tools instead of raw file operations
+- Get full codebase context before making changes — ask if unclear
+- Validate card status transitions through the kanban domain
+- Track context with sessions, TODOs, and notes`;
+const SECTION_GOVERNANCE = `## Governance Policies (Runtime Enforced)
+
+Governance policies are evaluated by the \`tool.execute.before\` hook on every
+tool invocation. Violations with \`error\` severity throw and block execution.
+These cover: CSV/YAML/env file access, force push, direct SQLite CLI,
+destructive shell ops, credential file reads.
+
+Use \`governance-validate\` to pre-check if an operation is allowed.
+Use \`governance-policies\` to list all active policies.`;
+const SECTION_CONTAINER_USE = `## Container-Use Environments
+
+Container-use environments are isolated containers with their own git worktree
+branches. Use them for all file, code, and shell operations.
+
+Workflow:
+1. \`env-init\` — Detect project stack
+2. \`env-create\` — Spin up container from git ref
+3. Work inside container via \`container-use_environment_*\` tools
+4. \`env-merge\` — Merge branch back to main
+5. \`env-delete\` — Clean up container + worktree
+
+IMPORTANT: Always inform the user how to view your work using
+\`container-use log <env_id>\` and \`container-use checkout <env_id>\`.
+
+Do NOT install or use the git CLI with \`environment_run_cmd\`. All environment
+tools handle git operations automatically.`;
+const SECTION_PIPELINE_DAGGER = `## CI/CD Pipelines (Dagger)
+
+Pipeline BC uses Dagger for CI/CD gate execution. Pipelines are created from
+stack templates (typescript-lib, python-app, etc.) and run gates in containers.
+
+Workflow:
+1. \`pipeline-init\` — Create pipeline from stack template
+2. \`pipeline-activate\` — Make pipeline runnable
+3. \`pipeline-run\` — Execute gates via Dagger
+4. \`pipeline-gate\` — Manual pass/fail/skip/retry for gates
+5. \`pipeline-status\` — View pipeline state and gate results
+
+Templates available via \`pipeline-template\` tool.
+Scaffold Dagger modules via \`pipeline-scaffold\` tool.`;
+const SECTION_VAULT = `## Obsidian Vault
+
+Documentation lives in \`obsidian-vault/\`. Use structured lists, NOT markdown
+tables (token efficiency). Update at end of every phase:
+
+- \`09-Dashboards/\` — Project dashboards and metrics
+- \`11-Domain-Reference/\` — Per-context architecture docs
+- \`12-Scope-Docs/CD-XXX-*.md\` — Grooming scope documents
+
+Use \`vault-manage\` tool for smart vault operations (inspect, read, write, create,
+search, table-read, table-update).`;
+const SECTION_GIT_STRATEGY = `## Git Strategy
+
+- Work on feature branches (never commit directly to \`main\`)
+- Commit messages: imperative verb + summary + card reference
+  - \`Add feature X (CD-001)\`
+  - \`Fix bug Y (CD-015)\`
+- Merge via PR or controlled merge
+- Never amend pushed commits without explicit request
+- Never push without explicit user approval`;
+const SECTION_CONFIG_SYSTEM = `## Configuration System
+
+\`config/jarvis.yaml\` holds tunable settings per bounded context. The ConfigService
+deep-merges YAML overrides over hardcoded defaults. Access config via the
+appropriate getter methods — never read YAML files directly.`;
+const SECTION_TOOL_QUICK_REFERENCE = `## Tool Quick Reference (112 tools)
+
+JARVIS provides 112 tools across 11 bounded contexts. Key tool groups:
+
+- **Context Memory** (8): \`context-session-start\`, \`context-session-finish\`, \`context-todo-add\`, \`context-note-add\`, \`context-search\`...
+- **Kanban** (31): \`kanban-card-create\`, \`kanban-card-move\`, \`kanban-board-view\`, \`kanban-sprint-create\`, \`kanban-epic-create\`...
+- **Governance** (2): \`governance-validate\`, \`governance-policies\`
+- **Token Metrics** (7): \`metrics-summary\`, \`metrics-agent-report\`, \`metrics-card-report\`...
+- **Vault** (11): \`vault-manage\` (smart facade), \`vault-doc-create\`, \`vault-doc-search\`...
+- **RAG** (8): \`rag-search\`, \`rag-snippet\`, \`rag-index\`, \`rag-oracle-search\`, \`rag-oracle-index\`...
+- **Data** (3): \`data-yaml-get\`, \`data-json-get\`, \`data-csv-query\`
+- **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\`...
+- **Workspace** (4): \`workspace-info\`, \`workspace-list\`, \`workspace-update\`, \`workspace-link\`
+- **Bootstrap** (2): \`jarvis-bootstrap\`, \`jarvis-healthcheck\`
+
+For detailed workflows, load the appropriate skill (see below).`;
+const SECTION_SKILLS_AND_COMMANDS = `## Available Skills
+
+Load skills via the \`skill()\` tool to get detailed workflow instructions:
+
+- **\`jarvis-kanban\`** — Full kanban lifecycle: card creation, grooming, sprint management, gate tasks
+- **\`jarvis-azure-sync\`** — Azure DevOps sync: push/pull/bidi-sync, PR creation, poll events
+- **\`jarvis-onboarding\`** — Setup, healthcheck, RAG indexing, tool group reference
+
+### Available Commands
+
+Use these slash commands for common operations:
+
+- **\`/healthcheck\`** — Run diagnostics and get actionable fix guidance
+- **\`/sync-azure\`** — Execute Azure DevOps sync workflow
+- **\`/start-card CD-XXX\`** — Start working on a specific card (handles full lifecycle)
+
+When you encounter an unfamiliar workflow, ALWAYS load the relevant skill first.`;
+const SECTION_RAG_ORACLE = `## Knowledge Search — RAG & ORACLE
+
+Before creating or modifying code, ALWAYS search first:
+
+- **\`rag-search\`** / **\`rag-snippet\`** — Search the codebase semantically
+- **\`rag-oracle-search\`** — Search curated framework documentation (governance, workflows, patterns)
+
+When you don't know how to do something, search ORACLE:
+\`\`\`
+rag-oracle-search  query="how to sync azure devops"
+rag-oracle-search  query="kanban grooming requirements"  domain="workflows"
+\`\`\`
+
+ORACLE domains: \`governance\`, \`workflows\`, \`patterns\`, \`quick_reference\`.`;
+// ── Dynamic Sections ──────────────────────────────────────────────────────────
+function generateAzureSyncSection(config) {
+    return `## Azure DevOps Integration
+
+This project is connected to Azure DevOps (${config.azureOrg}/${config.azureProject}).
+
+Available tools:
+- \`azure-sync-discover\` — Detect project template, list work items + iterations
+- \`azure-sync-push\` — Push cards/epics/sprints to Azure DevOps
+- \`azure-sync-pull\` — Pull work items from Azure DevOps
+- \`azure-sync-sync\` — Bidirectional sync (push then pull)
+- \`azure-sync-status\` — Show sync status between local and Azure
+- \`azure-sync-config\` — Show configuration + test connectivity
+- \`azure-sync-events\` — List/acknowledge/dismiss detected change events
+- \`azure-pr-create\` — Create Pull Request in Azure Repos
+- \`azure-pr-list\` — List Pull Requests
+
+Poll service can be enabled in \`config/jarvis.yaml\` under \`azure-sync.pollEnabled\`
+to automatically detect changes made by team members in Azure DevOps.`;
+}
+//# sourceMappingURL=use-cases.js.map

package/dist/application/bootstrap/use-cases.js.map

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

package/dist/application/rag/dtos.d.ts

@@ -38,6 +38,12 @@ export interface RagIndexResponse {
     readonly chunksCreated: number;
     readonly excludedFiles: number;
     readonly totalSizeMb: number;
+    /** Number of files skipped (unchanged since last index). */
+    readonly filesSkipped: number;
+    /** Number of files re-indexed (modified since last index). */
+    readonly filesUpdated: number;
+    /** Number of files removed from index (deleted from disk). */
+    readonly filesRemoved: number;
 }
 export interface RagSnippetRequest {
     readonly query: string;

package/dist/application/rag/dtos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dtos.d.ts","sourceRoot":"","sources":["../../../src/application/rag/dtos.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dtos.d.ts","sourceRoot":"","sources":["../../../src/application/rag/dtos.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAID,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAID,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAID,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,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,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC"}

package/dist/application/rag/use-cases.d.ts

@@ -10,7 +10,7 @@
  * DDD: Application Service pattern
  */
 import type { Result } from "../../domain/shared/value-objects.js";
-import type { EmbeddingProvider, VectorRepository, TextSplitterPort, FileDiscoveryPort } from "../../domain/rag/repositories.js";
+import type { EmbeddingProvider, VectorRepository, TextSplitterPort, FileDiscoveryPort, FileIndexRegistryPort } from "../../domain/rag/repositories.js";
 import type { RagConfig } from "../../domain/config/value-objects.js";
 import type { RagSearchRequest, RagSearchResponse, RagIndexRequest, RagIndexResponse, RagSnippetRequest, RagSnippetResponse, RagUpdateRequest, RagUpdateResponse, RagDeleteRequest, RagDeleteResponse, RagStatusRequest, RagStatusResponse } from "./dtos.js";
 export interface RagUseCasesDeps {
@@ -19,6 +19,8 @@ export interface RagUseCasesDeps {
     readonly textSplitter: TextSplitterPort;
     readonly fileDiscovery: FileDiscoveryPort;
     readonly ragConfig: RagConfig;
+    /** Optional: file index registry for incremental indexing. */
+    readonly fileIndexRegistry?: FileIndexRegistryPort;
 }
 export declare class RagUseCases {
     private readonly embedding;
@@ -26,9 +28,15 @@ export declare class RagUseCases {
     private readonly splitter;
     private readonly files;
     private readonly ragConfig;
+    private readonly registry;
     constructor(deps: RagUseCasesDeps);
     search(request: RagSearchRequest): Promise<Result<RagSearchResponse>>;
     index(request: RagIndexRequest): Promise<Result<RagIndexResponse>>;
+    /**
+     * Index a single file: read, split, embed, store chunks.
+     * @returns Number of chunks created for this file.
+     */
+    private indexSingleFile;
     snippet(request: RagSnippetRequest): Promise<Result<RagSnippetResponse>>;
     update(request: RagUpdateRequest): Promise<Result<RagUpdateResponse>>;
     delete(request: RagDeleteRequest): Promise<Result<RagDeleteResponse>>;

package/dist/application/rag/use-cases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-cases.d.ts","sourceRoot":"","sources":["../../../src/application/rag/use-cases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAO1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEtE,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAKnB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,IAAI,EAAE,eAAe;IAU3B,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAgCrE,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAmGlE,OAAO,CACX,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAoChC,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAkGrE,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAqBrE,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAuB5E"}
+{"version":3,"file":"use-cases.d.ts","sourceRoot":"","sources":["../../../src/application/rag/use-cases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EAGtB,MAAM,kCAAkC,CAAC;AAO1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEtE,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAKnB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CACpD;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAEjD,IAAI,EAAE,eAAe;IAW3B,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAgCrE,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAuGxE;;;OAGG;YACW,eAAe;IAgEvB,OAAO,CACX,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAoChC,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAkGrE,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAqBrE,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAuB5E"}

package/dist/application/rag/use-cases.js

@@ -1,6 +1,6 @@
 import { ok, fail } from "../../domain/shared/value-objects.js";
+import { extractSnippet, computeIndexDelta } from "../../domain/rag/services.js";
 import { EXTENSION_LANGUAGE_MAP, inferDomain, } from "../../domain/rag/value-objects.js";
-import { extractSnippet } from "../../domain/rag/services.js";
 import { extname } from "node:path";
 // ── Use Cases ─────────────────────────────────────────────────────────
 export class RagUseCases {
@@ -9,12 +9,14 @@ export class RagUseCases {
     splitter;
     files;
     ragConfig;
+    registry;
     constructor(deps) {
         this.embedding = deps.embeddingProvider;
         this.vectors = deps.vectorRepository;
         this.splitter = deps.textSplitter;
         this.files = deps.fileDiscovery;
         this.ragConfig = deps.ragConfig;
+        this.registry = deps.fileIndexRegistry;
     }
     // ── Search ──────────────────────────────────────────────────────
     async search(request) {
@@ -52,83 +54,146 @@ export class RagUseCases {
             const workspace = request.workspace.toLowerCase();
             // Discover files
             const analysis = await this.files.discover(request.directory);
-            // Clear if requested
+            // Clear if requested (wipe index + registry)
             if (request.clear === true) {
                 await this.vectors.clearIndex(workspace);
+                if (this.registry !== undefined) {
+                    await this.registry.clearRecords(workspace);
+                }
             }
             // Ensure index exists
             await this.vectors.ensureIndex(workspace);
             // Create .ragignore if not present
             await this.files.createRagignore(request.directory, analysis.projectType);
+            // Compute incremental delta if registry is available
+            let filesToProcess;
+            let filesSkipped = 0;
+            let filesUpdated = 0;
+            let filesRemoved = 0;
+            if (this.registry !== undefined && request.clear !== true) {
+                const indexed = await this.registry.loadRecords(workspace);
+                const delta = computeIndexDelta(analysis.files, indexed);
+                // Remove deleted files from vector store
+                for (const relPath of delta.toRemove) {
+                    const record = indexed.find((r) => r.relativePath === relPath);
+                    if (record !== undefined) {
+                        await this.vectors.deleteBySource(workspace, record.absolutePath);
+                    }
+                }
+                filesRemoved = delta.toRemove.length;
+                // Delete existing chunks for modified files (will be re-added)
+                for (const file of delta.toUpdate) {
+                    await this.vectors.deleteBySource(workspace, file.absolutePath);
+                }
+                filesUpdated = delta.toUpdate.length;
+                filesToProcess = [...delta.toAdd, ...delta.toUpdate];
+                filesSkipped = delta.unchanged.length;
+            }
+            else {
+                filesToProcess = analysis.files;
+            }
+            // Process files that need indexing
             let totalChunks = 0;
-            // Process each file
-            for (const file of analysis.files) {
-                const content = await this.files.readFile(file.absolutePath);
-                if (content === null || content.trim().length === 0)
-                    continue;
-                const ext = extname(file.absolutePath).toLowerCase();
-                const language = EXTENSION_LANGUAGE_MAP.get(ext);
-                const domain = inferDomain(file.relativePath);
-                const fileType = ext.startsWith(".") ? ext.slice(1) : ext;
-                // Route markdown through splitByHeaders when enabled
-                if (language === "markdown" &&
-                    this.ragConfig.markdownSplitByHeaders) {
-                    const sections = this.splitter.splitByHeaders(content);
-                    if (sections.length === 0)
-                        continue;
-                    const texts = sections.map((s) => enrichWithHeaders(s));
-                    const vectors = await this.embedding.embedBatch(texts);
-                    const chunks = sections.map((_, i) => ({
-                        vector: vectors[i],
-                        metadata: {
-                            source: file.absolutePath,
-                            workspace,
-                            domain,
-                            fileType,
-                            chunkIndex: i,
-                            totalChunks: sections.length,
-                            content: texts[i],
-                        },
-                    }));
-                    await this.vectors.addChunks(workspace, chunks);
-                    totalChunks += chunks.length;
-                    continue;
+            const newRecords = [];
+            for (const file of filesToProcess) {
+                const chunkCount = await this.indexSingleFile(file, workspace);
+                totalChunks += chunkCount;
+                newRecords.push({
+                    relativePath: file.relativePath,
+                    absolutePath: file.absolutePath,
+                    mtimeMs: file.mtimeMs,
+                    chunkCount,
+                });
+            }
+            // Update registry with current state
+            if (this.registry !== undefined) {
+                // Merge: keep unchanged records + add new/updated records
+                const indexed = request.clear === true
+                    ? []
+                    : await this.registry.loadRecords(workspace);
+                const processedPaths = new Set(newRecords.map((r) => r.relativePath));
+                const removedPaths = new Set();
+                if (this.registry !== undefined && request.clear !== true) {
+                    const delta = computeIndexDelta(analysis.files, indexed);
+                    for (const rp of delta.toRemove)
+                        removedPaths.add(rp);
                 }
-                // Standard language-aware splitting with config-driven chunk sizes
-                const chunkEntry = resolveChunkConfig(this.ragConfig, language);
-                const textChunks = await this.splitter.split(content, language, chunkEntry);
-                if (textChunks.length === 0)
-                    continue;
-                const texts = textChunks.map((c) => c.content);
-                const vectors = await this.embedding.embedBatch(texts);
-                const chunks = textChunks.map((chunk, i) => ({
-                    vector: vectors[i],
-                    metadata: {
-                        source: file.absolutePath,
-                        workspace,
-                        domain,
-                        fileType,
-                        chunkIndex: chunk.index,
-                        totalChunks: textChunks.length,
-                        content: chunk.content,
-                    },
-                }));
-                await this.vectors.addChunks(workspace, chunks);
-                totalChunks += chunks.length;
+                const keptRecords = indexed.filter((r) => !processedPaths.has(r.relativePath) && !removedPaths.has(r.relativePath));
+                await this.registry.saveRecords(workspace, [...keptRecords, ...newRecords]);
             }
             return ok({
                 workspace,
                 projectType: analysis.projectType,
-                filesIndexed: analysis.files.length,
+                filesIndexed: filesToProcess.length,
                 chunksCreated: totalChunks,
                 excludedFiles: analysis.excludedCount,
                 totalSizeMb: analysis.totalSizeMb,
+                filesSkipped,
+                filesUpdated,
+                filesRemoved,
             });
         }
         catch (error) {
             return fail(`RAG index failed: ${String(error)}`);
         }
     }
+    // ── Index Single File (private helper) ─────────────────────────
+    /**
+     * Index a single file: read, split, embed, store chunks.
+     * @returns Number of chunks created for this file.
+     */
+    async indexSingleFile(file, workspace) {
+        const content = await this.files.readFile(file.absolutePath);
+        if (content === null || content.trim().length === 0)
+            return 0;
+        const ext = extname(file.absolutePath).toLowerCase();
+        const language = EXTENSION_LANGUAGE_MAP.get(ext);
+        const domain = inferDomain(file.relativePath);
+        const fileType = ext.startsWith(".") ? ext.slice(1) : ext;
+        // Route markdown through splitByHeaders when enabled
+        if (language === "markdown" && this.ragConfig.markdownSplitByHeaders) {
+            const sections = this.splitter.splitByHeaders(content);
+            if (sections.length === 0)
+                return 0;
+            const texts = sections.map((s) => enrichWithHeaders(s));
+            const vectors = await this.embedding.embedBatch(texts);
+            const chunks = sections.map((_, i) => ({
+                vector: vectors[i],
+                metadata: {
+                    source: file.absolutePath,
+                    workspace,
+                    domain,
+                    fileType,
+                    chunkIndex: i,
+                    totalChunks: sections.length,
+                    content: texts[i],
+                },
+            }));
+            await this.vectors.addChunks(workspace, chunks);
+            return chunks.length;
+        }
+        // Standard language-aware splitting with config-driven chunk sizes
+        const chunkEntry = resolveChunkConfig(this.ragConfig, language);
+        const textChunks = await this.splitter.split(content, language, chunkEntry);
+        if (textChunks.length === 0)
+            return 0;
+        const texts = textChunks.map((c) => c.content);
+        const vectors = await this.embedding.embedBatch(texts);
+        const chunks = textChunks.map((chunk, i) => ({
+            vector: vectors[i],
+            metadata: {
+                source: file.absolutePath,
+                workspace,
+                domain,
+                fileType,
+                chunkIndex: chunk.index,
+                totalChunks: textChunks.length,
+                content: chunk.content,
+            },
+        }));
+        await this.vectors.addChunks(workspace, chunks);
+        return chunks.length;
+    }
     // ── Snippet ─────────────────────────────────────────────────────
     async snippet(request) {
         try {