@bcelep/capint 0.4.2

package/AGENT.md

@@ -0,0 +1,28 @@
+# AGENT.md — CapInt
+
+CapInt is an IDE-native, capability-first orchestration engine.
+
+## Task contract
+
+For every task:
+1. Build Execution Intent
+2. Ask confirm options (`apply_now | plan_first | analyze_only`)
+3. Route via capability + provider resolution
+
+## Runtime chain
+
+`parseIntent -> routeCapability -> resolveMemoryStrategy -> buildExecutionPolicy -> formatOutput`
+
+## Scope
+
+- Keep user UX minimal and chat-first.
+- Do not force users to remember skill/workflow names.
+- Memory strategy is silent and additive (`none|optional|required`); providers default off.
+- Medium/heavy tasks require verification evidence before claiming done.
+
+## Commands
+
+- `capint route` — execution intent
+- `capint consult` — dry-run recommendation
+- `capint status` / `capint doctor` / `capint audit` — health (no auto-fix)
+- `capint init` / `capint scaffold` — hybrid project bootstrap

package/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+## 0.4.2 — 2026-05-30
+
+Optional local context layer (flag-gated).
+
+### Added
+- `local-memory-adapter`, `local-graph-adapter`
+- `capint memory status`
+- `local_adapters` in Execution Intent when `CAPINT_LOCAL_CONTEXT=1`
+
+## 0.4.1 — 2026-05-30
+
+Lifecycle management.
+
+### Added
+- `capint uninstall` (manifest-driven, dry-run, keep flags)
+- `capint upgrade` (matrix merge, backup, visible conflict report)
+
+## 0.4.0 — 2026-05-30
+
+Productization release: install → route → IDE.
+
+### Added
+- Manifest schema v2 (`docs/manifest-schema.md`)
+- Init skill/workflow bundle; registry derived from matrix
+- `resolution_status` / `resolution_hint` for not_installed
+- `capint ide sync|check`, projections/session-start.md
+- Default `--ide-sync` on init; AGENTS.md stub; `.gitignore` fragment
+
+### Changed
+- Init copies bundle skills so `capint route "i18n"` resolves installed
+
+## 0.3.0 — 2026-05-30
+
+Plan phases 1–5 complete + orchestration extension.
+
+### Added
+- `capint consult`, `status`, `doctor`, `audit` (read-only operational surface)
+- `capint init` / `scaffold` hybrid bootstrap with safe-merge conflict policy
+- Provider activation policy (memory/graph default off)
+- Local `context_pack`, `orchestration` patterns, `capability_chains`
+- Optional append-only event log
+- Verification gates for medium/heavy tasks
+- `docs/architecture-decisions.md`, `docs/execution-intent-contract.md`, `docs/release-checklist.md`
+
+### Changed
+- Matrix schema 1.2 with `orchestration_pattern` per task type
+- `capint init` now scaffolds `skill-routing-matrix.json` + `registry.json`
+- `/forge` workflow expanded to phased template
+
+## 0.2.0 — 2026-05-30
+
+Initial modular orchestrator (intent parser, capability router, execution policy, memory bridge).
+
+## 0.1.0 — 2026-05-29
+
+Minimal `capint route` prototype.

package/README.md

