@bcelep/capint 0.4.2 → 0.7.0

package/schemas/explanation.v1.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://capint.dev/schemas/explanation.v1.json",
+  "title": "CapInt Route Explanation",
+  "type": "object",
+  "required": [
+    "task_type_id",
+    "matched_keywords",
+    "winner",
+    "files_to_read",
+    "reason_summary",
+    "alternatives_considered"
+  ],
+  "properties": {
+    "task_type_id": { "type": ["string", "null"] },
+    "matched_keywords": { "type": "array", "items": { "type": "string" } },
+    "winner": {
+      "type": ["object", "null"],
+      "properties": {
+        "type": { "type": "string" },
+        "resource": { "type": "string" }
+      }
+    },
+    "files_to_read": { "type": "array", "items": { "type": "string" } },
+    "reason_summary": { "type": "string" },
+    "alternatives_considered": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "resource": { "type": "string" },
+          "type": { "type": "string" },
+          "confidence": { "type": ["number", "null"] }
+        }
+      }
+    },
+    "resolver_order": { "type": "array", "items": { "type": "string" } },
+    "files_intended": { "type": "array", "items": { "type": "string" } },
+    "workspace_boundary": {
+      "type": "object",
+      "properties": {
+        "violated": { "type": "boolean" },
+        "suspicious_paths": { "type": "array", "items": { "type": "string" } },
+        "override_hint": { "type": ["string", "null"] }
+      }
+    }
+  }
+}

package/schemas/explanation.v2.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://capint.dev/schemas/explanation.v2.json",
+  "title": "CapInt Route Explanation v2",
+  "type": "object",
+  "required": [
+    "task_type_id",
+    "matched_keywords",
+    "winner",
+    "files_to_read",
+    "reason_summary",
+    "alternatives_considered"
+  ],
+  "properties": {
+    "task_type_id": { "type": ["string", "null"] },
+    "matched_keywords": { "type": "array", "items": { "type": "string" } },
+    "winner": {
+      "type": ["object", "null"],
+      "properties": {
+        "type": { "type": "string" },
+        "resource": { "type": "string" }
+      }
+    },
+    "files_to_read": { "type": "array", "items": { "type": "string" } },
+    "reason_summary": { "type": "string" },
+    "reason_plain": { "type": "string" },
+    "tooltip": { "type": "string" },
+    "locale": { "enum": ["tr", "en"] },
+    "alternatives_considered": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "resource": { "type": "string" },
+          "type": { "type": "string" },
+          "confidence": { "type": ["number", "null"] }
+        }
+      }
+    },
+    "resolver_order": { "type": "array", "items": { "type": "string" } },
+    "files_intended": { "type": "array", "items": { "type": "string" } },
+    "workspace_boundary": {
+      "type": "object",
+      "properties": {
+        "violated": { "type": "boolean" },
+        "suspicious_paths": { "type": "array", "items": { "type": "string" } },
+        "override_hint": { "type": ["string", "null"] }
+      }
+    }
+  }
+}

