sovr-patch 0.2.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.

Potentially problematic release.


This version of sovr-patch might be problematic. Click here for more details.

Files changed (102) hide show
  1. package/LICENSE +66 -0
  2. package/README.md +112 -0
  3. package/dist/audit/engine.js +140 -0
  4. package/dist/audit/engine.js.map +1 -0
  5. package/dist/audit/packs.js +21 -0
  6. package/dist/audit/packs.js.map +1 -0
  7. package/dist/audit/report.js +79 -0
  8. package/dist/audit/report.js.map +1 -0
  9. package/dist/audit/types.js +5 -0
  10. package/dist/audit/types.js.map +1 -0
  11. package/dist/cli/help.js +108 -0
  12. package/dist/cli/help.js.map +1 -0
  13. package/dist/cli/parse-argv.js +73 -0
  14. package/dist/cli/parse-argv.js.map +1 -0
  15. package/dist/commands/activate.js +179 -0
  16. package/dist/commands/activate.js.map +1 -0
  17. package/dist/commands/audit.js +89 -0
  18. package/dist/commands/audit.js.map +1 -0
  19. package/dist/commands/ci-gate.js +239 -0
  20. package/dist/commands/ci-gate.js.map +1 -0
  21. package/dist/commands/list-rules.js +11 -0
  22. package/dist/commands/list-rules.js.map +1 -0
  23. package/dist/commands/run.js +107 -0
  24. package/dist/commands/run.js.map +1 -0
  25. package/dist/commands/status.js +174 -0
  26. package/dist/commands/status.js.map +1 -0
  27. package/dist/core/engine.js +68 -0
  28. package/dist/core/engine.js.map +1 -0
  29. package/dist/core/license.js +243 -0
  30. package/dist/core/license.js.map +1 -0
  31. package/dist/core/load-project.js +41 -0
  32. package/dist/core/load-project.js.map +1 -0
  33. package/dist/core/report.js +68 -0
  34. package/dist/core/report.js.map +1 -0
  35. package/dist/core/rollback.js +160 -0
  36. package/dist/core/rollback.js.map +1 -0
  37. package/dist/core/safe-apply.js +75 -0
  38. package/dist/core/safe-apply.js.map +1 -0
  39. package/dist/core/types.js +3 -0
  40. package/dist/core/types.js.map +1 -0
  41. package/dist/core/update-check.js +162 -0
  42. package/dist/core/update-check.js.map +1 -0
  43. package/dist/core/verify.js +32 -0
  44. package/dist/core/verify.js.map +1 -0
  45. package/dist/index.js +124 -0
  46. package/dist/index.js.map +1 -0
  47. package/dist/patch/apply.js +14 -0
  48. package/dist/patch/apply.js.map +1 -0
  49. package/dist/patch/overlap.js +12 -0
  50. package/dist/patch/overlap.js.map +1 -0
  51. package/dist/patch/preview.js +48 -0
  52. package/dist/patch/preview.js.map +1 -0
  53. package/dist/rules/design-token/classify.js +16 -0
  54. package/dist/rules/design-token/classify.js.map +1 -0
  55. package/dist/rules/design-token/locate.js +113 -0
  56. package/dist/rules/design-token/locate.js.map +1 -0
  57. package/dist/rules/design-token/presets.js +53 -0
  58. package/dist/rules/design-token/presets.js.map +1 -0
  59. package/dist/rules/design-token/rule.js +13 -0
  60. package/dist/rules/design-token/rule.js.map +1 -0
  61. package/dist/rules/design-token/schema.js +84 -0
  62. package/dist/rules/design-token/schema.js.map +1 -0
  63. package/dist/rules/design-token/transform.js +27 -0
  64. package/dist/rules/design-token/transform.js.map +1 -0
  65. package/dist/rules/field-rename/classify.js +77 -0
  66. package/dist/rules/field-rename/classify.js.map +1 -0
  67. package/dist/rules/field-rename/locate.js +294 -0
  68. package/dist/rules/field-rename/locate.js.map +1 -0
  69. package/dist/rules/field-rename/rule.js +13 -0
  70. package/dist/rules/field-rename/rule.js.map +1 -0
  71. package/dist/rules/field-rename/schema.js +35 -0
  72. package/dist/rules/field-rename/schema.js.map +1 -0
  73. package/dist/rules/field-rename/transform.js +160 -0
  74. package/dist/rules/field-rename/transform.js.map +1 -0
  75. package/dist/rules/inline-style/classify.js +17 -0
  76. package/dist/rules/inline-style/classify.js.map +1 -0
  77. package/dist/rules/inline-style/locate.js +163 -0
  78. package/dist/rules/inline-style/locate.js.map +1 -0
  79. package/dist/rules/inline-style/presets.js +71 -0
  80. package/dist/rules/inline-style/presets.js.map +1 -0
  81. package/dist/rules/inline-style/rule.js +13 -0
  82. package/dist/rules/inline-style/rule.js.map +1 -0
  83. package/dist/rules/inline-style/schema.js +97 -0
  84. package/dist/rules/inline-style/schema.js.map +1 -0
  85. package/dist/rules/inline-style/transform.js +52 -0
  86. package/dist/rules/inline-style/transform.js.map +1 -0
  87. package/dist/rules/nullish-fallback/classify.js +22 -0
  88. package/dist/rules/nullish-fallback/classify.js.map +1 -0
  89. package/dist/rules/nullish-fallback/locate.js +175 -0
  90. package/dist/rules/nullish-fallback/locate.js.map +1 -0
  91. package/dist/rules/nullish-fallback/rule.js +13 -0
  92. package/dist/rules/nullish-fallback/rule.js.map +1 -0
  93. package/dist/rules/nullish-fallback/schema.js +10 -0
  94. package/dist/rules/nullish-fallback/schema.js.map +1 -0
  95. package/dist/rules/nullish-fallback/transform.js +49 -0
  96. package/dist/rules/nullish-fallback/transform.js.map +1 -0
  97. package/dist/rules/registry.js +21 -0
  98. package/dist/rules/registry.js.map +1 -0
  99. package/dist/rules/types.js +2 -0
  100. package/dist/rules/types.js.map +1 -0
  101. package/license.json +13 -0
  102. package/package.json +64 -0
