rungate 0.2.0 → 0.3.0
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/bin/rungate.ts +70 -0
- package/lib/aes-calculator.ts +66 -0
- package/lib/agent-audit.ts +139 -0
- package/lib/agent-brief-validation.ts +359 -0
- package/lib/agents-md-refs.ts +90 -0
- package/lib/bash-file-read.ts +197 -0
- package/lib/behavioral-cache.ts +78 -0
- package/lib/branch-cleanup.ts +234 -0
- package/lib/brief-context-parser.ts +35 -0
- package/lib/canary.ts +117 -0
- package/lib/check-registry.ts +226 -0
- package/lib/ci-checkout.ts +400 -0
- package/lib/cli-commands.ts +137 -0
- package/lib/compliance-backfill.ts +220 -0
- package/lib/compliance-report.ts +504 -0
- package/lib/compliance.ts +361 -0
- package/lib/config-loader.ts +255 -0
- package/lib/conformity.ts +1818 -131
- package/lib/container-provenance.ts +230 -0
- package/lib/create-brief.ts +150 -0
- package/lib/create-sc.ts +272 -0
- package/lib/deep-merge.ts +69 -0
- package/lib/dev-liveness.ts +214 -0
- package/lib/directive-extractor.ts +210 -0
- package/lib/distribution-standing.ts +113 -0
- package/lib/doc-hygiene.ts +238 -0
- package/lib/eval-criteria.ts +6 -0
- package/lib/evidence-portability.ts +123 -0
- package/lib/evidence-prevalidator.ts +390 -0
- package/lib/evidence-required.ts +150 -0
- package/lib/evidence-satisfiability.ts +288 -0
- package/lib/frontmatter.ts +163 -0
- package/lib/gap-scanner.ts +348 -0
- package/lib/gate-enforcement.ts +366 -0
- package/lib/generators/agent-briefs.ts +136 -0
- package/lib/generators/agents-md.ts +506 -0
- package/lib/generators/code-map.ts +60 -0
- package/lib/generators/types.ts +184 -0
- package/lib/git-ref-normalizer.ts +107 -0
- package/lib/github.ts +539 -0
- package/lib/harness-identity.ts +63 -0
- package/lib/hill-climb.ts +164 -0
- package/lib/instruction-effectiveness.ts +131 -0
- package/lib/issue-closure-audit.ts +225 -0
- package/lib/issue-create-override.ts +343 -0
- package/lib/js-top-level-code.ts +250 -0
- package/lib/liveness-contradiction.ts +149 -0
- package/lib/organize.ts +505 -0
- package/lib/paths.ts +197 -6
- package/lib/post-fix-verify.ts +157 -0
- package/lib/prior-branch.ts +489 -0
- package/lib/project-state-shape.ts +166 -0
- package/lib/promote-outputs.ts +156 -0
- package/lib/prove-label-gate.ts +35 -0
- package/lib/reachability.ts +302 -0
- package/lib/release-preflight.ts +186 -0
- package/lib/rule-health-pipeline.ts +264 -0
- package/lib/rule-health-trend.ts +161 -0
- package/lib/rule-provenance.ts +149 -0
- package/lib/rule-registry.ts +128 -0
- package/lib/rungate-schema.ts +114 -4
- package/lib/sc-claim-forms.ts +179 -0
- package/lib/sc-cover.ts +150 -0
- package/lib/sc-guard.ts +157 -0
- package/lib/sc-ids.ts +344 -0
- package/lib/scaffold/defaults.ts +165 -0
- package/lib/scaffold/managed-workflow.ts +370 -0
- package/lib/scaffold/owned-files.ts +265 -0
- package/lib/scaffold/steps.ts +2680 -0
- package/lib/scanner.ts +701 -0
- package/lib/screenshot-upload.ts +73 -0
- package/lib/secret-patterns.ts +112 -0
- package/lib/security-verdict.ts +616 -0
- package/lib/signal-phrases.ts +1 -0
- package/lib/spec-change-conformity.ts +80 -0
- package/lib/spec-files.ts +62 -0
- package/lib/spec-registry.ts +133 -0
- package/lib/spec-updater.ts +96 -0
- package/lib/stale-cleanup.ts +224 -0
- package/lib/stale-issue-scanner.ts +36 -0
- package/lib/strip-js-comments.ts +269 -0
- package/lib/suite-measurement.ts +228 -0
- package/lib/task-completion-checks.ts +177 -0
- package/lib/test-suite-lock.ts +1136 -0
- package/lib/transcript-checker.ts +1140 -0
- package/lib/validators/spec-validators.ts +171 -0
- package/lib/verdict-capture.ts +73 -0
- package/lib/verified-push.ts +358 -0
- package/lib/workflow-security.ts +174 -0
- package/lib/worktree-cleanup.ts +250 -0
- package/lib/worktree-collect.ts +283 -0
- package/lib/worktree-isolation.ts +82 -0
- package/package.json +36 -3
- package/prompts/ac-adversary.md +14 -2
- package/prompts/aditi.md +5 -0
- package/prompts/blast-radius.md +5 -0
- package/prompts/container-verify.md +5 -0
- package/prompts/discovery.md +4 -0
- package/prompts/environment.md +5 -0
- package/prompts/evidence-hierarchy.md +5 -0
- package/prompts/evidence-validator.md +11 -0
- package/prompts/marcus.md +5 -0
- package/prompts/prevention.md +5 -0
- package/prompts/prove-reproducer.md +12 -0
- package/prompts/quinn-decision-tree.md +5 -0
- package/prompts/quinn-ui-brief.md +5 -0
- package/prompts/quinn.md +5 -0
- package/prompts/rca.md +5 -0
- package/prompts/read-before-write.md +4 -0
- package/prompts/regression.md +5 -0
- package/prompts/serena.md +5 -0
- package/scripts/audit-specs.ts +464 -0
- package/scripts/convert-spec.ts +293 -0
- package/scripts/create-sc.ts +92 -0
- package/scripts/create-spec.ts +166 -0
- package/scripts/extract-constraints.ts +4 -3
- package/scripts/generate-code-map.ts +1 -1
- package/scripts/scaffold-project.ts +138 -1426
- package/scripts/sync-spec-tests.ts +211 -126
- package/.claude/agents/aditi.md +0 -47
- package/.claude/agents/marcus.md +0 -50
- package/.claude/agents/quinn.md +0 -58
- package/.claude/agents/rook.md +0 -47
- package/.claude/agents/serena.md +0 -46
- package/.claude/rungate.json +0 -11
- package/.fallowrc.json +0 -28
- package/.github/copilot-instructions.md +0 -20
- package/.rungate/conformity-findings.json +0 -648
- package/AGENTS.md +0 -106
- package/CODE-MAP.md +0 -50
- package/HARNESS.md +0 -88
- package/bun.lock +0 -26
- package/bunfig.toml +0 -2
- package/config/brief-policies.json +0 -28
- package/config/ceremony-profiles.json +0 -212
- package/config/consumer-cascade-map.json +0 -24
- package/config/doc-cascade-map.json +0 -24
- package/config/eval.json +0 -84
- package/config/profiles/account-plan.yaml +0 -36
- package/config/profiles/campaign.yaml +0 -94
- package/config/prove-evidence.schema.json +0 -65
- package/config/spec-policies.json +0 -36
- package/config/workflow-schema.json +0 -281
- package/gates/SCHEMA-GUIDE.md +0 -121
- package/gates/ac-quality.test.ts +0 -106
- package/gates/adversarial.test.ts +0 -274
- package/gates/brief-assembler.test.ts +0 -429
- package/gates/brief-assembler.ts +0 -334
- package/gates/bunfig.toml +0 -2
- package/gates/chain.test.ts +0 -91
- package/gates/e2e-smoke.test.ts +0 -234
- package/gates/error-classifier.test.ts +0 -249
- package/gates/error-classifier.ts +0 -89
- package/gates/orchestrator.test.ts +0 -950
- package/gates/orchestrator.ts +0 -569
- package/gates/preload.ts +0 -77
- package/gates/prompts/ac-adversary.md +0 -20
- package/gates/prompts/evidence-validator.md +0 -22
- package/gates/prompts/prove-reproducer.md +0 -53
- package/gates/prove.test.ts +0 -164
- package/gates/run-gate.ts +0 -936
- package/gates/schema-parity.test.ts +0 -197
- package/gates/schema.ts +0 -362
- package/gates/self-heal.test.ts +0 -511
- package/gates/self-heal.ts +0 -121
- package/gates/ship-orchestrator.test.ts +0 -379
- package/gates/ship-orchestrator.ts +0 -363
- package/gates/test-fixtures/broken-no-environments.json +0 -60
- package/gates/test-fixtures/valid-standard.json +0 -54
- package/gates/test-utils.ts +0 -43
- package/gates/witness.ts +0 -220
- package/gates/workflow.test.ts +0 -1053
- package/hooks/AgentBriefGuard.hook.ts +0 -586
- package/hooks/AgentVerdictCapture.hook.ts +0 -134
- package/hooks/AutoVerifyGate.hook.ts +0 -76
- package/hooks/GateEnforcement.hook.ts +0 -273
- package/hooks/IssueCloseGuard.hook.ts +0 -116
- package/hooks/MergeGuard.hook.ts +0 -55
- package/hooks/StaleTTLCleanup.hook.ts +0 -133
- package/hooks/VerifyPhaseLock.hook.ts +0 -81
- package/hooks/WorkflowStateGuard.hook.ts +0 -37
- package/hooks/lib/agentDetection.ts +0 -70
- package/hooks/lib/findWorkflow.ts +0 -101
- package/hooks/lib/parseStdin.ts +0 -37
- package/hooks/lib/paths.ts +0 -111
- package/hooks/lib/utils.ts +0 -81
- package/reference/migration-manifest.json +0 -554
- package/reference/prompts/agent-aditi.md +0 -38
- package/reference/prompts/agent-marcus.md +0 -38
- package/reference/prompts/agent-quinn.md +0 -38
- package/reference/prompts/agent-rook.md +0 -37
- package/reference/prompts/agent-serena.md +0 -37
- package/reference/prompts/council-skill.md +0 -170
- package/reference/prompts/goal-skill.md +0 -235
- package/reference/prompts/prove-skill.md +0 -283
- package/reference/prompts/quinn-standard.md +0 -246
- package/reference/prompts/ship-convergence.md +0 -65
- package/reference/prompts/ship-escalation.md +0 -43
- package/reference/prompts/ship-iteration.md +0 -382
- package/reference/prompts/ship-pending-patches.md +0 -246
- package/reference/prompts/ship-reference.md +0 -250
- package/reference/prompts/ship-skill.md +0 -347
- package/reference/prompts/ship-templates.md +0 -215
- package/reference/scripts/batch-status.sh +0 -68
- package/reference/scripts/chain-compat-check.sh +0 -67
- package/reference/scripts/context-audit.sh +0 -314
- package/reference/scripts/dead-export-check.sh +0 -61
- package/reference/scripts/generate-qc-tables.sh +0 -92
- package/reference/scripts/harness-init.sh +0 -111
- package/reference/scripts/pai-054-baseline-check.sh +0 -40
- package/reference/scripts/prove-smoke-test.sh +0 -112
- package/reference/scripts/setup-keychain-salt.sh +0 -12
- package/reference/scripts/skill-optimizer-friday.sh +0 -88
- package/reference/scripts/skill-qc-test.sh +0 -351
- package/reference/scripts/skill-synthesize-tonight.sh +0 -66
- package/reference/specs/HARNESS-EXTRACTION-SPEC.md +0 -263
- package/reference/specs/harness-v3-bash-deletion-plan.md +0 -65
- package/reference/specs/harness-v3-migration-plan.md +0 -188
- package/scripts/decision-reconcile.sh +0 -74
- package/scripts/decision-reconcile.ts +0 -152
- package/scripts/git-hooks/pre-commit +0 -76
- package/scripts/git-hooks/pre-push +0 -271
- package/scripts/harness-skill-check.sh +0 -52
- package/scripts/lib/gap-emit.sh +0 -65
- package/scripts/lib/jq-update.sh +0 -30
- package/scripts/lib/resolve-slug.sh +0 -30
- package/scripts/lib/verify-spec-compliance.sh +0 -102
- package/scripts/prove-backfill.sh +0 -87
- package/scripts/scaffold-rungate-config.ts +0 -91
- package/scripts/self-containment-check.sh +0 -109
- package/scripts/skill-qc-validator.sh +0 -402
- package/scripts/slug-resolver.sh +0 -14
- package/specs/BOOTSTRAP-DATA-FLOW-SPEC.md +0 -2493
- package/specs/BOOTSTRAP-TEST-PLAN.md +0 -571
- package/specs/HARNESS-GATES.md +0 -256
- package/specs/HARNESS-SKILL-CHAIN.md +0 -286
- package/specs/HARNESS-SKILL-CONTRACT.md +0 -93
- package/specs/HARNESS-STANDARD.md +0 -488
- package/specs/SPEC-TEMPLATE.md +0 -53
- package/specs/bootstrap-data-flow.png +0 -0
- package/specs/harness-automation-matrix.md +0 -314
- package/specs/harness-automation-matrix.rules.json +0 -64
- package/test/anti.test.ts +0 -80
- package/test/contract-negative.test.ts +0 -86
- package/test/contract.test.ts +0 -158
- package/test/external-deps.test.ts +0 -48
- package/test/fixtures/golden-project/.env.example +0 -3
- package/test/fixtures/golden-project/Makefile +0 -7
- package/test/fixtures/golden-project/docs/adr/ADR-001-framework.md +0 -23
- package/test/fixtures/golden-project/docs/setup-guide.md +0 -10
- package/test/fixtures/golden-project/package.json +0 -10
- package/test/fixtures/golden-project/specs/api-spec.md +0 -20
- package/test/fixtures/golden-project/src/auth.ts +0 -8
- package/test/fixtures/golden-project/src/db.ts +0 -11
- package/test/fixtures/golden-project/src/index.ts +0 -19
- package/test/fixtures/golden-project/src/utils/format.ts +0 -3
- package/test/fixtures/golden-project/test/auth.test.ts +0 -15
- package/test/fixtures/golden-project/tsconfig.json +0 -12
- package/test/meta-sc-coverage.test.ts +0 -159
- package/test/phase-0.test.ts +0 -846
- package/test/phase-1.test.ts +0 -617
- package/test/phase-2.test.ts +0 -620
- package/test/phase-3.test.ts +0 -99
- package/test/scaffold-conformity.test.ts +0 -8
- package/test/schema-canary.test.ts +0 -51
- package/test/spec-compliance-auto.test.ts +0 -64
- package/test/spec-compliance.test.ts +0 -295
- package/test/spec-discovery.test.ts +0 -68
- package/test/spec-drift.test.ts +0 -5
- package/test/structure.test.ts +0 -165
- package/test/unit/agent-brief-guard-ship.test.ts +0 -293
- package/test/unit/extract-constraints.test.ts +0 -145
- package/test/unit/issue-close-guard.test.ts +0 -204
- package/test/unit/scaffold-project.test.ts +0 -417
- package/test/unit/skill-cooccurrence.test.ts +0 -177
- package/test/unit/skill-sequence-logger.test.ts +0 -244
- package/test/unit/workflow-state-guard.test.ts +0 -95
- package/workflows/batch-ship.js +0 -295
- package/workflows/council.js +0 -481
- package/workflows/prove.js +0 -560
- package/workflows/ship.js +0 -789
- package/workflows/verify.js +0 -236
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CODE-MAP.md generator — produces code map content from ProjectScan data.
|
|
3
|
+
*
|
|
4
|
+
* Extracted from scaffold-project.ts per SCAFFOLD-DECOMPOSITION-SPEC (D-2).
|
|
5
|
+
* Takes scan data in, produces file content out. No file I/O.
|
|
6
|
+
*/
|
|
7
|
+
import type { ProjectScan } from "./types";
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Generate CODE-MAP.md content from project scan data.
|
|
11
|
+
*
|
|
12
|
+
* Returns the full markdown string. Does NOT write files.
|
|
13
|
+
*/
|
|
14
|
+
export function generateCodeMap(scan: ProjectScan): string {
|
|
15
|
+
const today = new Date().toISOString().split("T")[0];
|
|
16
|
+
const { name, dirs, deps, devDeps, modules, routes } = scan;
|
|
17
|
+
|
|
18
|
+
let md = `---
|
|
19
|
+
doc-type: code-map
|
|
20
|
+
status: generated
|
|
21
|
+
updated: ${today}
|
|
22
|
+
generator: scaffold-project.ts
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
# Code Map — ${name}
|
|
26
|
+
|
|
27
|
+
Auto-generated architecture snapshot.
|
|
28
|
+
|
|
29
|
+
## Summary
|
|
30
|
+
|
|
31
|
+
| Metric | Count |
|
|
32
|
+
|--------|-------|
|
|
33
|
+
| Source directories | ${dirs.length} |
|
|
34
|
+
| Dependencies | ${deps} |
|
|
35
|
+
| Dev dependencies | ${devDeps} |
|
|
36
|
+
|
|
37
|
+
## Directory Structure
|
|
38
|
+
|
|
39
|
+
| Directory | Files | Types |
|
|
40
|
+
|-----------|-------|-------|
|
|
41
|
+
${dirs.map(d => `| ${d.name}/ | ${d.fileCount} | ${d.types.join(", ")} |`).join("\n")}
|
|
42
|
+
`;
|
|
43
|
+
|
|
44
|
+
if (routes.length > 0) {
|
|
45
|
+
md += `\n## API Routes\n\n| Method | Path | File |\n|--------|------|------|\n`;
|
|
46
|
+
for (const r of routes) {
|
|
47
|
+
md += `| ${r.method} | ${r.path} | ${r.file} |\n`;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
if (modules.length > 0) {
|
|
52
|
+
md += `\n## Source Modules\n\n| File | Exports |\n|------|---------|\n`;
|
|
53
|
+
for (const mod of modules) {
|
|
54
|
+
md += `| ${mod.file} | ${mod.exports.join(", ")} |\n`;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
md += "\n";
|
|
59
|
+
return md;
|
|
60
|
+
}
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ProjectScan — typed interface for scaffold scan data.
|
|
3
|
+
*
|
|
4
|
+
* Scanner produces this; generators consume it.
|
|
5
|
+
* No shared mutable state (D-5 from SCAFFOLD-DECOMPOSITION-SPEC).
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
export type ProjectType = "code" | "content" | "infra" | "workflow";
|
|
9
|
+
|
|
10
|
+
export interface KeyFile {
|
|
11
|
+
file: string;
|
|
12
|
+
what: string;
|
|
13
|
+
when: string;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
export interface SpecEntry {
|
|
17
|
+
file: string;
|
|
18
|
+
governs: string;
|
|
19
|
+
testable: string;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface TestFile {
|
|
23
|
+
label: string;
|
|
24
|
+
file: string;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export interface RefFile {
|
|
28
|
+
file: string;
|
|
29
|
+
what: string;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export interface DocRoute {
|
|
33
|
+
need: string;
|
|
34
|
+
file: string;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export interface Category {
|
|
38
|
+
dir: string;
|
|
39
|
+
label: string;
|
|
40
|
+
frontmatter: string;
|
|
41
|
+
notes: string;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
export interface DirEntry {
|
|
45
|
+
name: string;
|
|
46
|
+
fileCount: number;
|
|
47
|
+
types: string[];
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export interface ModuleEntry {
|
|
51
|
+
file: string;
|
|
52
|
+
exports: string[];
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export interface RouteEntry {
|
|
56
|
+
method: string;
|
|
57
|
+
path: string;
|
|
58
|
+
file: string;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export interface PromptRoute {
|
|
62
|
+
file: string;
|
|
63
|
+
when: string;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
export interface AgentMeta {
|
|
67
|
+
description: string;
|
|
68
|
+
tools: string;
|
|
69
|
+
model: string;
|
|
70
|
+
tiers?: Record<string, string[]>;
|
|
71
|
+
memory?: string;
|
|
72
|
+
maxTurns?: number;
|
|
73
|
+
effort?: string;
|
|
74
|
+
disallowedTools?: string[];
|
|
75
|
+
omitClaudeMd?: boolean;
|
|
76
|
+
isolation?: string;
|
|
77
|
+
hooks?: Record<string, unknown>;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export interface ProjectScan {
|
|
81
|
+
/** Project name (from package.json or directory name) */
|
|
82
|
+
name: string;
|
|
83
|
+
/** Detected project type */
|
|
84
|
+
type: ProjectType;
|
|
85
|
+
/** Absolute path to project root */
|
|
86
|
+
root: string;
|
|
87
|
+
/** Project identity/description */
|
|
88
|
+
identity: string;
|
|
89
|
+
/** Detected tech stack entries */
|
|
90
|
+
techStack: string[];
|
|
91
|
+
/** Git remote URL */
|
|
92
|
+
repoUrl: string;
|
|
93
|
+
/** Test command (e.g., "bun test") */
|
|
94
|
+
testCmd: string;
|
|
95
|
+
/** Key files for agent reference */
|
|
96
|
+
keyFiles: KeyFile[];
|
|
97
|
+
/** Spec files with governs/testable metadata */
|
|
98
|
+
specs: SpecEntry[];
|
|
99
|
+
/** Test files found */
|
|
100
|
+
testFiles: TestFile[];
|
|
101
|
+
/** Reference files */
|
|
102
|
+
refFiles: RefFile[];
|
|
103
|
+
/** Documentation routing entries */
|
|
104
|
+
docRouting: DocRoute[];
|
|
105
|
+
/** Document categories for "Where to Create" section */
|
|
106
|
+
categories: Category[];
|
|
107
|
+
/** Consumer projects */
|
|
108
|
+
consumers: string[];
|
|
109
|
+
/** Whether CODE-MAP.md exists */
|
|
110
|
+
hasCodeMap: boolean;
|
|
111
|
+
/** Makefile targets string */
|
|
112
|
+
makeTargets: string;
|
|
113
|
+
/** Source directories found */
|
|
114
|
+
sourceDirs: string[];
|
|
115
|
+
/** Per-agent prompt routing */
|
|
116
|
+
promptRouting: Record<string, PromptRoute[]>;
|
|
117
|
+
/** Harness config from .claude/rungate.json */
|
|
118
|
+
harnessConfig: Record<string, any> | null;
|
|
119
|
+
/** Agent metadata (from roles config or defaults) */
|
|
120
|
+
agentMeta: Record<string, AgentMeta>;
|
|
121
|
+
/** Directory entries for code-map */
|
|
122
|
+
dirs: DirEntry[];
|
|
123
|
+
/** Dependency count */
|
|
124
|
+
deps: number;
|
|
125
|
+
/** Dev dependency count */
|
|
126
|
+
devDeps: number;
|
|
127
|
+
/** Source modules with exports */
|
|
128
|
+
modules: ModuleEntry[];
|
|
129
|
+
/** API routes detected */
|
|
130
|
+
routes: RouteEntry[];
|
|
131
|
+
/** Harness templates directory (absolute path) */
|
|
132
|
+
harnessTemplatesDir: string;
|
|
133
|
+
/** Prompt prefix for self-scaffolding detection */
|
|
134
|
+
promptPrefix: string;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* Create a ProjectScan with sensible defaults for testing.
|
|
139
|
+
* Override any field by passing partial data.
|
|
140
|
+
*/
|
|
141
|
+
export function mockProjectScan(overrides: Partial<ProjectScan> = {}): ProjectScan {
|
|
142
|
+
return {
|
|
143
|
+
name: "mock-project",
|
|
144
|
+
type: "code",
|
|
145
|
+
root: "/tmp/mock-project",
|
|
146
|
+
identity: "Mock project for testing",
|
|
147
|
+
techStack: [],
|
|
148
|
+
repoUrl: "",
|
|
149
|
+
testCmd: "bun test",
|
|
150
|
+
keyFiles: [
|
|
151
|
+
{ file: "AGENTS.md", what: "Project entry point", when: "Always first" },
|
|
152
|
+
],
|
|
153
|
+
specs: [],
|
|
154
|
+
testFiles: [],
|
|
155
|
+
refFiles: [],
|
|
156
|
+
docRouting: [],
|
|
157
|
+
categories: [
|
|
158
|
+
{ dir: "specs", label: "Specs", frontmatter: "`doc-type: spec`", notes: "SCs auto-generate tests" },
|
|
159
|
+
{ dir: "docs/adr", label: "ADRs", frontmatter: "`doc-type: adr`", notes: "Architecture decisions" },
|
|
160
|
+
],
|
|
161
|
+
consumers: [],
|
|
162
|
+
hasCodeMap: false,
|
|
163
|
+
makeTargets: "",
|
|
164
|
+
sourceDirs: [],
|
|
165
|
+
promptRouting: {},
|
|
166
|
+
harnessConfig: null,
|
|
167
|
+
agentMeta: {
|
|
168
|
+
marcus: {
|
|
169
|
+
description: "Principal engineer",
|
|
170
|
+
tools: "[Bash, Read, Write, Edit]",
|
|
171
|
+
model: "sonnet",
|
|
172
|
+
tiers: { reinforcement: ["Testing Rules"], mechanical: ["Workflow"] },
|
|
173
|
+
},
|
|
174
|
+
},
|
|
175
|
+
dirs: [],
|
|
176
|
+
deps: 0,
|
|
177
|
+
devDeps: 0,
|
|
178
|
+
modules: [],
|
|
179
|
+
routes: [],
|
|
180
|
+
harnessTemplatesDir: "",
|
|
181
|
+
promptPrefix: "node_modules/rungate/prompts",
|
|
182
|
+
...overrides,
|
|
183
|
+
};
|
|
184
|
+
}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Rewrite bare `main` / `master` git refs in evidence commands to `origin/...`.
|
|
3
|
+
*
|
|
4
|
+
* WHY
|
|
5
|
+
*
|
|
6
|
+
* Agent worktrees come from a shared clone whose local `main` ref is whatever
|
|
7
|
+
* it was when that ref was last updated locally — not when `origin/main` last
|
|
8
|
+
* moved. Sessions work on branches and rarely check out `main`, so the local
|
|
9
|
+
* ref drifts arbitrarily far behind and every agent inherits the drift. The
|
|
10
|
+
* same evidence command, on the same commit, can pass in one worktree and fail
|
|
11
|
+
* in another. An evidence command that is not reproducible is not evidence.
|
|
12
|
+
*
|
|
13
|
+
* #118: `git diff --exit-code main -- hooks/TestSuiteGuard.hook.ts` returned 1
|
|
14
|
+
* against a file that had not been touched since #67. The verify agent reported
|
|
15
|
+
* a specific 5-line diff and recommended reverting it. Against `origin/main`
|
|
16
|
+
* the same command exits 0. The false FAIL spawned a second Marcus to "fix" a
|
|
17
|
+
* correct file and cost roughly 300k tokens before the run ended.
|
|
18
|
+
*
|
|
19
|
+
* WHY A STATIC REWRITE RATHER THAN AN AUTO-FIX
|
|
20
|
+
*
|
|
21
|
+
* `evidence-prevalidator.ts` auto-fixes commands whose dry-run fails. That is
|
|
22
|
+
* the wrong trigger here: local `main` is only *sometimes* behind, so a
|
|
23
|
+
* stale-`main` command often passes prevalidation and fails later at Verify —
|
|
24
|
+
* which is exactly the #103 case. The defect is in the text of the command, so
|
|
25
|
+
* the repair is applied to the text, unconditionally.
|
|
26
|
+
*
|
|
27
|
+
* WHY THE CONSERVATIVE MATCH
|
|
28
|
+
*
|
|
29
|
+
* Over-rewriting is worse than the bug. Turning `src/main.ts` into
|
|
30
|
+
* `src/origin/main.ts`, or `grep main` into `grep origin/main`, would
|
|
31
|
+
* manufacture false failures instead of removing them. So this only rewrites
|
|
32
|
+
* `main`/`master` in the ref position of a known git subcommand, and never
|
|
33
|
+
* after `--`, which ends the ref list and begins pathspecs.
|
|
34
|
+
*/
|
|
35
|
+
|
|
36
|
+
/** Branch names that are conventionally the integration branch. */
|
|
37
|
+
const DEFAULT_BRANCHES = ["main", "master"];
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Git subcommands whose arguments are refs. Deliberately a short allowlist:
|
|
41
|
+
* a command not on it is left untouched rather than guessed at.
|
|
42
|
+
*/
|
|
43
|
+
const REF_TAKING = ["diff", "log", "merge-base", "rev-parse", "rev-list", "describe", "shortlog"];
|
|
44
|
+
|
|
45
|
+
export interface NormalizeResult {
|
|
46
|
+
/** The command, with bare default-branch refs qualified to origin/. */
|
|
47
|
+
command: string;
|
|
48
|
+
/** True when at least one ref was rewritten. */
|
|
49
|
+
changed: boolean;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Rewrite the ref-bearing segment of each `git <refcmd> ...` in a command.
|
|
54
|
+
*
|
|
55
|
+
* Operates per git invocation so that a compound command
|
|
56
|
+
* (`git log main..HEAD && git diff main`) has every invocation covered, and so
|
|
57
|
+
* that a non-git command in the same chain is never considered.
|
|
58
|
+
*/
|
|
59
|
+
export function normalizeGitRefs(command: string): NormalizeResult {
|
|
60
|
+
if (!command) return { command, changed: false };
|
|
61
|
+
|
|
62
|
+
let changed = false;
|
|
63
|
+
const branches = DEFAULT_BRANCHES.join("|");
|
|
64
|
+
|
|
65
|
+
// Match a git invocation up to the end of its ref list: either the `--`
|
|
66
|
+
// pathspec separator, a shell operator that ends the command, or end of
|
|
67
|
+
// string. Only that span is eligible for rewriting.
|
|
68
|
+
const invocation = new RegExp(
|
|
69
|
+
String.raw`\bgit\s+(?:-C\s+\S+\s+)?(${REF_TAKING.join("|")})\b([^|&;]*?)(?=\s--\s|\s*[|&;]|$)`,
|
|
70
|
+
"g",
|
|
71
|
+
);
|
|
72
|
+
|
|
73
|
+
const out = command.replace(invocation, (whole, sub: string, args: string) => {
|
|
74
|
+
// A bare default branch is a ref only when it stands alone as a word, or
|
|
75
|
+
// heads a range (`main..HEAD`, `main...HEAD`).
|
|
76
|
+
//
|
|
77
|
+
// The two lookarounds do different jobs and both are load-bearing:
|
|
78
|
+
//
|
|
79
|
+
// (?<![\w/.-]) nothing path-like or remote-like precedes it. Blocks
|
|
80
|
+
// `origin/main`, `upstream/main` and `src/main` — and is
|
|
81
|
+
// what makes a second pass a no-op instead of producing
|
|
82
|
+
// `origin/origin/main`.
|
|
83
|
+
// (?![\w/-]) not the head of a longer word or path: `maintenance`,
|
|
84
|
+
// `main/sub`.
|
|
85
|
+
// (?!\.\w) not a filename: `main.ts` is blocked, but `main..HEAD`
|
|
86
|
+
// is NOT, because the character after the first dot is
|
|
87
|
+
// another dot rather than a word character. A single
|
|
88
|
+
// `(?![\w/.-])` collapsed these two cases together and
|
|
89
|
+
// silently refused to fix the range form, which is the
|
|
90
|
+
// most common shape an evidence command actually uses.
|
|
91
|
+
const rewritten = args.replace(
|
|
92
|
+
new RegExp(String.raw`(?<![\w/.-])(${branches})(?![\w/-])(?!\.\w)`, "g"),
|
|
93
|
+
(m) => { changed = true; return `origin/${m}`; },
|
|
94
|
+
);
|
|
95
|
+
return `git ${whole.slice(4).replace(args, rewritten)}`;
|
|
96
|
+
});
|
|
97
|
+
|
|
98
|
+
return { command: out, changed };
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* Convenience predicate for tests and gates: does this command reference a
|
|
103
|
+
* default branch without qualifying it to a remote?
|
|
104
|
+
*/
|
|
105
|
+
export function hasBareDefaultBranchRef(command: string): boolean {
|
|
106
|
+
return normalizeGitRefs(command).changed;
|
|
107
|
+
}
|