package/schemas/ui-api.v1.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://capint.dev/schemas/ui-api.v1.json",
+  "title": "CapInt UI Wizard API",
+  "definitions": {
+    "RouteRequest": {
+      "type": "object",
+      "required": ["task"],
+      "properties": {
+        "task": { "type": "string", "minLength": 1 },
+        "locale": { "enum": ["tr", "en"] }
+      }
+    },
+    "RouteResponse": {
+      "type": "object",
+      "required": ["result", "text_report", "chat_copy"],
+      "properties": {
+        "result": {
+          "type": "object",
+          "required": ["execution_intent"],
+          "properties": {
+            "execution_intent": { "$ref": "execution-intent.v1.json" }
+          }
+        },
+        "text_report": { "type": "string" },
+        "chat_copy": { "type": "string" }
+      }
+    },
+    "HealthResponse": {
+      "type": "object",
+      "required": ["ok", "doctor", "status"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "doctor": { "type": "object" },
+        "status": {
+          "type": "object",
+          "properties": {
+            "skills_on_disk": { "type": "number" },
+            "core_skills": { "type": "number" },
+            "matrix_version": { "type": ["string", "null"] },
+            "capint_package": { "type": "string" }
+          }
+        }
+      }
+    },
+    "RecoverRequest": {
+      "type": "object",
+      "properties": {
+        "apply": { "type": "boolean", "default": false },
+        "latest": { "type": "boolean", "default": true }
+      }
+    },
+    "FeedbackRequest": {
+      "type": "object",
+      "properties": {
+        "rating": { "type": "integer", "minimum": 1, "maximum": 5 },
+        "comment": { "type": "string", "maxLength": 2000 },
+        "source": { "type": "string", "default": "ui" }
+      }
+    }
+  },
+  "paths": {
+    "/api/health": {
+      "get": { "response": { "$ref": "#/definitions/HealthResponse" } }
+    },
+    "/api/route": {
+      "post": {
+        "request": { "$ref": "#/definitions/RouteRequest" },
+        "response": { "$ref": "#/definitions/RouteResponse" }
+      }
+    },
+    "/api/recover": {
+      "post": {
+        "request": { "$ref": "#/definitions/RecoverRequest" },
+        "response": { "type": "object" }
+      }
+    },
+    "/api/feedback": {
+      "post": {
+        "request": { "$ref": "#/definitions/FeedbackRequest" },
+        "response": { "type": "object", "properties": { "ok": { "type": "boolean" } } }
+      }
+    }
+  }
+}

package/scripts/capint-task.ps1

@@ -0,0 +1,38 @@
+# CapInt task helper (PowerShell)
+# Usage: .\scripts\capint-task.ps1 "prd hazırla"
+#        $env:CAPINT_DEFAULT_CONFIRM="plan_first"; .\scripts\capint-task.ps1 "i18n"
+
+param(
+  [Parameter(Mandatory = $true, Position = 0)]
+  [string]$Task
+)
+
+$ErrorActionPreference = "Stop"
+$root = Split-Path -Parent $PSScriptRoot
+$capintJs = Join-Path $root "bin\capint.js"
+
+if (Get-Command capint -ErrorAction SilentlyContinue) {
+  $capint = @("capint")
+} elseif (Test-Path $capintJs) {
+  $capint = @("node", $capintJs)
+} else {
+  Write-Error "capint not found — npm install -g @bcelep/capint"
+}
+
+& @capint[0] @capint[1..($capint.Length - 1)] pipeline $Task --force 2>$null
+if ($LASTEXITCODE -ne 0) {
+  & @capint[0] @capint[1..($capint.Length - 1)] doctor
+}
+
+$json = & @capint[0] @capint[1..($capint.Length - 1)] route --json $Task | Out-String
+$data = $json | ConvertFrom-Json
+$ei = $data.execution_intent
+[PSCustomObject]@{
+  intent            = $ei.intent
+  capability        = $ei.capability
+  resolution        = $ei.resolution
+  resolution_status = $ei.resolution_status
+  plan              = $ei.plan
+  confirm_default   = $ei.confirm_default_option
+  files_to_read     = @($ei.explanation.files_to_read)
+} | ConvertTo-Json -Depth 5

package/scripts/capint-task.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# CapInt task helper — route + optional pipeline preflight
+# Usage: ./scripts/capint-task.sh "prd hazırla"
+#        CAPINT_DEFAULT_CONFIRM=plan_first ./scripts/capint-task.sh "i18n çeviri"
+
+set -euo pipefail
+
+TASK="${*:-}"
+if [ -z "$TASK" ]; then
+  echo 'Usage: capint-task.sh "your task text"' >&2
+  exit 1
+fi
+
+if command -v capint >/dev/null 2>&1; then
+  CAPINT=(capint)
+elif [ -f "$(dirname "$0")/../bin/capint.js" ]; then
+  CAPINT=(node "$(dirname "$0")/../bin/capint.js")
+else
+  echo "capint not found — npm install -g @bcelep/capint" >&2
+  exit 1
+fi
+
+"${CAPINT[@]}" pipeline "$TASK" --force 2>/dev/null || "${CAPINT[@]}" doctor
+"${CAPINT[@]}" route --json "$TASK" | node -e "
+const chunks = [];
+process.stdin.on('data', d => chunks.push(d));
+process.stdin.on('end', () => {
+  const data = JSON.parse(Buffer.concat(chunks).toString());
+  const ei = data.execution_intent;
+  console.log(JSON.stringify({
+    intent: ei.intent,
+    capability: ei.capability,
+    resolution: ei.resolution,
+    resolution_status: ei.resolution_status,
+    plan: ei.plan,
+    confirm_default: ei.confirm_default_option,
+    files_to_read: ei.explanation?.files_to_read || []
+  }, null, 2));
+});
+"

