@mc1global/opencode-jarvis 0.8.1 → 0.10.0

package/dist/infrastructure/config/yaml-config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-config-writer.js","sourceRoot":"","sources":["../../../src/infrastructure/config/yaml-config-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,SAAS,CAAC;AAG3B;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,QAAQ,CAAC,IAA6B;QACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,kEAAkE;IAC1D,SAAS,CAAC,IAA6B;QAC7C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YACrB,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,GAAG;YAChB,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/infrastructure/context-memory/execution-journal-repository.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SQLite Execution Journal Repository
+ *
+ * Implements ExecutionJournalRepository interface from domain layer.
+ * Maps ExecutionEntry entities to/from SQLite rows.
+ * Entry IDs are auto-increment integers assigned by SQLite.
+ *
+ * SOLID: SRP - persistence for ExecutionEntry only
+ * SOLID: DIP - implements domain interface
+ */
+import type { SqliteAdapter } from "../database/sqlite-adapter.js";
+import type { ExecutionJournalRepository } from "../../domain/context-memory/repositories.js";
+import { ExecutionEntry } from "../../domain/context-memory/entities.js";
+import { ExecutionEntryId } from "../../domain/context-memory/value-objects.js";
+import { WorkspaceId } from "../../domain/shared/value-objects.js";
+export declare class SqliteExecutionJournalRepository implements ExecutionJournalRepository {
+    private readonly db;
+    constructor(db: SqliteAdapter);
+    save(entry: ExecutionEntry): Promise<ExecutionEntry>;
+    findById(id: ExecutionEntryId): Promise<ExecutionEntry | null>;
+    update(entry: ExecutionEntry): Promise<void>;
+    findRunning(workspace: WorkspaceId): Promise<readonly ExecutionEntry[]>;
+    pruneOlderThan(workspace: WorkspaceId, before: Date): Promise<number>;
+    private toDomain;
+}
+//# sourceMappingURL=execution-journal-repository.d.ts.map

package/dist/infrastructure/context-memory/execution-journal-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-journal-repository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/context-memory/execution-journal-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EACL,gBAAgB,EAGjB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,WAAW,EAAa,MAAM,sCAAsC,CAAC;AAmC9E,qBAAa,gCAAiC,YAAW,0BAA0B;IACrE,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,aAAa;IAIxC,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BpD,QAAQ,CAAC,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAQ9D,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C,WAAW,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAQvE,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3E,OAAO,CAAC,QAAQ;CAoBjB"}

package/dist/infrastructure/context-memory/execution-journal-repository.js