@@ -0,0 +1,94 @@
+# CapInt
+
+Capability-first orchestration engine for IDE agents.
+
+Package: `@bcelep/capint`  
+CLI: `capint`
+
+## Quick start
+
+```bash
+cd your-project
+npx @bcelep/capint init
+npx @bcelep/capint route "i18n çeviri lang file hub"
+```
+
+Init scaffolds docs, matrix, registry (derived from matrix), skill/workflow bundle, and runs `capint ide sync` by default.  
+Skip IDE sync: `capint init --no-ide-sync` then `capint ide sync` manually.
+
+## Install flow
+
+1. `npx @bcelep/capint init` — scaffold + bundle + IDE projections
+2. `capint route "<task>"` — Execution Intent with `resolution_status: installed|not_installed`
+3. `capint doctor` — drift check (read-only)
+4. Optional: `capint upgrade --dry-run` / `capint uninstall --dry-run`
+
+## Commands
+
+### Routing
+
+- `capint route "<task>"`
+- `capint route --json "<task>"`
+- `capint route --verbose "<task>"`
+- `capint route --list`
+
+### Operational (read-only / dry-run)
+
+- `capint consult "<task>" [--json]` — recommendation only
+- `capint status [--json]` — matrix/registry health
+- `capint doctor [--json]` — drift diagnosis
+- `capint audit [--json]` — project + contract audit
+
+### Scaffold
+
+- `capint init [--preset minimal] [--name Project] [--no-ide-sync]`
+- `capint scaffold --list`
+- `capint scaffold --preset minimal|prismx-compatible`
+
+Init writes `AGENT.md`, `AGENTS.md`, `design.md`, `.gitignore` (managed fragment), matrix, registry, skills bundle, workflows.  
+Conflicts → `*.capint.new.md`. Manifest: `.capint/scaffold-manifest.json` (schema v2).
+
+### IDE integration
+
+- `capint ide sync [--dry-run] [--targets cursor,claude,gemini,antigravity]`
+- `capint ide check [--json]`
+
+### Lifecycle
+
+- `capint uninstall [--dry-run] [--yes] [--keep-agent] [--keep-ide] [--include-sidecars]`
+- `capint upgrade [--dry-run] [--apply]`
+
+### Optional context (v0.4.2)
+
+- `capint memory status [--json]` — local file availability (read-only)
+- Route hot path unchanged unless `CAPINT_LOCAL_CONTEXT=1`
+
+## Documentation
+
+- [docs/manifest-schema.md](docs/manifest-schema.md) — scaffold manifest v2
+- [docs/architecture-decisions.md](docs/architecture-decisions.md)
+- [docs/execution-intent-contract.md](docs/execution-intent-contract.md)
+- [docs/release-checklist.md](docs/release-checklist.md)
+- [CHANGELOG.md](CHANGELOG.md)
+
+## Architecture
+
+Core chain:
+
+- `src/lib/intent-parser.js`
+- `src/lib/capability-router.js`
+- `src/lib/execution-policy.js`
+- `src/lib/context-memory-bridge.js`
+- `src/lib/route-engine.js`
+
+## Execution Intent contract
+
+Every route produces:
+
+- `intent`, `capability`, `resolution`, `memory`, `plan`
+- `resolution_status`, `resolution_hint` when skill/workflow missing
+- `confirm` block with `apply_now | plan_first | analyze_only`
+- `verification_required` on medium/heavy or `not_installed`
+- `orchestration`, `context_pack`, optional `local_adapters` (flag-gated)
+
+Maintainer verification: `npm run release-check`

