avorelo 0.1.0 → 0.3.0

package/scripts/lib/workflow-signals.js

@@ -1,419 +0,0 @@
-"use strict";
-
-// Workflow signals: collects local deterministic signals for workflow discipline.
-// All collectors fail open — missing state/modules return unknown, never throw.
-
-const fs = require("fs");
-const path = require("path");
-const { execSync } = require("child_process");
-
-const REENTRY_MEMORY_REL = ".claude/cco/state/reentry-memory.jsonl";
-const BUDGET_REL = ".claude/cco/state/context-budget.json";
-const RECEIPTS_REL = ".claude/cco/receipts";
-const PROOF_CANONICAL_REL = ".claude/cco/state";
-const REENTRY_STATE_REL = ".claude/cco/state/reentry-state.json";
-const TASK_COMPLETED_DIR_REL = ".claude/cco/state";
-const MAX_EVIDENCE_BYTES = 64 * 1024;
-
-// --- Repo state ---
-
-function inferRepoState(options = {}) {
-  // Accept injected output for tests; otherwise run git safely.
-  const { cwd, _gitStatusOutput } = options;
-
-  let raw;
-  if (typeof _gitStatusOutput === "string") {
-    raw = _gitStatusOutput;
-  } else {
-    try {
-      raw = execSync("git status --porcelain", {
-        cwd: cwd || process.cwd(),
-        timeout: 3000,
-        stdio: ["pipe", "pipe", "pipe"],
-      }).toString("utf8");
-    } catch {
-      return { repoState: "unknown", changedFilesCount: 0, hasStagedChanges: false, hasUnstagedChanges: false };
-    }
-  }
-
-  const lines = raw.split("\n").filter((l) => l.trim().length > 0);
-  if (lines.length === 0) {
-    return { repoState: "clean", changedFilesCount: 0, hasStagedChanges: false, hasUnstagedChanges: false };
-  }
-
-  // Staged: first char is not space/?
-  // Unstaged: second char is not space/?
-  const staged = lines.filter((l) => l.length >= 2 && l[0] !== " " && l[0] !== "?").length;
-  const unstaged = lines.filter((l) => l.length >= 2 && l[1] !== " " && l[1] !== "?").length;
-
-  return {
-    repoState: "modified",
-    changedFilesCount: lines.length,
-    hasStagedChanges: staged > 0,
-    hasUnstagedChanges: unstaged > 0,
-  };
-}
-
-// --- Context pressure ---
-
-function inferContextPressure(options = {}) {
-  const { cwd, budgetStatus } = options;
-
-  // Accept pre-built budgetStatus (from dashboard) to avoid double-loading.
-  if (budgetStatus && typeof budgetStatus === "object") {
-    const s = budgetStatus.status;
-    if (s === "critical") return { contextPressure: "critical" };
-    if (s === "warn") return { contextPressure: "warn" };
-    if (s === "ok") return { contextPressure: "ok" };
-    return { contextPressure: "unknown" };
-  }
-
-  // Otherwise try to read the stored budget state file directly.
-  try {
-    const p = path.join(cwd || process.cwd(), BUDGET_REL);
-    const data = JSON.parse(fs.readFileSync(p, "utf8"));
-    if (data && typeof data.usedPercent === "number" && typeof data.warnAtPercent === "number") {
-      const pct = data.usedPercent;
-      const blockAt = data.blockAtPercent || 90;
-      const warnAt = data.warnAtPercent || 70;
-      if (pct >= blockAt) return { contextPressure: "critical" };
-      if (pct >= warnAt) return { contextPressure: "warn" };
-      return { contextPressure: "ok" };
-    }
-  } catch {
-    // file missing or parse error — treat as unknown
-  }
-
-  return { contextPressure: "unknown" };
-}
-
-// --- Reentry memory state ---
-
-function inferReentryState(options = {}) {
-  const { cwd } = options;
-  try {
-    const p = path.join(cwd || process.cwd(), REENTRY_MEMORY_REL);
-    const stat = fs.statSync(p);
-    if (stat.isFile() && stat.size > 0) {
-      return { reentryState: "available" };
-    }
-    return { reentryState: "missing" };
-  } catch {
-    return { reentryState: "missing" };
-  }
-}
-
-// --- Validation / proof state ---
-
-// Conservative: look for any receipt in the receipts dir, or canonical proof files.
-// missing = no receipt files at all
-// partial = at least one receipt exists
-// passed = latest receipt has outcome "completed" or "success"
-function inferValidationState(options = {}) {
-  const { cwd } = options;
-  try {
-    const receiptsDir = path.join(cwd || process.cwd(), RECEIPTS_REL);
-    const files = fs.readdirSync(receiptsDir).filter((f) => f.endsWith(".json"));
-    if (files.length === 0) {
-      return { validationState: "missing" };
-    }
-
-    // Check the most recent receipt for completion status.
-    const sorted = files
-      .map((f) => ({ f, mtime: fs.statSync(path.join(receiptsDir, f)).mtimeMs }))
-      .sort((a, b) => b.mtime - a.mtime);
-
-    try {
-      const latest = JSON.parse(fs.readFileSync(path.join(receiptsDir, sorted[0].f), "utf8"));
-      // Receipt schema: result.status is the completion_status string.
-      // Valid values from proof-receipt.js: "completed", "safe_stop", "partial",
-      // "ended_without_completion", "unknown".
-      const status = latest?.result?.status || "";
-      if (status === "completed" || status === "safe_stop") {
-        return { validationState: "passed" };
-      }
-      if (status === "partial") {
-        return { validationState: "partial" };
-      }
-    } catch {
-      // can't read latest; fall through to partial
-    }
-
-    return { validationState: "partial" };
-  } catch {
-    return { validationState: "missing" };
-  }
-}
-
-// --- Risk / agent security state ---
-
-// Maps existing agent-security mode and scan data to a simple riskLevel.
-// Conservative: only escalate to high if there is evidence from an existing scan.
-function inferRiskState(options = {}) {
-  const { cwd, agentSecuritySurface, agentSecurityMode } = options;
-
-  // Use pre-built surface from dashboard if available.
-  if (agentSecuritySurface && typeof agentSecuritySurface === "object") {
-    const mode = agentSecuritySurface.mode || "off";
-    const summary = agentSecuritySurface.summary || {};
-    const highRisk = Number(summary.highRisk || 0);
-    const mediumRisk = Number(summary.mediumRisk || 0);
-
-    if (highRisk > 0) return { riskLevel: "high", agentSecurityState: mode };
-    if (mode === "warn" || mode === "approve" || mode === "enforce") return { riskLevel: "medium", agentSecurityState: mode };
-    if (mediumRisk > 0) return { riskLevel: "medium", agentSecurityState: mode };
-    if (mode === "visibility") return { riskLevel: "low", agentSecurityState: mode };
-    return { riskLevel: "low", agentSecurityState: mode };
-  }
-
-  // Fall back to config mode only if surface not available.
-  const mode = agentSecurityMode || "off";
-  if (mode === "warn" || mode === "approve" || mode === "enforce") return { riskLevel: "medium", agentSecurityState: mode };
-  if (mode === "visibility") return { riskLevel: "low", agentSecurityState: mode };
-  return { riskLevel: "low", agentSecurityState: mode };
-}
-
-// --- Session evidence collection ---
-
-// Reads latest task-completed and reentry-state files for keyword classification.
-// Bounded by MAX_EVIDENCE_BYTES; fails open with empty string on any error.
-function collectTaskEvidence(cwd) {
-  const base = cwd || process.cwd();
-  const parts = [];
-
-  // Latest task-completed-*.json: nextBestAction, topReasonCodes
-  try {
-    const dir = path.join(base, TASK_COMPLETED_DIR_REL);
-    const files = fs
-      .readdirSync(dir)
-      .filter((f) => f.startsWith("task-completed-") && f.endsWith(".json"))
-      .map((f) => ({ f, mtime: fs.statSync(path.join(dir, f)).mtimeMs }))
-      .sort((a, b) => b.mtime - a.mtime);
-    if (files.length > 0) {
-      const raw = fs.readFileSync(path.join(dir, files[0].f), "utf8");
-      if (raw.length <= MAX_EVIDENCE_BYTES) {
-        const data = JSON.parse(raw);
-        if (data.nextBestAction) parts.push(data.nextBestAction);
-        if (Array.isArray(data.topReasonCodes)) parts.push(data.topReasonCodes.join(" "));
-      }
-    }
-  } catch {
-    // ignore
-  }
-
-  // Stop events: latest stop-*.json: reason, message, nextBoundedAction
-  try {
-    const dir = path.join(base, TASK_COMPLETED_DIR_REL);
-    const files = fs
-      .readdirSync(dir)
-      .filter((f) => f.startsWith("stop-") && f.endsWith(".json"))
-      .map((f) => ({ f, mtime: fs.statSync(path.join(dir, f)).mtimeMs }))
-      .sort((a, b) => b.mtime - a.mtime);
-    if (files.length > 0) {
-      const raw = fs.readFileSync(path.join(dir, files[0].f), "utf8");
-      if (raw.length <= MAX_EVIDENCE_BYTES) {
-        const data = JSON.parse(raw);
-        if (data.reason) parts.push(data.reason);
-        if (data.message) parts.push(data.message);
-        if (data.nextBoundedAction) parts.push(data.nextBoundedAction);
-      }
-    }
-  } catch {
-    // ignore
-  }
-
-  // Reentry state: nextAction, resumeHint, unresolvedRisk
-  try {
-    const p = path.join(base, REENTRY_STATE_REL);
-    const raw = fs.readFileSync(p, "utf8");
-    if (raw.length <= MAX_EVIDENCE_BYTES) {
-      const data = JSON.parse(raw);
-      if (data.nextAction) parts.push(data.nextAction);
-      if (data.resumeHint) parts.push(data.resumeHint);
-      if (data.unresolvedRisk) parts.push(data.unresolvedRisk);
-    }
-  } catch {
-    // ignore
-  }
-
-  return parts.join(" ").toLowerCase();
-}
-
-// --- Keyword-based task type classification ---
-
-// Deterministic keyword rules. Returns { taskType, confidence, reasonCodes }.
-// Confidence: "high" = dominant signal, "medium" = at least one match, "low" = weak.
-function classifyTaskTypeFromText(text) {
-  if (!text || text.trim().length === 0) {
-    return { taskType: "unknown", confidence: "low", reasonCodes: [] };
-  }
-
-  const t = text.toLowerCase();
-
-  // PR/finalization patterns — require specific finalization language; "release" excluded (too generic).
-  const prKeywords = ["pull request", " pr ", "merge request", "git commit", "ship the", "shipping", "final check", "proof bundle", "ready to merge"];
-  const prMatches = prKeywords.filter((k) => t.includes(k));
-
-  // Bug patterns
-  const bugKeywords = ["failed test", "failing test", "regression", "bug", "error", "exception", " fix ", "broken", "failure", "failing", "debug", "diagnose"];
-  const bugMatches = bugKeywords.filter((k) => t.includes(k));
-
-  // Feature patterns — "add ", "support ", "build ", "create " excluded: too generic in system messages.
-  const featureKeywords = ["implement", "introduce", "new feature", "capability", "feature"];
-  const featureMatches = featureKeywords.filter((k) => t.includes(k));
-
-  // Refactor patterns
-  const refactorKeywords = ["refactor", "cleanup", "clean up", "simplify", "restructure", "rename", "architecture", "extract ", "consolidate", "reorganize"];
-  const refactorMatches = refactorKeywords.filter((k) => t.includes(k));
-
-  const bugScore = bugMatches.length;
-  const featureScore = featureMatches.length;
-  const refactorScore = refactorMatches.length;
-  const prScore = prMatches.length;
-
-  // PR wins only with explicit finalization signals
-  if (prScore >= 1 && bugScore === 0) {
-    return { taskType: "pr", confidence: prScore >= 2 ? "high" : "medium", reasonCodes: prMatches };
-  }
-
-  // Bug wins over feature/refactor
-  if (bugScore > 0 && bugScore >= featureScore && bugScore >= refactorScore) {
-    return { taskType: "bug", confidence: bugScore >= 3 ? "high" : "medium", reasonCodes: bugMatches };
-  }
-
-  // Feature beats refactor if it has more matches
-  if (featureScore > 0 && featureScore >= refactorScore) {
-    return { taskType: "feature", confidence: featureScore >= 2 ? "high" : "medium", reasonCodes: featureMatches };
-  }
-
-  if (refactorScore > 0) {
-    return { taskType: "refactor", confidence: refactorScore >= 2 ? "high" : "medium", reasonCodes: refactorMatches };
-  }
-
-  return { taskType: "unknown", confidence: "low", reasonCodes: [] };
-}
-
-// --- Task type inference ---
-
-// Only infer taskType when there is a deterministic local signal.
-// No NLP, no LLM calls. Returns additive fields taskTypeConfidence, taskTypeSource, taskTypeReasonCodes.
-function inferTaskType(options = {}) {
-  const { cwd, validationState, hasStagedChanges } = options;
-
-  // Staged changes + partial/passed validation → likely PR/finalization candidate
-  if (hasStagedChanges && (validationState === "partial" || validationState === "passed")) {
-    return { taskType: "pr", taskTypeConfidence: "high", taskTypeSource: "receipt+staged", taskTypeReasonCodes: ["STAGED_CHANGES", "VALIDATION_" + (validationState || "unknown").toUpperCase()] };
-  }
-
-  // Try to detect incomplete/stalled session from most recent receipt.
-  // "ended_without_completion" → likely a bug or unexpected stop, suggest diagnose.
-  let receiptStatus = "";
-  try {
-    const receiptsDir = path.join(cwd || process.cwd(), RECEIPTS_REL);
-    const files = fs.readdirSync(receiptsDir).filter((f) => f.endsWith(".json"));
-    if (files.length > 0) {
-      const sorted = files
-        .map((f) => ({ f, mtime: fs.statSync(path.join(receiptsDir, f)).mtimeMs }))
-        .sort((a, b) => b.mtime - a.mtime);
-      const latest = JSON.parse(fs.readFileSync(path.join(receiptsDir, sorted[0].f), "utf8"));
-      receiptStatus = latest?.result?.status || "";
-    }
-  } catch {
-    // ignore
-  }
-
-  if (receiptStatus === "ended_without_completion") {
-    // Check session evidence for more specific classification before defaulting to bug.
-    const evidenceText = collectTaskEvidence(cwd);
-    const classified = classifyTaskTypeFromText(evidenceText);
-    if (classified.confidence !== "low" && classified.taskType !== "unknown") {
-      return {
-        taskType: classified.taskType,
-        taskTypeConfidence: classified.confidence,
-        taskTypeSource: "session-evidence",
-        taskTypeReasonCodes: classified.reasonCodes,
-      };
-    }
-    return { taskType: "bug", taskTypeConfidence: "medium", taskTypeSource: "receipt", taskTypeReasonCodes: ["ENDED_WITHOUT_COMPLETION"] };
-  }
-
-  // No receipt signal — try session evidence directly.
-  const evidenceText = collectTaskEvidence(cwd);
-  const classified = classifyTaskTypeFromText(evidenceText);
-  if (classified.confidence !== "low" && classified.taskType !== "unknown") {
-    return {
-      taskType: classified.taskType,
-      taskTypeConfidence: classified.confidence,
-      taskTypeSource: "session-evidence",
-      taskTypeReasonCodes: classified.reasonCodes,
-    };
-  }
-
-  return { taskType: "unknown", taskTypeConfidence: "low", taskTypeSource: "none", taskTypeReasonCodes: [] };
-}
-
-// --- Master signal collector ---
-
-// Collects all signals. Accepts pre-built surfaces to avoid redundant work.
-// Options:
-//   cwd               - working directory (default: process.cwd())
-//   budgetStatus      - pre-built budgetStatus from dashboard (optional)
-//   agentSecuritySurface - pre-built agentSecurity from dashboard (optional)
-//   agentSecurityMode - raw config mode (fallback if surface absent)
-//   _gitStatusOutput  - injected git output for tests
-function collectWorkflowSignals(options = {}) {
-  const cwd = options.cwd || process.cwd();
-
-  const repoSignals = inferRepoState({ cwd, _gitStatusOutput: options._gitStatusOutput });
-  const pressureSignals = inferContextPressure({ cwd, budgetStatus: options.budgetStatus });
-  const reentrySignals = inferReentryState({ cwd });
-  const validationSignals = inferValidationState({ cwd });
-  const riskSignals = inferRiskState({
-    cwd,
-    agentSecuritySurface: options.agentSecuritySurface,
-    agentSecurityMode: options.agentSecurityMode,
-  });
-  const taskSignals = inferTaskType({
-    cwd,
-    repoState: repoSignals.repoState,
-    validationState: validationSignals.validationState,
-    hasStagedChanges: repoSignals.hasStagedChanges,
-  });
-
-  return {
-    repoState: repoSignals.repoState,
-    changedFilesCount: repoSignals.changedFilesCount,
-    hasStagedChanges: repoSignals.hasStagedChanges,
-    hasUnstagedChanges: repoSignals.hasUnstagedChanges,
-    contextPressure: pressureSignals.contextPressure,
-    reentryState: reentrySignals.reentryState,
-    validationState: validationSignals.validationState,
-    riskLevel: riskSignals.riskLevel,
-    agentSecurityState: riskSignals.agentSecurityState,
-    taskType: taskSignals.taskType,
-    taskTypeConfidence: taskSignals.taskTypeConfidence || "low",
-    taskTypeSource: taskSignals.taskTypeSource || "none",
-    taskTypeReasonCodes: taskSignals.taskTypeReasonCodes || [],
-  };
-}
-
-// Convenience: build the full workflow-discipline input from local signals.
-// Merges auto-detected signals with any caller-provided overrides.
-function buildWorkflowInput(options = {}) {
-  const signals = collectWorkflowSignals(options);
-  // Caller overrides take precedence over auto-detected signals.
-  return { ...signals, ...(options.overrides || {}) };
-}
-
-module.exports = {
-  inferRepoState,
-  inferContextPressure,
-  inferReentryState,
-  inferValidationState,
-  inferRiskState,
-  inferTaskType,
-  collectWorkflowSignals,
-  buildWorkflowInput,
-  collectTaskEvidence,
-  classifyTaskTypeFromText,
-};

