@fusengine/harness 0.1.29 → 0.1.31

package/dist/cache/index.mjs

@@ -1,3 +1,3 @@
-import { a as queryHash, i as jaccardSimilar, n as summarizeIndex, r as compactMarkdown, t as loadIndex } from "../cache-BzbX-ztL.mjs";
-import { a as extractText, i as mcpCacheKey, n as cachePath, r as cacheStore, t as cacheLookup } from "../store-DeIsfMg5.mjs";
+import { n as jaccardSimilar, r as queryHash, t as compactMarkdown } from "../cache-C9z9LclL.mjs";
+import { a as extractText, i as mcpCacheKey, n as cachePath, o as loadIndex, r as cacheStore, s as summarizeIndex, t as cacheLookup } from "../store-PrNPm6So.mjs";
 export { cacheLookup, cachePath, cacheStore, compactMarkdown, extractText, jaccardSimilar, loadIndex, mcpCacheKey, queryHash, summarizeIndex };

package/dist/{cache-BzbX-ztL.mjs → cache-C9z9LclL.mjs}

@@ -1,4 +1,3 @@
-import { existsSync, readFileSync } from "node:fs";
 import { createHash } from "node:crypto";
 //#region src/cache/compact.ts
 const HTML_ENTITIES = {
@@ -54,33 +53,4 @@ function jaccardSimilar(a, b, threshold = .8) {
 	return inter / union > threshold;
 }
 //#endregion
-//#region src/cache/io.ts
-/** Read a JSON array from `path`; [] on missing/corrupt/non-array. */
-function loadIndex(path) {
-	try {
-		if (!existsSync(path)) return [];
-		const data = JSON.parse(readFileSync(path, "utf8"));
-		return Array.isArray(data) ? data : [];
-	} catch {
-		return [];
-	}
-}
-/** Summarize an index of `{ tool?, ts? }` entries. */
-function summarizeIndex(index) {
-	const byTool = {};
-	const timestamps = [];
-	for (const entry of index) {
-		if (typeof entry !== "object" || entry === null) continue;
-		const e = entry;
-		if (typeof e.tool === "string") byTool[e.tool] = (byTool[e.tool] ?? 0) + 1;
-		if (typeof e.ts === "string") timestamps.push(e.ts);
-	}
-	return {
-		total: index.length,
-		byTool,
-		oldestTs: timestamps.length ? timestamps.reduce((a, b) => a < b ? a : b) : null,
-		newestTs: timestamps.length ? timestamps.reduce((a, b) => a > b ? a : b) : null
-	};
-}
-//#endregion
-export { queryHash as a, jaccardSimilar as i, summarizeIndex as n, compactMarkdown as r, loadIndex as t };
+export { jaccardSimilar as n, queryHash as r, compactMarkdown as t };

package/dist/cli/bin.mjs

@@ -3,7 +3,7 @@ import { r as resolveTtlSec } from "../ttl-BG55s6HZ.mjs";
 import { t as detectHarness } from "../harness-C8Nxxyn_.mjs";
 import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-CXsV-wIJ.mjs";
 import { n as writeInitFile, t as initFor } from "../run-D91N4ul1.mjs";
-import { t as handleHook } from "../handle-nu3GYVek.mjs";
+import { t as handleHook } from "../handle-DW9cWdVt.mjs";
 //#region src/cli/bin.ts
 /**
 * harness — CLI for @fusengine/harness.
@@ -25,11 +25,22 @@ async function readStdin() {
 }
 const cmd = process.argv[2];
 if (cmd === "hook") {
-	const outcome = await handleHook(process.argv[3] ?? detectHarness().id, await readStdin(), {
+	const id = process.argv[3] ?? detectHarness().id;
+	const scopeArg = process.argv[4];
+	const scope = scopeArg !== void 0 && (/* @__PURE__ */ new Set([
+		"solid",
+		"rules",
+		"carto",
+		"security",
+		"changelog",
+		"aipilot"
+	])).has(scopeArg) ? scopeArg : "core";
+	const outcome = await handleHook(id, await readStdin(), {
 		now: Date.now(),
 		cwd: process.cwd(),
 		refsDir: process.env.FUSE_HARNESS_REFS,
-		windowMs: resolveTtlSec(process.env) * 1e3
+		windowMs: resolveTtlSec(process.env) * 1e3,
+		scope
 	});
 	if (outcome.stdout) process.stdout.write(outcome.stdout);
 	process.exit(outcome.exit);