@@ -0,0 +1,110 @@
+import { ExecutionEntry } from "../../domain/context-memory/entities.js";
+import { ExecutionEntryId, ExecutionState, SessionId, } from "../../domain/context-memory/value-objects.js";
+import { WorkspaceId, Timestamp } from "../../domain/shared/value-objects.js";
+const SCHEMA_KEY = "context_memory_execution_journal";
+const DDL = `
+  CREATE TABLE IF NOT EXISTS execution_journal (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    tool_name TEXT NOT NULL,
+    args_summary TEXT NOT NULL DEFAULT '',
+    state TEXT NOT NULL DEFAULT 'running',
+    workspace TEXT NOT NULL,
+    session_id TEXT,
+    started_at TEXT NOT NULL,
+    finished_at TEXT,
+    error_message TEXT,
+    FOREIGN KEY (session_id) REFERENCES sessions(id)
+  );
+  CREATE INDEX IF NOT EXISTS idx_execjournal_workspace ON execution_journal(workspace);
+  CREATE INDEX IF NOT EXISTS idx_execjournal_state ON execution_journal(state);
+  CREATE INDEX IF NOT EXISTS idx_execjournal_started_at ON execution_journal(started_at);
+`;
+export class SqliteExecutionJournalRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.db.ensureSchema(SCHEMA_KEY, DDL);
+    }
+    async save(entry) {
+        const sql = `
+      INSERT INTO execution_journal (tool_name, args_summary, state, workspace, session_id, started_at, finished_at, error_message)
+      VALUES (@tool_name, @args_summary, @state, @workspace, @session_id, @started_at, @finished_at, @error_message)
+    `;
+        const result = this.db.execute(sql, {
+            tool_name: entry.toolName,
+            args_summary: entry.argsSummary,
+            state: entry.state,
+            workspace: entry.workspace.value,
+            session_id: entry.sessionId?.value ?? null,
+            started_at: entry.startedAt.toISO(),
+            finished_at: entry.finishedAt?.toISO() ?? null,
+            error_message: entry.errorMessage ?? null,
+        });
+        const realId = Number(result.lastInsertRowid);
+        return ExecutionEntry.reconstitute({
+            id: ExecutionEntryId.create(realId),
+            toolName: entry.toolName,
+            argsSummary: entry.argsSummary,
+            state: entry.state,
+            workspace: entry.workspace,
+            ...(entry.sessionId !== undefined ? { sessionId: entry.sessionId } : {}),
+            startedAt: entry.startedAt,
+            ...(entry.finishedAt !== undefined ? { finishedAt: entry.finishedAt } : {}),
+            ...(entry.errorMessage !== undefined ? { errorMessage: entry.errorMessage } : {}),
+        });
+    }
+    async findById(id) {
+        const row = this.db.queryOne("SELECT * FROM execution_journal WHERE id = @id", { id: id.numericValue });
+        return row != null ? this.toDomain(row) : null;
+    }
+    async update(entry) {
+        const sql = `
+      UPDATE execution_journal
+      SET state = @state, finished_at = @finished_at, error_message = @error_message
+      WHERE id = @id
+    `;
+        this.db.execute(sql, {
+            id: entry.id.numericValue,
+            state: entry.state,
+            finished_at: entry.finishedAt?.toISO() ?? null,
+            error_message: entry.errorMessage ?? null,
+        });
+    }
+    async findRunning(workspace) {
+        const rows = this.db.queryAll("SELECT * FROM execution_journal WHERE workspace = @workspace AND state = @state ORDER BY started_at DESC", { workspace: workspace.value, state: ExecutionState.Running });
+        return rows.map((row) => this.toDomain(row));
+    }
+    async pruneOlderThan(workspace, before) {
+        const sql = `
+      DELETE FROM execution_journal
+      WHERE workspace = @workspace AND state != @running AND started_at < @before
+    `;
+        const result = this.db.execute(sql, {
+            workspace: workspace.value,
+            running: ExecutionState.Running,
+            before: before.toISOString(),
+        });
+        return result.changes;
+    }
+    toDomain(row) {
+        const props = {
+            id: ExecutionEntryId.create(row.id),
+            toolName: row.tool_name,
+            argsSummary: row.args_summary,
+            state: row.state,
+            workspace: WorkspaceId.from(row.workspace),
+            ...(row.session_id !== null
+                ? { sessionId: SessionId.from(row.session_id) }
+                : {}),
+            startedAt: Timestamp.fromISO(row.started_at),
+            ...(row.finished_at !== null
+                ? { finishedAt: Timestamp.fromISO(row.finished_at) }
+                : {}),
+            ...(row.error_message !== null
+                ? { errorMessage: row.error_message }
+                : {}),
+        };
+        return ExecutionEntry.reconstitute(props);
+    }
+}
+//# sourceMappingURL=execution-journal-repository.js.map

package/dist/infrastructure/context-memory/execution-journal-repository.js.map

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

package/dist/tools/config-tools.d.ts

@@ -0,0 +1,12 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { ConfigService } from "../application/config/config-service.js";
+import type { ConfigWriteService } from "../application/config/config-write-service.js";
+export interface ConfigToolsDeps {
+    readonly configService: ConfigService;
+    readonly configWriteService: ConfigWriteService;
+}
+/**
+ * Creates config read/write tools for agent-guided configuration.
+ */
+export declare function createConfigTools(deps: ConfigToolsDeps): Record<string, ToolDefinition>;
+//# sourceMappingURL=config-tools.d.ts.map

package/dist/tools/config-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-tools.d.ts","sourceRoot":"","sources":["../../src/tools/config-tools.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AAOxF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;CACjD;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,GACpB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyGhC"}

package/dist/tools/config-tools.js