package/scripts/generate-schema-docs.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import crypto from "crypto";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.join(__dirname, "..");
+const schemaDir = path.join(root, "schemas");
+const outDir = path.join(root, "docs", "generated");
+
+const SCHEMAS = [
+  "execution-intent.v1.json",
+  "explanation.v2.json",
+  "ui-api.v1.json",
+  "explanation.v1.json"
+];
+
+function propsTable(schema) {
+  const props = schema.properties || {};
+  const req = new Set(schema.required || []);
+  const lines = ["| Field | Type | Required |", "|-------|------|----------|"];
+  for (const [name, def] of Object.entries(props)) {
+    const type = def.enum ? def.enum.join(" \\| ") : def.type || def.$ref || "object";
+    lines.push(`| \`${name}\` | ${type} | ${req.has(name) ? "yes" : "no"} |`);
+  }
+  return lines.join("\n");
+}
+
+function renderSchemaDoc(fileName, schema) {
+  const title = schema.title || fileName;
+  return `# ${title}
+
+> Auto-generated from \`schemas/${fileName}\`. Do not edit by hand.
+
+**$id:** \`${schema.$id || ""}\`
+
+## Properties
+
+${propsTable(schema)}
+
+## Raw schema
+
+\`\`\`json
+${JSON.stringify(schema, null, 2)}
+\`\`\`
+`;
+}
+
+function hashContent(content) {
+  return crypto.createHash("sha256").update(content).digest("hex").slice(0, 16);
+}
+
+function generate() {
+  fs.mkdirSync(outDir, { recursive: true });
+  const written = [];
+  for (const file of SCHEMAS) {
+    const src = path.join(schemaDir, file);
+    if (!fs.existsSync(src)) continue;
+    const schema = JSON.parse(fs.readFileSync(src, "utf-8"));
+    const base = file.replace(/\.json$/, "");
+    const md = renderSchemaDoc(file, schema);
+    const dest = path.join(outDir, `${base}.md`);
+    fs.writeFileSync(dest, md, "utf-8");
+    written.push(dest);
+  }
+  const index = `# CapInt generated schema docs
+
+${SCHEMAS.filter((f) => fs.existsSync(path.join(schemaDir, f)))
+  .map((f) => `- [${f.replace(/\.json$/, "")}](./${f.replace(/\.json$/, "")}.md)`)
+  .join("\n")}
+`;
+  fs.writeFileSync(path.join(outDir, "README.md"), index, "utf-8");
+  return written;
+}
+
+function check() {
+  const tmp = [];
+  for (const file of SCHEMAS) {
+    const src = path.join(schemaDir, file);
+    if (!fs.existsSync(src)) continue;
+    const schema = JSON.parse(fs.readFileSync(src, "utf-8"));
+    const expected = renderSchemaDoc(file, schema);
+    const dest = path.join(outDir, `${file.replace(/\.json$/, "")}.md`);
+    if (!fs.existsSync(dest)) {
+      console.error(`missing generated doc: ${path.relative(root, dest)}`);
+      process.exit(1);
+    }
+    const actual = fs.readFileSync(dest, "utf-8");
+    if (hashContent(actual) !== hashContent(expected)) {
+      console.error(`stale generated doc: ${path.relative(root, dest)} — run: node scripts/generate-schema-docs.mjs`);
+      process.exit(1);
+    }
+    tmp.push(dest);
+  }
+  console.log(`schema docs check ok (${tmp.length} files)`);
+}
+
+if (process.argv.includes("--check")) {
+  check();
+} else {
+  const files = generate();
+  console.log(`generated ${files.length} schema docs → docs/generated/`);
+}