package/scripts/lib/workspace-map.js

@@ -1,281 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const { ensureCcoDirs, safeWriteJson, safeReadJson, nowIso } = require("./fsx");
-
-const WORKSPACE_MAP_REL_PATH = ".claude/cco/state/workspace-map.json";
-const IGNORED_DIRS = new Set([
-  ".git",
-  "node_modules",
-  "dist",
-  "build",
-  "coverage",
-  ".next",
-  ".turbo",
-  ".cache",
-  ".wasp",
-  ".avorelo",
-]);
-
-function normalize(value) {
-  return String(value || "").replace(/\\/g, "/");
-}
-
-function exists(cwd, relPathValue) {
-  return fs.existsSync(path.join(cwd, relPathValue));
-}
-
-function safeReadDir(absPath) {
-  try {
-    return fs.readdirSync(absPath, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-}
-
-function listFiles(cwd, relDir, matcher = () => true, limit = 50) {
-  const results = [];
-  const startAbs = path.join(cwd, relDir);
-
-  function walk(currentAbs, currentRel) {
-    if (results.length >= limit) return;
-    const entries = safeReadDir(currentAbs);
-    for (const entry of entries) {
-      if (results.length >= limit) break;
-      const entryRel = currentRel ? `${currentRel}/${entry.name}` : entry.name;
-      if (entry.isDirectory()) {
-        if (IGNORED_DIRS.has(entry.name)) continue;
-        walk(path.join(currentAbs, entry.name), entryRel);
-        continue;
-      }
-      const normalized = normalize(entryRel);
-      if (matcher(normalized)) {
-        results.push(normalized);
-      }
-    }
-  }
-
-  if (fs.existsSync(startAbs)) {
-    walk(startAbs, normalize(relDir));
-  }
-
-  return results;
-}
-
-function readPackageScripts(cwd) {
-  try {
-    const pkg = JSON.parse(fs.readFileSync(path.join(cwd, "package.json"), "utf8"));
-    return pkg.scripts || {};
-  } catch {
-    return {};
-  }
-}
-
-function readCapabilityPacks() {
-  try {
-    const { listPacks } = require("./capability-packs");
-    return listPacks().map((pack) => pack.id);
-  } catch {
-    return [];
-  }
-}
-
-function detectSurfaces(cwd) {
-  const packageScripts = readPackageScripts(cwd);
-  const docs = listFiles(cwd, "docs", (file) => file.endsWith(".md"), 80);
-  const tests = listFiles(cwd, "tests", (file) => /\.(js|ts|mjs)$/i.test(file), 80);
-  const skills = listFiles(cwd, "skills", (file) => /SKILL\.md$/i.test(file), 80);
-  const adapters = [];
-
-  if (exists(cwd, "bin/avorelo")) adapters.push("cli");
-  if (exists(cwd, ".claude/settings.json")) adapters.push("claude-code");
-  if (exists(cwd, ".avorelo/generated/codex/AGENTS.md")) adapters.push("codex");
-  if (exists(cwd, ".avorelo/generated/cursor/rules/avorelo.mdc")) adapters.push("cursor");
-  if (exists(cwd, ".avorelo/generated/gemini/GEMINI.md")) adapters.push("gemini");
-  if (exists(cwd, ".avorelo/generated/copilot/copilot-instructions.md")) adapters.push("copilot");
-  if (exists(cwd, "apps/public-web")) adapters.push("public-web");
-
-  return {
-    packageScripts,
-    docs,
-    tests,
-    skills,
-    adapters,
-    commands: Object.keys(packageScripts),
-    capabilityFiles: [
-      "scripts/lib/capability-registry.js",
-      "scripts/lib/capability-packs.js",
-      "scripts/lib/capability-recommender.js",
-      "scripts/lib/prompt-compiler.js",
-      "scripts/lib/agent-enforcement.js",
-      "scripts/lib/source-catalog.js",
-      "scripts/lib/workspace-map.js",
-      "scripts/lib/product-learning-events.js",
-    ].filter((file) => exists(cwd, file)),
-    statusFiles: [
-      "scripts/cco-status.js",
-      "scripts/cco-dashboard.js",
-      "scripts/lib/public-cli.js",
-    ].filter((file) => exists(cwd, file)),
-    evidencePaths: [
-      ".claude/cco/receipts",
-      ".claude/cco/evidence",
-      ".claude/cco/security",
-      ".claude/cco/events",
-      WORKSPACE_MAP_REL_PATH,
-    ].filter((file) => exists(cwd, file)),
-  };
-}
-
-function detectGaps(cwd, surfaces) {
-  const gaps = [];
-
-  if (!exists(cwd, "scripts/lib/source-catalog.js")) {
-    gaps.push("Reference source catalog is missing.");
-  }
-  if (!exists(cwd, WORKSPACE_MAP_REL_PATH)) {
-    gaps.push("Workspace Map artifact has not been generated yet.");
-  }
-  if (!exists(cwd, "docs/Product-Learning-Telemetry.md")) {
-    gaps.push("Product-learning telemetry doc is missing.");
-  }
-  if (!surfaces.skills.some((file) => file.startsWith("skills/avorelo/"))) {
-    gaps.push("Canonical Avorelo skills are missing.");
-  }
-  if (!exists(cwd, "scripts/avorelo-sync-adapters.js")) {
-    gaps.push("Thin adapter generator is missing.");
-  }
-  return gaps;
-}
-
-function buildCompactAgentContext(map, options = {}) {
-  const task = String(options.task || "").trim();
-  const relevantFiles = [];
-
-  if (/pricing|plan|upgrade/i.test(task)) {
-    relevantFiles.push("docs/Pricing-Capability-Mapping.md", "scripts/lib/plans.js", "scripts/lib/entitlements.js");
-  }
-  if (/workspace|navigation|map/i.test(task)) {
-    relevantFiles.push("scripts/lib/workspace-map.js", "scripts/lib/public-cli.js", "tests/workspace-map.test.js");
-  }
-  if (/source|skill|reference/i.test(task)) {
-    relevantFiles.push("scripts/lib/source-catalog.js", "scripts/avorelo-skills.js", "tests/source-catalog.test.js");
-  }
-  if (/telemetry|learning|event/i.test(task)) {
-    relevantFiles.push("scripts/lib/product-learning-events.js", "docs/Product-Learning-Telemetry.md");
-  }
-
-  const dedupedFiles = [...new Set(relevantFiles)].filter((file) => exists(options.cwd || process.cwd(), file));
-  const likelyDocs = map.docs.slice(0, 8);
-  const likelyTests = map.tests.slice(0, 8);
-
-  return {
-    relevantFiles: dedupedFiles,
-    likelyTests,
-    likelyDocs,
-    capabilitySurfaces: map.capabilityFiles.slice(0, 8),
-    safetyBoundaries: [
-      "Avoid editing generated evidence or temp folders unless the task is explicitly about them.",
-      "Do not trust external skill sources without source-catalog review.",
-      "Keep plugin-visible guidance thin and public-safe.",
-    ],
-    doNotTouch: [
-      ".tmp-*",
-      ".codex-worktree-runtime-*",
-      ".wasp",
-      "node_modules",
-    ],
-    nextAction: map.recommendedNextAction,
-  };
-}
-
-function generateWorkspaceMap(cwd, options = {}) {
-  ensureCcoDirs(cwd);
-  const surfaces = detectSurfaces(cwd);
-  const capabilityPackIds = readCapabilityPacks();
-  const gaps = detectGaps(cwd, surfaces);
-  const status = gaps.length === 0 ? "ready" : capabilityPackIds.length > 0 ? "partial" : "insufficient";
-
-  const workspaceMap = {
-    workspaceMapVersion: 1,
-    generatedAt: nowIso(),
-    cwd,
-    status,
-    capabilityPackIds,
-    capabilitiesMapped: surfaces.capabilityFiles.length,
-    surfacesMapped: surfaces.adapters.length + surfaces.commands.length + surfaces.statusFiles.length,
-    testsDetected: surfaces.tests.length,
-    docsDetected: surfaces.docs.length,
-    adaptersDetected: surfaces.adapters,
-    packageScripts: surfaces.packageScripts,
-    commandSurfaces: surfaces.commands,
-    capabilityFiles: surfaces.capabilityFiles,
-    statusFiles: surfaces.statusFiles,
-    docs: surfaces.docs.slice(0, 20),
-    tests: surfaces.tests.slice(0, 20),
-    skills: surfaces.skills.slice(0, 20),
-    evidencePaths: surfaces.evidencePaths,
-    gapsDetected: gaps.length,
-    gaps,
-    topGaps: gaps.slice(0, 5),
-    recommendedNextAction: gaps.length
-      ? gaps[0]
-      : "Use the Workspace Map artifact as compact agent context before broad repo scans.",
-  };
-
-  workspaceMap.compactAgentContext = buildCompactAgentContext(workspaceMap, {
-    cwd,
-    task: options.task || "",
-  });
-  workspaceMap.artifactPath = WORKSPACE_MAP_REL_PATH;
-  return workspaceMap;
-}
-
-function writeWorkspaceMap(cwd, options = {}) {
-  const map = generateWorkspaceMap(cwd, options);
-  safeWriteJson(cwd, WORKSPACE_MAP_REL_PATH, map);
-  if (map.gaps.includes("Workspace Map artifact has not been generated yet.")) {
-    map.gaps = map.gaps.filter((gap) => gap !== "Workspace Map artifact has not been generated yet.");
-    map.gapsDetected = map.gaps.length;
-    map.topGaps = map.gaps.slice(0, 5);
-    if (map.status === "partial" && map.gaps.length === 0) {
-      map.status = "ready";
-      map.recommendedNextAction = "Use the Workspace Map artifact as compact agent context before broad repo scans.";
-    }
-    safeWriteJson(cwd, WORKSPACE_MAP_REL_PATH, map);
-  }
-  return map;
-}
-
-function readWorkspaceMap(cwd) {
-  return safeReadJson(cwd, WORKSPACE_MAP_REL_PATH, null);
-}
-
-function formatWorkspaceMapText(map) {
-  if (!map) {
-    return "Workspace Map unavailable.";
-  }
-
-  return [
-    "Avorelo Workspace Map",
-    `Status: ${map.status}`,
-    `Capabilities mapped: ${map.capabilitiesMapped}`,
-    `Surfaces mapped: ${map.surfacesMapped}`,
-    `Docs detected: ${map.docsDetected}`,
-    `Tests detected: ${map.testsDetected}`,
-    `Adapters: ${map.adaptersDetected.join(", ") || "none"}`,
-    `Top gaps: ${map.topGaps.join(" | ") || "none"}`,
-    `Next: ${map.recommendedNextAction}`,
-    `Artifact: ${map.artifactPath}`,
-  ].join("\n");
-}
-
-module.exports = {
-  WORKSPACE_MAP_REL_PATH,
-  generateWorkspaceMap,
-  writeWorkspaceMap,
-  readWorkspaceMap,
-  formatWorkspaceMapText,
-  buildCompactAgentContext,
-};