@@ -0,0 +1,136 @@
+/**
+ * Config Tools
+ *
+ * OpenCode tool definitions for reading and writing JARVIS configuration.
+ * Provides agent-accessible tools for the /config slash command and
+ * general config management within OpenCode sessions.
+ *
+ * Tools defined (2):
+ *   config-read   — Read current effective config for a section or all sections
+ *   config-write  — Update config values for a specific section
+ *
+ * SOLID: SRP — config tool exposure only
+ * SOLID: DIP — depends on use case abstractions
+ */
+import { tool } from "@opencode-ai/plugin";
+const z = tool.schema;
+// ── Tool Factory ──────────────────────────────────────────────────────
+/**
+ * Creates config read/write tools for agent-guided configuration.
+ */
+export function createConfigTools(deps) {
+    const { configService, configWriteService } = deps;
+    // ── config-read ──────────────────────────────────────────────────
+    const configRead = tool({
+        description: "Read current effective JARVIS configuration. Without a section argument, " +
+            "returns all writable sections with their current effective values (defaults merged " +
+            "with user overrides). With a section argument, returns that section's full config. " +
+            "Shows which values are overridden vs defaults.",
+        args: {
+            section: z
+                .string()
+                .optional()
+                .describe("Config section to read (e.g., 'rag', 'azure-sync', 'pipeline', " +
+                "'agent-registry', 'mcp-server', 'kanban', 'token-metrics'). " +
+                "Omit to read all sections."),
+        },
+        async execute(args) {
+            const writableContexts = configWriteService.getWritableContexts();
+            if (args.section !== undefined) {
+                if (!writableContexts.includes(args.section)) {
+                    return `Unknown or non-writable section: "${args.section}"\n\nWritable sections: ${writableContexts.join(", ")}`;
+                }
+                const effective = configService.getConfig(args.section);
+                return formatConfigSection(args.section, effective);
+            }
+            // All sections
+            const lines = [
+                "JARVIS Configuration — All Sections",
+                `External config file: ${configService.isExternalConfigAvailable() ? "found" : "not found (using defaults only)"}`,
+                "",
+            ];
+            for (const ctx of writableContexts) {
+                const effective = configService.getConfig(ctx);
+                lines.push(formatConfigSection(ctx, effective));
+                lines.push("");
+            }
+            return lines.join("\n");
+        },
+    });
+    // ── config-write ─────────────────────────────────────────────────
+    const configWrite = tool({
+        description: "Update JARVIS configuration values for a specific section. " +
+            "Accepts a JSON object with the values to change. Only values that " +
+            "differ from defaults are persisted to config/jarvis.yaml. " +
+            "Validates input before writing (e.g., pollEnabled requires org+project).",
+        args: {
+            section: z
+                .string()
+                .describe("Config section to update (e.g., 'azure-sync', 'rag', 'pipeline', " +
+                "'agent-registry', 'mcp-server', 'kanban', 'token-metrics')."),
+            values: z
+                .string()
+                .describe("JSON string of the partial values to update. " +
+                'Example: \'{"organization": "MyOrg", "project": "MyProject"}\' for azure-sync. ' +
+                "Only include the keys you want to change."),
+        },
+        async execute(args) {
+            let parsed;
+            try {
+                parsed = JSON.parse(args.values);
+            }
+            catch {
+                return `Error: Invalid JSON in values parameter: ${args.values}`;
+            }
+            if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                return "Error: values must be a JSON object (not array or primitive)";
+            }
+            try {
+                const effective = configWriteService.updateContext(args.section, parsed);
+                return (`Configuration updated for "${args.section}".\n\n` +
+                    `New effective values:\n${formatConfigSection(args.section, effective)}`);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return `Error updating "${args.section}": ${msg}`;
+            }
+        },
+    });
+    return {
+        "config-read": configRead,
+        "config-write": configWrite,
+    };
+}
+// ── Formatting Helpers ────────────────────────────────────────────────
+function formatConfigSection(name, config) {
+    const lines = [`[${name}]`];
+    if (config === null || config === undefined) {
+        lines.push("  (no configuration)");
+        return lines.join("\n");
+    }
+    if (typeof config !== "object") {
+        lines.push(`  ${String(config)}`);
+        return lines.join("\n");
+    }
+    formatObject(config, lines, 1);
+    return lines.join("\n");
+}
+function formatObject(obj, lines, depth) {
+    const indent = "  ".repeat(depth);
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === null) {
+            lines.push(`${indent}${key}: null`);
+        }
+        else if (typeof value === "object" && !Array.isArray(value)) {
+            lines.push(`${indent}${key}:`);
+            formatObject(value, lines, depth + 1);
+        }
+        else if (Array.isArray(value)) {
+            lines.push(`${indent}${key}: [${value.map((v) => JSON.stringify(v)).join(", ")}]`);
+        }
+        else {
+            lines.push(`${indent}${key}: ${String(value)}`);
+        }
+    }
+}
+//# sourceMappingURL=config-tools.js.map

package/dist/tools/config-tools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mc1global/opencode-jarvis",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "JARVIS Framework - OpenCode native plugin for multi-agent development with DDD architecture",
   "author": "Julio Fabio de O. Chagas <julio.fabio@mc1global.com>",
   "license": "SEE LICENSE IN LICENSE",