package/scripts/release-check.mjs

@@ -8,6 +8,7 @@ const root = path.join(__dirname, "..");
 
 const steps = [
   ["validate-matrix", ["node", "scripts/validate-matrix.mjs"]],
+  ["validate-registry", ["node", "scripts/validate-registry.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"]],
@@ -19,9 +20,31 @@ const steps = [
   ["uninstall", ["node", "tests/uninstall.test.mjs"]],
   ["upgrade", ["node", "tests/upgrade.test.mjs"]],
   ["local-adapters", ["node", "tests/local-adapters.test.mjs"]],
+  ["explanation", ["node", "tests/explanation.test.mjs"]],
+  ["providers-doctor", ["node", "tests/providers-doctor.test.mjs"]],
+  ["stack", ["node", "tests/stack.test.mjs"]],
+  ["skill-audit", ["node", "tests/skill-audit.test.mjs"]],
+  ["cli-ui-parity", ["node", "tests/cli-ui-parity.test.mjs"]],
+  ["generate-schema-docs", ["node", "scripts/generate-schema-docs.mjs"]],
+  ["schema-docs-check", ["node", "scripts/generate-schema-docs.mjs", "--check"]],
+  ["workspace-boundary", ["node", "tests/workspace-boundary.test.mjs"]],
+  ["skill-disable", ["node", "tests/skill-disable.test.mjs"]],
+  ["recover", ["node", "tests/recover.test.mjs"]],
+  ["consult-status", ["node", "tests/consult-status.test.mjs"]],
+  ["ui-server", ["node", "tests/ui-server.test.mjs"]],
+  ["ui-wizard-e2e", ["node", "tests/ui-wizard.e2e.mjs"]],
+  ["pipeline", ["node", "tests/pipeline.test.mjs"]],
+  ["bundle-minimal", ["node", "tests/bundle-minimal.test.mjs"]],
   ["route-smoke", ["node", "bin/capint.js", "route", "i18n çeviri"]],
+  ["pipeline-smoke", ["node", "bin/capint.js", "pipeline", "i18n çeviri", "--force"]],
   ["doctor-smoke", ["node", "bin/capint.js", "doctor"]],
-  ["audit-smoke", ["node", "bin/capint.js", "audit", "--json"]]
+  ["audit-smoke", ["node", "bin/capint.js", "audit", "--json"]],
+  ["skill-audit-smoke", ["node", "bin/capint.js", "skill", "audit", "--json"]],
+  ["feedback-smoke", ["node", "bin/capint.js", "feedback", "--summary", "--json"]],
+  ["providers-doctor-smoke", ["node", "bin/capint.js", "providers", "doctor", "--json"]],
+  ["stack-doctor-smoke", ["node", "bin/capint.js", "stack", "doctor", "--json"]],
+  ["consult-smoke", ["node", "bin/capint.js", "consult", "debug login", "--json"]],
+  ["status-smoke", ["node", "bin/capint.js", "status", "--json"]]
 ];
 
 let failed = 0;

package/scripts/validate-registry.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.join(__dirname, "..");
+
+const REQUIRED_TOP = ["schema_version", "core", "recommended", "optional"];
+const TIERS = ["core", "recommended", "optional", "project_added"];
+
+function fail(msg) {
+  console.error(`registry validation error: ${msg}`);
+  process.exit(1);
+}
+
+function validateRegistry(registry) {
+  if (!registry || typeof registry !== "object") fail("root must be object");
+  for (const key of REQUIRED_TOP) {
+    if (!(key in registry)) fail(`missing top-level key: ${key}`);
+  }
+  if (!/^\d+\.\d+$/.test(String(registry.schema_version || ""))) {
+    fail("schema_version must be major.minor (e.g. 1.1)");
+  }
+  const seen = new Set();
+  for (const tier of TIERS) {
+    const list = registry[tier];
+    if (list == null) continue;
+    if (!Array.isArray(list)) fail(`${tier} must be array`);
+    for (const name of list) {
+      if (typeof name !== "string" || !name.trim()) fail(`${tier} entry must be non-empty string`);
+      if (seen.has(name)) fail(`duplicate skill name across tiers: ${name}`);
+      seen.add(name);
+    }
+  }
+  if (!registry.core.length) fail("core tier must not be empty");
+  console.log(
+    `registry valid (schema_version ${registry.schema_version}, ${seen.size} unique skills)`
+  );
+}
+
+const registryPath = process.argv[2] || path.join(root, "registry.json");
+if (!fs.existsSync(registryPath)) fail(`file not found: ${registryPath}`);
+validateRegistry(JSON.parse(fs.readFileSync(registryPath, "utf-8")));

package/skill-routing-matrix.json

@@ -1,5 +1,5 @@
 {
-  "schema_version": "1.2",
+  "schema_version": "1.3",
   "updated_at": "2026-05-30",
   "resolver_order": ["exact_keyword", "domain_rules", "classification_default"],
   "fallback_policy": {
@@ -12,9 +12,9 @@
     "heavy": "confirm"
   },
   "clarification_policy": {
-    "mode": "always_confirm",
+    "mode": "adaptive",
     "max_options": 3,
-    "default_option": "plan_first"
+    "default_option": "apply_now"
   },
   "verification_defaults": {
     "require_on_light": false,
@@ -57,7 +57,7 @@
   },
   "rules_domain_map": {
     "rules/security.md": {
-      "skills": ["security-hardening"],
+      "skills": ["security-and-hardening"],
       "weight_min": "medium"
     },
     "rules/testing.md": {
@@ -66,6 +66,21 @@
     }
   },
   "task_types": [
+    {
+      "id": "skill_route",
+      "capability": "capability-routing",
+      "phase": "meta",
+      "orchestration_pattern": "supervisor",
+      "keywords": ["which skill", "hangi skill", "route task", "capability"],
+      "weight_default": "light",
+      "requires_memory": "none",
+      "default_execution_policy": "confirm",
+      "providers": [
+        { "name": "skill", "type": "skill", "resource": "task-skill-router", "confidence_base": 0.91 }
+      ],
+      "skills": ["task-skill-router", "prismx-skill-gateway"],
+      "workflow": null
+    },
     {
       "id": "debug",
       "capability": "systematic-debugging",
@@ -131,6 +146,22 @@
       "skills": ["context-memory-bridge"],
       "workflow": null
     },
+    {
+      "id": "write_prd",
+      "capability": "spec-authoring",
+      "phase": "plan",
+      "orchestration_pattern": "pipeline",
+      "keywords": ["prd", "requirements", "user story", "gereksinim", "spec yaz", "product requirements"],
+      "weight_default": "medium",
+      "requires_memory": "optional",
+      "default_execution_policy": "confirm",
+      "providers": [
+        { "name": "workflow", "type": "workflow", "resource": "genesis", "confidence_base": 0.83 },
+        { "name": "skill", "type": "skill", "resource": "prd", "confidence_base": 0.8 }
+      ],
+      "skills": ["prd", "spec-writer", "brainstorming"],
+      "workflow": "/genesis"
+    },
     {
       "id": "workflow_override",
       "capability": "workflow-override",
@@ -145,6 +176,21 @@
       ],
       "skills": ["capability-router"],
       "workflow": null
+    },
+    {
+      "id": "workspace_scope",
+      "capability": "workspace-boundary",
+      "phase": "meta",
+      "orchestration_pattern": "supervisor",
+      "keywords": ["başka repo", "other repo", "cross repo", "dış proje", "workspace dışı", "outside workspace", "wrong repo"],
+      "weight_default": "medium",
+      "requires_memory": "none",
+      "default_execution_policy": "override",
+      "providers": [
+        { "name": "skill", "type": "skill", "resource": "prismx-skill-gateway", "confidence_base": 0.92 }
+      ],
+      "skills": ["prismx-skill-gateway"],
+      "workflow": null
     }
   ]
 }