package/LICENSE ADDED
@@ -0,0 +1,66 @@
1
+ Business Source License 1.1
2
+
3
+ Parameters
4
+
5
+ Licensor: SOVR
6
+ Licensed Work: sovr-patch
7
+ The Licensed Work is (c) 2026 SOVR.
8
+ Additional Use Grant: You may make production use of the Licensed Work,
9
+ provided your use does not include offering the
10
+ Licensed Work to third parties as a hosted or
11
+ managed service, where the service provides users
12
+ with access to any substantial set of the features
13
+ or functionality of the Licensed Work.
14
+ Change Date: Four years from the date the Licensed Work is
15
+ published.
16
+ Change License: Apache License, Version 2.0
17
+
18
+ For information about alternative licensing arrangements for the Licensed
19
+ Work, please contact: yuhang@sovr.inc
20
+
21
+ Notice
22
+
23
+ Business Source License 1.1
24
+
25
+ Terms
26
+
27
+ The Licensor hereby grants you the right to copy, modify, create
28
+ derivative works, redistribute, and make non-production use of the
29
+ Licensed Work. The Licensor may make an Additional Use Grant, above,
30
+ permitting limited production use.
31
+
32
+ Effective on the Change Date, or the fourth anniversary of the first
33
+ publicly available distribution of a specific version of the Licensed
34
+ Work under this License, whichever comes first, the Licensor hereby
35
+ grants you rights under the terms of the Change License, and the rights
36
+ granted in the paragraph above terminate.
37
+
38
+ If your use of the Licensed Work does not comply with the requirements
39
+ currently in effect as described in this License, you must purchase a
40
+ commercial license from the Licensor, its affiliated entities, or
41
+ authorized resellers, or you must refrain from using the Licensed Work.
42
+
43
+ All copies of the original and modified Licensed Work, and derivative
44
+ works of the Licensed Work, are subject to this License. This License
45
+ applies separately for each version of the Licensed Work and the Change
46
+ Date may vary for each version of the Licensed Work released by
47
+ Licensor.
48
+
49
+ You must conspicuously display this License on each original or modified
50
+ copy of the Licensed Work. If you receive the Licensed Work in original
51
+ or modified form from a third party, the terms and conditions set forth
52
+ in this License apply to your use of that work.
53
+
54
+ Any use of the Licensed Work in violation of this License will
55
+ automatically terminate your rights under this License for the current
56
+ and all other versions of the Licensed Work.
57
+
58
+ This License does not grant you any right in any trademark or logo of
59
+ Licensor or its affiliates (provided that you may use a trademark or
60
+ logo of Licensor as expressly required by this License).
61
+
62
+ TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS
63
+ PROVIDED ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES
64
+ AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION)
65
+ WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
66
+ NON-INFRINGEMENT, AND TITLE.
package/README.md ADDED
@@ -0,0 +1,112 @@
1
+ # SOVR Patch: Rule Engine v0.1
2
+
3
+ Stop grepping. Start patching.
4
+
5
+ `sovr-patch` is an AST-based code migration engine designed for safe, deterministic, and verifiable TypeScript refactoring.
6
+
7
+ It is built as the foundation for the "AI Mechanical Work Compressor" — shifting AI's role from writing unverified code to orchestrating deterministic AST rules.
8
+
9
+ ---
10
+
11
+ ## Architecture
12
+
13
+ The engine is built around a 4-phase pipeline:
14
+
15
+ 1. **Locate**: Find all AST nodes matching a rule's pattern
16
+ 2. **Classify**: Categorize hits into `safe`, `ambiguous`, or `unsafe` based on syntax context
17
+ 3. **Transform**: Generate patches (diffs) only for `safe` hits
18
+ 4. **Verify & Apply** (`safe-apply`):
19
+ - Apply patches to a temporary copy of the repository
20
+ - Run the TypeScript compiler (`tsc --noEmit`) against the patched copy
21
+ - **Only if verification passes**, write the changes to the real repository
22
+
23
+ ---
24
+
25
+ ## Usage
26
+
27
+ ### 1. List available rules
28
+ ```bash
29
+ npx sovr-patch list-rules
30
+ ```
31
+
32
+ ### 2. Dry-run a rule (Preview)
33
+ ```bash
34
+ npx sovr-patch run \
35
+ --rule field-rename \
36
+ --from "config.baseUrl" \
37
+ --to "config.apiBaseUrl" \
38
+ --repo ./my-repo \
39
+ --report
40
+ ```
41
+
42
+ ### 3. Safe-apply a rule (Verify & Write)
43
+ ```bash
44
+ npx sovr-patch run \
45
+ --rule field-rename \
46
+ --from "config.baseUrl" \
47
+ --to "config.apiBaseUrl" \
48
+ --repo ./my-repo \
49
+ --apply \
50
+ --report
51
+ ```
52
+
53
+ ---
54
+
55
+ ## The Rule Contract
56
+
57
+ Every rule in `sovr-patch` implements a strict interface:
58
+
59
+ ```typescript
60
+ export type RuleDefinition<TConfig> = {
61
+ name: string;
62
+ description: string;
63
+
64
+ parseConfig(input: Record<string, unknown>): TConfig;
65
+
66
+ locate(context: RuleContext<TConfig>): RuleLocateResult[];
67
+
68
+ classify(located: RuleLocateResult, context: RuleContext<TConfig>): RuleScanHit;
69
+
70
+ transform(hit: RuleScanHit, context: RuleContext<TConfig>): PatchOp | null;
71
+ };
72
+ ```
73
+
74
+ This enforces the separation of concerns: locating nodes is separate from determining if they are safe to modify, which is separate from generating the actual text replacement.
75
+
76
+ ---
77
+
78
+ ## Directory Structure
79
+
80
+ ```
81
+ src/
82
+ ├── cli/ # Command-line interface and argument parsing
83
+ ├── commands/ # CLI command implementations (run, list-rules)
84
+ ├── core/ # Core engine, types, report generation, safe-apply
85
+ ├── patch/ # Patch application, overlap detection, diff generation
86
+ └── rules/ # Rule implementations
87
+ ├── field-rename/ # Rule: Safe object field renaming
88
+ ├── nullish-fallback/ # Rule: Inject ?? fallback
89
+ ├── registry.ts # Rule registration
90
+ └── types.ts # Rule contract interface
91
+ ```
92
+
93
+ ---
94
+
95
+ ## Tests
96
+
97
+ ```bash
98
+ npm run ci
99
+ ```
100
+
101
+ Runs the CI gate, which includes:
102
+ - TypeScript build check
103
+ - Unit tests (scan, rewrite, safe-apply)
104
+ - Engine integration tests
105
+ - CLI smoke tests
106
+ - Trial regression tests
107
+
108
+ ---
109
+
110
+ ## License
111
+
112
+ MIT
@@ -0,0 +1,140 @@
1
+ import path from "node:path";
2
+ import { loadProject } from "../core/load-project.js";
3
+ import { createRuleRegistry, getRuleOrThrow } from "../rules/registry.js";
4
+ import { getPackOrThrow } from "./packs.js";
5
+ // ─── Rule → category mapping ─────────────────────────────────
6
+ const RULE_CATEGORY = {
7
+ "field-rename": "migration",
8
+ "nullish-fallback": "migration",
9
+ "design-token": "refactor",
10
+ "inline-style": "refactor",
11
+ };
12
+ function categoryFor(ruleName) {
13
+ return RULE_CATEGORY[ruleName] ?? "risk";
14
+ }
15
+ // ─── Build per-rule audit result ──────────────────────────────
16
+ function buildRuleResult(rule, loaded, hits, repoPath) {
17
+ const safe = hits.filter((h) => h.severity === "safe").length;
18
+ const ambiguous = hits.filter((h) => h.severity === "ambiguous").length;
19
+ const unsafe = hits.filter((h) => h.severity === "unsafe").length;
20
+ // Count affected files
21
+ const affectedFileSet = new Set(hits.map((h) => h.filePath));
22
+ // Top files by hit count
23
+ const fileHitMap = new Map();
24
+ for (const hit of hits) {
25
+ const rel = path.relative(repoPath, hit.filePath);
26
+ fileHitMap.set(rel, (fileHitMap.get(rel) ?? 0) + 1);
27
+ }
28
+ const topFiles = [...fileHitMap.entries()]
29
+ .sort((a, b) => b[1] - a[1])
30
+ .slice(0, 5)
31
+ .map(([filePath, hitCount]) => ({ filePath, hitCount }));
32
+ // Sample hits (up to 3)
33
+ const sampleHits = hits.slice(0, 3).map((h) => ({
34
+ filePath: path.relative(repoPath, h.filePath),
35
+ line: h.line,
36
+ sourceText: h.sourceText,
37
+ severity: h.severity,
38
+ reason: h.reason,
39
+ }));
40
+ return {
41
+ ruleName: rule.name,
42
+ category: categoryFor(rule.name),
43
+ description: rule.description,
44
+ metrics: {
45
+ filesScanned: loaded.sourceFiles.length,
46
+ hits: hits.length,
47
+ safe,
48
+ ambiguous,
49
+ unsafe,
50
+ affectedFiles: affectedFileSet.size,
51
+ },
52
+ topFiles,
53
+ sampleHits,
54
+ suggestedCommand: `sovr-patch run --rule ${rule.name} --repo ${repoPath}`,
55
+ };
56
+ }
57
+ // ─── Generate recommendations ─────────────────────────────────
58
+ function generateRecommendations(results, repoPath) {
59
+ const recs = [];
60
+ for (const r of results) {
61
+ if (r.metrics.hits === 0)
62
+ continue;
63
+ const priority = r.metrics.safe >= 10 ? "high" : r.metrics.safe >= 3 ? "medium" : "low";
64
+ recs.push({
65
+ priority,
66
+ title: `Run ${r.ruleName} migration`,
67
+ reason: `${r.metrics.hits} hits found across ${r.metrics.affectedFiles} files. ${r.metrics.safe} can be auto-fixed safely.`,
68
+ suggestedRule: r.ruleName,
69
+ suggestedCommand: `sovr-patch run --rule ${r.ruleName} --repo ${repoPath}`,
70
+ });
71
+ }
72
+ // Sort by priority
73
+ const order = { high: 0, medium: 1, low: 2 };
74
+ recs.sort((a, b) => order[a.priority] - order[b.priority]);
75
+ return recs;
76
+ }
77
+ export function runAudit(params) {
78
+ const loaded = loadProject(params.repo, params.tsconfig);
79
+ const registry = createRuleRegistry();
80
+ // Resolve which rules to run
81
+ let mode;
82
+ let rulesToRun;
83
+ if (params.pack) {
84
+ mode = "pack";
85
+ const pack = getPackOrThrow(params.pack);
86
+ rulesToRun = pack.rules.map((name) => getRuleOrThrow(registry, name));
87
+ }
88
+ else if (params.rule) {
89
+ mode = "rule";
90
+ rulesToRun = [getRuleOrThrow(registry, params.rule)];
91
+ }
92
+ else {
93
+ throw new Error("audit requires --rule <name> or --pack <name>");
94
+ }
95
+ // Run locate + classify for each rule (no transform, no apply)
96
+ const results = [];
97
+ for (const rule of rulesToRun) {
98
+ const configInput = params.configByRule?.[rule.name] ?? {};
99
+ // Inject mode:audit so dual-mode rules (design-token, inline-style)
100
+ // can operate in zero-config discovery mode
101
+ const configWithMode = { ...configInput, mode: "audit" };
102
+ let config;
103
+ try {
104
+ config = rule.parseConfig(configWithMode);
105
+ }
106
+ catch (err) {
107
+ // In pack mode, skip rules that require config not provided
108
+ if (mode === "pack") {
109
+ continue;
110
+ }
111
+ throw err;
112
+ }
113
+ const context = { loaded, config };
114
+ const located = rule.locate(context);
115
+ const hits = located.map((item) => rule.classify(item, context));
116
+ results.push(buildRuleResult(rule, loaded, hits, params.repo));
117
+ }
118
+ // Aggregate summary
119
+ const summary = {
120
+ totalFilesScanned: loaded.sourceFiles.length,
121
+ totalRulesRun: results.length,
122
+ totalHits: results.reduce((s, r) => s + r.metrics.hits, 0),
123
+ totalSafe: results.reduce((s, r) => s + r.metrics.safe, 0),
124
+ totalAmbiguous: results.reduce((s, r) => s + r.metrics.ambiguous, 0),
125
+ totalUnsafe: results.reduce((s, r) => s + r.metrics.unsafe, 0),
126
+ totalAffectedFiles: results.reduce((s, r) => s + r.metrics.affectedFiles, 0),
127
+ };
128
+ const recommendations = generateRecommendations(results, params.repo);
129
+ return {
130
+ version: "0.2.0",
131
+ mode,
132
+ repoPath: params.repo,
133
+ tsconfigPath: loaded.tsconfigPath,
134
+ generatedAt: new Date().toISOString(),
135
+ summary,
136
+ results,
137
+ recommendations,
138
+ };
139
+ }
140
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/audit/engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ export const AUDIT_PACKS = [
2
+ {
3
+ name: "safe-ts-migration",
4
+ description: "Audit TypeScript migration opportunities and fallback safety.",
5
+ rules: ["field-rename", "nullish-fallback"],
6
+ },
7
+ {
8
+ name: "frontend-refactor",
9
+ description: "Audit frontend refactor opportunities across styles and design tokens.",
10
+ rules: ["design-token", "inline-style"],
11
+ },
12
+ ];
13
+ export function getPackOrThrow(name) {
14
+ const pack = AUDIT_PACKS.find((p) => p.name === name);
15
+ if (!pack) {
16
+ const available = AUDIT_PACKS.map((p) => p.name).join(", ");
17
+ throw new Error(`unknown pack: "${name}". Available packs: ${available}`);
18
+ }
19
+ return pack;
20
+ }
21
+ //# sourceMappingURL=packs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"packs.js","sourceRoot":"","sources":["../../src/audit/packs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,+DAA+D;QAC5E,KAAK,EAAE,CAAC,cAAc,EAAE,kBAAkB,CAAC;KAC5C;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,wEAAwE;QACrF,KAAK,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;KACxC;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,uBAAuB,SAAS,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,79 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ // ─── Terminal text report ─────────────────────────────────────
4
+ export function printAuditReport(report) {
5
+ // Section 1: Summary
6
+ console.log("");
7
+ console.log("Audit Summary");
8
+ console.log("─────────────");
9
+ console.log(`Files scanned: ${report.summary.totalFilesScanned}`);
10
+ console.log(`Rules run: ${report.summary.totalRulesRun}`);
11
+ console.log(`Total hits: ${report.summary.totalHits}`);
12
+ console.log(`Safe auto-fixes: ${report.summary.totalSafe}`);
13
+ console.log(`Ambiguous: ${report.summary.totalAmbiguous}`);
14
+ console.log(`Unsafe: ${report.summary.totalUnsafe}`);
15
+ console.log(`Affected files: ${report.summary.totalAffectedFiles}`);
16
+ console.log("");
17
+ // Section 2: Per-rule breakdown
18
+ for (const result of report.results) {
19
+ console.log(`${result.ruleName} (${result.category})`);
20
+ console.log("─".repeat(result.ruleName.length + result.category.length + 3));
21
+ console.log(` hits: ${result.metrics.hits}`);
22
+ console.log(` safe: ${result.metrics.safe}`);
23
+ console.log(` ambiguous: ${result.metrics.ambiguous}`);
24
+ console.log(` unsafe: ${result.metrics.unsafe}`);
25
+ console.log(` affected files: ${result.metrics.affectedFiles}`);
26
+ console.log("");
27
+ // Top files
28
+ if (result.topFiles.length > 0) {
29
+ console.log(" Top Files:");
30
+ for (const f of result.topFiles) {
31
+ const padded = f.filePath.padEnd(40);
32
+ console.log(` ${padded} ${f.hitCount}`);
33
+ }
34
+ console.log("");
35
+ }
36
+ // Sample hits
37
+ if (result.sampleHits.length > 0) {
38
+ console.log(" Sample Hits:");
39
+ for (const h of result.sampleHits) {
40
+ console.log(` ${h.filePath}:${h.line} [${h.severity}] ${h.sourceText}`);
41
+ }
42
+ console.log("");
43
+ }
44
+ }
45
+ // Section 3: Recommendations
46
+ if (report.recommendations.length > 0) {
47
+ console.log("Recommendations");
48
+ console.log("───────────────");
49
+ for (const rec of report.recommendations) {
50
+ const icon = rec.priority === "high" ? "▲" : rec.priority === "medium" ? "●" : "○";
51
+ console.log(` ${icon} [${rec.priority.toUpperCase()}] ${rec.title}`);
52
+ console.log(` ${rec.reason}`);
53
+ if (rec.suggestedCommand) {
54
+ console.log(` Run: ${rec.suggestedCommand}`);
55
+ }
56
+ console.log("");
57
+ }
58
+ }
59
+ // Section 4: Suggested next step
60
+ if (report.results.length > 0 && report.summary.totalHits > 0) {
61
+ const topResult = report.results.reduce((a, b) => a.metrics.safe > b.metrics.safe ? a : b);
62
+ console.log("Suggested Next Step");
63
+ console.log("───────────────────");
64
+ console.log(`Run:`);
65
+ console.log(` ${topResult.suggestedCommand}`);
66
+ console.log("");
67
+ }
68
+ }
69
+ // ─── JSON file output ─────────────────────────────────────────
70
+ export function writeAuditReportToFile(report, filePath) {
71
+ const resolved = path.resolve(filePath);
72
+ const dir = path.dirname(resolved);
73
+ if (!fs.existsSync(dir)) {
74
+ fs.mkdirSync(dir, { recursive: true });
75
+ }
76
+ fs.writeFileSync(resolved, JSON.stringify(report, null, 2), "utf-8");
77
+ return resolved;
78
+ }
79
+ //# sourceMappingURL=report.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/audit/report.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ // ─── Audit subsystem types ────────────────────────────────────
2
+ // Audit = quantify structural issues before changing code.
3
+ // Output: problem scale, auto-fixable ratio, risk boundary, suggested rules.
4
+ export {};
5
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,2DAA2D;AAC3D,6EAA6E"}
@@ -0,0 +1,108 @@
1
+ export function printHelp() {
2
+ console.log(`
3
+ sovr-patch — Safe TypeScript field rename engine
4
+
5
+ USAGE:
6
+ sovr-patch <command> [options]
7
+
8
+ COMMANDS:
9
+ list-rules List all available rules
10
+ scan Scan a repo with a rule (dry run, no changes)
11
+ run Run a rule (scan + transform + optional apply)
12
+ audit Audit a repo — quantify issues before changing code
13
+ status Check license status, plan, rules, and expiry
14
+ activate Activate a signed license file (unlocks safe-apply)
15
+ ci-gate CI enforcement gate (Enterprise/Full Engine)
16
+
17
+ OPTIONS:
18
+ --rule <name> Rule to use (e.g., field-rename, nullish-fallback)
19
+ --repo <path> Path to the target repo (default: .)
20
+ --tsconfig <path> Path to tsconfig.json (default: <repo>/tsconfig.json)
21
+ --apply Apply patches to the real repo (with safe-apply verification)
22
+ --no-verify Skip tsc verification in dry run mode
23
+ --json Output results as JSON
24
+ --report Print summary report
25
+ --report-file <path> Write JSON report to file
26
+
27
+ RULE-SPECIFIC OPTIONS (passed as --key value):
28
+ field-rename:
29
+ --from <path> Source field path (e.g., "plan.yearlyPrice")
30
+ --to <path> Target field path (e.g., "plan.prices.find(...)")
31
+ --fallback <value> Fallback value for nullish coalescing (e.g., "0")
32
+ --include-this Also scan this.<from> chains
33
+
34
+ nullish-fallback:
35
+ --target <path> Target property access (e.g., "plan.yearlyPrice")
36
+ --fallback <value> Fallback value (e.g., "0")
37
+
38
+ STATUS OPTIONS:
39
+ --json Output license status as JSON
40
+ --verbose Show additional details (file path, signature info)
41
+
42
+ ACTIVATE OPTIONS:
43
+ <license.json> Path to signed license file (recommended)
44
+ --key <key> Legacy: verify key against API (deprecated)
45
+ --status Check current license (alias for 'status' command)
46
+ --deactivate Remove current license
47
+
48
+ AUDIT OPTIONS:
49
+ --rule <name> Single rule to audit (e.g., design-token)
50
+ --pack <name> Audit pack to run (e.g., frontend-refactor, safe-ts-migration)
51
+ --repo <path> Path to the target repo (default: .)
52
+ --tsconfig <path> Path to tsconfig.json (default: <repo>/tsconfig.json)
53
+ --json Output audit report as JSON
54
+ --report-file <path> Write JSON audit report to file
55
+
56
+ AUDIT PACKS:
57
+ safe-ts-migration field-rename + nullish-fallback
58
+ frontend-refactor design-token + inline-style
59
+
60
+ CI-GATE OPTIONS:
61
+ --rules <r1,r2,...> Comma-separated rules to check
62
+ --max-hits <n> Max allowed hits before failing (default: 0)
63
+ --report-file <path> Write combined JSON report to file
64
+ --json Output results as JSON
65
+
66
+ EXAMPLES:
67
+ # Check license status
68
+ sovr-patch status
69
+ sovr-patch status --json
70
+ sovr-patch status --verbose
71
+
72
+ # Activate with signed license file (recommended)
73
+ sovr-patch activate license.json
74
+
75
+ # Legacy: activate with key (deprecated)
76
+ sovr-patch activate --key SOVR-xxxxxxxxxxxxxxxxxxxx
77
+
78
+ # Deactivate license
79
+ sovr-patch activate --deactivate
80
+
81
+ # List available rules
82
+ sovr-patch list-rules
83
+
84
+ # Run a rule (dry-run by default)
85
+ sovr-patch run --rule field-rename \\
86
+ --from "config.baseUrl" --to "config.endpoint" \\
87
+ --repo ./my-project --report
88
+
89
+ # Run with safe-apply (requires license)
90
+ sovr-patch run --rule field-rename \\
91
+ --from "plan.yearlyPrice" \\
92
+ --to "plan.prices.find(p => p.interval === 'year')?.amount" \\
93
+ --fallback "0" --repo ./my-project --apply
94
+
95
+ # Audit a single rule
96
+ sovr-patch audit --rule design-token --repo ./web
97
+
98
+ # Audit a pack (multiple rules)
99
+ sovr-patch audit --pack frontend-refactor --repo ./web
100
+
101
+ # CI gate — block PRs with migration debt
102
+ sovr-patch ci-gate \\
103
+ --rules field-rename,nullish-fallback \\
104
+ --repo ./my-project --max-hits 0 \\
105
+ --report-file ./sovr-ci-report.json
106
+ `);
107
+ }
108
+ //# sourceMappingURL=help.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGb,CAAC,CAAC;AACH,CAAC"}
@@ -0,0 +1,73 @@
1
+ function getArg(argv, flag) {
2
+ const i = argv.indexOf(flag);
3
+ return i === -1 ? undefined : argv[i + 1];
4
+ }
5
+ function hasFlag(argv, flag) {
6
+ return argv.includes(flag);
7
+ }
8
+ const KNOWN_FLAGS_WITH_VALUE = [
9
+ "--rule", "--repo", "--tsconfig", "--report-file",
10
+ ];
11
+ const KNOWN_FLAGS_BOOLEAN = [
12
+ "--apply", "--json", "--report", "--no-verify",
13
+ ];
14
+ /**
15
+ * Determine if a token is a boolean flag (no value follows it).
16
+ * A flag is boolean if:
17
+ * - The next token starts with "--" (another flag)
18
+ * - There is no next token (end of argv)
19
+ */
20
+ function isBooleanFlag(argv, index) {
21
+ const next = argv[index + 1];
22
+ return next === undefined || next.startsWith("--");
23
+ }
24
+ export function parseCli(argv) {
25
+ const command = argv[2];
26
+ if (!command) {
27
+ throw new Error(`missing command. Usage: sovr-patch <list-rules|scan|run> [options]`);
28
+ }
29
+ const rule = getArg(argv, "--rule");
30
+ const repo = getArg(argv, "--repo") ?? ".";
31
+ const tsconfig = getArg(argv, "--tsconfig");
32
+ const apply = hasFlag(argv, "--apply");
33
+ const verify = !argv.includes("--no-verify");
34
+ const json = hasFlag(argv, "--json");
35
+ const report = hasFlag(argv, "--report");
36
+ const reportFile = getArg(argv, "--report-file");
37
+ // Collect remaining key-value flags as rule config
38
+ const config = {};
39
+ for (let i = 3; i < argv.length; i += 1) {
40
+ const token = argv[i];
41
+ if (!token.startsWith("--"))
42
+ continue;
43
+ if (KNOWN_FLAGS_WITH_VALUE.includes(token)) {
44
+ i += 1;
45
+ continue;
46
+ }
47
+ if (KNOWN_FLAGS_BOOLEAN.includes(token)) {
48
+ continue;
49
+ }
50
+ const key = token.replace(/^--/, "");
51
+ // Check if this is a boolean flag (no value or next token is a flag)
52
+ if (isBooleanFlag(argv, i)) {
53
+ config[key] = true;
54
+ }
55
+ else {
56
+ config[key] = argv[i + 1];
57
+ i += 1;
58
+ }
59
+ }
60
+ return {
61
+ command,
62
+ rule,
63
+ repo,
64
+ tsconfig,
65
+ apply,
66
+ verify,
67
+ json,
68
+ report,
69
+ reportFile,
70
+ config,
71
+ };
72
+ }
73
+ //# sourceMappingURL=parse-argv.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse-argv.js","sourceRoot":"","sources":["../../src/cli/parse-argv.ts"],"names":[],"mappings":"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"}