@@ -15,10 +15,12 @@
     }
   },
   "bin": {
-    "jarvis-mcp": "dist/mcp-server.js"
+    "jarvis-mcp": "dist/mcp-server.js",
+    "jarvis": "dist/cli/config-wizard.js"
   },
   "files": [
     "dist/",
+    "templates/",
     "LICENSE",
     "README.md",
     "QUICK-GUIDE.md"
@@ -45,6 +47,7 @@
     "@opencode-ai/plugin": ">=1.1.0"
   },
   "dependencies": {
+    "@clack/prompts": "^1.0.1",
     "@langchain/textsplitters": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "js-yaml": "^4.1.1",

package/templates/agents-md.template.md

@@ -0,0 +1,232 @@
+# 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, automatic cost tracking, and CI/CD
+pipeline support.
+
+## Architecture Constraints — Inviolable
+
+- **SOLID Principles** — Every class/module must strictly respect all 5 principles
+- **Domain-Driven Design** — Domain layer has ZERO external dependencies. Repository
+  interfaces in domain, implementations in infrastructure
+- **Max 500 lines per file** — No exceptions. Split by responsibility if approaching limit
+- **ESM modules** — `"type": "module"` required by `@opencode-ai/plugin`
+- **Strict TypeScript** — `exactOptionalPropertyTypes`, `verbatimModuleSyntax`,
+  `noUncheckedIndexedAccess` all enabled
+- **13 bounded contexts** with strict DDD boundaries — no direct imports between contexts
+- **Cross-context communication** via ports/callbacks wired at composition root
+
+## 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
+
+## 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
+- Skip grooming requirements or gate tasks for cards
+- Import directly between bounded contexts — use ports/callbacks
+
+### 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
+- Meet all gate tasks before moving cards through review/tested/done
+
+## Governance Policies (13 Runtime Enforced)
+
+Governance policies are evaluated by the `tool.execute.before` hook on every
+tool invocation. Violations with `error` severity throw and block execution.
+
+Policy groups:
+- **File access** — Block direct CSV, YAML, env file reads (use specialized tools)
+- **Shell safety** — Block force push, direct SQLite CLI, warn on destructive ops
+- **Security** — Block env dump, sensitive file reads, credential file access
+- **Pipeline** — Warn when running pipeline without linked card
+- **Kanban** — Require gate tasks before status transitions, warn on rapid transitions
+
+Use `governance-validate` to pre-check if an operation is allowed.
+Use `governance-policies` to list all active policies.
+
+{{#IF 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.
+{{/IF CONTAINER_USE}}
+
+{{#IF AZURE_SYNC}}
+## Azure DevOps Integration
+
+This project is connected to Azure DevOps ({{AZURE_ORG}}/{{AZURE_PROJECT}}).
+
+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-sync-poll-status` — Show background poll service status
+- `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.
+{{/IF AZURE_SYNC}}
+
+{{#IF PIPELINE}}
+## 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.
+{{/IF PIPELINE}}
+
+## 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).
+
+## 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
+
+## 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.
+
+Available config sections: `rag`, `azure-sync`, `kanban`, `mcp-server`,
+`pipeline`, `token-metrics` (with `sprintBudgetUsd` and `budgetAlertThreshold`).
+
+## Tool Quick Reference (113 tools)
+
+JARVIS provides 113 tools across 13 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`, `kanban-grooming-validate`, `kanban-card-gate`...
+- **Governance** (2): `governance-validate`, `governance-policies`
+- **Token Metrics** (7): `metrics-summary`, `metrics-agent-report`, `metrics-card-report`, `metrics-sprint-report`, `metrics-estimate`... (auto-tracks cost per card/sprint)
+- **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`, `agent-register`, `agent-profile`...
+- **Pipeline** (10): `pipeline-init`, `pipeline-run`, `pipeline-status`, `pipeline-template`, `pipeline-scaffold`...
+- **Environment** (6): `env-init`, `env-create`, `env-list`, `env-status`, `env-merge`, `env-delete`
+- **Workspace** (4): `workspace-info`, `workspace-list`, `workspace-update`, `workspace-link`
+- **Azure Sync** (10): `azure-sync-discover`, `azure-sync-push`, `azure-sync-pull`, `azure-sync-sync`, `azure-pr-create`...
+- **Bootstrap** (3): `jarvis-bootstrap`, `jarvis-healthcheck`, `jarvis-terminal-commands`
+- **Domain Map** (2): `domain-map-analyze`, `domain-map-view`
+
+For detailed workflows, load the appropriate skill (see below).
+
+## 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.
+
+## 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`.