package/bin/capint.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+const args = process.argv.slice(2);
+const command = args[0];
+const flags = {};
+for (let i = 0; i < args.length; i++) {
+  if (args[i].startsWith("--")) {
+    const key = args[i].slice(2);
+    if (args[i + 1] && !args[i + 1].startsWith("--")) {
+      flags[key] = args[i + 1];
+      i++;
+    } else {
+      flags[key] = true;
+    }
+  }
+}
+
+async function main() {
+  switch (command) {
+    case "route":
+      return require("../src/commands/route")(args.slice(1), flags);
+    case "consult":
+      return require("../src/commands/consult")(args.slice(1), flags);
+    case "status":
+      return require("../src/commands/status")(args.slice(1), flags);
+    case "doctor":
+      return require("../src/commands/doctor")(args.slice(1), flags);
+    case "init":
+      return require("../src/commands/init")(args.slice(1), flags);
+    case "scaffold":
+      return require("../src/commands/scaffold")(args.slice(1), flags);
+    case "audit":
+      return require("../src/commands/audit")(args.slice(1), flags);
+    case "ide":
+      return require("../src/commands/ide")(args.slice(1), flags);
+    case "uninstall":
+      return require("../src/commands/uninstall")(args.slice(1), flags);
+    case "upgrade":
+      return require("../src/commands/upgrade")(args.slice(1), flags);
+    case "memory":
+      return require("../src/commands/memory")(args.slice(1), flags);
+    case "version":
+    case "--version":
+    case "-v":
+      console.log(`capint v${require("../package.json").version}`);
+      return;
+    case "help":
+    case "--help":
+    case "-h":
+    case undefined:
+      showHelp();
+      return;
+    default:
+      console.error(`Unknown command: ${command}`);
+      showHelp();
+      process.exit(1);
+  }
+}
+
+function showHelp() {
+  console.log(`
+capint ${require("../package.json").version}
+
+Usage:
+  capint route "<task>"
+  capint route --json "<task>"
+  capint route --verbose "<task>"
+  capint route --list
+
+  capint consult "<task>" [--json]     dry-run recommendation (no side effects)
+  capint status [--json]               read-only project health
+  capint doctor [--json]               diagnose drift (no auto-fix)
+  capint audit [--json]                project + contract audit (read-only)
+
+  capint init [--preset minimal] [--name Project] [--no-ide-sync] [--json]
+  capint scaffold [--preset minimal|prismx-compatible] [--list] [--json]
+
+  capint ide sync|check [--dry-run] [--json] [--targets cursor,claude,...]
+  capint uninstall [--dry-run] [--yes] [--keep-agent] [--keep-ide] [--include-sidecars]
+  capint upgrade [--dry-run] [--apply]
+  capint memory status [--json]
+
+  capint version
+`);
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/design.md

@@ -0,0 +1,23 @@
+# design.md — CapInt
+
+<!-- capint:managed:start -->
+## Goal
+
+Capability-first orchestration engine for IDE agents: route natural language to capability + provider without skill-name memorization.
+
+## Boundaries
+
+- In scope: routing, execution policy, hybrid scaffold, optional memory/graph adapters
+- Out of scope: skill catalog inflation, bundled vector DB, autonomous multi-agent armies
+
+## Success criteria
+
+- [ ] Deterministic `capint route` for same input + matrix
+- [ ] Execution Intent contract stable across releases
+- [ ] Scaffold never blind-overwrites existing docs
+- [ ] Memory/graph providers default off
+
+## Updated
+
+2026-05-30
+<!-- capint:managed:end -->

package/docs/architecture-decisions.md

@@ -0,0 +1,95 @@
+# CapInt Architecture Decisions
+
+## Positioning
+
+CapInt is a **capability-first runtime router** for IDE agents — not a skill catalog, not a multi-agent factory, not a memory engine.
+
+| Layer | CapInt | Neighbor repos |
+|-------|--------|----------------|
+| Routing | Yes (core) | skill-gateway, agent-skills |
+| Team generation | No | revfactory/harness, agency-agents |
+| Memory/graph engine | No (adapters only) | mempalace, agentmemory, graphify |
+| Cross-harness standardization | Partial (project scaffold) | affaan-m/ECC |
+| Verification discipline | Yes (policy gates) | obra/superpowers |
+
+## Adopted patterns
+
+- **Invisible gateway** (skill-gateway): route without ceremony; user sees Execution Intent, not skill names.
+- **Confirm triad** (PrismX lesson): `apply_now | plan_first | analyze_only` on medium+.
+- **Operational hygiene** (ECC): `consult`, `status`, `doctor` — read-only / dry-run, no auto-fix.
+- **Verification gate** (superpowers): medium/heavy requires evidence before "done".
+- **Hybrid scaffold**: minimal first, `prismx-compatible` only on explicit opt-in.
+
+## Explicitly avoided
+
+- Bundling memory/graph runtimes in core (Docker, vector DB, MCP tool floods).
+- Self-mutating skills / instinct evolution.
+- Full autonomous PM→Architect→Dev→QA pipelines.
+- Markdown-only routing tables as source of truth (matrix JSON is SoT).
+- Blind overwrite of existing project docs.
+
+## Provider activation policy
+
+Default: **off** for memory and graph providers.
+
+Activation requires (any):
+
+1. Capability `requires_memory: required`, or
+2. High-risk capability (memory-retrieval, incident-response, threat-modeling), or
+3. Explicit env flag (`CAPINT_MEMORY=1`, `CAPINT_GRAPH=1`)
+
+Blocked when:
+
+- `light` weight and capability does not require memory
+- `doctor` has not passed (unless feature flag set)
+
+Fallback: always `local` (HANDOFF, AGENT.md, design.md, project files).
+
+## Event log (optional)
+
+Route events append to `.capint/logs/route-events.ndjson` only when:
+
+- `CAPINT_EVENT_LOG=1`, or
+- `.capint/context.json` has `"event_log": true`
+
+Default: off. Does not block route hot-path when disabled.
+
+## Schema versioning
+
+| Change | Version bump |
+|--------|----------------|
+| `execution_intent` breaking field change | package major |
+| matrix field addition | matrix minor (e.g. 1.0 → 1.1) |
+| matrix field removal or semantic break | matrix major |
+
+## Scaffold conflict policy
+
+- Missing file → create
+- File with `<!-- capint:managed:start/end -->` → merge inner block only
+- File without managed markers → write `*.capint.new.md`, never overwrite
+- `--force` opt-in only
+
+## Operational command contracts
+
+| Command | Side effects | Auto-fix |
+|---------|--------------|----------|
+| `consult` | None | No |
+| `status` | None | No |
+| `doctor` | None | No |
+| `audit` | None | No |
+| `init` / `scaffold` | Creates/merges files | No (safe-merge only) |
+| `route` | None | No |
+
+## Inspiration map (repos reviewed)
+
+| Repo | Take | Skip |
+|------|------|------|
+| addyosmani/agent-skills | lifecycle phases, verification | mandatory 15-step for all tasks |
+| buraksu42/skill-gateway | invisible router, quality tiers | web search on miss, install links in chat |
+| multica-ai/andrej-karpathy-skills | constitutional layer | CLAUDE.md-only routing |
+| affaan-m/ECC | doctor/status/install state | 249 skills default, daemon/TUI |
+| obra/superpowers | evidence-before-claims | full subagent army on light tasks |
+| msitarzewski/agency-agents | convert/install UX | 144 persona default bundle |
+| MemPalace / agentmemory / graphify | adapter contracts | core embedding, hooks, MCP surfaces |
+| giancarloerra/SocratiCode | provider boundary | AGPL docker stack in core |
+| revfactory/harness | orchestration patterns reference | team factory in router core |

package/docs/execution-intent-contract.md

@@ -0,0 +1,81 @@
+# Execution Intent Contract
+
+Stable output from `capint route --json`. Package major bumps only on breaking changes to required fields.
+
+## Required fields
+
+| Field | Type | Values |
+|-------|------|--------|
+| `intent` | string | Original task text |
+| `capability` | string | Resolved capability id |
+| `resolution` | string | `provider/resource` e.g. `skill/localization-hub` |
+| `memory` | string | `none` \| `optional` \| `required` |
+| `plan` | string | `auto` \| `confirm` \| `override` |
+| `confirm` | object | `{ enabled, mode, prompt, options, default_option }` |
+| `confirm_question` | string \| null | Human prompt |
+| `confirm_options` | array | `{ id, label }[]` |
+| `confirm_default_option` | string \| null | e.g. `plan_first` |
+| `fallback` | object \| null | `{ capability, override }` when ambiguous |
+
+## Optional fields (v0.3+)
+
+| Field | Description |
+|-------|-------------|
+| `verification_required` | boolean |
+| `verification_hints` | string[] |
+| `verification_profile` | string |
+| `provider_activation` | memory/graph gating result |
+| `context_pack` | local file snippets when memory active |
+| `orchestration` | `{ pattern, execution_mode, chains[] }` |
+| `route_explain` | verbose routing debug |
+| `resolution_status` | `installed` \| `not_installed` |
+| `resolution_hint` | string when not installed |
+| `local_adapters` | optional; only when `CAPINT_LOCAL_CONTEXT=1` |
+
+## Example: medium debug task
+
+```json
+{
+  "intent": "debug login hatasi var",
+  "capability": "systematic-debugging",
+  "resolution": "skill/systematic-debugging",
+  "memory": "optional",
+  "plan": "confirm",
+  "confirm": {
+    "enabled": true,
+    "mode": "always_confirm",
+    "default_option": "plan_first"
+  },
+  "verification_required": true,
+  "orchestration": {
+    "pattern": "producer_reviewer",
+    "execution_mode": "pipeline",
+    "chains": [{ "then_capability": "refactor-simplify", "when": "plan_first" }]
+  }
+}
+```
+
+## Example: memory lookup
+
+```json
+{
+  "capability": "memory-retrieval",
+  "memory": "required",
+  "context_pack": {
+    "source": "local",
+    "snippets": [{ "source": "AGENT.md", "confidence": "verbatim" }]
+  },
+  "provider_activation": {
+    "memory": { "activated": true, "default": "off" },
+    "graph": { "activated": true, "default": "off" }
+  }
+}
+```
+
+## Confirm options
+
+| Option | Agent behavior |
+|--------|----------------|
+| `apply_now` | Execute immediately (subagent mode) |
+| `plan_first` | Short plan, then execute (pipeline mode) |
+| `analyze_only` | Read-only analysis (explore mode) |

package/docs/manifest-schema.md

@@ -0,0 +1,36 @@
+# Scaffold manifest schema (v2.0)
+
+`.capint/scaffold-manifest.json` is the shared source-of-truth for init, uninstall, and upgrade file tracking.
+
+## Top-level
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `schema_version` | `"2.0"` | Manifest schema version |
+| `last_run` | ISO string | Last scaffold/ide-sync run timestamp |
+| `preset` | string | Preset id used |
+| `summary` | object | `{ created, updated, skipped, conflict }` |
+| `files` | array | File entries (see below) |
+| `history` | array | Last 10 run summaries |
+
+## File entry
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `path` | string | yes | Project-relative path |
+| `action` | enum | yes | `created` \| `updated` \| `skipped` \| `conflict` |
+| `source` | enum | yes | `capint` (managed) \| `user` |
+| `removable` | boolean | yes | Safe for `capint uninstall` when `source: capint` |
+| `kind` | enum | yes | `doc` \| `skill` \| `workflow` \| `matrix` \| `registry` \| `ide_projection` |
+| `marker` | string \| null | no | IDE sync marker when `kind: ide_projection` |
+| `sidecar` | string \| null | no | Conflict sidecar path |
+
+## Rules
+
+- Bundle skills/workflows: `source: capint`, `removable: true`, kind inferred from path.
+- User-edited docs without capint marker: never auto-deleted; uninstall respects `removable` and marker.
+- IDE projections must include marker: `<!-- source: capint/projections/session-start.md | capint ide sync -->`
+
+## Validation
+
+Run `node tests/manifest-schema.test.mjs` for schema round-trip fixtures.

package/docs/release-checklist.md

@@ -0,0 +1,31 @@
+# CapInt Release Checklist
+
+Use before tagging a new `@bcelep/capint` version.
+
+## Pre-release
+
+- [ ] `skill-routing-matrix.json` schema_version bumped if matrix shape changed
+- [ ] Package version bumped (major = breaking `execution_intent`, minor = features, patch = fixes)
+- [ ] `node scripts/validate-matrix.mjs` passes
+- [ ] `node scripts/release-check.mjs` passes (all phases)
+- [ ] README + `docs/architecture-decisions.md` reflect new commands/fields
+- [ ] Scaffold templates updated if init output changed
+
+## Matrix policy changes
+
+- [ ] New task_types have unique `id` and `orchestration_pattern`
+- [ ] `provider_activation_policy` defaults remain `off`
+- [ ] Breaking field removal → major matrix version + migration note
+- [ ] Field addition only → minor matrix version
+
+## Contract stability
+
+- [ ] `execution_intent` required keys unchanged OR major package bump
+- [ ] Snapshot fixtures updated if intentional behavior change
+- [ ] `capint route --json` output reviewed against `docs/execution-intent-contract.md`
+
+## Publish (manual)
+
+- [ ] `npm login` (maintainer)
+- [ ] `npm publish --access public`
+- [ ] Git tag `vX.Y.Z` on `Pegarose/capint`

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@bcelep/capint",
+  "version": "0.4.2",
+  "description": "Capability-first orchestration engine for IDE agents",
+  "license": "MIT",
+  "bin": {
+    "capint": "bin/capint.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "projections/",
+    "workflows/",
+    "skills/",
+    "scripts/",
+    "AGENT.md",
+    "skill-routing-matrix.json",
+    "registry.json",
+    "README.md",
+    "CHANGELOG.md",
+    "design.md",
+    "docs/"
+  ],
+  "scripts": {
+    "test": "node tests/contract-snapshot.test.mjs",
+    "validate": "node scripts/validate-matrix.mjs",
+    "release-check": "node scripts/release-check.mjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/projections/session-start.md

@@ -0,0 +1,32 @@
+---
+description: "CapInt session start + Execution Intent — projected via capint ide sync"
+---
+
+# Session start (all IDEs)
+
+Every **new conversation**, before editing files:
+
+1. Read root `AGENT.md` + `design.md` (+ `HANDOFF.md` if present).
+2. Keep startup output short (2–5 lines).
+
+# Task received
+
+When the user assigns work:
+
+1. User does not need to know skill names; you select capability.
+2. Before code, show short **Execution Intent**:
+   - `Intent: ...`
+   - `Capability: ...`
+   - `Resolution: provider/resource`
+   - `Memory: none|optional|required`
+   - `Plan: auto|confirm|override`
+3. Ask **one** short confirm question when plan is `confirm`:
+   - `Confirm: how should I proceed?`
+   - `Options: apply_now | plan_first | analyze_only`
+4. If ambiguous: `Capability: X (default)` + `Override: /workflow`
+
+# Paths
+
+- Session: `AGENT.md`
+- Matrix: `skill-routing-matrix.json`
+- CLI preview: `capint route "<task>"`

package/registry.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": "1.0",
+  "core": ["capability-router"],
+  "recommended": [
+    "context-memory-bridge",
+    "localization-hub",
+    "refactor",
+    "systematic-debugging"
+  ],
+  "optional": [],
+  "project_added": []
+}

package/scripts/release-check.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { spawnSync } from "child_process";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.join(__dirname, "..");
+
+const steps = [
+  ["validate-matrix", ["node", "scripts/validate-matrix.mjs"]],
+  ["manifest-schema", ["node", "tests/manifest-schema.test.mjs"]],
+  ["contract-snapshot", ["node", "tests/contract-snapshot.test.mjs"]],
+  ["scaffold-policy", ["node", "tests/scaffold-policy.test.mjs"]],
+  ["event-log", ["node", "tests/event-log.test.mjs"]],
+  ["faz6", ["node", "tests/faz6.test.mjs"]],
+  ["not-installed", ["node", "tests/not-installed.test.mjs"]],
+  ["init-integration", ["node", "tests/init-integration.test.mjs"]],
+  ["ide-sync", ["node", "tests/ide-sync.test.mjs"]],
+  ["uninstall", ["node", "tests/uninstall.test.mjs"]],
+  ["upgrade", ["node", "tests/upgrade.test.mjs"]],
+  ["local-adapters", ["node", "tests/local-adapters.test.mjs"]],
+  ["route-smoke", ["node", "bin/capint.js", "route", "i18n çeviri"]],
+  ["doctor-smoke", ["node", "bin/capint.js", "doctor"]],
+  ["audit-smoke", ["node", "bin/capint.js", "audit", "--json"]]
+];
+
+let failed = 0;
+for (const [name, cmd] of steps) {
+  const r = spawnSync(cmd[0], cmd.slice(1), { cwd: root, encoding: "utf-8" });
+  if (r.status === 0) {
+    console.log(`ok ${name}`);
+  } else {
+    console.error(`fail ${name}`);
+    if (r.stdout) process.stdout.write(r.stdout);
+    if (r.stderr) process.stderr.write(r.stderr);
+    failed++;
+  }
+}
+
+process.exit(failed > 0 ? 1 : 0);