package/dist/{skill-triggers-BZxov1es.mjs → describe-BYqhoV4c.mjs}

@@ -3,7 +3,8 @@ import { k as countLines } from "./evaluate-j3gRJ_ng.mjs";
 import { r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-Dd_x1-tZ.mjs";
 import { t as routeReferences } from "./router-D8cVrI-s.mjs";
 import { join } from "node:path";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
 //#region src/policy/detect-project.ts
 /** Keywords that signal a development task (APEX trigger). */
 const DEV_KEYWORDS = /\b(implement|create|build|fix|add|refactor|develop|feature|bug|update|modify|change|write|code)\b/i;
@@ -673,4 +674,364 @@ function skillTriggerGate(framework, content, refsRead, forcedSkill, cwd) {
 	};
 }
 //#endregion
-export { detectProjectType as _, MAX_EXA_RESULTS as a, detectCreationIntent as c, docConsultedGate as d, evaluateApex as f, detectModularArchitecture as g, DEV_KEYWORDS as h, frameworkSolidGate as i, APEX_GATES as l, solidReadGate as m, skillTriggerGate as n, MAX_TOKENS as o, freshnessGate as p, SKILL_TRIGGERS as r, capVerbosity as s, detectRequiredSkills as t, brainstormGate as u, isApexCommand as v, requiredArchSkill as y };
+//#region src/policy/claude-md-context.ts
+/** Dev-verb regex (FR/EN) that triggers the APEX preamble (case-insensitive). */
+const DEV_VERBS = /(cr[ée]er|impl[ée]menter|ajouter|d[ée]velopper|construire|build|refactor|migrer|implement|create|add|develop)/i;
+/**
+* Detect the project type from the cwd, reproducing the legacy Python logic:
+* package.json containing "next" → nextjs, else "react" → react; else
+* composer.json+artisan → laravel; else Package.swift / *.xcodeproj → swift;
+* else generic.
+* @param cwd - Project root to scan.
+* @returns The detected project type label.
+*/
+function detectClaudeMdProjectType(cwd) {
+	const pkg = join(cwd, "package.json");
+	if (existsSync(pkg)) try {
+		const content = readFileSync(pkg, "utf-8");
+		if (content.includes("next")) return "nextjs";
+		if (content.includes("react")) return "react";
+	} catch {}
+	if (existsSync(join(cwd, "composer.json")) && existsSync(join(cwd, "artisan"))) return "laravel";
+	if (existsSync(join(cwd, "Package.swift"))) return "swift";
+	try {
+		if (readdirSync(cwd).some((f) => f.endsWith(".xcodeproj"))) return "swift";
+	} catch {}
+	return "generic";
+}
+/**
+* Build the APEX instruction preamble for a development task.
+* @param projectType - Detected project type label.
+* @param maxLines - SOLID per-file line ceiling.
+* @returns The APEX instruction text.
+*/
+function buildApexInstruction(projectType, maxLines) {
+	return `INSTRUCTION: This is a development task. Use APEX methodology:
+
+**TRACKING FILE**: [project]/.claude/apex/task.json (auto-created on first Write/Edit)
+
+1. **ANALYZE** (MANDATORY - 3 AGENTS IN PARALLEL):
+   - explore-codebase + research-expert + ${projectType}-expert (framework expertise)\n   - Project type detected: ${projectType}\n\n2. **PLAN**: Use TaskCreate to break down tasks (<${maxLines} lines per file)\n\n3. **EXECUTE**: ${projectType}-expert, follow SOLID principles, split at ${maxLines - 10} lines\n\n4. **EXAMINE**: Run sniper agent after ANY modification\n\n**IMPORTANT**: Read .claude/apex/task.json to check documentation status before writing code.`;
+}
+/**
+* Build the UserPromptSubmit injection text: read `~/.claude/CLAUDE.md` and,
+* when the prompt matches a dev verb, prepend the APEX instruction. Returns
+* `null` when CLAUDE.md is absent/unreadable (the hook then emits nothing).
+* @param prompt - The raw user prompt.
+* @param cwd - Project root (for project-type detection).
+* @returns The injection text, or `null` to emit nothing.
+*/
+function buildClaudeMdContext(prompt, cwd) {
+	const claudeMd = join(homedir(), ".claude", "CLAUDE.md");
+	if (!existsSync(claudeMd)) return null;
+	let claudeContent;
+	try {
+		claudeContent = readFileSync(claudeMd, "utf-8");
+	} catch {
+		return null;
+	}
+	if (!DEV_VERBS.test(prompt)) return `# CLAUDE.md\n${claudeContent}`;
+	return `${buildApexInstruction(detectClaudeMdProjectType(cwd), resolveMaxLines())}\n\n# CLAUDE.md\n${claudeContent}`;
+}
+//#endregion
+//#region src/policy/apex-task-context.ts
+/**
+* Read the current task state from `task.json`, reproducing the legacy Python
+* logic. Any read/parse error falls back to `("1", "", "analyze", "none")`.
+* @param taskFile - Absolute path to `.claude/apex/task.json`.
+* @returns The parsed {@link ApexTaskState}.
+*/
+function loadApexTaskState(taskFile) {
+	try {
+		const data = JSON.parse(readFileSync(taskFile, "utf-8"));
+		const id = String(data.current_task ?? "1");
+		const task = (data.tasks ?? {})[id] ?? {};
+		const subject = typeof task.subject === "string" ? task.subject : "";
+		const phase = typeof task.phase === "string" ? task.phase : "analyze";
+		const consultedMap = task.doc_consulted ?? {};
+		return {
+			id,
+			subject,
+			phase,
+			docs: Object.entries(consultedMap).filter(([, v]) => typeof v === "object" && v !== null && v.consulted === true).map(([k]) => k).join(", ") || "none"
+		};
+	} catch {
+		return {
+			id: "1",
+			subject: "",
+			phase: "analyze",
+			docs: "none"
+		};
+	}
+}
+/**
+* Build the APEX context string injected into a Task sub-agent prompt.
+* @param state - The parsed task state.
+* @param maxLines - SOLID per-file line ceiling.
+* @returns The injection text.
+*/
+function buildApexTaskContext(state, maxLines) {
+	return `⚠️ APEX MODE - Read .claude/apex/AGENTS.md for rules\n\nCurrent: Task #${state.id} - ${state.subject} (Phase: ${state.phase})\nDocs consulted: ${state.docs}\n\nAgent must:\n1. Read task.json → find last 3 completed tasks\n2. Read their notes in docs/ (task-{ID}-{subject}.md)\n3. TaskList → see pending tasks\n4. TaskUpdate(in_progress) → before starting\n5. Apply SOLID (files < ${maxLines} lines)\n6. Write notes to docs/task-{ID}-{subject}.md\n7. TaskUpdate(completed) → triggers auto-commit`;
+}
+/**
+* Build the PreToolUse Task injection, gated on the existence of the project's
+* `.claude/apex/` directory. Returns `null` when APEX is not active (no dir).
+* @param projectRoot - `CLAUDE_PROJECT_DIR` or cwd.
+* @returns The injection text, or `null` to emit nothing.
+*/
+function buildApexTaskInjection(projectRoot) {
+	const apexDir = join(projectRoot, ".claude", "apex");
+	if (!existsSync(apexDir)) return null;
+	return buildApexTaskContext(loadApexTaskState(join(apexDir, "task.json")), resolveMaxLines());
+}
+//#endregion
+//#region src/policy/cartographer/indicators.ts
+/**
+* Cartographer indicators — pure data sets used to detect a project root and to
+* exclude noise directories when walking a tree. Ports the constant tables from
+* `generate_project_map.py` / `write_recursive.py`.
+*/
+/** Filenames whose presence marks a directory as a project root. */
+const PROJECT_INDICATORS = /* @__PURE__ */ new Set([
+	"package.json",
+	"deno.json",
+	"bun.lockb",
+	"bun.lock",
+	"tsconfig.json",
+	"package-lock.json",
+	"yarn.lock",
+	"pnpm-lock.yaml",
+	"pnpm-workspace.yaml",
+	"composer.json",
+	"artisan",
+	"Cargo.toml",
+	"rust-toolchain.toml",
+	"go.mod",
+	"pyproject.toml",
+	"setup.py",
+	"setup.cfg",
+	"Pipfile",
+	"requirements.txt",
+	"environment.yml",
+	"Gemfile",
+	"Package.swift",
+	"Podfile",
+	"pubspec.yaml",
+	"pom.xml",
+	"build.gradle",
+	"build.gradle.kts",
+	"settings.gradle",
+	"build.sbt",
+	"Makefile",
+	"CMakeLists.txt",
+	"meson.build",
+	"configure.ac",
+	"Directory.Build.props",
+	"global.json",
+	"mix.exs",
+	"rebar.config",
+	"project.clj",
+	"deps.edn",
+	"stack.yaml",
+	"cabal.project",
+	"dune-project",
+	"build.zig",
+	"gleam.toml",
+	"v.mod",
+	"Project.toml",
+	"DESCRIPTION",
+	"cpanfile",
+	"Makefile.PL",
+	".luacheckrc",
+	"astro.config.mjs",
+	"next.config.js",
+	"next.config.mjs",
+	"nuxt.config.ts",
+	"vite.config.ts",
+	"next.config.ts",
+	"angular.json",
+	"svelte.config.js",
+	"svelte.config.ts",
+	"main.tf",
+	"ansible.cfg",
+	"pulumi.yaml",
+	"cdk.json",
+	"Chart.yaml",
+	"wrangler.toml",
+	"fly.toml",
+	"turbo.json",
+	"nx.json",
+	"BUILD",
+	"WORKSPACE",
+	"Justfile",
+	"Taskfile.yml",
+	"docker-compose.yml",
+	"docker-compose.yaml",
+	"compose.yml",
+	"compose.yaml",
+	"Dockerfile",
+	".git"
+]);
+/** Directory names skipped entirely during the tree walk. */
+const EXCLUDE_DIRS = /* @__PURE__ */ new Set([
+	"node_modules",
+	".git",
+	".next",
+	".nuxt",
+	"dist",
+	"build",
+	".output",
+	"vendor",
+	"__pycache__",
+	".venv",
+	"venv",
+	".cartographer",
+	".claude",
+	".ruff_cache",
+	".DS_Store",
+	"coverage",
+	".turbo",
+	".vercel",
+	".netlify",
+	"Pods",
+	"DerivedData",
+	".build",
+	".swiftpm"
+]);
+//#endregion
+//#region src/policy/cartographer/frontmatter.ts
+/**
+* Frontmatter parsing — pure text helpers (no fs). Ports `parse_frontmatter.py`.
+*/
+const BLOCK_SCALARS = /* @__PURE__ */ new Set([
+	"|",
+	">",
+	"|+",
+	"|-",
+	">+",
+	">-"
+]);
+/** Escape regex metacharacters in an arbitrary field name. */
+function escapeRe(s) {
+	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+* Extract a single frontmatter field's value from `text`. Strips surrounding
+* quotes; skips YAML block-scalar markers. Returns "" when absent.
+* @param text - The full document text.
+* @param field - The frontmatter key to read.
+* @returns The field value, or "".
+*/
+function parseField(text, field) {
+	const fm = /^---\s*\n([\s\S]*?)\n---/.exec(text);
+	if (!fm || fm[1] === void 0) return "";
+	const lineRe = new RegExp(`^${escapeRe(field)}\\s*:\\s*(.+)$`);
+	for (const line of fm[1].split("\n")) {
+		const m = lineRe.exec(line);
+		if (!m || m[1] === void 0) continue;
+		const val = m[1].trim().replace(/^["']|["']$/g, "");
+		if (BLOCK_SCALARS.has(val)) continue;
+		return val;
+	}
+	return "";
+}
+/**
+* Derive a short description from the body following the frontmatter: the first
+* non-empty trimmed line, sliced to `maxLen`. Returns "" when none.
+* @param text - The full document text.
+* @param maxLen - Maximum length of the returned description.
+* @returns The body-derived description, or "".
+*/
+function parseBodyDesc(text, maxLen = 60) {
+	const m = /^---\s*\n[\s\S]*?\n---\s*\n([\s\S]*)/.exec(text);
+	if (!m || m[1] === void 0) return "";
+	for (const raw of m[1].split("\n")) {
+		const line = raw.trim();
+		if (line) return line.slice(0, maxLen);
+	}
+	return "";
+}
+//#endregion
+//#region src/policy/cartographer/entry.ts
+const ENTRY_RE = /^(.*?)\[([^\]]+)\]\(([^)]+)\)\s*(?:—|-{1,2})\s*(.*)$/;
+const ENRICH_RE = /^(?:.*?)\[([^\]]+)\]\(([^)]+)\)\s*(?:—|-{1,2})\s*(.+)$/;
+/**
+* Parse a `merge_index` tree line into its parts. Returns null on no match.
+* @param line - The raw tree line.
+* @returns The parsed entry, or null.
+*/
+function parseEntry(line) {
+	const m = ENTRY_RE.exec(line);
+	if (!m || m[1] === void 0 || m[2] === void 0 || m[3] === void 0 || m[4] === void 0) return null;
+	return {
+		prefix: m[1],
+		name: m[2],
+		path: m[3],
+		desc: m[4]
+	};
+}
+/**
+* Parse an enrichment line into `[path, desc]`, requiring a non-empty desc.
+* @param line - The raw index line.
+* @returns The `[path, desc]` pair, or null.
+*/
+function parseEnrichment(line) {
+	const m = ENRICH_RE.exec(line);
+	if (!m || m[2] === void 0 || m[3] === void 0) return null;
+	const desc = m[3].trim();
+	return desc ? [m[2], desc] : null;
+}
+//#endregion
+//#region src/policy/cartographer/describe.ts
+/**
+* File-description heuristics — pure text in, description out (no fs). Ports
+* `describe.py`.
+*/
+const SOURCE_SUFFIXES = /* @__PURE__ */ new Set([
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".py",
+	".swift"
+]);
+/**
+* First `# ` Markdown heading text (sans hashes), sliced to 60. "" when none.
+* @param text - The document text.
+* @returns The heading text, or "".
+*/
+function firstHeading(text) {
+	for (const line of text.split("\n")) if (line.startsWith("# ")) return line.replace(/^#+/, "").trim().slice(0, 60);
+	return "";
+}
+/**
+* First leading comment among the first 10 lines (`//`, `#` but not `#!`, or a
+* `"""`/`'''` docstring), sliced to 60. "" when none.
+* @param text - The source text.
+* @returns The comment text, or "".
+*/
+function firstComment(text) {
+	const lines = text.split("\n").slice(0, 10);
+	for (const raw of lines) {
+		const line = raw.trim();
+		if ((line.startsWith("//") || line.startsWith("#")) && !line.startsWith("#!")) return line.replace(/^[/#! ]+/, "").slice(0, 60);
+		if (line.startsWith("\"\"\"") || line.startsWith("'''")) return line.replace(/^['"\s]+|['"\s]+$/g, "").slice(0, 60);
+	}
+	return "";
+}
+/**
+* Derive a description from a file's suffix + text. For `.md`, the supplied
+* frontmatter `description` (truncated) wins over the first heading; for known
+* source suffixes, the first comment; else "".
+* @param suffix - The file extension (with dot).
+* @param text - The file text.
+* @param mdField - The pre-parsed frontmatter `description` (md only).
+* @returns The derived description, or "".
+*/
+function descFromText(suffix, text, mdField) {
+	if (suffix === ".md") return mdField.slice(0, 60) || firstHeading(text);
+	if (SOURCE_SUFFIXES.has(suffix)) return firstComment(text);
+	return "";
+}
+//#endregion
+export { solidReadGate as A, capVerbosity as C, docConsultedGate as D, brainstormGate as E, requiredArchSkill as F, detectModularArchitecture as M, detectProjectType as N, evaluateApex as O, isApexCommand as P, MAX_TOKENS as S, APEX_GATES as T, detectRequiredSkills as _, parseEntry as a, frameworkSolidGate as b, EXCLUDE_DIRS as c, buildApexTaskInjection as d, loadApexTaskState as f, detectClaudeMdProjectType as g, buildClaudeMdContext as h, parseEnrichment as i, DEV_KEYWORDS as j, freshnessGate as k, PROJECT_INDICATORS as l, buildApexInstruction as m, firstComment as n, parseBodyDesc as o, DEV_VERBS as p, firstHeading as r, parseField as s, descFromText as t, buildApexTaskContext as u, skillTriggerGate as v, detectCreationIntent as w, MAX_EXA_RESULTS as x, SKILL_TRIGGERS as y };

package/dist/freshness/index.mjs

@@ -1,3 +1,3 @@
 import { i as resolveSessions, n as formatDocSatisfactionStatus, r as isDocConsulted, t as formatDocDeny } from "../doc-helpers-Dd_x1-tZ.mjs";
-import { t as incrementTrivialEditCounter } from "../freshness-CezohJHo.mjs";
+import { t as incrementTrivialEditCounter } from "../freshness-otdUpuvP.mjs";
 export { formatDocDeny, formatDocSatisfactionStatus, incrementTrivialEditCounter, isDocConsulted, resolveSessions };

package/dist/{freshness-CezohJHo.mjs → freshness-otdUpuvP.mjs}

@@ -1,4 +1,4 @@
-import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "./json-io-xpTDuvtn.mjs";
+import { i as writeJsonFile, n as ensureDir, r as readJsonFile } from "./json-io-CAn72gI4.mjs";
 import { dirname } from "node:path";
 //#region src/freshness/trivial-edit-counter.ts
 /**