anvil-engineering-workbench 0.0.0-stage → 1.0.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/CHANGELOG.md +40 -0
- package/LICENSE +17 -0
- package/README.md +778 -3
- package/SECURITY.md +17 -0
- package/dist/ai/claude-code-provider.d.ts +31 -0
- package/dist/ai/claude-code-provider.js +81 -0
- package/dist/ai/claude-code-provider.js.map +1 -0
- package/dist/ai/provider.d.ts +47 -0
- package/dist/ai/provider.js +57 -0
- package/dist/ai/provider.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +1945 -0
- package/dist/cli.js.map +1 -0
- package/dist/core/agent-config-release.d.ts +22 -0
- package/dist/core/agent-config-release.js +109 -0
- package/dist/core/agent-config-release.js.map +1 -0
- package/dist/core/agent-config-versioning.d.ts +33 -0
- package/dist/core/agent-config-versioning.js +209 -0
- package/dist/core/agent-config-versioning.js.map +1 -0
- package/dist/core/agent-evaluation-intelligence.d.ts +46 -0
- package/dist/core/agent-evaluation-intelligence.js +191 -0
- package/dist/core/agent-evaluation-intelligence.js.map +1 -0
- package/dist/core/agent-evolution.d.ts +20 -0
- package/dist/core/agent-evolution.js +35 -0
- package/dist/core/agent-evolution.js.map +1 -0
- package/dist/core/agent-experiment-studio.d.ts +27 -0
- package/dist/core/agent-experiment-studio.js +65 -0
- package/dist/core/agent-experiment-studio.js.map +1 -0
- package/dist/core/agent-optimization.d.ts +27 -0
- package/dist/core/agent-optimization.js +63 -0
- package/dist/core/agent-optimization.js.map +1 -0
- package/dist/core/agent-registry.d.ts +9 -0
- package/dist/core/agent-registry.js +95 -0
- package/dist/core/agent-registry.js.map +1 -0
- package/dist/core/agent-security-audit.d.ts +28 -0
- package/dist/core/agent-security-audit.js +260 -0
- package/dist/core/agent-security-audit.js.map +1 -0
- package/dist/core/agent-workspace-context.d.ts +14 -0
- package/dist/core/agent-workspace-context.js +66 -0
- package/dist/core/agent-workspace-context.js.map +1 -0
- package/dist/core/ai-code-review.d.ts +20 -0
- package/dist/core/ai-code-review.js +70 -0
- package/dist/core/ai-code-review.js.map +1 -0
- package/dist/core/anthropic-provider.d.ts +16 -0
- package/dist/core/anthropic-provider.js +85 -0
- package/dist/core/anthropic-provider.js.map +1 -0
- package/dist/core/architecture-map.d.ts +26 -0
- package/dist/core/architecture-map.js +124 -0
- package/dist/core/architecture-map.js.map +1 -0
- package/dist/core/benchmark-engine.d.ts +52 -0
- package/dist/core/benchmark-engine.js +109 -0
- package/dist/core/benchmark-engine.js.map +1 -0
- package/dist/core/benchmark-matrix.d.ts +123 -0
- package/dist/core/benchmark-matrix.js +169 -0
- package/dist/core/benchmark-matrix.js.map +1 -0
- package/dist/core/benchmark-regression.d.ts +54 -0
- package/dist/core/benchmark-regression.js +96 -0
- package/dist/core/benchmark-regression.js.map +1 -0
- package/dist/core/change-intelligence.d.ts +40 -0
- package/dist/core/change-intelligence.js +114 -0
- package/dist/core/change-intelligence.js.map +1 -0
- package/dist/core/code-intelligence.d.ts +20 -0
- package/dist/core/code-intelligence.js +119 -0
- package/dist/core/code-intelligence.js.map +1 -0
- package/dist/core/code-review.d.ts +30 -0
- package/dist/core/code-review.js +93 -0
- package/dist/core/code-review.js.map +1 -0
- package/dist/core/code-search.d.ts +16 -0
- package/dist/core/code-search.js +93 -0
- package/dist/core/code-search.js.map +1 -0
- package/dist/core/container-sandbox.d.ts +20 -0
- package/dist/core/container-sandbox.js +220 -0
- package/dist/core/container-sandbox.js.map +1 -0
- package/dist/core/dashboard-server.d.ts +11 -0
- package/dist/core/dashboard-server.js +1068 -0
- package/dist/core/dashboard-server.js.map +1 -0
- package/dist/core/dependency-graph.d.ts +29 -0
- package/dist/core/dependency-graph.js +90 -0
- package/dist/core/dependency-graph.js.map +1 -0
- package/dist/core/dependency-impact.d.ts +51 -0
- package/dist/core/dependency-impact.js +201 -0
- package/dist/core/dependency-impact.js.map +1 -0
- package/dist/core/dependency-intelligence.d.ts +60 -0
- package/dist/core/dependency-intelligence.js +241 -0
- package/dist/core/dependency-intelligence.js.map +1 -0
- package/dist/core/doctor.d.ts +17 -0
- package/dist/core/doctor.js +239 -0
- package/dist/core/doctor.js.map +1 -0
- package/dist/core/engineering-risk.d.ts +40 -0
- package/dist/core/engineering-risk.js +125 -0
- package/dist/core/engineering-risk.js.map +1 -0
- package/dist/core/evaluation-engine.d.ts +110 -0
- package/dist/core/evaluation-engine.js +182 -0
- package/dist/core/evaluation-engine.js.map +1 -0
- package/dist/core/execution-trace.d.ts +27 -0
- package/dist/core/execution-trace.js +137 -0
- package/dist/core/execution-trace.js.map +1 -0
- package/dist/core/experiment-history.d.ts +31 -0
- package/dist/core/experiment-history.js +64 -0
- package/dist/core/experiment-history.js.map +1 -0
- package/dist/core/experiment-manifest.d.ts +67 -0
- package/dist/core/experiment-manifest.js +100 -0
- package/dist/core/experiment-manifest.js.map +1 -0
- package/dist/core/gemini-provider.d.ts +15 -0
- package/dist/core/gemini-provider.js +87 -0
- package/dist/core/gemini-provider.js.map +1 -0
- package/dist/core/git-intelligence.d.ts +26 -0
- package/dist/core/git-intelligence.js +84 -0
- package/dist/core/git-intelligence.js.map +1 -0
- package/dist/core/hook-engine.d.ts +23 -0
- package/dist/core/hook-engine.js +74 -0
- package/dist/core/hook-engine.js.map +1 -0
- package/dist/core/hosted-agent-provider.d.ts +19 -0
- package/dist/core/hosted-agent-provider.js +133 -0
- package/dist/core/hosted-agent-provider.js.map +1 -0
- package/dist/core/intelligence-timeline.d.ts +41 -0
- package/dist/core/intelligence-timeline.js +158 -0
- package/dist/core/intelligence-timeline.js.map +1 -0
- package/dist/core/model-router.d.ts +59 -0
- package/dist/core/model-router.js +291 -0
- package/dist/core/model-router.js.map +1 -0
- package/dist/core/openai-compatible-provider.d.ts +19 -0
- package/dist/core/openai-compatible-provider.js +151 -0
- package/dist/core/openai-compatible-provider.js.map +1 -0
- package/dist/core/orchestrator.d.ts +94 -0
- package/dist/core/orchestrator.js +263 -0
- package/dist/core/orchestrator.js.map +1 -0
- package/dist/core/patch-application.d.ts +54 -0
- package/dist/core/patch-application.js +504 -0
- package/dist/core/patch-application.js.map +1 -0
- package/dist/core/patch-approval.d.ts +23 -0
- package/dist/core/patch-approval.js +181 -0
- package/dist/core/patch-approval.js.map +1 -0
- package/dist/core/patch-validation.d.ts +12 -0
- package/dist/core/patch-validation.js +112 -0
- package/dist/core/patch-validation.js.map +1 -0
- package/dist/core/permission-policy.d.ts +13 -0
- package/dist/core/permission-policy.js +98 -0
- package/dist/core/permission-policy.js.map +1 -0
- package/dist/core/project-health.d.ts +72 -0
- package/dist/core/project-health.js +79 -0
- package/dist/core/project-health.js.map +1 -0
- package/dist/core/project-init.d.ts +9 -0
- package/dist/core/project-init.js +253 -0
- package/dist/core/project-init.js.map +1 -0
- package/dist/core/project-inspector.d.ts +24 -0
- package/dist/core/project-inspector.js +175 -0
- package/dist/core/project-inspector.js.map +1 -0
- package/dist/core/project-memory.d.ts +22 -0
- package/dist/core/project-memory.js +173 -0
- package/dist/core/project-memory.js.map +1 -0
- package/dist/core/provider-diagnostics.d.ts +12 -0
- package/dist/core/provider-diagnostics.js +73 -0
- package/dist/core/provider-diagnostics.js.map +1 -0
- package/dist/core/provider-response.d.ts +4 -0
- package/dist/core/provider-response.js +46 -0
- package/dist/core/provider-response.js.map +1 -0
- package/dist/core/quality-audit.d.ts +29 -0
- package/dist/core/quality-audit.js +101 -0
- package/dist/core/quality-audit.js.map +1 -0
- package/dist/core/regression-intelligence.d.ts +41 -0
- package/dist/core/regression-intelligence.js +56 -0
- package/dist/core/regression-intelligence.js.map +1 -0
- package/dist/core/remediation-planner.d.ts +43 -0
- package/dist/core/remediation-planner.js +124 -0
- package/dist/core/remediation-planner.js.map +1 -0
- package/dist/core/review-history.d.ts +18 -0
- package/dist/core/review-history.js +68 -0
- package/dist/core/review-history.js.map +1 -0
- package/dist/core/review-planner.d.ts +2 -0
- package/dist/core/review-planner.js +79 -0
- package/dist/core/review-planner.js.map +1 -0
- package/dist/core/run-history-output.d.ts +22 -0
- package/dist/core/run-history-output.js +51 -0
- package/dist/core/run-history-output.js.map +1 -0
- package/dist/core/run-replay.d.ts +9 -0
- package/dist/core/run-replay.js +64 -0
- package/dist/core/run-replay.js.map +1 -0
- package/dist/core/run-store.d.ts +13 -0
- package/dist/core/run-store.js +300 -0
- package/dist/core/run-store.js.map +1 -0
- package/dist/core/sandbox-cleanup-audit.d.ts +14 -0
- package/dist/core/sandbox-cleanup-audit.js +57 -0
- package/dist/core/sandbox-cleanup-audit.js.map +1 -0
- package/dist/core/sandbox-compliance.d.ts +19 -0
- package/dist/core/sandbox-compliance.js +34 -0
- package/dist/core/sandbox-compliance.js.map +1 -0
- package/dist/core/sandbox-lifecycle.d.ts +8 -0
- package/dist/core/sandbox-lifecycle.js +36 -0
- package/dist/core/sandbox-lifecycle.js.map +1 -0
- package/dist/core/sandbox-policy.d.ts +31 -0
- package/dist/core/sandbox-policy.js +80 -0
- package/dist/core/sandbox-policy.js.map +1 -0
- package/dist/core/sandbox-runtime.d.ts +10 -0
- package/dist/core/sandbox-runtime.js +44 -0
- package/dist/core/sandbox-runtime.js.map +1 -0
- package/dist/core/sandbox-security-profiles.d.ts +16 -0
- package/dist/core/sandbox-security-profiles.js +43 -0
- package/dist/core/sandbox-security-profiles.js.map +1 -0
- package/dist/core/skill-registry.d.ts +14 -0
- package/dist/core/skill-registry.js +186 -0
- package/dist/core/skill-registry.js.map +1 -0
- package/dist/core/staged-verification.d.ts +27 -0
- package/dist/core/staged-verification.js +108 -0
- package/dist/core/staged-verification.js.map +1 -0
- package/dist/core/verification-history.d.ts +10 -0
- package/dist/core/verification-history.js +71 -0
- package/dist/core/verification-history.js.map +1 -0
- package/dist/core/verification.d.ts +37 -0
- package/dist/core/verification.js +204 -0
- package/dist/core/verification.js.map +1 -0
- package/dist/core/workflow-store.d.ts +16 -0
- package/dist/core/workflow-store.js +113 -0
- package/dist/core/workflow-store.js.map +1 -0
- package/dist/core/workspace-browser.d.ts +22 -0
- package/dist/core/workspace-browser.js +115 -0
- package/dist/core/workspace-browser.js.map +1 -0
- package/dist/core/workspace-scan-policy.d.ts +2 -0
- package/dist/core/workspace-scan-policy.js +11 -0
- package/dist/core/workspace-scan-policy.js.map +1 -0
- package/dist/core/workspace-tool-broker.d.ts +28 -0
- package/dist/core/workspace-tool-broker.js +70 -0
- package/dist/core/workspace-tool-broker.js.map +1 -0
- package/dist/index.d.ts +75 -0
- package/dist/index.js +82 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/server.d.ts +2 -0
- package/dist/mcp/server.js +342 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/mcp/workspace-path.d.ts +2 -0
- package/dist/mcp/workspace-path.js +41 -0
- package/dist/mcp/workspace-path.js.map +1 -0
- package/package.json +67 -5
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { type DependencyIntelligenceReport } from "./dependency-intelligence.js";
|
|
2
|
+
export type RemediationPriority = "critical" | "high" | "moderate" | "low" | "info";
|
|
3
|
+
export interface RemediationItem {
|
|
4
|
+
id: string;
|
|
5
|
+
priority: RemediationPriority;
|
|
6
|
+
category: "vulnerability" | "outdated" | "license" | "inventory";
|
|
7
|
+
packageName: string;
|
|
8
|
+
currentVersion: string | null;
|
|
9
|
+
suggestedVersion: string | null;
|
|
10
|
+
title: string;
|
|
11
|
+
rationale: string;
|
|
12
|
+
recommendedAction: string;
|
|
13
|
+
command: string | null;
|
|
14
|
+
confidence: "evidence-backed" | "advisory";
|
|
15
|
+
requiresReview: true;
|
|
16
|
+
}
|
|
17
|
+
export interface RemediationPlan {
|
|
18
|
+
root: string;
|
|
19
|
+
generatedAt: string;
|
|
20
|
+
evidence: {
|
|
21
|
+
vulnerabilityReport: string | null;
|
|
22
|
+
outdatedReport: string | null;
|
|
23
|
+
lockfileParsed: boolean;
|
|
24
|
+
};
|
|
25
|
+
summary: {
|
|
26
|
+
total: number;
|
|
27
|
+
critical: number;
|
|
28
|
+
high: number;
|
|
29
|
+
moderate: number;
|
|
30
|
+
low: number;
|
|
31
|
+
info: number;
|
|
32
|
+
evidenceBacked: number;
|
|
33
|
+
advisory: number;
|
|
34
|
+
};
|
|
35
|
+
items: RemediationItem[];
|
|
36
|
+
limitations: string[];
|
|
37
|
+
}
|
|
38
|
+
export declare function buildRemediationPlan(report: DependencyIntelligenceReport): RemediationPlan;
|
|
39
|
+
export declare function generateRemediationPlan(root: string, options?: {
|
|
40
|
+
auditReport?: string;
|
|
41
|
+
outdatedReport?: string;
|
|
42
|
+
}): Promise<RemediationPlan>;
|
|
43
|
+
export declare function formatRemediationPlan(plan: RemediationPlan): string;
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
import { analyzeDependencies } from "./dependency-intelligence.js";
|
|
2
|
+
function priorityFor(severity) {
|
|
3
|
+
return severity === "critical" || severity === "high" || severity === "moderate" || severity === "low" ? severity : "info";
|
|
4
|
+
}
|
|
5
|
+
function versionParts(value) {
|
|
6
|
+
const match = value.trim().replace(/^[~^=v]/, "").match(/^(\d+)\.(\d+)\.(\d+)/);
|
|
7
|
+
return match ? match.slice(1).map(Number) : null;
|
|
8
|
+
}
|
|
9
|
+
function updateGuidance(item) {
|
|
10
|
+
const outdated = item.outdated;
|
|
11
|
+
const current = versionParts(outdated.current), wanted = versionParts(outdated.wanted), latest = versionParts(outdated.latest);
|
|
12
|
+
const isMajor = Boolean(current && latest && latest[0] !== current[0]);
|
|
13
|
+
if (wanted && current && wanted[0] !== undefined && wanted[1] !== undefined && wanted[2] !== undefined && current[0] !== undefined && current[1] !== undefined && current[2] !== undefined && wanted[0] === current[0] && (wanted[1] > current[1] || wanted[2] > current[2])) {
|
|
14
|
+
return {
|
|
15
|
+
title: "Review a compatible update",
|
|
16
|
+
rationale: `npm outdated reports ${outdated.current} installed and ${outdated.wanted} wanted within the declared range; latest is ${outdated.latest}.`,
|
|
17
|
+
action: "Review the package changelog and test compatibility, then update the lockfile using the wanted version if appropriate.",
|
|
18
|
+
command: `npm install ${item.name}@${outdated.wanted}`
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
return {
|
|
22
|
+
title: isMajor ? "Assess a major-version upgrade" : "Review the reported version gap",
|
|
23
|
+
rationale: `npm outdated reports current ${outdated.current}, wanted ${outdated.wanted}, latest ${outdated.latest}. FORGE cannot establish compatibility from version numbers alone.`,
|
|
24
|
+
action: "Review release notes, migration guidance, peer dependencies and downstream usage before choosing an upgrade.",
|
|
25
|
+
command: null
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
export function buildRemediationPlan(report) {
|
|
29
|
+
const items = [];
|
|
30
|
+
for (const dependency of report.dependencies) {
|
|
31
|
+
for (const [index, vulnerability] of dependency.vulnerabilities.entries()) {
|
|
32
|
+
const priority = priorityFor(vulnerability.severity);
|
|
33
|
+
items.push({
|
|
34
|
+
id: `vulnerability:${dependency.name}:${index}`, priority, category: "vulnerability",
|
|
35
|
+
packageName: dependency.name, currentVersion: dependency.locked, suggestedVersion: null,
|
|
36
|
+
title: vulnerability.title, rationale: `${vulnerability.severity} severity finding imported from ${report.sources.vulnerabilityReport ?? "an audit report"}; affected range: ${vulnerability.range ?? "not supplied"}.`,
|
|
37
|
+
recommendedAction: vulnerability.fixAvailable === true
|
|
38
|
+
? "Inspect the npm audit remediation details and review the proposed dependency tree before applying any update."
|
|
39
|
+
: vulnerability.fixAvailable === false
|
|
40
|
+
? "No automatic fix is reported. Review the advisory, assess exposure, and plan a compatible manual upgrade or mitigation."
|
|
41
|
+
: "Review the advisory and determine whether a compatible fix is available; the imported report does not confirm fix availability.",
|
|
42
|
+
command: vulnerability.fixAvailable === true ? "npm audit fix --dry-run" : null,
|
|
43
|
+
confidence: "evidence-backed", requiresReview: true
|
|
44
|
+
});
|
|
45
|
+
}
|
|
46
|
+
if (dependency.outdated) {
|
|
47
|
+
const guidance = updateGuidance(dependency);
|
|
48
|
+
items.push({
|
|
49
|
+
id: `outdated:${dependency.name}`, priority: "low", category: "outdated",
|
|
50
|
+
packageName: dependency.name, currentVersion: dependency.outdated.current,
|
|
51
|
+
suggestedVersion: dependency.outdated.wanted, title: guidance.title, rationale: guidance.rationale,
|
|
52
|
+
recommendedAction: guidance.action, command: guidance.command,
|
|
53
|
+
confidence: "evidence-backed", requiresReview: true
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
if (dependency.licenseClass === "unknown") {
|
|
57
|
+
items.push({
|
|
58
|
+
id: `license:${dependency.name}`, priority: "info", category: "license",
|
|
59
|
+
packageName: dependency.name, currentVersion: dependency.locked, suggestedVersion: null,
|
|
60
|
+
title: "Verify license metadata",
|
|
61
|
+
rationale: "No license identifier was available in the lockfile or installed package manifest.",
|
|
62
|
+
recommendedAction: "Inspect the package's authoritative LICENSE file and published metadata; do not assume permission from missing metadata.",
|
|
63
|
+
command: null, confidence: "advisory", requiresReview: true
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
else if (dependency.licenseClass === "copyleft") {
|
|
67
|
+
items.push({
|
|
68
|
+
id: `license:${dependency.name}`, priority: "moderate", category: "license",
|
|
69
|
+
packageName: dependency.name, currentVersion: dependency.locked, suggestedVersion: null,
|
|
70
|
+
title: "Review copyleft license obligations",
|
|
71
|
+
rationale: `License metadata is ${dependency.license ?? "classified as copyleft"}; classification is heuristic and is not a legal conclusion.`,
|
|
72
|
+
recommendedAction: "Have the project's responsible reviewer assess the exact license text and distribution obligations.",
|
|
73
|
+
command: null, confidence: "advisory", requiresReview: true
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
if (!report.manifestFound) {
|
|
78
|
+
items.push({
|
|
79
|
+
id: "inventory:missing-manifest", priority: "info", category: "inventory", packageName: "(project)",
|
|
80
|
+
currentVersion: null, suggestedVersion: null, title: "No npm manifest detected",
|
|
81
|
+
rationale: "The analyzer did not find a readable package.json.",
|
|
82
|
+
recommendedAction: "Confirm the project ecosystem before selecting a package-management remediation workflow.",
|
|
83
|
+
command: null, confidence: "advisory", requiresReview: true
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
const rank = { critical: 0, high: 1, moderate: 2, low: 3, info: 4 };
|
|
87
|
+
items.sort((a, b) => rank[a.priority] - rank[b.priority] || a.packageName.localeCompare(b.packageName) || a.id.localeCompare(b.id));
|
|
88
|
+
const count = (priority) => items.filter(item => item.priority === priority).length;
|
|
89
|
+
return {
|
|
90
|
+
root: report.root, generatedAt: new Date().toISOString(),
|
|
91
|
+
evidence: { vulnerabilityReport: report.sources.vulnerabilityReport, outdatedReport: report.sources.outdatedReport, lockfileParsed: report.lockfile.parsed },
|
|
92
|
+
summary: { total: items.length, critical: count("critical"), high: count("high"), moderate: count("moderate"), low: count("low"), info: count("info"), evidenceBacked: items.filter(item => item.confidence === "evidence-backed").length, advisory: items.filter(item => item.confidence === "advisory").length },
|
|
93
|
+
items,
|
|
94
|
+
limitations: [
|
|
95
|
+
"This is a reviewable plan, not an automated repair. FORGE does not install, upgrade, remove, or modify dependencies.",
|
|
96
|
+
"Vulnerability and outdated recommendations are only as current as the imported local npm reports; no registry or advisory service is queried.",
|
|
97
|
+
"Version compatibility cannot be inferred from semver alone. Review release notes, peer dependencies, lockfile changes, and project tests.",
|
|
98
|
+
"License categories are heuristic metadata signals, not legal advice or a full SPDX compatibility analysis.",
|
|
99
|
+
"Commands are suggestions only and are never executed by FORGE."
|
|
100
|
+
]
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
export async function generateRemediationPlan(root, options = {}) {
|
|
104
|
+
return buildRemediationPlan(await analyzeDependencies(root, options));
|
|
105
|
+
}
|
|
106
|
+
export function formatRemediationPlan(plan) {
|
|
107
|
+
const lines = [
|
|
108
|
+
"# FORGE Remediation Plan", "", `- Project: \`${plan.root}\``, `- Generated: ${plan.generatedAt}`,
|
|
109
|
+
`- Items: ${plan.summary.total} (critical ${plan.summary.critical}, high ${plan.summary.high}, moderate ${plan.summary.moderate}, low ${plan.summary.low}, info ${plan.summary.info})`,
|
|
110
|
+
`- Evidence-backed: ${plan.summary.evidenceBacked}; advisory: ${plan.summary.advisory}`, "",
|
|
111
|
+
"## Prioritized actions",
|
|
112
|
+
...(plan.items.length ? plan.items.map((item, index) => [
|
|
113
|
+
`${index + 1}. [${item.priority.toUpperCase()}] ${item.title} — ${item.packageName}`,
|
|
114
|
+
` ${item.rationale}`, ` Action: ${item.recommendedAction}`,
|
|
115
|
+
...(item.command ? [` Suggested command (not executed): \`${item.command}\``] : [])
|
|
116
|
+
].join("\n")) : ["No remediation items were generated from the available evidence."]),
|
|
117
|
+
"", "## Evidence", `- npm audit report: ${plan.evidence.vulnerabilityReport ?? "NOT PROVIDED — vulnerabilities not assessed"}`,
|
|
118
|
+
`- npm outdated report: ${plan.evidence.outdatedReport ?? "NOT PROVIDED — outdated status not assessed"}`,
|
|
119
|
+
`- Lockfile parsed: ${plan.evidence.lockfileParsed ? "yes" : "no"}`, "",
|
|
120
|
+
"## Limitations", ...plan.limitations.map(item => "- " + item), ""
|
|
121
|
+
];
|
|
122
|
+
return lines.join("\n");
|
|
123
|
+
}
|
|
124
|
+
//# sourceMappingURL=remediation-planner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"remediation-planner.js","sourceRoot":"","sources":["../../src/core/remediation-planner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { CodeReviewReport } from "./code-review.js";
|
|
2
|
+
import type { AIReviewResult } from "./ai-code-review.js";
|
|
3
|
+
export interface ReviewRecord {
|
|
4
|
+
id: string;
|
|
5
|
+
createdAt: string;
|
|
6
|
+
report: CodeReviewReport;
|
|
7
|
+
ai?: AIReviewResult;
|
|
8
|
+
}
|
|
9
|
+
export declare function saveReview(root: string, report: CodeReviewReport, ai?: AIReviewResult): Promise<ReviewRecord>;
|
|
10
|
+
export declare function loadReview(root: string, id: string): Promise<ReviewRecord>;
|
|
11
|
+
export declare function listReviews(root: string): Promise<ReviewRecord[]>;
|
|
12
|
+
export interface ReviewComparison {
|
|
13
|
+
added: string[];
|
|
14
|
+
resolved: string[];
|
|
15
|
+
persistent: string[];
|
|
16
|
+
}
|
|
17
|
+
export declare function compareReviews(before: ReviewRecord, after: ReviewRecord): ReviewComparison;
|
|
18
|
+
export declare function formatReviewRecord(record: ReviewRecord): string;
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
|
|
2
|
+
import { randomUUID } from "node:crypto";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
const ID = /^review-[a-f0-9-]{20,40}$/;
|
|
5
|
+
function directory(root) { return path.join(path.resolve(root), ".forge", "reviews"); }
|
|
6
|
+
function validateId(id) { if (!ID.test(id) || id.includes(".."))
|
|
7
|
+
throw new Error("Invalid review identifier."); }
|
|
8
|
+
export async function saveReview(root, report, ai) {
|
|
9
|
+
const id = "review-" + randomUUID();
|
|
10
|
+
const record = { id, createdAt: new Date().toISOString(), report, ...(ai ? { ai } : {}) };
|
|
11
|
+
const dir = directory(root);
|
|
12
|
+
await mkdir(dir, { recursive: true });
|
|
13
|
+
const target = path.join(dir, id + ".json");
|
|
14
|
+
const temp = path.join(dir, "." + id + "." + randomUUID() + ".tmp");
|
|
15
|
+
try {
|
|
16
|
+
await writeFile(temp, JSON.stringify(record, null, 2) + "\n", { encoding: "utf8", flag: "wx", mode: 0o600 });
|
|
17
|
+
await rename(temp, target);
|
|
18
|
+
}
|
|
19
|
+
catch (error) {
|
|
20
|
+
await rm(temp, { force: true }).catch(() => undefined);
|
|
21
|
+
throw error;
|
|
22
|
+
}
|
|
23
|
+
return record;
|
|
24
|
+
}
|
|
25
|
+
export async function loadReview(root, id) {
|
|
26
|
+
validateId(id);
|
|
27
|
+
const parsed = JSON.parse(await readFile(path.join(directory(root), id + ".json"), "utf8"));
|
|
28
|
+
if (!parsed || typeof parsed !== "object" || !("id" in parsed) || parsed.id !== id || !("report" in parsed))
|
|
29
|
+
throw new Error("Stored review has an invalid format.");
|
|
30
|
+
return parsed;
|
|
31
|
+
}
|
|
32
|
+
export async function listReviews(root) {
|
|
33
|
+
let entries;
|
|
34
|
+
try {
|
|
35
|
+
entries = await readdir(directory(root), { withFileTypes: true });
|
|
36
|
+
}
|
|
37
|
+
catch (error) {
|
|
38
|
+
if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
|
|
39
|
+
return [];
|
|
40
|
+
throw error;
|
|
41
|
+
}
|
|
42
|
+
const records = [];
|
|
43
|
+
for (const entry of entries) {
|
|
44
|
+
if (!entry.isFile() || !entry.name.endsWith(".json"))
|
|
45
|
+
continue;
|
|
46
|
+
const id = entry.name.slice(0, -5);
|
|
47
|
+
if (!ID.test(id))
|
|
48
|
+
continue;
|
|
49
|
+
try {
|
|
50
|
+
records.push(await loadReview(root, id));
|
|
51
|
+
}
|
|
52
|
+
catch { /* Ignore invalid records. */ }
|
|
53
|
+
}
|
|
54
|
+
return records.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
|
|
55
|
+
}
|
|
56
|
+
function key(f) { return [f.file, f.ruleId ?? "AI", f.title].join("::"); }
|
|
57
|
+
export function compareReviews(before, after) {
|
|
58
|
+
const oldFindings = [...before.report.findings, ...(before.ai?.suggestions ?? [])];
|
|
59
|
+
const newFindings = [...after.report.findings, ...(after.ai?.suggestions ?? [])];
|
|
60
|
+
const oldSet = new Set(oldFindings.map(key));
|
|
61
|
+
const newSet = new Set(newFindings.map(key));
|
|
62
|
+
return { added: [...newSet].filter(x => !oldSet.has(x)).sort(), resolved: [...oldSet].filter(x => !newSet.has(x)).sort(), persistent: [...newSet].filter(x => oldSet.has(x)).sort() };
|
|
63
|
+
}
|
|
64
|
+
export function formatReviewRecord(record) {
|
|
65
|
+
const ai = record.ai?.suggestions.length ?? 0;
|
|
66
|
+
return ["# Saved FORGE Review", "- ID: " + record.id, "- Created: " + record.createdAt, "- Files: " + record.report.filesReviewed.length, "- Static findings: " + record.report.findings.length, "- AI suggestions: " + ai, "", record.report.findings.map(f => "- [" + f.severity + "] " + f.file + ":" + f.line + " — " + f.title).join("\n") || "No static findings.", ...(record.ai ? ["", "## AI suggestions", ...record.ai.suggestions.flatMap(s => ["- [" + s.severity + "] " + s.file + ":" + s.line + " — " + s.title, ...(s.patch ? [" Patch preview (not applied):", "```diff", s.patch, "```"] : [])])] : [])].join("\n");
|
|
67
|
+
}
|
|
68
|
+
//# sourceMappingURL=review-history.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"review-history.js","sourceRoot":"","sources":["../../src/core/review-history.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { createRun } from "./orchestrator.js";
|
|
2
|
+
export function createReviewPlan(goal) {
|
|
3
|
+
const normalized = goal.trim();
|
|
4
|
+
if (!normalized)
|
|
5
|
+
throw new Error("Provide a goal after --goal.");
|
|
6
|
+
const tasks = [
|
|
7
|
+
{
|
|
8
|
+
id: "understand",
|
|
9
|
+
agent: "architect",
|
|
10
|
+
title: "Understand project structure and change scope",
|
|
11
|
+
prompt: `Inspect the relevant project structure and conventions for this goal: ${normalized}. Identify affected modules, assumptions, constraints and important interfaces. Do not modify files.`,
|
|
12
|
+
},
|
|
13
|
+
{
|
|
14
|
+
id: "plan",
|
|
15
|
+
agent: "planner",
|
|
16
|
+
title: "Create an implementation plan",
|
|
17
|
+
prompt: `Using the project understanding, produce an ordered implementation plan for: ${normalized}. Include file-level scope, acceptance criteria, risks and verification steps. Do not modify files.`,
|
|
18
|
+
dependsOn: ["understand"],
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
id: "review",
|
|
22
|
+
agent: "code-reviewer",
|
|
23
|
+
title: "Review correctness and regression risks",
|
|
24
|
+
prompt: `Review the proposed approach for ${normalized}. Identify correctness defects, edge cases, compatibility risks and missing tests. Cite evidence and distinguish confirmed issues from hypotheses.`,
|
|
25
|
+
dependsOn: ["plan"],
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
id: "security",
|
|
29
|
+
agent: "security-reviewer",
|
|
30
|
+
title: "Review security and trust boundaries",
|
|
31
|
+
prompt: `Assess the proposed approach for ${normalized} for input validation, permissions, secrets, filesystem/process/network boundaries and untrusted content. Report concrete risks and mitigations.`,
|
|
32
|
+
dependsOn: ["plan"],
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
id: "performance",
|
|
36
|
+
agent: "performance-engineer",
|
|
37
|
+
title: "Review performance implications",
|
|
38
|
+
prompt: `Assess likely performance implications of ${normalized}. Identify measurable bottleneck hypotheses, complexity or resource risks, and benchmarks that would validate them. Do not invent measurements.`,
|
|
39
|
+
dependsOn: ["plan"],
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
id: "debugging",
|
|
43
|
+
agent: "debugger",
|
|
44
|
+
title: "Identify diagnostic and failure scenarios",
|
|
45
|
+
prompt: `Identify likely failure modes related to ${normalized}. Propose a hypothesis-led debugging and reproduction strategy. Clearly label hypotheses; do not claim to have executed tests.`,
|
|
46
|
+
dependsOn: ["plan"],
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
id: "tests",
|
|
50
|
+
agent: "test-engineer",
|
|
51
|
+
title: "Define verification strategy",
|
|
52
|
+
prompt: `Define unit, integration, boundary and failure tests for ${normalized}. Distinguish suggested checks from checks actually executed.`,
|
|
53
|
+
dependsOn: ["plan"],
|
|
54
|
+
},
|
|
55
|
+
{
|
|
56
|
+
id: "docs",
|
|
57
|
+
agent: "documentation-writer",
|
|
58
|
+
title: "Review documentation impact",
|
|
59
|
+
prompt: `Identify documentation, examples, configuration references and migration notes affected by ${normalized}. Keep proposed documentation consistent with verified behavior.`,
|
|
60
|
+
dependsOn: ["plan"],
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
id: "delivery",
|
|
64
|
+
agent: "devops-engineer",
|
|
65
|
+
title: "Review CI and delivery impact",
|
|
66
|
+
prompt: `Identify build, CI, release and deployment checks needed for ${normalized}. Do not claim any workflow passed without run evidence.`,
|
|
67
|
+
dependsOn: ["plan"],
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
id: "release",
|
|
71
|
+
agent: "release-manager",
|
|
72
|
+
title: "Prepare engineering readiness summary",
|
|
73
|
+
prompt: `Synthesize the preceding specialist findings for ${normalized}. Produce a concise readiness summary, unresolved risks, required checks and go/no-go recommendation. Mark all unverified claims explicitly.`,
|
|
74
|
+
dependsOn: ["review", "security", "performance", "debugging", "tests", "docs", "delivery"],
|
|
75
|
+
},
|
|
76
|
+
];
|
|
77
|
+
return createRun(normalized, tasks);
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=review-planner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"review-planner.js","sourceRoot":"","sources":["../../src/core/review-planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkC,MAAM,mBAAmB,CAAC;AAE9E,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAEjE,MAAM,KAAK,GAAgB;QACzB;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,+CAA+C;YACtD,MAAM,EAAE,yEAAyE,UAAU,sGAAsG;SAClM;QACD;YACE,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,+BAA+B;YACtC,MAAM,EAAE,gFAAgF,UAAU,qGAAqG;YACvM,SAAS,EAAE,CAAC,YAAY,CAAC;SAC1B;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE,eAAe;YACtB,KAAK,EAAE,yCAAyC;YAChD,MAAM,EAAE,oCAAoC,UAAU,oJAAoJ;YAC1M,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB;QACD;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE,sCAAsC;YAC7C,MAAM,EAAE,oCAAoC,UAAU,kJAAkJ;YACxM,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB;QACD;YACE,EAAE,EAAE,aAAa;YACjB,KAAK,EAAE,sBAAsB;YAC7B,KAAK,EAAE,iCAAiC;YACxC,MAAM,EAAE,6CAA6C,UAAU,iJAAiJ;YAChN,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB;QACD;YACE,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,2CAA2C;YAClD,MAAM,EAAE,4CAA4C,UAAU,gIAAgI;YAC9L,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB;QACD;YACE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,eAAe;YACtB,KAAK,EAAE,8BAA8B;YACrC,MAAM,EAAE,4DAA4D,UAAU,+DAA+D;YAC7I,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB;QACD;YACE,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,sBAAsB;YAC7B,KAAK,EAAE,6BAA6B;YACpC,MAAM,EAAE,8FAA8F,UAAU,kEAAkE;YAClL,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB;QACD;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,iBAAiB;YACxB,KAAK,EAAE,+BAA+B;YACtC,MAAM,EAAE,gEAAgE,UAAU,0DAA0D;YAC5I,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB;QACD;YACE,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,iBAAiB;YACxB,KAAK,EAAE,uCAAuC;YAC9C,MAAM,EAAE,oDAAoD,UAAU,8IAA8I;YACpN,SAAS,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC;SAC3F;KACF,CAAC;IAEF,OAAO,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { RunRecord } from "./orchestrator.js";
|
|
2
|
+
export interface RunHistoryJsonItem {
|
|
3
|
+
id: string;
|
|
4
|
+
goal: string;
|
|
5
|
+
status: RunRecord["status"];
|
|
6
|
+
createdAt: string;
|
|
7
|
+
updatedAt: string;
|
|
8
|
+
taskCount: number;
|
|
9
|
+
pendingTaskCount: number;
|
|
10
|
+
awaitingApprovalTaskCount: number;
|
|
11
|
+
runningTaskCount: number;
|
|
12
|
+
completedTaskCount: number;
|
|
13
|
+
failedTaskCount: number;
|
|
14
|
+
blockedTaskCount: number;
|
|
15
|
+
eventCount: number;
|
|
16
|
+
}
|
|
17
|
+
export interface RunHistoryJson {
|
|
18
|
+
schemaVersion: 1;
|
|
19
|
+
runs: RunHistoryJsonItem[];
|
|
20
|
+
}
|
|
21
|
+
/** Formats the public, versioned summary contract for `forge runs --json`. */
|
|
22
|
+
export declare function formatRunHistoryJson(runs: readonly RunRecord[]): string;
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/** Formats the public, versioned summary contract for `forge runs --json`. */
|
|
2
|
+
export function formatRunHistoryJson(runs) {
|
|
3
|
+
const output = {
|
|
4
|
+
schemaVersion: 1,
|
|
5
|
+
runs: runs.map((run) => ({
|
|
6
|
+
id: run.id,
|
|
7
|
+
goal: run.goal,
|
|
8
|
+
status: run.status,
|
|
9
|
+
createdAt: run.createdAt,
|
|
10
|
+
updatedAt: run.updatedAt,
|
|
11
|
+
taskCount: run.tasks.length,
|
|
12
|
+
...run.tasks.reduce((counts, task) => {
|
|
13
|
+
switch (task.status) {
|
|
14
|
+
case "pending":
|
|
15
|
+
counts.pendingTaskCount += 1;
|
|
16
|
+
break;
|
|
17
|
+
case "awaiting_approval":
|
|
18
|
+
counts.awaitingApprovalTaskCount += 1;
|
|
19
|
+
break;
|
|
20
|
+
case "running":
|
|
21
|
+
counts.runningTaskCount += 1;
|
|
22
|
+
break;
|
|
23
|
+
case "completed":
|
|
24
|
+
counts.completedTaskCount += 1;
|
|
25
|
+
break;
|
|
26
|
+
case "failed":
|
|
27
|
+
counts.failedTaskCount += 1;
|
|
28
|
+
break;
|
|
29
|
+
case "blocked":
|
|
30
|
+
counts.blockedTaskCount += 1;
|
|
31
|
+
break;
|
|
32
|
+
default: {
|
|
33
|
+
const exhaustiveStatus = task.status;
|
|
34
|
+
throw new Error(`Unsupported task status: ${String(exhaustiveStatus)}`);
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
return counts;
|
|
38
|
+
}, {
|
|
39
|
+
pendingTaskCount: 0,
|
|
40
|
+
awaitingApprovalTaskCount: 0,
|
|
41
|
+
runningTaskCount: 0,
|
|
42
|
+
completedTaskCount: 0,
|
|
43
|
+
failedTaskCount: 0,
|
|
44
|
+
blockedTaskCount: 0,
|
|
45
|
+
}),
|
|
46
|
+
eventCount: run.events.length,
|
|
47
|
+
})),
|
|
48
|
+
};
|
|
49
|
+
return JSON.stringify(output, null, 2) + "\n";
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=run-history-output.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-history-output.js","sourceRoot":"","sources":["../../src/core/run-history-output.ts"],"names":[],"mappings":"AAuBA,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,IAA0B;IAC7D,MAAM,MAAM,GAAmB;QAC7B,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACvB,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM;YAC3B,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBACnC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;oBACpB,KAAK,SAAS;wBAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;wBAAC,MAAM;oBACpD,KAAK,mBAAmB;wBAAE,MAAM,CAAC,yBAAyB,IAAI,CAAC,CAAC;wBAAC,MAAM;oBACvE,KAAK,SAAS;wBAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;wBAAC,MAAM;oBACpD,KAAK,WAAW;wBAAE,MAAM,CAAC,kBAAkB,IAAI,CAAC,CAAC;wBAAC,MAAM;oBACxD,KAAK,QAAQ;wBAAE,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;wBAAC,MAAM;oBAClD,KAAK,SAAS;wBAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;wBAAC,MAAM;oBACpD,OAAO,CAAC,CAAC,CAAC;wBACR,MAAM,gBAAgB,GAAU,IAAI,CAAC,MAAM,CAAC;wBAC5C,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;oBAC1E,CAAC;gBACH,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC,EAAE;gBACD,gBAAgB,EAAE,CAAC;gBACnB,yBAAyB,EAAE,CAAC;gBAC5B,gBAAgB,EAAE,CAAC;gBACnB,kBAAkB,EAAE,CAAC;gBACrB,eAAe,EAAE,CAAC;gBAClB,gBAAgB,EAAE,CAAC;aACpB,CAAC;YACF,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM;SAC9B,CAAC,CAAC;KACJ,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAChD,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { type RunRecord } from "./orchestrator.js";
|
|
2
|
+
/**
|
|
3
|
+
* Creates a new, auditable replay run from a failed run.
|
|
4
|
+
* Completed prerequisites are retained; provider/policy-blocked tasks are not
|
|
5
|
+
* silently reset. The caller must explicitly resume the returned run.
|
|
6
|
+
*/
|
|
7
|
+
export declare function createReplayRun(source: RunRecord): RunRecord;
|
|
8
|
+
/** Creates a focused retry run for one failed task and its blocked dependants. */
|
|
9
|
+
export declare function createTaskRetryRun(source: RunRecord, taskId: string): RunRecord;
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { createRun } from "./orchestrator.js";
|
|
2
|
+
/**
|
|
3
|
+
* Creates a new, auditable replay run from a failed run.
|
|
4
|
+
* Completed prerequisites are retained; provider/policy-blocked tasks are not
|
|
5
|
+
* silently reset. The caller must explicitly resume the returned run.
|
|
6
|
+
*/
|
|
7
|
+
export function createReplayRun(source) {
|
|
8
|
+
const rejected = source.tasks.find(record => record.approval?.decision === "rejected");
|
|
9
|
+
if (rejected)
|
|
10
|
+
throw new Error(`Cannot replay run: task "${rejected.task.id}" was explicitly rejected.`);
|
|
11
|
+
const retryable = source.tasks.filter(record => record.status === "failed" ||
|
|
12
|
+
(record.status === "blocked" && !record.error?.startsWith("Blocked by policy hook:")));
|
|
13
|
+
if (retryable.length === 0)
|
|
14
|
+
throw new Error("This run has no retryable failed or dependency-blocked tasks.");
|
|
15
|
+
const replay = createRun(source.goal, source.tasks.map(record => record.task));
|
|
16
|
+
replay.tasks = source.tasks.map(record => {
|
|
17
|
+
const shouldReset = record.status === "failed" ||
|
|
18
|
+
(record.status === "blocked" && !record.error?.startsWith("Blocked by policy hook:"));
|
|
19
|
+
return shouldReset
|
|
20
|
+
? { task: { ...record.task, dependsOn: [...(record.task.dependsOn ?? [])] }, status: "pending" }
|
|
21
|
+
: { ...record, task: { ...record.task, dependsOn: [...(record.task.dependsOn ?? [])] } };
|
|
22
|
+
});
|
|
23
|
+
replay.events.push({
|
|
24
|
+
at: new Date().toISOString(),
|
|
25
|
+
taskId: "*",
|
|
26
|
+
type: "started",
|
|
27
|
+
message: `Replay created from run ${source.id}; completed task results were retained.`,
|
|
28
|
+
});
|
|
29
|
+
return replay;
|
|
30
|
+
}
|
|
31
|
+
/** Creates a focused retry run for one failed task and its blocked dependants. */
|
|
32
|
+
export function createTaskRetryRun(source, taskId) {
|
|
33
|
+
const target = source.tasks.find(record => record.task.id === taskId);
|
|
34
|
+
if (!target || target.status !== "failed") {
|
|
35
|
+
throw new Error("Only a failed task can be retried directly; retry its failed prerequisite instead.");
|
|
36
|
+
}
|
|
37
|
+
if (target.approval?.decision === "rejected") {
|
|
38
|
+
throw new Error("An explicitly rejected task cannot be retried.");
|
|
39
|
+
}
|
|
40
|
+
const reset = new Set([taskId]);
|
|
41
|
+
let changed = true;
|
|
42
|
+
while (changed) {
|
|
43
|
+
changed = false;
|
|
44
|
+
for (const record of source.tasks) {
|
|
45
|
+
if (!reset.has(record.task.id) && record.status === "blocked" &&
|
|
46
|
+
(record.task.dependsOn ?? []).some(dependency => reset.has(dependency)) &&
|
|
47
|
+
!record.error?.startsWith("Blocked by policy hook:")) {
|
|
48
|
+
reset.add(record.task.id);
|
|
49
|
+
changed = true;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
const retry = createRun(source.goal, source.tasks.map(record => record.task));
|
|
54
|
+
retry.tasks = source.tasks.map(record => reset.has(record.task.id)
|
|
55
|
+
? { task: { ...record.task, dependsOn: [...(record.task.dependsOn ?? [])] }, status: "pending" }
|
|
56
|
+
: { ...record, task: { ...record.task, dependsOn: [...(record.task.dependsOn ?? [])] } });
|
|
57
|
+
retry.events.push({
|
|
58
|
+
at: new Date().toISOString(), taskId,
|
|
59
|
+
type: "started",
|
|
60
|
+
message: `Focused retry created from run ${source.id}; reset ${[...reset].join(", ")}.`,
|
|
61
|
+
});
|
|
62
|
+
return retry;
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=run-replay.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-replay.js","sourceRoot":"","sources":["../../src/core/run-replay.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { RunRecord } from "./orchestrator.js";
|
|
2
|
+
/** Holds an exclusive execution lease across a complete resume operation. */
|
|
3
|
+
export declare function withRunExecutionLock<T>(projectPath: string, runId: string, action: () => Promise<T>): Promise<T>;
|
|
4
|
+
export declare function saveRun(projectPath: string, run: RunRecord): Promise<string>;
|
|
5
|
+
export declare function loadRun(projectPath: string, runId: string): Promise<RunRecord>;
|
|
6
|
+
export declare function listRuns(projectPath: string): Promise<RunRecord[]>;
|
|
7
|
+
export declare function decideTaskApproval(projectPath: string, runId: string, taskId: string, decision: "approved" | "rejected", reviewer: string, reason?: string): Promise<RunRecord>;
|
|
8
|
+
/**
|
|
9
|
+
* Marks work interrupted by a process restart as failed and ambiguous.
|
|
10
|
+
* Provider calls are never replayed automatically: a remote provider may have
|
|
11
|
+
* completed the request before the local process stopped persisting its result.
|
|
12
|
+
*/
|
|
13
|
+
export declare function recoverInterruptedRun(projectPath: string, runId: string): Promise<RunRecord>;
|