@hunter-harness/workflow-harness 0.2.15 → 0.2.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/harness/bundles/general/claude-code/.harness-build.json +1 -1
- package/harness/bundles/general/claude-code/harness-archive/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-knowledge-ingest/scripts/harness_knowledge.py +16 -1
- package/harness/bundles/general/claude-code/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-plan/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-review/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-review/reference.md +13 -0
- package/harness/bundles/general/claude-code/harness-run/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-submit/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-sync/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/harness-test/SKILL.md +1 -1
- package/harness/bundles/general/claude-code/scripts/harness_gate.py +75 -0
- package/harness/bundles/general/claude-code/scripts/harness_integration.py +38 -0
- package/harness/bundles/general/claude-code/scripts/harness_ledger.py +70 -3
- package/harness/bundles/general/claude-code/scripts/harness_paths.py +17 -0
- package/harness/bundles/general/claude-code/scripts/harness_plan_finalize.py +147 -0
- package/harness/bundles/general/claude-code/scripts/harness_profile.py +58 -7
- package/harness/bundles/general/claude-code/scripts/harness_review.py +107 -0
- package/harness/bundles/general/codebuddy/.harness-build.json +1 -1
- package/harness/bundles/general/codebuddy/harness-archive/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-knowledge-ingest/scripts/harness_knowledge.py +16 -1
- package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-plan/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-review/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-review/reference.md +13 -0
- package/harness/bundles/general/codebuddy/harness-run/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-submit/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-sync/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/harness-test/SKILL.md +1 -1
- package/harness/bundles/general/codebuddy/scripts/harness_gate.py +75 -0
- package/harness/bundles/general/codebuddy/scripts/harness_integration.py +38 -0
- package/harness/bundles/general/codebuddy/scripts/harness_ledger.py +70 -3
- package/harness/bundles/general/codebuddy/scripts/harness_paths.py +17 -0
- package/harness/bundles/general/codebuddy/scripts/harness_plan_finalize.py +147 -0
- package/harness/bundles/general/codebuddy/scripts/harness_profile.py +58 -7
- package/harness/bundles/general/codebuddy/scripts/harness_review.py +107 -0
- package/harness/bundles/general/codex/.harness-build.json +1 -1
- package/harness/bundles/general/codex/harness-archive/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-knowledge-ingest/scripts/harness_knowledge.py +16 -1
- package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-plan/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-review/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-review/reference.md +13 -0
- package/harness/bundles/general/codex/harness-run/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-submit/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-sync/SKILL.md +1 -1
- package/harness/bundles/general/codex/harness-test/SKILL.md +1 -1
- package/harness/bundles/general/codex/scripts/harness_gate.py +75 -0
- package/harness/bundles/general/codex/scripts/harness_integration.py +38 -0
- package/harness/bundles/general/codex/scripts/harness_ledger.py +70 -3
- package/harness/bundles/general/codex/scripts/harness_paths.py +17 -0
- package/harness/bundles/general/codex/scripts/harness_plan_finalize.py +147 -0
- package/harness/bundles/general/codex/scripts/harness_profile.py +58 -7
- package/harness/bundles/general/codex/scripts/harness_review.py +107 -0
- package/harness/bundles/general/cursor/.harness-build.json +1 -1
- package/harness/bundles/general/cursor/harness-archive/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-knowledge-ingest/scripts/harness_knowledge.py +16 -1
- package/harness/bundles/general/cursor/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-plan/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-review/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-review/reference.md +13 -0
- package/harness/bundles/general/cursor/harness-run/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-submit/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-sync/SKILL.md +1 -1
- package/harness/bundles/general/cursor/harness-test/SKILL.md +1 -1
- package/harness/bundles/general/cursor/scripts/harness_gate.py +75 -0
- package/harness/bundles/general/cursor/scripts/harness_integration.py +38 -0
- package/harness/bundles/general/cursor/scripts/harness_ledger.py +70 -3
- package/harness/bundles/general/cursor/scripts/harness_paths.py +17 -0
- package/harness/bundles/general/cursor/scripts/harness_plan_finalize.py +147 -0
- package/harness/bundles/general/cursor/scripts/harness_profile.py +58 -7
- package/harness/bundles/general/cursor/scripts/harness_review.py +107 -0
- package/harness/bundles/java/claude-code/.harness-build.json +1 -1
- package/harness/bundles/java/claude-code/harness-apidoc/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-archive/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-knowledge-ingest/scripts/harness_knowledge.py +16 -1
- package/harness/bundles/java/claude-code/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-package/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-plan/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-review/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-review/reference.md +13 -0
- package/harness/bundles/java/claude-code/harness-run/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-submit/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-sync/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/harness-test/SKILL.md +1 -1
- package/harness/bundles/java/claude-code/scripts/harness_gate.py +75 -0
- package/harness/bundles/java/claude-code/scripts/harness_integration.py +38 -0
- package/harness/bundles/java/claude-code/scripts/harness_ledger.py +70 -3
- package/harness/bundles/java/claude-code/scripts/harness_paths.py +17 -0
- package/harness/bundles/java/claude-code/scripts/harness_plan_finalize.py +147 -0
- package/harness/bundles/java/claude-code/scripts/harness_profile.py +58 -7
- package/harness/bundles/java/claude-code/scripts/harness_review.py +107 -0
- package/harness/bundles/java/codebuddy/.harness-build.json +1 -1
- package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-archive/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-knowledge-ingest/scripts/harness_knowledge.py +16 -1
- package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-package/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-plan/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-review/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-review/reference.md +13 -0
- package/harness/bundles/java/codebuddy/harness-run/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-submit/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-sync/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/harness-test/SKILL.md +1 -1
- package/harness/bundles/java/codebuddy/scripts/harness_gate.py +75 -0
- package/harness/bundles/java/codebuddy/scripts/harness_integration.py +38 -0
- package/harness/bundles/java/codebuddy/scripts/harness_ledger.py +70 -3
- package/harness/bundles/java/codebuddy/scripts/harness_paths.py +17 -0
- package/harness/bundles/java/codebuddy/scripts/harness_plan_finalize.py +147 -0
- package/harness/bundles/java/codebuddy/scripts/harness_profile.py +58 -7
- package/harness/bundles/java/codebuddy/scripts/harness_review.py +107 -0
- package/harness/bundles/java/codex/.harness-build.json +1 -1
- package/harness/bundles/java/codex/harness-apidoc/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-archive/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-knowledge-ingest/scripts/harness_knowledge.py +16 -1
- package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-package/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-plan/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-review/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-review/reference.md +13 -0
- package/harness/bundles/java/codex/harness-run/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-submit/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-sync/SKILL.md +1 -1
- package/harness/bundles/java/codex/harness-test/SKILL.md +1 -1
- package/harness/bundles/java/codex/scripts/harness_gate.py +75 -0
- package/harness/bundles/java/codex/scripts/harness_integration.py +38 -0
- package/harness/bundles/java/codex/scripts/harness_ledger.py +70 -3
- package/harness/bundles/java/codex/scripts/harness_paths.py +17 -0
- package/harness/bundles/java/codex/scripts/harness_plan_finalize.py +147 -0
- package/harness/bundles/java/codex/scripts/harness_profile.py +58 -7
- package/harness/bundles/java/codex/scripts/harness_review.py +107 -0
- package/harness/bundles/java/cursor/.harness-build.json +1 -1
- package/harness/bundles/java/cursor/harness-apidoc/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-archive/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-codebase-map/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-knowledge-ingest/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-knowledge-ingest/scripts/harness_knowledge.py +16 -1
- package/harness/bundles/java/cursor/harness-knowledge-query/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-package/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-plan/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-review/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-review/reference.md +13 -0
- package/harness/bundles/java/cursor/harness-run/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-submit/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-sync/SKILL.md +1 -1
- package/harness/bundles/java/cursor/harness-test/SKILL.md +1 -1
- package/harness/bundles/java/cursor/scripts/harness_gate.py +75 -0
- package/harness/bundles/java/cursor/scripts/harness_integration.py +38 -0
- package/harness/bundles/java/cursor/scripts/harness_ledger.py +70 -3
- package/harness/bundles/java/cursor/scripts/harness_paths.py +17 -0
- package/harness/bundles/java/cursor/scripts/harness_plan_finalize.py +147 -0
- package/harness/bundles/java/cursor/scripts/harness_profile.py +58 -7
- package/harness/bundles/java/cursor/scripts/harness_review.py +107 -0
- package/harness/manifests/general/claude-code.json +21 -21
- package/harness/manifests/general/codebuddy.json +21 -21
- package/harness/manifests/general/codex.json +21 -21
- package/harness/manifests/general/cursor.json +21 -21
- package/harness/manifests/java/claude-code.json +23 -23
- package/harness/manifests/java/codebuddy.json +23 -23
- package/harness/manifests/java/codex.json +23 -23
- package/harness/manifests/java/cursor.json +23 -23
- package/hunter-workflow-family.json +2 -2
- package/package.json +1 -1
|
@@ -1266,6 +1266,31 @@ def cmd_status(args: argparse.Namespace) -> int:
|
|
|
1266
1266
|
return _emit(_txn_from_args(args).status())
|
|
1267
1267
|
|
|
1268
1268
|
|
|
1269
|
+
def cmd_journal(args: argparse.Namespace) -> int:
|
|
1270
|
+
"""C5: journal 子命令 — 默认 compact (transactionId/currentStep/status),--verbose 全量。"""
|
|
1271
|
+
txn = _txn_from_args(args)
|
|
1272
|
+
full = txn.status()
|
|
1273
|
+
if getattr(args, "verbose", False):
|
|
1274
|
+
return _emit(full)
|
|
1275
|
+
# Derive currentStep: first non-DONE step, or last step name if all DONE.
|
|
1276
|
+
current_step = None
|
|
1277
|
+
for step in full.get("steps", []):
|
|
1278
|
+
if step.get("status") != "DONE":
|
|
1279
|
+
current_step = step.get("name")
|
|
1280
|
+
break
|
|
1281
|
+
if current_step is None and full.get("steps"):
|
|
1282
|
+
current_step = full["steps"][-1].get("name")
|
|
1283
|
+
overall_status = "DONE" if all(
|
|
1284
|
+
step.get("status") == "DONE" for step in full.get("steps", [])
|
|
1285
|
+
) else "IN_PROGRESS"
|
|
1286
|
+
compact = {
|
|
1287
|
+
"transactionId": full.get("transactionId"),
|
|
1288
|
+
"currentStep": current_step,
|
|
1289
|
+
"status": overall_status,
|
|
1290
|
+
}
|
|
1291
|
+
return _emit(compact)
|
|
1292
|
+
|
|
1293
|
+
|
|
1269
1294
|
def build_parser() -> argparse.ArgumentParser:
|
|
1270
1295
|
parser = argparse.ArgumentParser(prog="harness_integration.py")
|
|
1271
1296
|
sub = parser.add_subparsers(dest="command_name", required=True)
|
|
@@ -1287,6 +1312,19 @@ def build_parser() -> argparse.ArgumentParser:
|
|
|
1287
1312
|
add("recover", cmd_recover)
|
|
1288
1313
|
add("status", cmd_status)
|
|
1289
1314
|
|
|
1315
|
+
p_journal = sub.add_parser("journal")
|
|
1316
|
+
p_journal.add_argument("--change", required=True)
|
|
1317
|
+
p_journal.add_argument("--run-id", required=True)
|
|
1318
|
+
p_journal.add_argument("--target-branch", default="main")
|
|
1319
|
+
p_journal.add_argument("--feature-branch", required=True)
|
|
1320
|
+
p_journal.add_argument("--temp-root", required=True)
|
|
1321
|
+
p_journal.add_argument(
|
|
1322
|
+
"--verbose",
|
|
1323
|
+
action="store_true",
|
|
1324
|
+
help="emit full journal payload (default: compact transactionId/currentStep/status)",
|
|
1325
|
+
)
|
|
1326
|
+
p_journal.set_defaults(func=cmd_journal)
|
|
1327
|
+
|
|
1290
1328
|
p_verify = sub.add_parser("verify")
|
|
1291
1329
|
p_verify.add_argument("--change", required=True)
|
|
1292
1330
|
p_verify.add_argument("--run-id", required=True)
|
|
@@ -100,6 +100,37 @@ def emit_json(payload: dict[str, Any], *, as_json: bool) -> None:
|
|
|
100
100
|
sys.stdout.write(("ok" if ok else "error") + "\n")
|
|
101
101
|
|
|
102
102
|
|
|
103
|
+
def _compact_record_payload(payload: dict[str, Any]) -> dict[str, Any]:
|
|
104
|
+
"""C5: record compact — ok/action/verification/status only."""
|
|
105
|
+
return {
|
|
106
|
+
"ok": payload.get("ok", True),
|
|
107
|
+
"action": payload.get("action"),
|
|
108
|
+
"verification": payload.get("verification"),
|
|
109
|
+
"status": payload.get("status"),
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
def _compact_can_reuse_payload(payload: dict[str, Any]) -> dict[str, Any]:
|
|
114
|
+
"""C5: can-reuse compact — ok/reuse/code only."""
|
|
115
|
+
return {
|
|
116
|
+
"ok": payload.get("ok", True),
|
|
117
|
+
"reuse": payload.get("reuse"),
|
|
118
|
+
"code": payload.get("code"),
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
def emit_compact_or_verbose(
|
|
123
|
+
payload: dict[str, Any],
|
|
124
|
+
*,
|
|
125
|
+
as_json: bool,
|
|
126
|
+
verbose: bool,
|
|
127
|
+
compact_fn,
|
|
128
|
+
) -> None:
|
|
129
|
+
"""Emit compact payload by default; full payload when --verbose."""
|
|
130
|
+
out = payload if verbose else compact_fn(payload)
|
|
131
|
+
emit_json(out, as_json=as_json)
|
|
132
|
+
|
|
133
|
+
|
|
103
134
|
def emit_error(message: str, *, as_json: bool, code: int = 1) -> int:
|
|
104
135
|
payload = {"ok": False, "error": message}
|
|
105
136
|
if as_json:
|
|
@@ -1227,6 +1258,7 @@ def cmd_hash(args: argparse.Namespace) -> int:
|
|
|
1227
1258
|
|
|
1228
1259
|
def cmd_can_reuse(args: argparse.Namespace) -> int:
|
|
1229
1260
|
as_json = bool(args.json)
|
|
1261
|
+
verbose = bool(getattr(args, "verbose", False))
|
|
1230
1262
|
verification = args.verification
|
|
1231
1263
|
if verification not in VERIFICATIONS:
|
|
1232
1264
|
return emit_error(
|
|
@@ -1253,7 +1285,10 @@ def cmd_can_reuse(args: argparse.Namespace) -> int:
|
|
|
1253
1285
|
"verification": verification,
|
|
1254
1286
|
"detail": err,
|
|
1255
1287
|
}
|
|
1256
|
-
|
|
1288
|
+
emit_compact_or_verbose(
|
|
1289
|
+
payload, as_json=as_json, verbose=verbose,
|
|
1290
|
+
compact_fn=_compact_can_reuse_payload,
|
|
1291
|
+
)
|
|
1257
1292
|
return 0
|
|
1258
1293
|
files = resolve_input_files(resolved_files, project_root)
|
|
1259
1294
|
if not files:
|
|
@@ -1275,12 +1310,16 @@ def cmd_can_reuse(args: argparse.Namespace) -> int:
|
|
|
1275
1310
|
except (OSError, ValueError, json.JSONDecodeError) as exc:
|
|
1276
1311
|
return emit_error(f"can-reuse failed: {exc}", as_json=as_json)
|
|
1277
1312
|
|
|
1278
|
-
|
|
1313
|
+
emit_compact_or_verbose(
|
|
1314
|
+
payload, as_json=as_json, verbose=verbose,
|
|
1315
|
+
compact_fn=_compact_can_reuse_payload,
|
|
1316
|
+
)
|
|
1279
1317
|
return 0
|
|
1280
1318
|
|
|
1281
1319
|
|
|
1282
1320
|
def cmd_record(args: argparse.Namespace) -> int:
|
|
1283
1321
|
as_json = bool(args.json)
|
|
1322
|
+
verbose = bool(getattr(args, "verbose", False))
|
|
1284
1323
|
change_dir = resolve_path(args.change_dir)
|
|
1285
1324
|
verification = args.verification
|
|
1286
1325
|
if verification not in VERIFICATIONS:
|
|
@@ -1421,6 +1460,16 @@ def cmd_record(args: argparse.Namespace) -> int:
|
|
|
1421
1460
|
if _nonempty_str(getattr(args, "tests_reused_from", None)):
|
|
1422
1461
|
entry["testsReusedFrom"] = str(args.tests_reused_from).strip()
|
|
1423
1462
|
|
|
1463
|
+
# C9: bind scenario IDs from --scenario-ids to this ledger entry.
|
|
1464
|
+
scenario_ids_raw = getattr(args, "scenario_ids", None)
|
|
1465
|
+
if _nonempty_str(scenario_ids_raw):
|
|
1466
|
+
ids = [s.strip() for s in str(scenario_ids_raw).split(",") if s.strip()]
|
|
1467
|
+
if ids:
|
|
1468
|
+
entry["scenarioIds"] = ids
|
|
1469
|
+
elif "scenarioIds" in entry:
|
|
1470
|
+
# Fresh record without scenario-ids must not keep stale ids from prev.
|
|
1471
|
+
entry.pop("scenarioIds", None)
|
|
1472
|
+
|
|
1424
1473
|
ledger["validations"][verification] = entry
|
|
1425
1474
|
if "changeName" not in ledger:
|
|
1426
1475
|
ledger["changeName"] = change_dir.name
|
|
@@ -1487,7 +1536,10 @@ def cmd_record(args: argparse.Namespace) -> int:
|
|
|
1487
1536
|
"diffHash": ledger.get("diffHash"),
|
|
1488
1537
|
"resolvedProjectRoot": str(project_root) if project_root else None,
|
|
1489
1538
|
}
|
|
1490
|
-
|
|
1539
|
+
emit_compact_or_verbose(
|
|
1540
|
+
payload, as_json=as_json, verbose=verbose,
|
|
1541
|
+
compact_fn=_compact_record_payload,
|
|
1542
|
+
)
|
|
1491
1543
|
return 0
|
|
1492
1544
|
|
|
1493
1545
|
|
|
@@ -1589,6 +1641,11 @@ def build_parser() -> argparse.ArgumentParser:
|
|
|
1589
1641
|
default=None,
|
|
1590
1642
|
help="optional environment hash to compare against ledger entry (UT-017)",
|
|
1591
1643
|
)
|
|
1644
|
+
p_reuse.add_argument(
|
|
1645
|
+
"--verbose",
|
|
1646
|
+
action="store_true",
|
|
1647
|
+
help="emit full payload (default: compact ok/reuse/code)",
|
|
1648
|
+
)
|
|
1592
1649
|
p_reuse.set_defaults(func=cmd_can_reuse)
|
|
1593
1650
|
|
|
1594
1651
|
p_record = sub.add_parser("record", parents=[shared_json], help="write validation result into ledger")
|
|
@@ -1669,6 +1726,16 @@ def build_parser() -> argparse.ArgumentParser:
|
|
|
1669
1726
|
default=None,
|
|
1670
1727
|
help="ledger v3: scope reason (required when --applicability NOT_APPLICABLE)",
|
|
1671
1728
|
)
|
|
1729
|
+
p_record.add_argument(
|
|
1730
|
+
"--scenario-ids",
|
|
1731
|
+
default=None,
|
|
1732
|
+
help="comma-separated scenario IDs from scenario-manifest.json to bind to this entry",
|
|
1733
|
+
)
|
|
1734
|
+
p_record.add_argument(
|
|
1735
|
+
"--verbose",
|
|
1736
|
+
action="store_true",
|
|
1737
|
+
help="emit full payload (default: compact ok/action/verification/status)",
|
|
1738
|
+
)
|
|
1672
1739
|
p_record.set_defaults(func=cmd_record)
|
|
1673
1740
|
|
|
1674
1741
|
p_diff = sub.add_parser(
|
|
@@ -83,6 +83,23 @@ def _git_common_dir(cwd: Path) -> Path | None:
|
|
|
83
83
|
return common
|
|
84
84
|
|
|
85
85
|
|
|
86
|
+
def common_root(project_root: Path) -> Path:
|
|
87
|
+
"""Resolve the shared "common" root for a project.
|
|
88
|
+
|
|
89
|
+
For a linked worktree, ``git rev-parse --git-common-dir`` points at the
|
|
90
|
+
main repository's ``.git`` directory; its parent is the main project root.
|
|
91
|
+
For the main worktree, the common dir is ``<root>/.git`` so the parent is
|
|
92
|
+
the project root itself. Falls back to the resolved input when not in a
|
|
93
|
+
git repo (e.g. exploratory scratch dirs).
|
|
94
|
+
"""
|
|
95
|
+
cwd = Path(project_root).resolve()
|
|
96
|
+
common = _git_common_dir(cwd)
|
|
97
|
+
if common is None:
|
|
98
|
+
return cwd
|
|
99
|
+
# common dir is <root>/.git — its parent is the main project root.
|
|
100
|
+
return common.parent.resolve()
|
|
101
|
+
|
|
102
|
+
|
|
86
103
|
def _root_commit(cwd: Path) -> str | None:
|
|
87
104
|
raw = _git_text(cwd, "rev-list", "--max-parents=0", "HEAD")
|
|
88
105
|
if not raw:
|
|
@@ -30,11 +30,117 @@ if hasattr(sys.stderr, "reconfigure"):
|
|
|
30
30
|
SCHEMA_VERSION = 1
|
|
31
31
|
_LINK = re.compile(r"\[[^\]]+\]\(([^)]+)\)")
|
|
32
32
|
|
|
33
|
+
# C8: valid ownerPhase values (lifecycle phases that can own tasks).
|
|
34
|
+
VALID_OWNER_PHASES = {"plan", "run", "test", "review", "submit"}
|
|
35
|
+
|
|
36
|
+
# C9: map scenario priority to required evidence kind.
|
|
37
|
+
PRIORITY_EVIDENCE_KIND = {
|
|
38
|
+
"P0": "ledger",
|
|
39
|
+
"P1": "ledger",
|
|
40
|
+
"P2": "advisory",
|
|
41
|
+
}
|
|
42
|
+
|
|
33
43
|
|
|
34
44
|
def _result_error(code: str, message: str) -> dict[str, Any]:
|
|
35
45
|
return {"ok": False, "code": code, "error": message}
|
|
36
46
|
|
|
37
47
|
|
|
48
|
+
def parse_test_scenarios(scenarios_path: Path) -> list[dict[str, str]]:
|
|
49
|
+
"""C9: parse test-scenarios.md tables, extracting scenario rows.
|
|
50
|
+
|
|
51
|
+
Returns a list of dicts with keys: id / priority / scenario / verification /
|
|
52
|
+
ownerPhase / requiredEvidenceKind (last one derived from priority).
|
|
53
|
+
"""
|
|
54
|
+
text = Path(scenarios_path).read_text(encoding="utf-8-sig")
|
|
55
|
+
lines = text.splitlines()
|
|
56
|
+
scenarios: list[dict[str, str]] = []
|
|
57
|
+
# Find all tables whose header includes "ID" and "优先级" (or "priority").
|
|
58
|
+
i = 0
|
|
59
|
+
while i < len(lines):
|
|
60
|
+
line = lines[i].strip()
|
|
61
|
+
if line.startswith("|") and "ID" in line and ("优先级" in line or "priority" in line):
|
|
62
|
+
header_line = line
|
|
63
|
+
headers = [h.strip() for h in header_line.strip("|").split("|")]
|
|
64
|
+
col_map: dict[str, int] = {}
|
|
65
|
+
for idx, name in enumerate(headers):
|
|
66
|
+
key = name.lower()
|
|
67
|
+
col_map[key] = idx
|
|
68
|
+
# Skip separator row
|
|
69
|
+
i += 2
|
|
70
|
+
while i < len(lines):
|
|
71
|
+
row = lines[i].strip()
|
|
72
|
+
if not row.startswith("|"):
|
|
73
|
+
break
|
|
74
|
+
cells = [c.strip() for c in row.strip("|").split("|")]
|
|
75
|
+
if len(cells) < len(headers):
|
|
76
|
+
i += 1
|
|
77
|
+
continue
|
|
78
|
+
scenario: dict[str, str] = {}
|
|
79
|
+
for cn, en in (
|
|
80
|
+
("ID", "id"),
|
|
81
|
+
("优先级", "priority"),
|
|
82
|
+
("场景", "scenario"),
|
|
83
|
+
("验证方式", "verification"),
|
|
84
|
+
("owner phase", "ownerPhase"),
|
|
85
|
+
):
|
|
86
|
+
if cn.lower() in col_map:
|
|
87
|
+
scenario[en] = cells[col_map[cn.lower()]]
|
|
88
|
+
# Derive requiredEvidenceKind from priority
|
|
89
|
+
priority = scenario.get("priority", "")
|
|
90
|
+
scenario["requiredEvidenceKind"] = PRIORITY_EVIDENCE_KIND.get(priority, "advisory")
|
|
91
|
+
scenarios.append(scenario)
|
|
92
|
+
i += 1
|
|
93
|
+
continue
|
|
94
|
+
i += 1
|
|
95
|
+
return scenarios
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
def parse_plan_tasks(plan_path: Path) -> list[dict[str, str]]:
|
|
99
|
+
"""C8: parse plan.md task table rows, extracting optional ownerPhase/implementationDoneWhen/verificationPhase columns.
|
|
100
|
+
|
|
101
|
+
Returns a list of dicts with keys: # / 簇 / 任务 / ownerPhase / implementationDoneWhen /
|
|
102
|
+
verificationPhase / requiresExplicitAuthority (last four optional, only present when
|
|
103
|
+
the column header includes them).
|
|
104
|
+
"""
|
|
105
|
+
text = Path(plan_path).read_text(encoding="utf-8-sig")
|
|
106
|
+
lines = text.splitlines()
|
|
107
|
+
# Find the task table: a header row starting with "| #" followed by a separator row.
|
|
108
|
+
header_idx = -1
|
|
109
|
+
for i, line in enumerate(lines):
|
|
110
|
+
stripped = line.strip()
|
|
111
|
+
if stripped.startswith("|") and "#" in stripped and "任务" in stripped:
|
|
112
|
+
header_idx = i
|
|
113
|
+
break
|
|
114
|
+
if header_idx < 0:
|
|
115
|
+
return []
|
|
116
|
+
header_line = lines[header_idx]
|
|
117
|
+
headers = [h.strip() for h in header_line.strip().strip("|").split("|")]
|
|
118
|
+
# Map header names to column indices (case-insensitive, English keys).
|
|
119
|
+
col_map: dict[str, int] = {}
|
|
120
|
+
for idx, name in enumerate(headers):
|
|
121
|
+
key = name.lower()
|
|
122
|
+
col_map[key] = idx
|
|
123
|
+
tasks: list[dict[str, str]] = []
|
|
124
|
+
for line in lines[header_idx + 2 :]: # skip header + separator
|
|
125
|
+
stripped = line.strip()
|
|
126
|
+
if not stripped.startswith("|"):
|
|
127
|
+
break # end of table
|
|
128
|
+
cells = [c.strip() for c in stripped.strip("|").split("|")]
|
|
129
|
+
if len(cells) < len(headers):
|
|
130
|
+
continue
|
|
131
|
+
task: dict[str, str] = {}
|
|
132
|
+
# Chinese headers
|
|
133
|
+
for cn, en in (("#", "num"), ("簇", "cluster"), ("任务", "task")):
|
|
134
|
+
if cn in col_map:
|
|
135
|
+
task[en] = cells[col_map[cn]]
|
|
136
|
+
# English optional columns
|
|
137
|
+
for en in ("ownerPhase", "implementationDoneWhen", "verificationPhase", "requiresExplicitAuthority"):
|
|
138
|
+
if en.lower() in col_map:
|
|
139
|
+
task[en] = cells[col_map[en.lower()]]
|
|
140
|
+
tasks.append(task)
|
|
141
|
+
return tasks
|
|
142
|
+
|
|
143
|
+
|
|
38
144
|
def _atomic_write_json(path: Path, payload: dict[str, Any]) -> None:
|
|
39
145
|
path.parent.mkdir(parents=True, exist_ok=True)
|
|
40
146
|
fd, raw_tmp = tempfile.mkstemp(
|
|
@@ -146,6 +252,21 @@ def validate_staging(staging: Path, change_name: str) -> dict[str, Any]:
|
|
|
146
252
|
f"{rel.as_posix()}: missing reference {raw_link}",
|
|
147
253
|
)
|
|
148
254
|
|
|
255
|
+
# C8: validate ownerPhase values in plan.md task table.
|
|
256
|
+
plan_path = staging / "plans" / f"{change_name}-plan.md"
|
|
257
|
+
tasks = parse_plan_tasks(plan_path)
|
|
258
|
+
for task in tasks:
|
|
259
|
+
owner = task.get("ownerPhase")
|
|
260
|
+
if owner is not None and owner != "" and owner not in VALID_OWNER_PHASES:
|
|
261
|
+
return _result_error(
|
|
262
|
+
"PLAN_OWNER_PHASE_INVALID",
|
|
263
|
+
f"task {task.get('num', '?')}: ownerPhase '{owner}' not in {sorted(VALID_OWNER_PHASES)}",
|
|
264
|
+
)
|
|
265
|
+
|
|
266
|
+
# C9: parse test-scenarios.md for scenario manifest.
|
|
267
|
+
scenarios_path = staging / "plans" / f"{change_name}-test-scenarios.md"
|
|
268
|
+
scenarios = parse_test_scenarios(scenarios_path)
|
|
269
|
+
|
|
149
270
|
digest = hashlib.sha256()
|
|
150
271
|
artifact_names: list[str] = []
|
|
151
272
|
for path in files:
|
|
@@ -159,6 +280,8 @@ def validate_staging(staging: Path, change_name: str) -> dict[str, Any]:
|
|
|
159
280
|
"ok": True,
|
|
160
281
|
"files": artifact_names,
|
|
161
282
|
"artifactsHash": "sha256:" + digest.hexdigest(),
|
|
283
|
+
"tasks": tasks,
|
|
284
|
+
"scenarios": scenarios,
|
|
162
285
|
}
|
|
163
286
|
|
|
164
287
|
|
|
@@ -367,6 +490,30 @@ def finalize_plan(
|
|
|
367
490
|
finally:
|
|
368
491
|
tmp.unlink(missing_ok=True)
|
|
369
492
|
|
|
493
|
+
# C8: write implementation-checkpoints.json with parsed task ownerPhase.
|
|
494
|
+
tasks = validation.get("tasks") or []
|
|
495
|
+
if tasks:
|
|
496
|
+
checkpoints_path = change_dir / "meta" / "implementation-checkpoints.json"
|
|
497
|
+
checkpoints_payload = {
|
|
498
|
+
"schemaVersion": 1,
|
|
499
|
+
"changeName": change_name,
|
|
500
|
+
"tasks": tasks,
|
|
501
|
+
"foundationGate": "approved",
|
|
502
|
+
}
|
|
503
|
+
_atomic_write_json(checkpoints_path, checkpoints_payload)
|
|
504
|
+
created.append(checkpoints_path)
|
|
505
|
+
|
|
506
|
+
# C9: write scenario-manifest.json with parsed scenarios.
|
|
507
|
+
scenarios = validation.get("scenarios") or []
|
|
508
|
+
manifest_path = change_dir / "meta" / "scenario-manifest.json"
|
|
509
|
+
manifest_payload = {
|
|
510
|
+
"schemaVersion": 1,
|
|
511
|
+
"changeName": change_name,
|
|
512
|
+
"scenarios": scenarios,
|
|
513
|
+
}
|
|
514
|
+
_atomic_write_json(manifest_path, manifest_payload)
|
|
515
|
+
created.append(manifest_path)
|
|
516
|
+
|
|
370
517
|
pending_receipt = {
|
|
371
518
|
"schemaVersion": SCHEMA_VERSION,
|
|
372
519
|
"changeName": change_name,
|
|
@@ -27,6 +27,12 @@ import sys
|
|
|
27
27
|
from pathlib import Path
|
|
28
28
|
from typing import Any
|
|
29
29
|
|
|
30
|
+
SCRIPTS_DIR = Path(__file__).resolve().parent
|
|
31
|
+
if str(SCRIPTS_DIR) not in sys.path:
|
|
32
|
+
sys.path.insert(0, str(SCRIPTS_DIR))
|
|
33
|
+
|
|
34
|
+
import harness_paths # noqa: E402
|
|
35
|
+
|
|
30
36
|
|
|
31
37
|
if hasattr(sys.stdout, "reconfigure"):
|
|
32
38
|
sys.stdout.reconfigure(encoding="utf-8")
|
|
@@ -358,14 +364,53 @@ def empty_profile_skeleton(excluded: tuple[str, ...] | list[str]) -> dict[str, A
|
|
|
358
364
|
|
|
359
365
|
|
|
360
366
|
def load_profile(project: Path) -> dict[str, Any] | None:
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
+
"""C7: 分层读取 — 先读 common_root 的 build-profile.json,再叠加 execution root 的 override。
|
|
368
|
+
|
|
369
|
+
common_root 是 worktree 共享的主项目根(git common dir 的父目录);
|
|
370
|
+
execution root 是当前工作目录(可能是 linked worktree)。
|
|
371
|
+
override 合并策略:execution 的 buildCommands 覆盖 common 的同名 key;
|
|
372
|
+
common 独有的 key 保留。
|
|
373
|
+
"""
|
|
374
|
+
project = Path(project).resolve()
|
|
375
|
+
common = harness_paths.common_root(project)
|
|
376
|
+
common_path = common / PROFILE_REL
|
|
377
|
+
exec_path = project / PROFILE_REL
|
|
378
|
+
|
|
379
|
+
common_data: dict[str, Any] | None = None
|
|
380
|
+
if common_path.is_file():
|
|
381
|
+
try:
|
|
382
|
+
data = read_json(common_path)
|
|
383
|
+
if isinstance(data, dict):
|
|
384
|
+
common_data = data
|
|
385
|
+
except (OSError, json.JSONDecodeError):
|
|
386
|
+
pass
|
|
387
|
+
|
|
388
|
+
exec_data: dict[str, Any] | None = None
|
|
389
|
+
if exec_path.is_file():
|
|
390
|
+
try:
|
|
391
|
+
data = read_json(exec_path)
|
|
392
|
+
if isinstance(data, dict):
|
|
393
|
+
exec_data = data
|
|
394
|
+
except (OSError, json.JSONDecodeError):
|
|
395
|
+
pass
|
|
396
|
+
|
|
397
|
+
if common_data is None and exec_data is None:
|
|
367
398
|
return None
|
|
368
|
-
|
|
399
|
+
if common_data is None:
|
|
400
|
+
return exec_data
|
|
401
|
+
if exec_data is None:
|
|
402
|
+
return common_data
|
|
403
|
+
|
|
404
|
+
# Merge: start from common, overlay execution's buildCommands.
|
|
405
|
+
merged = dict(common_data)
|
|
406
|
+
common_cmds = common_data.get("buildCommands") or {}
|
|
407
|
+
exec_cmds = exec_data.get("buildCommands") or {}
|
|
408
|
+
if common_cmds or exec_cmds:
|
|
409
|
+
merged_cmds = dict(common_cmds) if isinstance(common_cmds, dict) else {}
|
|
410
|
+
if isinstance(exec_cmds, dict):
|
|
411
|
+
merged_cmds.update(exec_cmds)
|
|
412
|
+
merged["buildCommands"] = merged_cmds
|
|
413
|
+
return merged
|
|
369
414
|
|
|
370
415
|
|
|
371
416
|
def _merge_user_overrides(
|
|
@@ -616,6 +661,8 @@ def resolve_command(
|
|
|
616
661
|
*,
|
|
617
662
|
test_classes: list[str] | None = None,
|
|
618
663
|
modules: list[str] | None = None,
|
|
664
|
+
common_root: Path | None = None,
|
|
665
|
+
execution_root: Path | None = None,
|
|
619
666
|
) -> dict[str, Any]:
|
|
620
667
|
cmd = (profile.get("commands") or {}).get(key)
|
|
621
668
|
if not isinstance(cmd, dict):
|
|
@@ -625,6 +672,10 @@ def resolve_command(
|
|
|
625
672
|
replacements["{testClasses}"] = ",".join(test_classes)
|
|
626
673
|
if modules is not None:
|
|
627
674
|
replacements["{modules}"] = ",".join(modules)
|
|
675
|
+
if common_root is not None:
|
|
676
|
+
replacements["{commonRoot}"] = str(common_root)
|
|
677
|
+
if execution_root is not None:
|
|
678
|
+
replacements["{executionRoot}"] = str(execution_root)
|
|
628
679
|
|
|
629
680
|
command = cmd.get("command", "")
|
|
630
681
|
for placeholder, val in replacements.items():
|
|
@@ -14,6 +14,7 @@ Python 3.10+, stdlib only.
|
|
|
14
14
|
from __future__ import annotations
|
|
15
15
|
|
|
16
16
|
import argparse
|
|
17
|
+
import datetime as dt
|
|
17
18
|
import hashlib
|
|
18
19
|
import json
|
|
19
20
|
import os
|
|
@@ -270,6 +271,112 @@ def _emit(payload: Any, *, as_json: bool) -> int:
|
|
|
270
271
|
return 0 if payload.get("ok") else 1
|
|
271
272
|
|
|
272
273
|
|
|
274
|
+
def dispatch_review(
|
|
275
|
+
*,
|
|
276
|
+
change_dir: Path,
|
|
277
|
+
run_id: str,
|
|
278
|
+
budget_seconds: int = 300,
|
|
279
|
+
) -> dict[str, Any]:
|
|
280
|
+
"""C11: dispatch a bounded review task.
|
|
281
|
+
|
|
282
|
+
Returns reviewTaskId / deadline / heartbeatAt. The caller is expected to
|
|
283
|
+
poll the review subagent and collect partial findings on timeout.
|
|
284
|
+
"""
|
|
285
|
+
now = dt.datetime.now(dt.timezone.utc).astimezone()
|
|
286
|
+
task_id = f"review-{uuid.uuid4().hex}"
|
|
287
|
+
deadline = now + dt.timedelta(seconds=budget_seconds)
|
|
288
|
+
# heartbeat at midpoint of the budget
|
|
289
|
+
heartbeat = now + dt.timedelta(seconds=budget_seconds // 2)
|
|
290
|
+
return {
|
|
291
|
+
"ok": True,
|
|
292
|
+
"code": "DISPATCHED",
|
|
293
|
+
"reviewTaskId": task_id,
|
|
294
|
+
"runId": run_id,
|
|
295
|
+
"deadline": deadline.isoformat(timespec="milliseconds"),
|
|
296
|
+
"heartbeatAt": heartbeat.isoformat(timespec="milliseconds"),
|
|
297
|
+
"budgetSeconds": budget_seconds,
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
|
|
301
|
+
def collect_partial_findings(
|
|
302
|
+
*,
|
|
303
|
+
change_dir: Path,
|
|
304
|
+
run_id: str,
|
|
305
|
+
completed_dimensions: list[str],
|
|
306
|
+
pending_dimensions: list[str],
|
|
307
|
+
) -> dict[str, Any]:
|
|
308
|
+
"""C11: collect partial findings after timeout — completed dimensions only.
|
|
309
|
+
|
|
310
|
+
Applies the degradation matrix to decide the fallback path.
|
|
311
|
+
"""
|
|
312
|
+
matrix = degradation_matrix(
|
|
313
|
+
subagent_timed_out=bool(pending_dimensions),
|
|
314
|
+
main_session_available=True,
|
|
315
|
+
)
|
|
316
|
+
return {
|
|
317
|
+
"ok": True,
|
|
318
|
+
"code": "PARTIAL_FINDINGS",
|
|
319
|
+
"runId": run_id,
|
|
320
|
+
"completedDimensions": list(completed_dimensions),
|
|
321
|
+
"pendingDimensions": list(pending_dimensions),
|
|
322
|
+
"degradationMatrix": matrix,
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
|
|
326
|
+
def degradation_matrix(
|
|
327
|
+
*,
|
|
328
|
+
subagent_timed_out: bool,
|
|
329
|
+
main_session_available: bool,
|
|
330
|
+
) -> dict[str, Any]:
|
|
331
|
+
"""C11: degradation matrix — subagent timeout → main session; main fail → ADVISORY."""
|
|
332
|
+
if not subagent_timed_out:
|
|
333
|
+
return {"fallback": "none", "status": "OK"}
|
|
334
|
+
if main_session_available:
|
|
335
|
+
return {"fallback": "main-session", "status": "DEGRADED"}
|
|
336
|
+
return {"fallback": "advisory", "status": "ADVISORY"}
|
|
337
|
+
|
|
338
|
+
|
|
339
|
+
def validate_codegraph_identity(
|
|
340
|
+
*,
|
|
341
|
+
response: dict[str, Any],
|
|
342
|
+
expected_repository_id: str,
|
|
343
|
+
expected_head: str,
|
|
344
|
+
) -> dict[str, Any]:
|
|
345
|
+
"""C12: validate CodeGraph identity — repositoryId/indexedHead must match.
|
|
346
|
+
|
|
347
|
+
On mismatch, signal CODEGRAPH_IDENTITY_MISMATCH with fallback to Grep/Glob + Read.
|
|
348
|
+
"""
|
|
349
|
+
repo_id = response.get("repositoryId")
|
|
350
|
+
indexed_head = response.get("indexedHead")
|
|
351
|
+
indexed_at = response.get("indexedAt")
|
|
352
|
+
if (
|
|
353
|
+
repo_id == expected_repository_id
|
|
354
|
+
and indexed_head == expected_head
|
|
355
|
+
and indexed_at
|
|
356
|
+
):
|
|
357
|
+
return {
|
|
358
|
+
"ok": True,
|
|
359
|
+
"code": "IDENTITY_OK",
|
|
360
|
+
"repositoryId": repo_id,
|
|
361
|
+
"indexedHead": indexed_head,
|
|
362
|
+
"indexedAt": indexed_at,
|
|
363
|
+
}
|
|
364
|
+
return {
|
|
365
|
+
"ok": False,
|
|
366
|
+
"code": "CODEGRAPH_IDENTITY_MISMATCH",
|
|
367
|
+
"expected": {
|
|
368
|
+
"repositoryId": expected_repository_id,
|
|
369
|
+
"indexedHead": expected_head,
|
|
370
|
+
},
|
|
371
|
+
"actual": {
|
|
372
|
+
"repositoryId": repo_id,
|
|
373
|
+
"indexedHead": indexed_head,
|
|
374
|
+
"indexedAt": indexed_at,
|
|
375
|
+
},
|
|
376
|
+
"fallback": "grep-glob-read",
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
|
|
273
380
|
def cmd_validate_findings(args: argparse.Namespace) -> int:
|
|
274
381
|
doc = _read_json(Path(args.input))
|
|
275
382
|
problems = validate_findings(doc)
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: harness-apidoc
|
|
3
3
|
description: 从 Java 后端代码生成结构化前端 API 文档(Controller/VO/ErrorCode)。使用场景:接口文档、前端接口文档、API 文档生成
|
|
4
4
|
---
|
|
5
|
-
<!-- generated by harness_deploy.py; core=
|
|
5
|
+
<!-- generated by harness_deploy.py; core=c42bb93a903746aa; overlay=java; agent=codex; do not edit -->
|
|
6
6
|
# harness-apidoc — 前端接口文档(Java overlay)
|
|
7
7
|
|
|
8
8
|
## Purpose
|
|
@@ -3,7 +3,7 @@ name: harness-archive
|
|
|
3
3
|
description: 归档所有变更产出(计划/测试报告/审查/SQL/API文档)到
|
|
4
4
|
.harness/archive/,含归档元数据和可视化最终总结。使用场景:归档、完成归档、收尾、打包产出物
|
|
5
5
|
---
|
|
6
|
-
<!-- generated by harness_deploy.py; core=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=c42bb93a903746aa; overlay=java; agent=codex; do not edit -->
|
|
7
7
|
# harness-archive — 变更归档
|
|
8
8
|
|
|
9
9
|
## Purpose
|
|
@@ -3,7 +3,7 @@ name: harness-codebase-map
|
|
|
3
3
|
description: 分析现有代码库并生成 .harness/codebase/map/
|
|
4
4
|
下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。
|
|
5
5
|
---
|
|
6
|
-
<!-- generated by harness_deploy.py; core=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=c42bb93a903746aa; overlay=java; agent=codex; do not edit -->
|
|
7
7
|
# harness-codebase-map — 代码库地图
|
|
8
8
|
|
|
9
9
|
## Purpose
|
|
@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
|
|
|
3
3
|
description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景:ingest knowledge、sync
|
|
4
4
|
knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
|
|
5
5
|
---
|
|
6
|
-
<!-- generated by harness_deploy.py; core=
|
|
6
|
+
<!-- generated by harness_deploy.py; core=c42bb93a903746aa; overlay=java; agent=codex; do not edit -->
|
|
7
7
|
# harness-knowledge-ingest
|
|
8
8
|
|
|
9
9
|
从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识,生成并维护本地 `.harness/knowledge/` 索引。
|