ralphy-spec 0.1.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.
- package/CHANGELOG.md +32 -0
- package/README.ja.md +94 -127
- package/README.ko.md +94 -127
- package/README.md +94 -129
- package/README.zh.md +94 -127
- package/bin/ralphy-spec.js +0 -0
- package/dist/cli/budget.d.ts +3 -0
- package/dist/cli/budget.d.ts.map +1 -0
- package/dist/cli/budget.js +77 -0
- package/dist/cli/budget.js.map +1 -0
- package/dist/cli/checkpoint.d.ts +3 -0
- package/dist/cli/checkpoint.d.ts.map +1 -0
- package/dist/cli/checkpoint.js +23 -0
- package/dist/cli/checkpoint.js.map +1 -0
- package/dist/cli/init.d.ts +3 -0
- package/dist/cli/init.d.ts.map +1 -0
- package/dist/cli/init.js +72 -0
- package/dist/cli/init.js.map +1 -0
- package/dist/cli/report.d.ts +3 -0
- package/dist/cli/report.d.ts.map +1 -0
- package/dist/cli/report.js +53 -0
- package/dist/cli/report.js.map +1 -0
- package/dist/cli/run.d.ts +3 -0
- package/dist/cli/run.d.ts.map +1 -0
- package/dist/cli/run.js +112 -0
- package/dist/cli/run.js.map +1 -0
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.d.ts.map +1 -0
- package/dist/cli/status.js +76 -0
- package/dist/cli/status.js.map +1 -0
- package/dist/cli/tail.d.ts +3 -0
- package/dist/cli/tail.d.ts.map +1 -0
- package/dist/cli/tail.js +46 -0
- package/dist/cli/tail.js.map +1 -0
- package/dist/cli/update.d.ts +3 -0
- package/dist/cli/update.d.ts.map +1 -0
- package/dist/cli/update.js +62 -0
- package/dist/cli/update.js.map +1 -0
- package/dist/cli/validate.d.ts +3 -0
- package/dist/cli/validate.d.ts.map +1 -0
- package/dist/cli/validate.js +83 -0
- package/dist/cli/validate.js.map +1 -0
- package/dist/core/artifacts/budget-writer.d.ts +11 -0
- package/dist/core/artifacts/budget-writer.d.ts.map +1 -0
- package/dist/core/artifacts/budget-writer.js +28 -0
- package/dist/core/artifacts/budget-writer.js.map +1 -0
- package/dist/core/artifacts/run-log-writer.d.ts +20 -0
- package/dist/core/artifacts/run-log-writer.d.ts.map +1 -0
- package/dist/core/artifacts/run-log-writer.js +40 -0
- package/dist/core/artifacts/run-log-writer.js.map +1 -0
- package/dist/core/artifacts/run-log-writer.test.d.ts +2 -0
- package/dist/core/artifacts/run-log-writer.test.d.ts.map +1 -0
- package/dist/core/artifacts/run-log-writer.test.js +37 -0
- package/dist/core/artifacts/run-log-writer.test.js.map +1 -0
- package/dist/core/artifacts/status-writer.d.ts +16 -0
- package/dist/core/artifacts/status-writer.d.ts.map +1 -0
- package/dist/core/artifacts/status-writer.js +52 -0
- package/dist/core/artifacts/status-writer.js.map +1 -0
- package/dist/core/artifacts/status-writer.test.d.ts +2 -0
- package/dist/core/artifacts/status-writer.test.d.ts.map +1 -0
- package/dist/core/artifacts/status-writer.test.js +47 -0
- package/dist/core/artifacts/status-writer.test.js.map +1 -0
- package/dist/core/artifacts/task-artifacts.d.ts +19 -0
- package/dist/core/artifacts/task-artifacts.d.ts.map +1 -0
- package/dist/core/artifacts/task-artifacts.js +35 -0
- package/dist/core/artifacts/task-artifacts.js.map +1 -0
- package/dist/core/artifacts/tasks-writer.d.ts +19 -0
- package/dist/core/artifacts/tasks-writer.d.ts.map +1 -0
- package/dist/core/artifacts/tasks-writer.js +67 -0
- package/dist/core/artifacts/tasks-writer.js.map +1 -0
- package/dist/core/artifacts/tasks-writer.test.d.ts +2 -0
- package/dist/core/artifacts/tasks-writer.test.d.ts.map +1 -0
- package/dist/core/artifacts/tasks-writer.test.js +28 -0
- package/dist/core/artifacts/tasks-writer.test.js.map +1 -0
- package/dist/core/backends/claude-code.d.ts +17 -0
- package/dist/core/backends/claude-code.d.ts.map +1 -0
- package/dist/core/backends/claude-code.js +75 -0
- package/dist/core/backends/claude-code.js.map +1 -0
- package/dist/core/backends/cursor.d.ts +17 -0
- package/dist/core/backends/cursor.d.ts.map +1 -0
- package/dist/core/backends/cursor.js +75 -0
- package/dist/core/backends/cursor.js.map +1 -0
- package/dist/core/backends/noop.d.ts +10 -0
- package/dist/core/backends/noop.d.ts.map +1 -0
- package/dist/core/backends/noop.js +17 -0
- package/dist/core/backends/noop.js.map +1 -0
- package/dist/core/backends/opencode.d.ts +16 -0
- package/dist/core/backends/opencode.d.ts.map +1 -0
- package/dist/core/backends/opencode.js +73 -0
- package/dist/core/backends/opencode.js.map +1 -0
- package/dist/core/backends/types.d.ts +21 -0
- package/dist/core/backends/types.d.ts.map +1 -0
- package/dist/core/backends/types.js +3 -0
- package/dist/core/backends/types.js.map +1 -0
- package/dist/core/budgets/errors.d.ts +5 -0
- package/dist/core/budgets/errors.d.ts.map +1 -0
- package/dist/core/budgets/errors.js +11 -0
- package/dist/core/budgets/errors.js.map +1 -0
- package/dist/core/budgets/manager.d.ts +21 -0
- package/dist/core/budgets/manager.d.ts.map +1 -0
- package/dist/core/budgets/manager.js +48 -0
- package/dist/core/budgets/manager.js.map +1 -0
- package/dist/core/budgets/state.d.ts +25 -0
- package/dist/core/budgets/state.d.ts.map +1 -0
- package/dist/core/budgets/state.js +33 -0
- package/dist/core/budgets/state.js.map +1 -0
- package/dist/core/budgets/tiers.d.ts +32 -0
- package/dist/core/budgets/tiers.d.ts.map +1 -0
- package/dist/core/budgets/tiers.js +67 -0
- package/dist/core/budgets/tiers.js.map +1 -0
- package/dist/core/engine/constraints.d.ts +16 -0
- package/dist/core/engine/constraints.d.ts.map +1 -0
- package/dist/core/engine/constraints.js +21 -0
- package/dist/core/engine/constraints.js.map +1 -0
- package/dist/core/engine/constraints.policy.test.d.ts +2 -0
- package/dist/core/engine/constraints.policy.test.d.ts.map +1 -0
- package/dist/core/engine/constraints.policy.test.js +85 -0
- package/dist/core/engine/constraints.policy.test.js.map +1 -0
- package/dist/core/engine/context-pack.d.ts +12 -0
- package/dist/core/engine/context-pack.d.ts.map +1 -0
- package/dist/core/engine/context-pack.js +45 -0
- package/dist/core/engine/context-pack.js.map +1 -0
- package/dist/core/engine/loop.d.ts +28 -0
- package/dist/core/engine/loop.d.ts.map +1 -0
- package/dist/core/engine/loop.hardcap.test.d.ts +2 -0
- package/dist/core/engine/loop.hardcap.test.d.ts.map +1 -0
- package/dist/core/engine/loop.hardcap.test.js +77 -0
- package/dist/core/engine/loop.hardcap.test.js.map +1 -0
- package/dist/core/engine/loop.js +864 -0
- package/dist/core/engine/loop.js.map +1 -0
- package/dist/core/engine/phases.d.ts +2 -0
- package/dist/core/engine/phases.d.ts.map +1 -0
- package/dist/core/engine/phases.js +3 -0
- package/dist/core/engine/phases.js.map +1 -0
- package/dist/core/engine/repair.d.ts +6 -0
- package/dist/core/engine/repair.d.ts.map +1 -0
- package/dist/core/engine/repair.js +23 -0
- package/dist/core/engine/repair.js.map +1 -0
- package/dist/core/folders.d.ts +26 -0
- package/dist/core/folders.d.ts.map +1 -0
- package/dist/core/folders.js +58 -0
- package/dist/core/folders.js.map +1 -0
- package/dist/core/memory/ledger.d.ts +13 -0
- package/dist/core/memory/ledger.d.ts.map +1 -0
- package/dist/core/memory/ledger.js +24 -0
- package/dist/core/memory/ledger.js.map +1 -0
- package/dist/core/memory/persistence.d.ts +54 -0
- package/dist/core/memory/persistence.d.ts.map +1 -0
- package/dist/core/memory/persistence.js +180 -0
- package/dist/core/memory/persistence.js.map +1 -0
- package/dist/core/reporting/failure-summary.d.ts +23 -0
- package/dist/core/reporting/failure-summary.d.ts.map +1 -0
- package/dist/core/reporting/failure-summary.js +63 -0
- package/dist/core/reporting/failure-summary.js.map +1 -0
- package/dist/core/reporting/failure-summary.test.d.ts +2 -0
- package/dist/core/reporting/failure-summary.test.d.ts.map +1 -0
- package/dist/core/reporting/failure-summary.test.js +22 -0
- package/dist/core/reporting/failure-summary.test.js.map +1 -0
- package/dist/core/reporting/spend.d.ts +40 -0
- package/dist/core/reporting/spend.d.ts.map +1 -0
- package/dist/core/reporting/spend.js +157 -0
- package/dist/core/reporting/spend.js.map +1 -0
- package/dist/core/spec/dag.d.ts +7 -0
- package/dist/core/spec/dag.d.ts.map +1 -0
- package/dist/core/spec/dag.js +65 -0
- package/dist/core/spec/dag.js.map +1 -0
- package/dist/core/spec/file-contract.d.ts +13 -0
- package/dist/core/spec/file-contract.d.ts.map +1 -0
- package/dist/core/spec/file-contract.js +29 -0
- package/dist/core/spec/file-contract.js.map +1 -0
- package/dist/core/spec/loader.d.ts +8 -0
- package/dist/core/spec/loader.d.ts.map +1 -0
- package/dist/core/spec/loader.js +62 -0
- package/dist/core/spec/loader.js.map +1 -0
- package/dist/core/spec/schemas.d.ts +1135 -0
- package/dist/core/spec/schemas.d.ts.map +1 -0
- package/dist/core/spec/schemas.js +235 -0
- package/dist/core/spec/schemas.js.map +1 -0
- package/dist/core/spec/sprint-defaults.d.ts +16 -0
- package/dist/core/spec/sprint-defaults.d.ts.map +1 -0
- package/dist/core/spec/sprint-defaults.js +55 -0
- package/dist/core/spec/sprint-defaults.js.map +1 -0
- package/dist/core/spec/sprint-defaults.test.d.ts +2 -0
- package/dist/core/spec/sprint-defaults.test.d.ts.map +1 -0
- package/dist/core/spec/sprint-defaults.test.js +51 -0
- package/dist/core/spec/sprint-defaults.test.js.map +1 -0
- package/dist/core/spec/types.d.ts +82 -0
- package/dist/core/spec/types.d.ts.map +1 -0
- package/dist/core/spec/types.js +3 -0
- package/dist/core/spec/types.js.map +1 -0
- package/dist/core/validators/parsers/eslint.d.ts +3 -0
- package/dist/core/validators/parsers/eslint.d.ts.map +1 -0
- package/dist/core/validators/parsers/eslint.js +35 -0
- package/dist/core/validators/parsers/eslint.js.map +1 -0
- package/dist/core/validators/parsers/jest.d.ts +3 -0
- package/dist/core/validators/parsers/jest.d.ts.map +1 -0
- package/dist/core/validators/parsers/jest.js +16 -0
- package/dist/core/validators/parsers/jest.js.map +1 -0
- package/dist/core/validators/parsers/tsc.d.ts +3 -0
- package/dist/core/validators/parsers/tsc.d.ts.map +1 -0
- package/dist/core/validators/parsers/tsc.js +32 -0
- package/dist/core/validators/parsers/tsc.js.map +1 -0
- package/dist/core/validators/runner.d.ts +8 -0
- package/dist/core/validators/runner.d.ts.map +1 -0
- package/dist/core/validators/runner.js +85 -0
- package/dist/core/validators/runner.js.map +1 -0
- package/dist/core/validators/signatures.d.ts +3 -0
- package/dist/core/validators/signatures.d.ts.map +1 -0
- package/dist/core/validators/signatures.js +10 -0
- package/dist/core/validators/signatures.js.map +1 -0
- package/dist/core/validators/types.d.ts +27 -0
- package/dist/core/validators/types.d.ts.map +1 -0
- package/dist/core/validators/types.js +3 -0
- package/dist/core/validators/types.js.map +1 -0
- package/dist/core/workspace/contract-enforcer.d.ts +54 -0
- package/dist/core/workspace/contract-enforcer.d.ts.map +1 -0
- package/dist/core/workspace/contract-enforcer.js +128 -0
- package/dist/core/workspace/contract-enforcer.js.map +1 -0
- package/dist/core/workspace/manager.d.ts +28 -0
- package/dist/core/workspace/manager.d.ts.map +1 -0
- package/dist/core/workspace/manager.js +3 -0
- package/dist/core/workspace/manager.js.map +1 -0
- package/dist/core/workspace/merge.d.ts +38 -0
- package/dist/core/workspace/merge.d.ts.map +1 -0
- package/dist/core/workspace/merge.js +92 -0
- package/dist/core/workspace/merge.js.map +1 -0
- package/dist/core/workspace/patch-mode.d.ts +22 -0
- package/dist/core/workspace/patch-mode.d.ts.map +1 -0
- package/dist/core/workspace/patch-mode.js +91 -0
- package/dist/core/workspace/patch-mode.js.map +1 -0
- package/dist/core/workspace/scope-detector.d.ts +13 -0
- package/dist/core/workspace/scope-detector.d.ts.map +1 -0
- package/dist/core/workspace/scope-detector.js +34 -0
- package/dist/core/workspace/scope-detector.js.map +1 -0
- package/dist/core/workspace/worktree-mode.d.ts +28 -0
- package/dist/core/workspace/worktree-mode.d.ts.map +1 -0
- package/dist/core/workspace/worktree-mode.js +157 -0
- package/dist/core/workspace/worktree-mode.js.map +1 -0
- package/dist/index.js +16 -4
- package/dist/index.js.map +1 -1
- package/dist/templates/claude-code/ralphy-archive.md +1 -1
- package/dist/templates/claude-code/ralphy-implement.md +1 -1
- package/dist/templates/claude-code/ralphy-plan.md +1 -1
- package/dist/templates/claude-code/ralphy-validate.md +1 -1
- package/dist/templates/cursor/ralphy-archive.md +1 -1
- package/dist/templates/cursor/ralphy-implement.md +1 -1
- package/dist/templates/cursor/ralphy-plan.md +1 -1
- package/dist/templates/cursor/ralphy-validate.md +1 -1
- package/dist/templates/shared/openspec-tasks-template.md +23 -3
- package/dist/templates/shared/project-template.yml +232 -0
- package/dist/utils/installer.d.ts.map +1 -1
- package/dist/utils/installer.js +31 -1
- package/dist/utils/installer.js.map +1 -1
- package/dist/utils/validator.d.ts.map +1 -1
- package/dist/utils/validator.js +10 -0
- package/dist/utils/validator.js.map +1 -1
- package/package.json +15 -5
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"failure-summary.test.js","sourceRoot":"","sources":["../../../src/core/reporting/failure-summary.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,uDAAwD;AAExD,IAAA,iBAAQ,EAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,IAAA,WAAE,EAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,EAAE,GAAG,IAAA,qCAAmB,EAAC;YAC7B,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,kBAAkB;YAC1B,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC7E,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;SACjC,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QAClD,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACzC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { BudgetUsage } from "../budgets/state";
|
|
2
|
+
export type SpendEntry = {
|
|
3
|
+
taskId: string;
|
|
4
|
+
backendId?: string;
|
|
5
|
+
phase?: string;
|
|
6
|
+
usd: number;
|
|
7
|
+
tokens: number;
|
|
8
|
+
wallTimeMs: number;
|
|
9
|
+
iterations: number;
|
|
10
|
+
};
|
|
11
|
+
export type SpendBreakdown = {
|
|
12
|
+
total: BudgetUsage;
|
|
13
|
+
byTask: Map<string, BudgetUsage>;
|
|
14
|
+
byBackend: Map<string, BudgetUsage>;
|
|
15
|
+
byPhase: Map<string, BudgetUsage>;
|
|
16
|
+
entries: SpendEntry[];
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Aggregate spend data from ledger events.
|
|
20
|
+
*
|
|
21
|
+
* This processes ledger events to build a breakdown of spending
|
|
22
|
+
* by task, backend, and phase.
|
|
23
|
+
*/
|
|
24
|
+
export declare function aggregateSpend(events: SpendEntry[]): SpendBreakdown;
|
|
25
|
+
/**
|
|
26
|
+
* Format spend breakdown as markdown report.
|
|
27
|
+
*/
|
|
28
|
+
export declare function formatSpendReport(breakdown: SpendBreakdown): string;
|
|
29
|
+
/**
|
|
30
|
+
* Create spend entries from ledger events.
|
|
31
|
+
*
|
|
32
|
+
* This function parses ledger events and extracts spend information
|
|
33
|
+
* from events with kind="iteration_complete" or similar.
|
|
34
|
+
*/
|
|
35
|
+
export declare function extractSpendFromLedger(ledgerEvents: Array<{
|
|
36
|
+
taskId?: string;
|
|
37
|
+
kind: string;
|
|
38
|
+
data?: unknown;
|
|
39
|
+
}>): SpendEntry[];
|
|
40
|
+
//# sourceMappingURL=spend.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spend.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/spend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,CA0DnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,CA+DnE;AAYD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,KAAK,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,GACD,UAAU,EAAE,CA+Bd"}
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.aggregateSpend = aggregateSpend;
|
|
4
|
+
exports.formatSpendReport = formatSpendReport;
|
|
5
|
+
exports.extractSpendFromLedger = extractSpendFromLedger;
|
|
6
|
+
/**
|
|
7
|
+
* Aggregate spend data from ledger events.
|
|
8
|
+
*
|
|
9
|
+
* This processes ledger events to build a breakdown of spending
|
|
10
|
+
* by task, backend, and phase.
|
|
11
|
+
*/
|
|
12
|
+
function aggregateSpend(events) {
|
|
13
|
+
const total = { usd: 0, tokens: 0, wallTimeMs: 0, iterations: 0 };
|
|
14
|
+
const byTask = new Map();
|
|
15
|
+
const byBackend = new Map();
|
|
16
|
+
const byPhase = new Map();
|
|
17
|
+
for (const entry of events) {
|
|
18
|
+
// Accumulate total
|
|
19
|
+
total.usd += entry.usd;
|
|
20
|
+
total.tokens += entry.tokens;
|
|
21
|
+
total.wallTimeMs += entry.wallTimeMs;
|
|
22
|
+
total.iterations += entry.iterations;
|
|
23
|
+
// By task
|
|
24
|
+
const taskUsage = byTask.get(entry.taskId) ?? {
|
|
25
|
+
usd: 0,
|
|
26
|
+
tokens: 0,
|
|
27
|
+
wallTimeMs: 0,
|
|
28
|
+
iterations: 0,
|
|
29
|
+
};
|
|
30
|
+
taskUsage.usd += entry.usd;
|
|
31
|
+
taskUsage.tokens += entry.tokens;
|
|
32
|
+
taskUsage.wallTimeMs += entry.wallTimeMs;
|
|
33
|
+
taskUsage.iterations += entry.iterations;
|
|
34
|
+
byTask.set(entry.taskId, taskUsage);
|
|
35
|
+
// By backend (if present)
|
|
36
|
+
if (entry.backendId) {
|
|
37
|
+
const backendUsage = byBackend.get(entry.backendId) ?? {
|
|
38
|
+
usd: 0,
|
|
39
|
+
tokens: 0,
|
|
40
|
+
wallTimeMs: 0,
|
|
41
|
+
iterations: 0,
|
|
42
|
+
};
|
|
43
|
+
backendUsage.usd += entry.usd;
|
|
44
|
+
backendUsage.tokens += entry.tokens;
|
|
45
|
+
backendUsage.wallTimeMs += entry.wallTimeMs;
|
|
46
|
+
backendUsage.iterations += entry.iterations;
|
|
47
|
+
byBackend.set(entry.backendId, backendUsage);
|
|
48
|
+
}
|
|
49
|
+
// By phase (if present)
|
|
50
|
+
if (entry.phase) {
|
|
51
|
+
const phaseUsage = byPhase.get(entry.phase) ?? {
|
|
52
|
+
usd: 0,
|
|
53
|
+
tokens: 0,
|
|
54
|
+
wallTimeMs: 0,
|
|
55
|
+
iterations: 0,
|
|
56
|
+
};
|
|
57
|
+
phaseUsage.usd += entry.usd;
|
|
58
|
+
phaseUsage.tokens += entry.tokens;
|
|
59
|
+
phaseUsage.wallTimeMs += entry.wallTimeMs;
|
|
60
|
+
phaseUsage.iterations += entry.iterations;
|
|
61
|
+
byPhase.set(entry.phase, phaseUsage);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
return { total, byTask, byBackend, byPhase, entries: events };
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Format spend breakdown as markdown report.
|
|
68
|
+
*/
|
|
69
|
+
function formatSpendReport(breakdown) {
|
|
70
|
+
const lines = [];
|
|
71
|
+
lines.push(`# Spend Breakdown Report`);
|
|
72
|
+
lines.push(``);
|
|
73
|
+
// Total
|
|
74
|
+
lines.push(`## Summary`);
|
|
75
|
+
lines.push(``);
|
|
76
|
+
lines.push(`| Metric | Value |`);
|
|
77
|
+
lines.push(`|--------|-------|`);
|
|
78
|
+
lines.push(`| Total USD | $${breakdown.total.usd.toFixed(4)} |`);
|
|
79
|
+
lines.push(`| Total Tokens | ${breakdown.total.tokens.toLocaleString()} |`);
|
|
80
|
+
lines.push(`| Wall Time | ${formatDuration(breakdown.total.wallTimeMs)} |`);
|
|
81
|
+
lines.push(`| Iterations | ${breakdown.total.iterations} |`);
|
|
82
|
+
lines.push(``);
|
|
83
|
+
// By Task
|
|
84
|
+
if (breakdown.byTask.size > 0) {
|
|
85
|
+
lines.push(`## By Task`);
|
|
86
|
+
lines.push(``);
|
|
87
|
+
lines.push(`| Task | USD | Tokens | Time | Iterations |`);
|
|
88
|
+
lines.push(`|------|-----|--------|------|------------|`);
|
|
89
|
+
for (const [taskId, usage] of breakdown.byTask.entries()) {
|
|
90
|
+
lines.push(`| ${taskId} | $${usage.usd.toFixed(4)} | ${usage.tokens.toLocaleString()} | ${formatDuration(usage.wallTimeMs)} | ${usage.iterations} |`);
|
|
91
|
+
}
|
|
92
|
+
lines.push(``);
|
|
93
|
+
}
|
|
94
|
+
// By Backend
|
|
95
|
+
if (breakdown.byBackend.size > 0) {
|
|
96
|
+
lines.push(`## By Backend`);
|
|
97
|
+
lines.push(``);
|
|
98
|
+
lines.push(`| Backend | USD | Tokens | Time | Iterations |`);
|
|
99
|
+
lines.push(`|---------|-----|--------|------|------------|`);
|
|
100
|
+
for (const [backendId, usage] of breakdown.byBackend.entries()) {
|
|
101
|
+
lines.push(`| ${backendId} | $${usage.usd.toFixed(4)} | ${usage.tokens.toLocaleString()} | ${formatDuration(usage.wallTimeMs)} | ${usage.iterations} |`);
|
|
102
|
+
}
|
|
103
|
+
lines.push(``);
|
|
104
|
+
}
|
|
105
|
+
// By Phase
|
|
106
|
+
if (breakdown.byPhase.size > 0) {
|
|
107
|
+
lines.push(`## By Phase`);
|
|
108
|
+
lines.push(``);
|
|
109
|
+
lines.push(`| Phase | USD | Tokens | Time | Iterations |`);
|
|
110
|
+
lines.push(`|-------|-----|--------|------|------------|`);
|
|
111
|
+
for (const [phase, usage] of breakdown.byPhase.entries()) {
|
|
112
|
+
lines.push(`| ${phase} | $${usage.usd.toFixed(4)} | ${usage.tokens.toLocaleString()} | ${formatDuration(usage.wallTimeMs)} | ${usage.iterations} |`);
|
|
113
|
+
}
|
|
114
|
+
lines.push(``);
|
|
115
|
+
}
|
|
116
|
+
return lines.join("\n");
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Format duration in human-readable form.
|
|
120
|
+
*/
|
|
121
|
+
function formatDuration(ms) {
|
|
122
|
+
if (ms < 1000)
|
|
123
|
+
return `${ms}ms`;
|
|
124
|
+
if (ms < 60_000)
|
|
125
|
+
return `${(ms / 1000).toFixed(1)}s`;
|
|
126
|
+
if (ms < 3600_000)
|
|
127
|
+
return `${(ms / 60_000).toFixed(1)}m`;
|
|
128
|
+
return `${(ms / 3600_000).toFixed(1)}h`;
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Create spend entries from ledger events.
|
|
132
|
+
*
|
|
133
|
+
* This function parses ledger events and extracts spend information
|
|
134
|
+
* from events with kind="iteration_complete" or similar.
|
|
135
|
+
*/
|
|
136
|
+
function extractSpendFromLedger(ledgerEvents) {
|
|
137
|
+
const entries = [];
|
|
138
|
+
for (const event of ledgerEvents) {
|
|
139
|
+
// Look for events that contain spend data
|
|
140
|
+
if (event.kind === "iteration_complete" || event.kind === "backend_usage") {
|
|
141
|
+
const data = event.data;
|
|
142
|
+
if (data && event.taskId) {
|
|
143
|
+
entries.push({
|
|
144
|
+
taskId: event.taskId,
|
|
145
|
+
backendId: data.backendId,
|
|
146
|
+
phase: data.phase,
|
|
147
|
+
usd: data.usd ?? 0,
|
|
148
|
+
tokens: data.tokens ?? 0,
|
|
149
|
+
wallTimeMs: data.wallTimeMs ?? 0,
|
|
150
|
+
iterations: 1,
|
|
151
|
+
});
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
return entries;
|
|
156
|
+
}
|
|
157
|
+
//# sourceMappingURL=spend.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spend.js","sourceRoot":"","sources":["../../../src/core/reporting/spend.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../../src/core/spec/dag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,SAAS,CAiEzD"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.buildTaskDAG = buildTaskDAG;
|
|
4
|
+
function buildTaskDAG(tasks) {
|
|
5
|
+
const tasksById = new Map();
|
|
6
|
+
for (const t of tasks) {
|
|
7
|
+
if (tasksById.has(t.id)) {
|
|
8
|
+
throw new Error(`Duplicate task id: ${t.id}`);
|
|
9
|
+
}
|
|
10
|
+
tasksById.set(t.id, t);
|
|
11
|
+
}
|
|
12
|
+
const indeg = new Map();
|
|
13
|
+
const adj = new Map();
|
|
14
|
+
for (const id of tasksById.keys()) {
|
|
15
|
+
indeg.set(id, 0);
|
|
16
|
+
adj.set(id, new Set());
|
|
17
|
+
}
|
|
18
|
+
for (const t of tasks) {
|
|
19
|
+
const deps = t.deps ?? [];
|
|
20
|
+
for (const dep of deps) {
|
|
21
|
+
if (!tasksById.has(dep)) {
|
|
22
|
+
throw new Error(`Task ${t.id} depends on missing task ${dep}`);
|
|
23
|
+
}
|
|
24
|
+
adj.get(dep).add(t.id);
|
|
25
|
+
indeg.set(t.id, (indeg.get(t.id) ?? 0) + 1);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
const queue = [];
|
|
29
|
+
for (const [id, d] of indeg.entries()) {
|
|
30
|
+
if (d === 0)
|
|
31
|
+
queue.push(id);
|
|
32
|
+
}
|
|
33
|
+
// Prefer higher priority first (stable-ish by id)
|
|
34
|
+
queue.sort((a, b) => {
|
|
35
|
+
const pa = tasksById.get(a)?.priority ?? 0;
|
|
36
|
+
const pb = tasksById.get(b)?.priority ?? 0;
|
|
37
|
+
if (pa !== pb)
|
|
38
|
+
return pb - pa;
|
|
39
|
+
return a.localeCompare(b);
|
|
40
|
+
});
|
|
41
|
+
const order = [];
|
|
42
|
+
while (queue.length) {
|
|
43
|
+
const id = queue.shift();
|
|
44
|
+
order.push(id);
|
|
45
|
+
for (const next of adj.get(id) ?? []) {
|
|
46
|
+
indeg.set(next, (indeg.get(next) ?? 0) - 1);
|
|
47
|
+
if (indeg.get(next) === 0) {
|
|
48
|
+
queue.push(next);
|
|
49
|
+
queue.sort((a, b) => {
|
|
50
|
+
const pa = tasksById.get(a)?.priority ?? 0;
|
|
51
|
+
const pb = tasksById.get(b)?.priority ?? 0;
|
|
52
|
+
if (pa !== pb)
|
|
53
|
+
return pb - pa;
|
|
54
|
+
return a.localeCompare(b);
|
|
55
|
+
});
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
if (order.length !== tasksById.size) {
|
|
60
|
+
const remaining = [...tasksById.keys()].filter((id) => !order.includes(id));
|
|
61
|
+
throw new Error(`Cycle detected in task dependencies. Remaining: ${remaining.join(", ")}`);
|
|
62
|
+
}
|
|
63
|
+
return { tasksById, order };
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=dag.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dag.js","sourceRoot":"","sources":["../../../src/core/spec/dag.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { FileContract } from "./types";
|
|
2
|
+
export type ContractViolation = {
|
|
3
|
+
file: string;
|
|
4
|
+
reason: "forbidden" | "not_allowed" | "new_file_disallowed";
|
|
5
|
+
};
|
|
6
|
+
export declare function evaluateFileContract(args: {
|
|
7
|
+
changedFiles: Array<{
|
|
8
|
+
file: string;
|
|
9
|
+
isNew: boolean;
|
|
10
|
+
}>;
|
|
11
|
+
contract: FileContract;
|
|
12
|
+
}): ContractViolation[];
|
|
13
|
+
//# sourceMappingURL=file-contract.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-contract.d.ts","sourceRoot":"","sources":["../../../src/core/spec/file-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,qBAAqB,CAAC;CAC7D,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,QAAQ,EAAE,YAAY,CAAC;CACxB,GAAG,iBAAiB,EAAE,CA6BtB"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.evaluateFileContract = evaluateFileContract;
|
|
4
|
+
const minimatch_1 = require("minimatch");
|
|
5
|
+
function evaluateFileContract(args) {
|
|
6
|
+
const { changedFiles, contract } = args;
|
|
7
|
+
const allowed = contract.allowed ?? [];
|
|
8
|
+
const forbidden = contract.forbidden ?? [];
|
|
9
|
+
const allowNewFiles = contract.allowNewFiles ?? true;
|
|
10
|
+
const violations = [];
|
|
11
|
+
for (const { file, isNew } of changedFiles) {
|
|
12
|
+
if (isNew && !allowNewFiles) {
|
|
13
|
+
violations.push({ file, reason: "new_file_disallowed" });
|
|
14
|
+
continue;
|
|
15
|
+
}
|
|
16
|
+
if (forbidden.some((pat) => (0, minimatch_1.minimatch)(file, pat, { dot: true }))) {
|
|
17
|
+
violations.push({ file, reason: "forbidden" });
|
|
18
|
+
continue;
|
|
19
|
+
}
|
|
20
|
+
if (allowed.length) {
|
|
21
|
+
const ok = allowed.some((pat) => (0, minimatch_1.minimatch)(file, pat, { dot: true }));
|
|
22
|
+
if (!ok) {
|
|
23
|
+
violations.push({ file, reason: "not_allowed" });
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
return violations;
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=file-contract.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-contract.js","sourceRoot":"","sources":["../../../src/core/spec/file-contract.ts"],"names":[],"mappings":";;AAQA,oDAgCC;AAxCD,yCAAsC;AAQtC,SAAgB,oBAAoB,CAAC,IAGpC;IACC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAExC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAC;IAErD,MAAM,UAAU,GAAwB,EAAE,CAAC;IAE3C,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,YAAY,EAAE,CAAC;QAC3C,IAAI,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,qBAAS,EAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACjE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,qBAAS,EAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/spec/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;YA6B/B,iBAAiB;CAiBhC"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.SpecLoader = void 0;
|
|
7
|
+
const promises_1 = __importDefault(require("node:fs/promises"));
|
|
8
|
+
const node_path_1 = __importDefault(require("node:path"));
|
|
9
|
+
const yaml_1 = __importDefault(require("yaml"));
|
|
10
|
+
const zod_1 = require("zod");
|
|
11
|
+
const schemas_1 = require("./schemas");
|
|
12
|
+
const sprint_defaults_1 = require("./sprint-defaults");
|
|
13
|
+
class SpecLoader {
|
|
14
|
+
repoRoot;
|
|
15
|
+
constructor(repoRoot) {
|
|
16
|
+
this.repoRoot = repoRoot;
|
|
17
|
+
}
|
|
18
|
+
async loadProjectSpec() {
|
|
19
|
+
const ymlPath = node_path_1.default.join(this.repoRoot, "openspec", "project.yml");
|
|
20
|
+
const jsonPath = node_path_1.default.join(this.repoRoot, "openspec", "project.json");
|
|
21
|
+
const rawText = await this.readFirstExisting([ymlPath, jsonPath]);
|
|
22
|
+
const raw = rawText.kind === "yml" ? yaml_1.default.parse(rawText.text) : JSON.parse(rawText.text);
|
|
23
|
+
try {
|
|
24
|
+
const spec = schemas_1.projectSpecSchema.parse(raw);
|
|
25
|
+
const tasks = (spec.tasks ?? []).map((t) => {
|
|
26
|
+
const size = t.sprint?.size;
|
|
27
|
+
if (!size)
|
|
28
|
+
return t;
|
|
29
|
+
const defaults = spec.sprintDefaults?.[size] ?? sprint_defaults_1.SPRINT_SIZE_DEFAULTS[size];
|
|
30
|
+
if (!defaults)
|
|
31
|
+
return t;
|
|
32
|
+
return { ...t, budget: (0, sprint_defaults_1.mergeBudgetDefaults)(t.budget, defaults) };
|
|
33
|
+
});
|
|
34
|
+
return { ...spec, tasks };
|
|
35
|
+
}
|
|
36
|
+
catch (err) {
|
|
37
|
+
if (err instanceof zod_1.ZodError) {
|
|
38
|
+
const pretty = err.issues
|
|
39
|
+
.map((i) => `- ${i.path.join(".") || "(root)"}: ${i.message}`)
|
|
40
|
+
.join("\n");
|
|
41
|
+
throw new Error(`Invalid OpenSpec project spec:\n${pretty}`);
|
|
42
|
+
}
|
|
43
|
+
throw err;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
async readFirstExisting(candidates) {
|
|
47
|
+
for (const p of candidates) {
|
|
48
|
+
try {
|
|
49
|
+
const text = await promises_1.default.readFile(p, "utf8");
|
|
50
|
+
return { kind: p.endsWith(".json") ? "json" : "yml", path: p, text };
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
// continue
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
throw new Error(`Missing OpenSpec project file. Expected one of:\n${candidates
|
|
57
|
+
.map((p) => `- ${p}`)
|
|
58
|
+
.join("\n")}`);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
exports.SpecLoader = SpecLoader;
|
|
62
|
+
//# sourceMappingURL=loader.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/spec/loader.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAkC;AAClC,0DAA6B;AAC7B,gDAAwB;AACxB,6BAA+B;AAC/B,uCAA8C;AAE9C,uDAA8E;AAE9E,MAAa,UAAU;IACQ;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,KAAK,CAAC,eAAe;QACnB,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAClE,MAAM,GAAG,GACP,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,cAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,2BAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACzC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC;gBAC5B,IAAI,CAAC,IAAI;oBAAE,OAAO,CAAC,CAAC;gBACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,IAAI,sCAAoB,CAAC,IAAI,CAAC,CAAC;gBAC3E,IAAI,CAAC,QAAQ;oBAAE,OAAO,CAAC,CAAC;gBACxB,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAA,qCAAmB,EAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YACnE,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAQ,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM;qBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;qBAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,UAAoB;QAEpB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC1C,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;YACvE,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oDAAoD,UAAU;aAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;CACF;AAjDD,gCAiDC"}
|