rungate 0.2.1 → 0.4.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.
Files changed (129) hide show
  1. package/bin/rungate.ts +70 -0
  2. package/lib/aes-calculator.ts +66 -0
  3. package/lib/agent-audit.ts +139 -0
  4. package/lib/agent-brief-validation.ts +359 -0
  5. package/lib/agents-md-refs.ts +90 -0
  6. package/lib/bash-file-read.ts +197 -0
  7. package/lib/behavioral-cache.ts +78 -0
  8. package/lib/branch-cleanup.ts +234 -0
  9. package/lib/brief-context-parser.ts +35 -0
  10. package/lib/brief-precedence.ts +114 -0
  11. package/lib/canary.ts +117 -0
  12. package/lib/check-registry.ts +226 -0
  13. package/lib/ci-checkout.ts +426 -0
  14. package/lib/cli-commands.ts +137 -0
  15. package/lib/compliance-backfill.ts +232 -0
  16. package/lib/compliance-report.ts +605 -0
  17. package/lib/compliance.ts +361 -0
  18. package/lib/config-loader.ts +255 -0
  19. package/lib/config-readers.ts +86 -0
  20. package/lib/conformity.ts +2161 -137
  21. package/lib/container-provenance.ts +230 -0
  22. package/lib/create-brief.ts +150 -0
  23. package/lib/create-sc.ts +267 -0
  24. package/lib/decomposition-waves.ts +197 -0
  25. package/lib/deep-merge.ts +69 -0
  26. package/lib/dev-liveness.ts +214 -0
  27. package/lib/directive-extractor.ts +210 -0
  28. package/lib/distribution-standing.ts +113 -0
  29. package/lib/doc-hygiene.ts +238 -0
  30. package/lib/eval-criteria.ts +6 -0
  31. package/lib/evidence-portability.ts +123 -0
  32. package/lib/evidence-prevalidator.ts +390 -0
  33. package/lib/evidence-required.ts +150 -0
  34. package/lib/evidence-satisfiability.ts +288 -0
  35. package/lib/frontmatter.ts +163 -0
  36. package/lib/gap-scanner.ts +348 -0
  37. package/lib/gate-check-audit.ts +190 -0
  38. package/lib/gate-enforcement.ts +366 -0
  39. package/lib/generators/agent-briefs.ts +136 -0
  40. package/lib/generators/agents-md.ts +511 -0
  41. package/lib/generators/code-map.ts +60 -0
  42. package/lib/generators/types.ts +184 -0
  43. package/lib/git-ref-normalizer.ts +107 -0
  44. package/lib/github.ts +539 -0
  45. package/lib/harness-identity.ts +63 -0
  46. package/lib/hill-climb.ts +164 -0
  47. package/lib/instruction-effectiveness.ts +131 -0
  48. package/lib/issue-closure-audit.ts +225 -0
  49. package/lib/issue-create-override.ts +343 -0
  50. package/lib/issue-extraction.ts +368 -0
  51. package/lib/js-top-level-code.ts +250 -0
  52. package/lib/liveness-contradiction.ts +149 -0
  53. package/lib/organize.ts +505 -0
  54. package/lib/paths.ts +197 -6
  55. package/lib/phase2-decomposition.ts +270 -0
  56. package/lib/post-fix-verify.ts +157 -0
  57. package/lib/prior-branch.ts +512 -0
  58. package/lib/project-state-shape.ts +166 -0
  59. package/lib/promote-outputs.ts +156 -0
  60. package/lib/prove-label-gate.ts +128 -0
  61. package/lib/reachability.ts +302 -0
  62. package/lib/release-preflight.ts +288 -0
  63. package/lib/rule-health-pipeline.ts +264 -0
  64. package/lib/rule-health-trend.ts +161 -0
  65. package/lib/rule-provenance.ts +149 -0
  66. package/lib/rule-registry.ts +128 -0
  67. package/lib/rungate-schema.ts +127 -5
  68. package/lib/sc-claim-forms.ts +179 -0
  69. package/lib/sc-cover.ts +150 -0
  70. package/lib/sc-guard.ts +157 -0
  71. package/lib/sc-ids.ts +344 -0
  72. package/lib/scaffold/defaults.ts +165 -0
  73. package/lib/scaffold/managed-workflow.ts +370 -0
  74. package/lib/scaffold/owned-files.ts +265 -0
  75. package/lib/scaffold/pre-push-hook.ts +165 -0
  76. package/lib/scaffold/steps.ts +2621 -0
  77. package/lib/scanner.ts +701 -0
  78. package/lib/scope-denylist.ts +258 -0
  79. package/lib/screenshot-upload.ts +73 -0
  80. package/lib/secret-patterns.ts +112 -0
  81. package/lib/security-verdict.ts +616 -0
  82. package/lib/signal-phrases.ts +1 -0
  83. package/lib/spec-change-conformity.ts +80 -0
  84. package/lib/spec-files.ts +62 -0
  85. package/lib/spec-registry.ts +133 -0
  86. package/lib/spec-updater.ts +96 -0
  87. package/lib/stale-cleanup.ts +224 -0
  88. package/lib/stale-issue-scanner.ts +36 -0
  89. package/lib/strip-js-comments.ts +269 -0
  90. package/lib/suite-measurement.ts +228 -0
  91. package/lib/task-completion-checks.ts +224 -0
  92. package/lib/test-suite-lock.ts +1136 -0
  93. package/lib/transcript-checker.ts +1140 -0
  94. package/lib/typescript-project.ts +233 -0
  95. package/lib/validators/spec-validators.ts +171 -0
  96. package/lib/verdict-capture.ts +73 -0
  97. package/lib/verified-push.ts +535 -0
  98. package/lib/workflow-security.ts +174 -0
  99. package/lib/worktree-cleanup.ts +432 -0
  100. package/lib/worktree-collect.ts +283 -0
  101. package/lib/worktree-isolation.ts +82 -0
  102. package/lib/worktree-repo.ts +300 -0
  103. package/package.json +27 -3
  104. package/prompts/ac-adversary.md +14 -2
  105. package/prompts/aditi.md +5 -0
  106. package/prompts/blast-radius.md +5 -0
  107. package/prompts/container-verify.md +5 -0
  108. package/prompts/discovery.md +4 -0
  109. package/prompts/environment.md +5 -0
  110. package/prompts/evidence-hierarchy.md +5 -0
  111. package/prompts/evidence-validator.md +11 -0
  112. package/prompts/marcus.md +5 -0
  113. package/prompts/prevention.md +5 -0
  114. package/prompts/prove-reproducer.md +12 -0
  115. package/prompts/quinn-decision-tree.md +5 -0
  116. package/prompts/quinn-ui-brief.md +5 -0
  117. package/prompts/quinn.md +5 -0
  118. package/prompts/rca.md +5 -0
  119. package/prompts/read-before-write.md +4 -0
  120. package/prompts/regression.md +5 -0
  121. package/prompts/serena.md +5 -0
  122. package/scripts/audit-specs.ts +464 -0
  123. package/scripts/convert-spec.ts +293 -0
  124. package/scripts/create-sc.ts +92 -0
  125. package/scripts/create-spec.ts +166 -0
  126. package/scripts/extract-constraints.ts +4 -3
  127. package/scripts/generate-code-map.ts +1 -1
  128. package/scripts/scaffold-project.ts +138 -1426
  129. package/scripts/sync-spec-tests.ts +211 -126
@@ -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
+ }