rungate 0.2.1 → 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.
Files changed (119) 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/canary.ts +117 -0
  11. package/lib/check-registry.ts +226 -0
  12. package/lib/ci-checkout.ts +400 -0
  13. package/lib/cli-commands.ts +137 -0
  14. package/lib/compliance-backfill.ts +220 -0
  15. package/lib/compliance-report.ts +504 -0
  16. package/lib/compliance.ts +361 -0
  17. package/lib/config-loader.ts +255 -0
  18. package/lib/conformity.ts +1818 -131
  19. package/lib/container-provenance.ts +230 -0
  20. package/lib/create-brief.ts +150 -0
  21. package/lib/create-sc.ts +272 -0
  22. package/lib/deep-merge.ts +69 -0
  23. package/lib/dev-liveness.ts +214 -0
  24. package/lib/directive-extractor.ts +210 -0
  25. package/lib/distribution-standing.ts +113 -0
  26. package/lib/doc-hygiene.ts +238 -0
  27. package/lib/eval-criteria.ts +6 -0
  28. package/lib/evidence-portability.ts +123 -0
  29. package/lib/evidence-prevalidator.ts +390 -0
  30. package/lib/evidence-required.ts +150 -0
  31. package/lib/evidence-satisfiability.ts +288 -0
  32. package/lib/frontmatter.ts +163 -0
  33. package/lib/gap-scanner.ts +348 -0
  34. package/lib/gate-enforcement.ts +366 -0
  35. package/lib/generators/agent-briefs.ts +136 -0
  36. package/lib/generators/agents-md.ts +506 -0
  37. package/lib/generators/code-map.ts +60 -0
  38. package/lib/generators/types.ts +184 -0
  39. package/lib/git-ref-normalizer.ts +107 -0
  40. package/lib/github.ts +539 -0
  41. package/lib/harness-identity.ts +63 -0
  42. package/lib/hill-climb.ts +164 -0
  43. package/lib/instruction-effectiveness.ts +131 -0
  44. package/lib/issue-closure-audit.ts +225 -0
  45. package/lib/issue-create-override.ts +343 -0
  46. package/lib/js-top-level-code.ts +250 -0
  47. package/lib/liveness-contradiction.ts +149 -0
  48. package/lib/organize.ts +505 -0
  49. package/lib/paths.ts +197 -6
  50. package/lib/post-fix-verify.ts +157 -0
  51. package/lib/prior-branch.ts +489 -0
  52. package/lib/project-state-shape.ts +166 -0
  53. package/lib/promote-outputs.ts +156 -0
  54. package/lib/prove-label-gate.ts +35 -0
  55. package/lib/reachability.ts +302 -0
  56. package/lib/release-preflight.ts +186 -0
  57. package/lib/rule-health-pipeline.ts +264 -0
  58. package/lib/rule-health-trend.ts +161 -0
  59. package/lib/rule-provenance.ts +149 -0
  60. package/lib/rule-registry.ts +128 -0
  61. package/lib/rungate-schema.ts +114 -4
  62. package/lib/sc-claim-forms.ts +179 -0
  63. package/lib/sc-cover.ts +150 -0
  64. package/lib/sc-guard.ts +157 -0
  65. package/lib/sc-ids.ts +344 -0
  66. package/lib/scaffold/defaults.ts +165 -0
  67. package/lib/scaffold/managed-workflow.ts +370 -0
  68. package/lib/scaffold/owned-files.ts +265 -0
  69. package/lib/scaffold/steps.ts +2680 -0
  70. package/lib/scanner.ts +701 -0
  71. package/lib/screenshot-upload.ts +73 -0
  72. package/lib/secret-patterns.ts +112 -0
  73. package/lib/security-verdict.ts +616 -0
  74. package/lib/signal-phrases.ts +1 -0
  75. package/lib/spec-change-conformity.ts +80 -0
  76. package/lib/spec-files.ts +62 -0
  77. package/lib/spec-registry.ts +133 -0
  78. package/lib/spec-updater.ts +96 -0
  79. package/lib/stale-cleanup.ts +224 -0
  80. package/lib/stale-issue-scanner.ts +36 -0
  81. package/lib/strip-js-comments.ts +269 -0
  82. package/lib/suite-measurement.ts +228 -0
  83. package/lib/task-completion-checks.ts +177 -0
  84. package/lib/test-suite-lock.ts +1136 -0
  85. package/lib/transcript-checker.ts +1140 -0
  86. package/lib/validators/spec-validators.ts +171 -0
  87. package/lib/verdict-capture.ts +73 -0
  88. package/lib/verified-push.ts +358 -0
  89. package/lib/workflow-security.ts +174 -0
  90. package/lib/worktree-cleanup.ts +250 -0
  91. package/lib/worktree-collect.ts +283 -0
  92. package/lib/worktree-isolation.ts +82 -0
  93. package/package.json +24 -2
  94. package/prompts/ac-adversary.md +14 -2
  95. package/prompts/aditi.md +5 -0
  96. package/prompts/blast-radius.md +5 -0
  97. package/prompts/container-verify.md +5 -0
  98. package/prompts/discovery.md +4 -0
  99. package/prompts/environment.md +5 -0
  100. package/prompts/evidence-hierarchy.md +5 -0
  101. package/prompts/evidence-validator.md +11 -0
  102. package/prompts/marcus.md +5 -0
  103. package/prompts/prevention.md +5 -0
  104. package/prompts/prove-reproducer.md +12 -0
  105. package/prompts/quinn-decision-tree.md +5 -0
  106. package/prompts/quinn-ui-brief.md +5 -0
  107. package/prompts/quinn.md +5 -0
  108. package/prompts/rca.md +5 -0
  109. package/prompts/read-before-write.md +4 -0
  110. package/prompts/regression.md +5 -0
  111. package/prompts/serena.md +5 -0
  112. package/scripts/audit-specs.ts +464 -0
  113. package/scripts/convert-spec.ts +293 -0
  114. package/scripts/create-sc.ts +92 -0
  115. package/scripts/create-spec.ts +166 -0
  116. package/scripts/extract-constraints.ts +4 -3
  117. package/scripts/generate-code-map.ts +1 -1
  118. package/scripts/scaffold-project.ts +138 -1426
  119. package/scripts/sync-spec-tests.ts +211 -126
