@chenmk/superflow 0.5.12 → 0.5.13

package/dist/domains/review/report.js

@@ -0,0 +1,62 @@
+import fs from "node:fs";
+import path from "node:path";
+const STATES = new Set([
+    "DONE", "DONE_WITH_CONCERNS", "BLOCKED", "NEEDS_CONTEXT",
+]);
+export function auditReviewReport(content, projectRoot) {
+    const lines = content.split(/\r?\n/);
+    const first = lines.find((line) => line.trim())?.trim() ?? "";
+    const state = STATES.has(first)
+        ? first
+        : null;
+    const issues = [];
+    if (!state)
+        issues.push("reviewer report must start with a four-state marker");
+    if (state === "DONE_WITH_CONCERNS" && !/^## Concerns\b/m.test(content)) {
+        issues.push("DONE_WITH_CONCERNS requires a Concerns section");
+    }
+    let findings = 0;
+    let inFindings = false;
+    for (const line of lines) {
+        if (/^## Findings\s*$/.test(line)) {
+            inFindings = true;
+            continue;
+        }
+        if (/^## /.test(line))
+            inFindings = false;
+        if (!inFindings)
+            continue;
+        if (!/^\s*-\s+/.test(line))
+            continue;
+        findings += 1;
+        const anchor = /(?:^|\s)([^\s:]+):([1-9]\d*)\b/.exec(line);
+        if (!anchor || !validAnchor(projectRoot, anchor[1], Number(anchor[2]))) {
+            issues.push(`invalid finding anchor: ${line.trim()}`);
+        }
+    }
+    return {
+        state,
+        eligibleForTriage: state === "DONE" && issues.length === 0,
+        findings,
+        issues,
+    };
+}
+function validAnchor(root, candidate, line) {
+    const absolute = path.resolve(root, candidate);
+    const relative = path.relative(root, absolute);
+    if (relative.startsWith("..") || path.isAbsolute(relative))
+        return false;
+    try {
+        const realRoot = fs.realpathSync(root);
+        const realFile = fs.realpathSync(absolute);
+        const realRelative = path.relative(realRoot, realFile);
+        if (realRelative.startsWith("..") || path.isAbsolute(realRelative))
+            return false;
+        const content = fs.readFileSync(realFile, "utf8");
+        return line <= content.split(/\r?\n/).length;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/domains/review/report.js.map

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

package/dist/domains/skill/registry.js

@@ -0,0 +1,87 @@
+const OWNER_PATTERN = /^[a-z][a-z0-9-]{1,31}$/;
+export function auditSkillRegistry(registry, assets) {
+    const errors = [];
+    const manifestSkills = unique(registry.skills);
+    const contracts = registry.contracts ?? [];
+    const byName = new Map();
+    for (const contract of contracts) {
+        if (!contract || typeof contract.name !== "string") {
+            errors.push("contract name is missing");
+            continue;
+        }
+        if (byName.has(contract.name)) {
+            errors.push(`duplicate contract: ${contract.name}`);
+            continue;
+        }
+        byName.set(contract.name, contract);
+        if (!OWNER_PATTERN.test(contract.owner)) {
+            errors.push(`invalid owner for ${contract.name}: ${contract.owner}`);
+        }
+        if (!nonEmptyList(contract.triggers)) {
+            errors.push(`triggers must not be empty: ${contract.name}`);
+        }
+        if (!nonEmptyList(contract.outputs)) {
+            errors.push(`outputs must not be empty: ${contract.name}`);
+        }
+        if (!Array.isArray(contract.excludes)) {
+            errors.push(`excludes must be an array: ${contract.name}`);
+        }
+        if (!Array.isArray(contract.neighbors)) {
+            errors.push(`neighbors must be an array: ${contract.name}`);
+        }
+    }
+    const missingContracts = manifestSkills.filter((name) => !byName.has(name));
+    for (const name of missingContracts) {
+        errors.push(`missing contract: ${name}`);
+    }
+    for (const name of byName.keys()) {
+        if (!manifestSkills.includes(name)) {
+            errors.push(`contract is not in manifest: ${name}`);
+        }
+    }
+    const mirrors = new Set(assets.en ?? []);
+    const missingMirrors = manifestSkills.filter((name) => !mirrors.has(name));
+    for (const name of missingMirrors) {
+        errors.push(`missing English mirror: ${name}`);
+    }
+    const known = new Set(manifestSkills);
+    for (const contract of contracts) {
+        for (const neighbor of contract.neighbors ?? []) {
+            if (!known.has(neighbor)) {
+                errors.push(`${contract.name} references unknown neighbor: ${neighbor}`);
+            }
+        }
+    }
+    const triggerOwners = new Map();
+    for (const contract of contracts) {
+        for (const trigger of contract.triggers ?? []) {
+            const normalized = trigger.trim().toLowerCase();
+            if (!normalized)
+                continue;
+            const previous = triggerOwners.get(normalized);
+            if (previous && previous !== contract.name) {
+                errors.push(`duplicate trigger '${trigger}' shared by ${previous} and ${contract.name}`);
+            }
+            else {
+                triggerOwners.set(normalized, contract.name);
+            }
+        }
+    }
+    return {
+        ok: errors.length === 0,
+        errors,
+        stats: {
+            manifestSkills: manifestSkills.length,
+            contracts: byName.size,
+            missingContracts: missingContracts.length,
+            missingMirrors: missingMirrors.length,
+        },
+    };
+}
+function unique(values) {
+    return [...new Set(Array.isArray(values) ? values : [])];
+}
+function nonEmptyList(values) {
+    return Array.isArray(values) && values.length > 0 && values.every((value) => typeof value === "string" && value.trim().length > 0);
+}
+//# sourceMappingURL=registry.js.map

package/dist/domains/skill/registry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenmk/superflow",
-  "version": "0.5.12",
+  "version": "0.5.13",
   "description": "SuperBridge Flow workflow CLI for Claude Code and Codex",
   "license": "MIT",
   "type": "module",

package/scripts/check-design-principles.mjs

@@ -10,6 +10,7 @@ const requirements = new Map([
       "docs/superflow-cli-design-principles.md",
       "docs/superflow-cli-evaluation-framework.md",
       "Codex、Claude",
+      "默认采用 ECC 治理",
     ],
   ],
   [
@@ -18,6 +19,7 @@ const requirements = new Map([
       "docs/superflow-cli-design-principles.md",
       "docs/superflow-cli-evaluation-framework.md",
       "docs/managed-work-design-principles.md",
+      "默认采用 ECC 治理",
     ],
   ],
   [
@@ -48,6 +50,7 @@ const requirements = new Map([
       "评价驱动维护",
       "Codex、Claude",
       "三个彼此独立但可衔接的入口",
+      "ECC 式能力治理",
     ],
   ],
   [
@@ -60,6 +63,7 @@ const requirements = new Map([
       "Evaluation-Driven Maintenance",
       "Codex and Claude",
       "three independent but composable entries",
+      "ECC-style capability governance",
     ],
   ],
   [