svharness 0.15.11 → 0.15.13

package/dist/lib/auto-state.js

@@ -4,6 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dedupePhases = dedupePhases;
+exports.dedupePhaseFields = dedupePhaseFields;
+exports.repairBuildStateYaml = repairBuildStateYaml;
+exports.quoteUnsafeNextAction = quoteUnsafeNextAction;
 exports.readBuildState = readBuildState;
 exports.writeBuildState = writeBuildState;
 exports.phaseStatus = phaseStatus;
@@ -60,29 +63,135 @@ function dedupePhases(rawYaml) {
     }
     return result.join('\n');
 }
+const PHASE_FIELD_REGEX = /^    ([A-Za-z_][\w-]*):/;
+/**
+ * Within each phase block, drop duplicate field keys (e.g. a second
+ * `completed_at:` appended by ACP text-editing). Keeps the **last**
+ * occurrence so the most recent agent edit wins.
+ */
+function dedupeFieldsInPhaseBlock(blockLines) {
+    if (blockLines.length === 0)
+        return blockLines;
+    const spans = [];
+    for (let i = 0; i < blockLines.length; i++) {
+        const match = blockLines[i].match(PHASE_FIELD_REGEX);
+        if (!match)
+            continue;
+        if (spans.length > 0)
+            spans[spans.length - 1].end = i;
+        spans.push({ key: match[1], start: i, end: blockLines.length });
+    }
+    const lastByKey = new Map();
+    spans.forEach((span, idx) => lastByKey.set(span.key, idx));
+    const out = [];
+    spans.forEach((span, idx) => {
+        if (lastByKey.get(span.key) === idx) {
+            out.push(...blockLines.slice(span.start, span.end));
+        }
+    });
+    return out;
+}
+/**
+ * Strip duplicate field keys inside each phase block under `phases:`.
+ */
+function dedupePhaseFields(rawYaml) {
+    const lines = rawYaml.split('\n');
+    const phaseKeyRegex = /^  (\S+):$/;
+    const result = [];
+    let inPhases = false;
+    let phaseHeader = null;
+    let blockLines = [];
+    const flushPhase = () => {
+        if (phaseHeader === null)
+            return;
+        result.push(phaseHeader);
+        result.push(...dedupeFieldsInPhaseBlock(blockLines));
+        phaseHeader = null;
+        blockLines = [];
+    };
+    for (const line of lines) {
+        if (/^phases:$/.test(line)) {
+            inPhases = true;
+            result.push(line);
+            continue;
+        }
+        if (!inPhases) {
+            result.push(line);
+            continue;
+        }
+        if (/^\S/.test(line) && !/^  /.test(line)) {
+            flushPhase();
+            inPhases = false;
+            result.push(line);
+            continue;
+        }
+        const keyMatch = line.match(phaseKeyRegex);
+        if (keyMatch) {
+            flushPhase();
+            phaseHeader = line;
+            continue;
+        }
+        if (phaseHeader !== null) {
+            blockLines.push(line);
+        }
+        else {
+            result.push(line);
+        }
+    }
+    flushPhase();
+    return result.join('\n');
+}
+/** Apply all text-level repairs for agent-corrupted build-state YAML. */
+function repairBuildStateYaml(raw) {
+    return quoteUnsafeNextAction(dedupePhaseFields(dedupePhases(raw)));
+}
+/**
+ * Quote unquoted next_action scalars that contain colons.
+ * Agent text-edits sometimes write "H1: xxx" without quotes, which breaks YAML.
+ */
+function quoteUnsafeNextAction(rawYaml) {
+    return rawYaml.replace(/^next_action:\s+(?!['">|])(.+)$/gm, (_match, value) => {
+        const trimmed = value.trimEnd();
+        if (!trimmed.includes(':')) {
+            return _match;
+        }
+        const escaped = trimmed.replace(/'/g, "''");
+        return `next_action: '${escaped}'`;
+    });
+}
+function parseBuildStateBody(raw) {
+    const body = raw.replace(/^#.*\n/gm, '');
+    const state = (js_yaml_1.default.load(body) ?? {});
+    state.phases = state.phases ?? {};
+    return state;
+}
+async function persistBuildStateRaw(statePath, raw) {
+    const tmpPath = statePath + '.tmp';
+    await fs_extra_1.default.writeFile(tmpPath, raw, 'utf8');
+    await fs_extra_1.default.rename(tmpPath, statePath);
+}
 async function readBuildState(harnessRoot) {
     const statePath = node_path_1.default.join(harnessRoot, '.harness-build-state.yaml');
     const raw = await fs_extra_1.default.readFile(statePath, 'utf8');
-    const body = raw.replace(/^#.*\n/gm, '');
     try {
-        const state = (js_yaml_1.default.load(body) ?? {});
-        state.phases = state.phases ?? {};
-        return state;
+        return parseBuildStateBody(raw);
     }
     catch (err) {
-        // Auto-repair duplicate phase keys (ACP agent text-editing artifact)
-        if (err instanceof js_yaml_1.default.YAMLException && err.message.includes('duplicated mapping key')) {
-            const fixed = dedupePhases(raw);
-            // Persist the fixed content so subsequent reads also succeed
-            const tmpPath = statePath + '.tmp';
-            await fs_extra_1.default.writeFile(tmpPath, fixed, 'utf8');
-            await fs_extra_1.default.rename(tmpPath, statePath);
-            const fixedBody = fixed.replace(/^#.*\n/gm, '');
-            const state = (js_yaml_1.default.load(fixedBody) ?? {});
-            state.phases = state.phases ?? {};
+        if (!(err instanceof js_yaml_1.default.YAMLException)) {
+            throw err;
+        }
+        const fixed = repairBuildStateYaml(raw);
+        if (fixed === raw) {
+            throw err;
+        }
+        try {
+            const state = parseBuildStateBody(fixed);
+            await persistBuildStateRaw(statePath, fixed);
             return state;
         }
-        throw err;
+        catch {
+            throw err;
+        }
     }
 }
 async function writeBuildState(harnessRoot, state) {

package/dist/lib/gate-checker.js

@@ -13,10 +13,21 @@ const ESSENTIAL_FILES = [
     'AGENTS_BUILD.md',
     '.harness-build-state.yaml',
 ];
-async function runMechanicalGates(harnessRoot, verbose = false) {
-    const doctor_exit = await runDoctorGate(harnessRoot);
+const REQ_PACK_ESSENTIAL = [
+    'harness.yaml',
+    '.harness-build-state.yaml',
+    'requirements/raw',
+    'requirements/md',
+    'requirements/yaml',
+    'requirements/_work',
+];
+async function runMechanicalGates(harnessRoot, opts = {}) {
+    const normalized = typeof opts === 'boolean' ? { verbose: opts } : opts;
+    const scope = normalized.scope ?? 'full';
+    const verbose = normalized.verbose ?? false;
+    const doctor_exit = await runDoctorGate(harnessRoot, scope);
     const verify_exit = await runVerifyGate(harnessRoot, verbose);
-    const file_completeness_pct = await computeFileCompleteness(harnessRoot);
+    const file_completeness_pct = await computeFileCompleteness(harnessRoot, scope);
     return {
         doctor_exit,
         verify_exit,
@@ -24,11 +35,11 @@ async function runMechanicalGates(harnessRoot, verbose = false) {
         doctor_passed: doctor_exit === 0,
     };
 }
-async function runDoctorGate(harnessRoot) {
+async function runDoctorGate(harnessRoot, scope) {
     try {
         const report = await (0, index_1.runDoctorChecks)({
             harnessRoot,
-            mode: 'pre-seal',
+            mode: scope === 'requirements' ? 'requirements' : 'pre-seal',
             strict: true,
         });
         return report.passed ? 0 : 1;
@@ -48,11 +59,10 @@ async function runVerifyGate(harnessRoot, verbose) {
         return 1;
     }
 }
-async function computeFileCompleteness(harnessRoot) {
-    const checks = [...ESSENTIAL_FILES];
-    for (const dir of ['requirements', 'references', 'specs', 'agent-env', 'tasks']) {
-        checks.push(dir);
-    }
+async function computeFileCompleteness(harnessRoot, scope) {
+    const checks = scope === 'requirements'
+        ? [...REQ_PACK_ESSENTIAL]
+        : [...ESSENTIAL_FILES, 'requirements', 'references', 'specs', 'agent-env', 'tasks'];
     let present = 0;
     for (const rel of checks) {
         if (await fs_extra_1.default.pathExists(node_path_1.default.join(harnessRoot, rel)))

package/dist/lib/phase-runner.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PhaseRunner = exports.PHASE_DEFS = void 0;
+exports.PhaseRunner = exports.SCOPE_PHASES = exports.PHASE_DEFS = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const node_path_1 = __importDefault(require("node:path"));
 const logger_1 = require("../utils/logger");
@@ -28,6 +28,10 @@ exports.PHASE_DEFS = [
     { key: 'S70_runtime_assets', short: 'S70', mode: 'acp', promptTemplate: 'S70-runtime-assets.md' },
     { key: 'S80_seed_memory', short: 'S80', mode: 'acp', promptTemplate: 'S80-seed-memory.md' },
 ];
+exports.SCOPE_PHASES = {
+    full: null,
+    requirements: ['S30_convert_docs', 'S40_extract_requirements'],
+};
 /** 阶段描述映射，供阶段执行时显示给用户了解当前进展。 */
 const PHASE_DESC = {
     S10_wiki: '生成 baseline wiki 正文',
@@ -62,7 +66,14 @@ class PhaseRunner {
     async getBuildPhases() {
         const harnessRoot = this.ctx.harnessRoot;
         const state = await (0, auto_state_1.readBuildState)(harnessRoot);
-        return exports.PHASE_DEFS.filter((def) => def.key in state.phases);
+        const allowed = exports.SCOPE_PHASES[this.ctx.scope];
+        return exports.PHASE_DEFS.filter((def) => {
+            if (!(def.key in state.phases))
+                return false;
+            if (allowed && !allowed.includes(def.key))
+                return false;
+            return true;
+        });
     }
     shouldStopAtMaxPhase(def) {
         if (!this.ctx.maxPhase)

package/dist/lib/ps-codechat-alias.js

@@ -13,7 +13,20 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
 const logger_1 = require("../utils/logger");
-const launch_script_path_1 = require("./launch-script-path");
+/**
+ * Resolve absolute path to templates/codechat/Start-CodeChat.ps1 in the installed package.
+ */
+function resolveStartCodeChatPs1Path() {
+    const fromDist = path_1.default.resolve(__dirname, '..', '..', 'templates', 'codechat', 'Start-CodeChat.ps1');
+    if (fs_extra_1.default.existsSync(fromDist)) {
+        return fromDist;
+    }
+    const fromCwd = path_1.default.resolve(__dirname, '..', '..', '..', 'templates', 'codechat', 'Start-CodeChat.ps1');
+    if (fs_extra_1.default.existsSync(fromCwd)) {
+        return fromCwd;
+    }
+    throw new Error(`未找到 Start-CodeChat.ps1（预期：${fromDist}）`);
+}
 const START_MARKER = /^#\s*>>>\s*codechat\s*>>>/;
 const END_MARKER = /^#\s*<<<\s*codechat\s*<<</;
 function assertWin32() {
@@ -57,8 +70,8 @@ function stripCodechatBlock(content) {
     const joined = clean.join('\n').replace(/\n+$/, '');
     return { clean: joined ? `${joined}\n` : '', hadBlock };
 }
-function buildAliasSnippet(launchScriptPath) {
-    const escapedPath = launchScriptPath.replace(/'/g, "''");
+function buildAliasSnippet(ps1Path) {
+    const escapedPath = ps1Path.replace(/'/g, "''");
     return `
 
 # >>> codechat >>>
@@ -69,17 +82,17 @@ function codechat {
         [string[]]$ExtraArgs
     )
     if (-not $Path) { $Path = (Get-Location).Path }
-    & node '${escapedPath}' "$Path" @ExtraArgs
+    & '${escapedPath}' -Action Start -WorkDir "$Path" @ExtraArgs
 }
 # <<< codechat <<<
 
 `;
 }
-function profileHasSvharnessAlias(content, launchScriptPath) {
+function profileHasSvharnessAlias(content, ps1Path) {
     if (!START_MARKER.test(content)) {
         return false;
     }
-    const needle = normalizePathForCompare(launchScriptPath);
+    const needle = normalizePathForCompare(ps1Path);
     return normalizePathForCompare(content).includes(needle);
 }
 /**
@@ -89,11 +102,11 @@ function profileHasSvharnessAlias(content, launchScriptPath) {
 async function installCodechatAlias(opts = {}) {
     assertWin32();
     const profilePath = getPowerShellProfilePath();
-    const launchScriptPath = (0, launch_script_path_1.resolveLaunchScriptPath)();
+    const ps1Path = resolveStartCodeChatPs1Path();
     const existing = (await fs_extra_1.default.pathExists(profilePath))
         ? await fs_extra_1.default.readFile(profilePath, 'utf8')
         : '';
-    if (profileHasSvharnessAlias(existing, launchScriptPath)) {
+    if (profileHasSvharnessAlias(existing, ps1Path)) {
         if (!opts.silent) {
             logger_1.logger.info(`PowerShell 别名 codechat 已存在：${profilePath}`);
         }
@@ -104,11 +117,11 @@ async function installCodechatAlias(opts = {}) {
         await fs_extra_1.default.writeFile(profilePath, '', 'utf8');
     }
     const { clean, hadBlock } = stripCodechatBlock(existing);
-    const snippet = buildAliasSnippet(launchScriptPath);
+    const snippet = buildAliasSnippet(ps1Path);
     await fs_extra_1.default.writeFile(profilePath, `${clean}${snippet}`, 'utf8');
     if (!opts.silent) {
         if (hadBlock) {
-            logger_1.logger.success(`已更新 PowerShell 别名 codechat → ${launchScriptPath}`);
+            logger_1.logger.success(`已更新 PowerShell 别名 codechat → ${ps1Path}`);
         }
         else {
             logger_1.logger.success(`已安装 PowerShell 别名 codechat → ${profilePath}`);
@@ -144,24 +157,24 @@ async function uninstallCodechatAlias(opts = {}) {
 function getCodechatAliasStatus() {
     assertWin32();
     const profilePath = getPowerShellProfilePath();
-    let launchScriptPath = '';
+    let ps1Path = '';
     try {
-        launchScriptPath = (0, launch_script_path_1.resolveLaunchScriptPath)();
+        ps1Path = resolveStartCodeChatPs1Path();
     }
     catch {
-        launchScriptPath = '(未找到)';
+        ps1Path = '(未找到)';
     }
     let installed = false;
-    if (fs_extra_1.default.existsSync(profilePath) && launchScriptPath !== '(未找到)') {
+    if (fs_extra_1.default.existsSync(profilePath) && ps1Path !== '(未找到)') {
         try {
             const content = fs_extra_1.default.readFileSync(profilePath, 'utf8');
-            installed = profileHasSvharnessAlias(content, launchScriptPath);
+            installed = profileHasSvharnessAlias(content, ps1Path);
         }
         catch {
             installed = false;
         }
     }
-    return { profilePath, installed, launchScriptPath };
+    return { profilePath, installed, launchScriptPath: ps1Path };
 }
 function printCodechatAliasStatus() {
     const status = getCodechatAliasStatus();

package/dist/lib/review-parser.js

@@ -3,10 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseReportFrontmatter = parseReportFrontmatter;
 exports.parseReviewReport = parseReviewReport;
+exports.parseGapsFromMarkdown = parseGapsFromMarkdown;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const score_aggregator_1 = require("./score-aggregator");
+async function parseReportFrontmatter(reportPath) {
+    if (!(await fs_extra_1.default.pathExists(reportPath)))
+        return null;
+    const content = await fs_extra_1.default.readFile(reportPath, 'utf8');
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match)
+        return null;
+    return js_yaml_1.default.load(match[1]);
+}
 async function parseReviewReport(reportPath) {
     if (!(await fs_extra_1.default.pathExists(reportPath)))
         return null;
@@ -51,6 +62,9 @@ function asRecord(value) {
     return typeof value === 'object' && value !== null ? value : {};
 }
 function parseGaps(content) {
+    return parseGapsFromMarkdown(content);
+}
+function parseGapsFromMarkdown(content) {
     const gaps = [];
     const lines = content.split(/\r?\n/);
     for (const line of lines) {

package/dist/lib/score-aggregator.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.computeMechanicalScore = computeMechanicalScore;
 exports.computeReviewScore = computeReviewScore;
 exports.computeCompositeScore = computeCompositeScore;
+exports.computeReqPackMechanicalScore = computeReqPackMechanicalScore;
+exports.computeReqPackScore = computeReqPackScore;
 const REVIEW_INTERNAL_WEIGHTS = {
     wiki: 15 / 90,
     requirements: 20 / 90,
@@ -37,6 +39,25 @@ function computeCompositeScore(review) {
         composite: roundScore(clamp(mechanical * 0.30 + reviewScore * 0.70, 0, 10)),
     };
 }
+/** auto_pack_req：硬门禁全通过=10，否则=0 */
+function computeReqPackMechanicalScore(gates, criticalCount) {
+    if (gates.doctor_exit !== 0 || gates.verify_exit !== 0 || criticalCount > 0) {
+        return 0;
+    }
+    return 10;
+}
+/** auto_pack_req 三维度综合分：机械 40% + 对抗 30% + 抽样 30% */
+function computeReqPackScore(gates, adversarialAverage, sampleTraceAverage, criticalCount) {
+    const mechanical = computeReqPackMechanicalScore(gates, criticalCount);
+    const adversarial = clamp(adversarialAverage, 0, 10);
+    const sample_trace = clamp(sampleTraceAverage, 0, 10);
+    const composite = roundScore(clamp(mechanical * 0.40 + adversarial * 0.30 + sample_trace * 0.30, 0, 10));
+    const gate_pass = gates.doctor_exit === 0 &&
+        gates.verify_exit === 0 &&
+        criticalCount === 0 &&
+        mechanical > 0;
+    return { mechanical, adversarial, sample_trace, composite, gate_pass };
+}
 function clamp(value, min, max) {
     if (!Number.isFinite(value))
         return min;

package/dist/lib/win-registry.js

@@ -86,4 +86,4 @@ function regKeyExists(key) {
 }
 exports.SHELL_MENU_KEY_BG = 'HKCU\\Software\\Classes\\Directory\\Background\\shell\\SvharnessLaunchCodeChatAgent';
 exports.SHELL_MENU_KEY_DIR = 'HKCU\\Software\\Classes\\Directory\\shell\\SvharnessLaunchCodeChatAgent';
-exports.SHELL_MENU_LABEL = '在此启动 CodeChat CLI';
+exports.SHELL_MENU_LABEL = 'Launch CodeChat CLI here';

package/dist/utils/validate-args.js

@@ -13,6 +13,7 @@ exports.resolveConvertPaths = resolveConvertPaths;
 exports.validateConvertArgs = validateConvertArgs;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const node_path_1 = __importDefault(require("node:path"));
+const convert_1 = require("../constants/convert");
 const harness_name_1 = require("./harness-name");
 const SUPPORTED_ARCHES = [
     'android-compose',
@@ -161,7 +162,7 @@ function listSupportedAgents() {
 }
 const DEFAULT_CONCURRENCY = 3;
 const DEFAULT_MAX_FILE_MB = 50;
-const DEFAULT_TIMEOUT_SEC = 120;
+const DEFAULT_TIMEOUT_SEC = convert_1.DEFAULT_CONVERT_TIMEOUT_SEC;
 const DEFAULT_ENDPOINT = 'http://markitdown.desaysz.site';
 const ENV_ENDPOINT = 'SVHARNESS_MARKITDOWN_ENDPOINT';
 const DEFAULT_CONVERT_TYPE = 'requirements';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svharness",
-  "version": "0.15.11",
+  "version": "0.15.13",
   "description": "CLI scaffolder for SDD-Driven Agent-Agnostic Coding Framework (harness)",
   "bin": {
     "svharness": "./bin/cli.js",
@@ -27,9 +27,10 @@
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "rebuild": "npm run clean && npm run build",
     "test:requirements": "npm run build && node scripts/test-parse-blocks.js",
-    "test:auto": "npm run build && node scripts/test-auto-score.js && node scripts/test-auto-prompt.js",
+    "test:auto": "npm run build && node scripts/test-auto-score.js && node scripts/test-auto-prompt.js && node scripts/test-acp-agent-cli-resolver.js && node scripts/test-auto-pack-req-context.js",
     "test:cli-declarations": "npm run build && node scripts/test-cli-input-declarations.js",
     "test:agent-launcher": "npm run build && node scripts/test-agent-launcher.js",
+    "test:acp-agent-cli": "npm run build && node scripts/test-acp-agent-cli-resolver.js",
     "prepare": "npm run build",
     "postinstall": "node scripts/postinstall.js",
     "preuninstall": "node scripts/preuninstall.js",