@@ -0,0 +1,73 @@
1
+ import { existsSync, readFileSync } from "fs";
2
+ import { basename } from "path";
3
+ import { $ } from "bun";
4
+
5
+ export interface UploadResult {
6
+ uploaded: string[];
7
+ failed: string[];
8
+ markdownLinks: string[];
9
+ }
10
+
11
+ /**
12
+ * Uploads screenshot files to GitHub via gists and returns markdown image links.
13
+ *
14
+ * Uses `gh gist create` to upload each screenshot file, then converts the gist URL
15
+ * to a raw content URL suitable for markdown embedding.
16
+ *
17
+ * @param issue - GitHub issue number (for future use in direct issue attachments)
18
+ * @param repo - Repository in owner/repo format
19
+ * @param screenshotPaths - Array of absolute paths to screenshot files
20
+ * @returns UploadResult with uploaded files, failed files, and markdown links
21
+ */
22
+ export async function uploadScreenshotsToIssue(
23
+ issue: number,
24
+ repo: string,
25
+ screenshotPaths: string[],
26
+ ): Promise<UploadResult> {
27
+ const result: UploadResult = {
28
+ uploaded: [],
29
+ failed: [],
30
+ markdownLinks: [],
31
+ };
32
+
33
+ if (screenshotPaths.length === 0) {
34
+ return result;
35
+ }
36
+
37
+ for (const filePath of screenshotPaths) {
38
+ // Check if file exists
39
+ if (!existsSync(filePath)) {
40
+ result.failed.push(filePath);
41
+ continue;
42
+ }
43
+
44
+ try {
45
+ // Upload to GitHub gist
46
+ // gh gist create returns the gist URL on stdout
47
+ const gistResult = await $`gh gist create --public ${filePath}`.text();
48
+ const gistUrl = gistResult.trim();
49
+
50
+ if (!gistUrl || !gistUrl.startsWith("https://gist.github.com/")) {
51
+ result.failed.push(filePath);
52
+ continue;
53
+ }
54
+
55
+ // Convert gist URL to raw content URL
56
+ // https://gist.github.com/user/abc123 → https://gist.githubusercontent.com/user/abc123/raw/filename.png
57
+ const gistId = gistUrl.split("/").pop();
58
+ const filename = basename(filePath);
59
+ const rawUrl = `https://gist.githubusercontent.com/${repo.split("/")[0]}/${gistId}/raw/${filename}`;
60
+
61
+ // Create markdown image link
62
+ const markdownLink = `![${filename}](${rawUrl})`;
63
+
64
+ result.uploaded.push(filePath);
65
+ result.markdownLinks.push(markdownLink);
66
+ } catch (error) {
67
+ result.failed.push(filePath);
68
+ console.error(`Failed to upload ${filePath}:`, error);
69
+ }
70
+ }
71
+
72
+ return result;
73
+ }
@@ -0,0 +1,112 @@
1
+ /**
2
+ * The single registry of secret patterns used by every scanner we generate.
3
+ *
4
+ * WHY THIS FILE EXISTS
5
+ *
6
+ * There were three copies and they disagreed:
7
+ *
8
+ * scripts/git-hooks/pre-commit:22 8 patterns
9
+ * lib/scaffold/steps.ts (gates.yml) 3 patterns
10
+ * lib/scaffold/steps.ts (pre-commit) 3 patterns
11
+ *
12
+ * So CI missed `gho_`, `ghs_`, `github_pat_`, `sk-ant-` and — worst — PEM
13
+ * private key blocks entirely. A committed private key passed CI. And the
14
+ * generated consumer pre-commit hook carried the weak 3-pattern set, so every
15
+ * downstream project got the gap too, while this repo's own checked-in hook
16
+ * had the full list.
17
+ *
18
+ * The generated `gates.yml` even asserted the opposite in a comment: "Two
19
+ * tiers matching the pre-commit hook, so local and CI cannot disagree about
20
+ * what counts as a secret." They disagreed. A comment is not a mechanism —
21
+ * this file is the mechanism, and test/unit/secret-patterns.test.ts asserts
22
+ * that every generated scanner carries exactly this registry.
23
+ *
24
+ * FORMAT
25
+ *
26
+ * POSIX ERE, consumed by `grep -E` and `git grep -E` in generated shell. Keep
27
+ * it portable: no PCRE (`\d`, `\w`, lookarounds), no single quotes — the
28
+ * string is embedded inside single-quoted shell arguments.
29
+ */
30
+
31
+ export interface SecretPattern {
32
+ /** Short identifier used in test failure messages. */
33
+ id: string;
34
+ /** POSIX ERE fragment, safe to join with `|`. */
35
+ ere: string;
36
+ /** What it catches, for the humans reading a blocked commit. */
37
+ description: string;
38
+ }
39
+
40
+ /**
41
+ * Tier 1 — anchored key formats.
42
+ *
43
+ * Unambiguous enough that a match is a secret, so there are no exceptions and
44
+ * no allowlist. Anything needing an exception belongs in tier 2.
45
+ */
46
+ export const TIER1_SECRET_PATTERNS: SecretPattern[] = [
47
+ { id: "github-pat-classic", ere: "ghp_[A-Za-z0-9]{36}", description: "GitHub personal access token" },
48
+ { id: "github-oauth", ere: "gho_[A-Za-z0-9]{36}", description: "GitHub OAuth token" },
49
+ { id: "github-server", ere: "ghs_[A-Za-z0-9]{36}", description: "GitHub server-to-server token" },
50
+ { id: "github-pat-fine", ere: "github_pat_[A-Za-z0-9]{22}_[A-Za-z0-9]{59}", description: "GitHub fine-grained PAT" },
51
+ { id: "aws-access-key", ere: "AKIA[A-Z0-9]{16}", description: "AWS access key ID" },
52
+ // {20,} not {48}. The pre-commit hook used {48} and the CI scan used {20,};
53
+ // taking the hook's value would have NARROWED CI, missing any sk- key
54
+ // shorter than 48 chars — a coverage regression smuggled in by a
55
+ // deduplication. When registries disagree, the union is the safe merge, not
56
+ // whichever copy you happened to start from.
57
+ { id: "openai", ere: "sk-[A-Za-z0-9]{20,}", description: "OpenAI-style API key" },
58
+ { id: "anthropic", ere: "sk-ant-[A-Za-z0-9-]{90,}", description: "Anthropic API key" },
59
+ {
60
+ id: "private-key",
61
+ ere: "-----BEGIN (RSA |EC |DSA |OPENSSH )?PRIVATE KEY-----",
62
+ description: "PEM private key block",
63
+ },
64
+ ];
65
+
66
+ /**
67
+ * Tier 2 — credential assignments.
68
+ *
69
+ * Shape-based rather than format-based, so it needs the allowlist below.
70
+ */
71
+ export const TIER2_ASSIGNMENT_ERE =
72
+ "(password|passwd|api[_-]?key|secret)[[:space:]]*[:=][[:space:]]*[A-Za-z0-9/+=_.-]{12,}";
73
+
74
+ /**
75
+ * Values that look like credentials but are not.
76
+ *
77
+ * Applied to the extracted VALUE, never the whole line. Matching anywhere on
78
+ * the line was an allowlist escape: appending `# placeholder` to a line
79
+ * holding a real secret laundered it past the scan.
80
+ */
81
+ export const TIER2_ALLOWED_VALUE_ERE =
82
+ "^$|[:=][[:space:]]*(process\\.env|os\\.environ|Deno\\.env|getenv|REDACTED|CHANGEME|placeholder)";
83
+
84
+ /** Tier 1 as one alternation, parenthesised and ready to embed in `grep -E '...'`. */
85
+ export function tier1Ere(): string {
86
+ return `(${TIER1_SECRET_PATTERNS.map(p => p.ere).join("|")})`;
87
+ }
88
+
89
+ /**
90
+ * Guard against a pattern that cannot survive the trip into generated shell.
91
+ *
92
+ * Every pattern here is interpolated into a single-quoted shell string inside
93
+ * a JS template literal. A single quote would terminate the shell quoting and
94
+ * a backtick would end the template — in both cases producing a scanner that
95
+ * either fails to parse or silently matches the wrong thing. Checked by a test
96
+ * rather than trusted, because the failure is invisible in review.
97
+ */
98
+ export function unshellSafePatterns(): string[] {
99
+ // Covers EVERY string that reaches generated shell, not just tier 1. The
100
+ // tier-2 assignment and allowlist expressions are embedded the same way, so
101
+ // checking only tier 1 would have been a validator with a narrower view
102
+ // than the thing it validates.
103
+ const embedded: Array<{ id: string; ere: string }> = [
104
+ ...TIER1_SECRET_PATTERNS.map(p => ({ id: p.id, ere: p.ere })),
105
+ { id: "tier2-assignment", ere: TIER2_ASSIGNMENT_ERE },
106
+ { id: "tier2-allowlist", ere: TIER2_ALLOWED_VALUE_ERE },
107
+ ];
108
+ // A single quote ends the shell quoting; a backtick or ${ ends the JS
109
+ // template the shell is built in. Backslashes are legitimate regex escapes,
110
+ // so they are not disqualifying on their own.
111
+ return embedded.filter(p => /['`]|\$\{/.test(p.ere)).map(p => p.id);
112
+ }