okstra 0.231.1 → 0.233.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/README.md +19 -271
- package/dist/cli-registry.mjs +14 -1
- package/dist/cli-registry.mjs.map +1 -1
- package/dist/commands/execute/render-bundle.d.mts +6 -1
- package/dist/commands/execute/render-bundle.mjs +139 -32
- package/dist/commands/execute/render-bundle.mjs.map +1 -1
- package/dist/commands/lifecycle/config.mjs +6 -74
- package/dist/commands/lifecycle/config.mjs.map +1 -1
- package/dist/commands/memory/memory.mjs +9 -55
- package/dist/commands/memory/memory.mjs.map +1 -1
- package/dist/commands/trace/capacity.d.mts +12 -0
- package/dist/commands/trace/capacity.mjs +21 -0
- package/dist/commands/trace/capacity.mjs.map +1 -0
- package/dist/commands/trace/model.d.mts +89 -0
- package/dist/commands/trace/model.mjs +251 -0
- package/dist/commands/trace/model.mjs.map +1 -0
- package/dist/commands/trace/progression.d.mts +11 -0
- package/dist/commands/trace/progression.mjs +194 -0
- package/dist/commands/trace/progression.mjs.map +1 -0
- package/dist/commands/trace/review.d.mts +7 -0
- package/dist/commands/trace/review.mjs +51 -0
- package/dist/commands/trace/review.mjs.map +1 -0
- package/dist/commands/trace/task-link.d.mts +18 -0
- package/dist/commands/trace/task-link.mjs +72 -0
- package/dist/commands/trace/task-link.mjs.map +1 -0
- package/dist/commands/trace/trace.d.mts +1 -0
- package/dist/commands/trace/trace.mjs +293 -0
- package/dist/commands/trace/trace.mjs.map +1 -0
- package/dist/lib/bounded-file.d.mts +1 -0
- package/dist/lib/bounded-file.mjs +36 -0
- package/dist/lib/bounded-file.mjs.map +1 -0
- package/dist/lib/config-store.d.mts +34 -0
- package/dist/lib/config-store.mjs +70 -0
- package/dist/lib/config-store.mjs.map +1 -0
- package/dist/lib/file-lock.mjs +4 -5
- package/dist/lib/file-lock.mjs.map +1 -1
- package/dist/lib/input-limit.d.mts +4 -0
- package/dist/lib/input-limit.mjs +8 -0
- package/dist/lib/input-limit.mjs.map +1 -0
- package/dist/lib/memory-auto-register.d.mts +1 -0
- package/dist/lib/memory-auto-register.mjs +98 -0
- package/dist/lib/memory-auto-register.mjs.map +1 -0
- package/dist/lib/memory-entry-contract.d.mts +12 -0
- package/dist/lib/memory-entry-contract.mjs +46 -0
- package/dist/lib/memory-entry-contract.mjs.map +1 -0
- package/dist/lib/python-helper.d.mts +1 -1
- package/dist/lib/python-helper.mjs +3 -2
- package/dist/lib/python-helper.mjs.map +1 -1
- package/dist/lib/record-secrets.d.mts +1 -0
- package/dist/lib/record-secrets.mjs +28 -0
- package/dist/lib/record-secrets.mjs.map +1 -0
- package/dist/lib/report-language-tag.d.mts +1 -0
- package/dist/lib/report-language-tag.mjs +4 -0
- package/dist/lib/report-language-tag.mjs.map +1 -0
- package/dist/lib/report-language.d.mts +1 -0
- package/dist/lib/report-language.mjs +50 -0
- package/dist/lib/report-language.mjs.map +1 -0
- package/dist/lib/skill-catalog.mjs +3 -0
- package/dist/lib/skill-catalog.mjs.map +1 -1
- package/dist/lib/types.d.mts +2 -1
- package/docs/architecture/storage-model.md +163 -5
- package/docs/architecture.md +17 -4
- package/docs/cli.md +511 -0
- package/docs/contributor-change-matrix.md +1 -2
- package/docs/project-structure-overview.md +33 -42
- package/package.json +1 -1
- package/runtime/BUILD.json +2 -2
- package/runtime/agents/common.json +8 -8
- package/runtime/agents/operations/trace-interface-review.json +6 -0
- package/runtime/agents/operations/trace-scope-review.json +6 -0
- package/runtime/agents/roles/verifier.json +2 -4
- package/runtime/bin/okstra-provider-exec.py +10 -4
- package/runtime/prompts/coding-preflight/architectures/hexagonal.md +23 -30
- package/runtime/prompts/coding-preflight/authoring-checks.md +17 -0
- package/runtime/prompts/coding-preflight/clean-code.md +88 -286
- package/runtime/prompts/coding-preflight/frameworks/node-server.md +2 -3
- package/runtime/prompts/coding-preflight/languages/java.md +3 -5
- package/runtime/prompts/coding-preflight/languages/javascript-typescript.md +5 -12
- package/runtime/prompts/coding-preflight/languages/kotlin.md +2 -4
- package/runtime/prompts/coding-preflight/languages/python.md +2 -7
- package/runtime/prompts/coding-preflight/languages/rust.md +2 -8
- package/runtime/prompts/coding-preflight/languages/sql.md +2 -4
- package/runtime/prompts/coding-preflight/overview.md +25 -38
- package/runtime/prompts/coding-preflight/review-rules.json +30 -0
- package/runtime/prompts/duties/code-reviewer.json +15 -18
- package/runtime/prompts/duties/implementation-verifier.json +1 -0
- package/runtime/prompts/duties/interface-reviewer.json +32 -0
- package/runtime/prompts/host-orchestration/README.md +18 -9
- package/runtime/prompts/launch.template.md +3 -2
- package/runtime/prompts/lead/context-loader.md +2 -0
- package/runtime/prompts/lead/okstra-lead-contract.md +7 -7
- package/runtime/prompts/lead/report-writer.md +6 -6
- package/runtime/prompts/profiles/_coding-conventions-preflight.md +41 -6
- package/runtime/prompts/profiles/_common-contract.md +1 -1
- package/runtime/python/okstra_ctl/agent/invocation.py +122 -36
- package/runtime/python/okstra_ctl/agent/prompt_cli/cli.py +72 -26
- package/runtime/python/okstra_ctl/agent/prompt_cli/corrections.py +23 -8
- package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +58 -14
- package/runtime/python/okstra_ctl/agent/prompt_cli/results.py +8 -11
- package/runtime/python/okstra_ctl/agent/standalone.py +15 -0
- package/runtime/python/okstra_ctl/analysis_packet.py +24 -30
- package/runtime/python/okstra_ctl/attempt_evidence.py +10 -0
- package/runtime/python/okstra_ctl/code_review_census.py +162 -7
- package/runtime/python/okstra_ctl/code_review_coverage.py +4 -274
- package/runtime/python/okstra_ctl/code_review_integrity.py +154 -0
- package/runtime/python/okstra_ctl/code_review_invocation.py +212 -0
- package/runtime/python/okstra_ctl/code_review_prepare.py +381 -0
- package/runtime/python/okstra_ctl/code_review_run.py +384 -0
- package/runtime/python/okstra_ctl/code_review_scope.py +49 -9
- package/runtime/python/okstra_ctl/code_review_supervisor.py +41 -0
- package/runtime/python/okstra_ctl/code_review_target.py +212 -13
- package/runtime/python/okstra_ctl/consumers.py +12 -9
- package/runtime/python/okstra_ctl/coverage_census.py +11 -2
- package/runtime/python/okstra_ctl/design_review.py +207 -0
- package/runtime/python/okstra_ctl/design_review_evidence.py +297 -0
- package/runtime/python/okstra_ctl/design_snapshot.py +16 -9
- package/runtime/python/okstra_ctl/direct_work.py +45 -3
- package/runtime/python/okstra_ctl/dispatch_core.py +31 -15
- package/runtime/python/okstra_ctl/dispatch_state.py +9 -2
- package/runtime/python/okstra_ctl/doctor.py +8 -25
- package/runtime/python/okstra_ctl/domain/role.py +1 -0
- package/runtime/python/okstra_ctl/doyouknow/__init__.py +9 -0
- package/runtime/python/okstra_ctl/doyouknow/cli.py +91 -0
- package/runtime/python/okstra_ctl/doyouknow/config.py +58 -0
- package/runtime/python/okstra_ctl/doyouknow/contracts.py +184 -0
- package/runtime/python/okstra_ctl/doyouknow/identity.py +22 -0
- package/runtime/python/okstra_ctl/doyouknow/paths.py +22 -0
- package/runtime/python/okstra_ctl/doyouknow/pending.py +72 -0
- package/runtime/python/okstra_ctl/doyouknow/registration.py +260 -0
- package/runtime/python/okstra_ctl/doyouknow/source_contracts.py +128 -0
- package/runtime/python/okstra_ctl/doyouknow/source_store.py +172 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/io.py +36 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/manager.py +300 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/memory.py +179 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/task.py +95 -0
- package/runtime/python/okstra_ctl/doyouknow/store.py +260 -0
- package/runtime/python/okstra_ctl/doyouknow/sync.py +58 -0
- package/runtime/python/okstra_ctl/execution_mutation_audit.py +18 -2
- package/runtime/python/okstra_ctl/file_size_cap.py +3 -4
- package/runtime/python/okstra_ctl/final_report_schema.py +37 -34
- package/runtime/python/okstra_ctl/incremental_carry.py +6 -7
- package/runtime/python/okstra_ctl/initial_prompt_materialization.py +9 -2
- package/runtime/python/okstra_ctl/json_boundary.py +51 -5
- package/runtime/python/okstra_ctl/jsonl.py +21 -0
- package/runtime/python/okstra_ctl/manager_cli.py +148 -1
- package/runtime/python/okstra_ctl/manager_journal.py +126 -0
- package/runtime/python/okstra_ctl/manager_launch.py +3 -3
- package/runtime/python/okstra_ctl/manager_log.py +221 -0
- package/runtime/python/okstra_ctl/manager_paths.py +8 -0
- package/runtime/python/okstra_ctl/manager_registration.py +29 -0
- package/runtime/python/okstra_ctl/manager_resume.py +59 -0
- package/runtime/python/okstra_ctl/manager_split.py +2 -2
- package/runtime/python/okstra_ctl/manager_store.py +116 -17
- package/runtime/python/okstra_ctl/manager_sync.py +45 -25
- package/runtime/python/okstra_ctl/manager_view.py +35 -2
- package/runtime/python/okstra_ctl/material.py +2 -0
- package/runtime/python/okstra_ctl/model_cli.py +64 -14
- package/runtime/python/okstra_ctl/model_defaults.py +22 -0
- package/runtime/python/okstra_ctl/model_io/renderers.py +16 -2
- package/runtime/python/okstra_ctl/model_io_cli.py +7 -1
- package/runtime/python/okstra_ctl/operation_invocation.py +207 -28
- package/runtime/python/okstra_ctl/path_hints.py +14 -3
- package/runtime/python/okstra_ctl/paths.py +6 -1
- package/runtime/python/okstra_ctl/phases/catalog.py +24 -7
- package/runtime/python/okstra_ctl/phases/final_verification/validation.py +20 -0
- package/runtime/python/okstra_ctl/phases/implementation/host-rules.md +3 -3
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-deliverable.md +10 -0
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-diff-review.md +23 -8
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-self-check.md +6 -4
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-verifier.md +38 -10
- package/runtime/python/okstra_ctl/phases/implementation/report_assets/implementation.template.html +13 -0
- package/runtime/python/okstra_ctl/phases/implementation/spec.md +25 -0
- package/runtime/python/okstra_ctl/phases/implementation/validation.py +6 -0
- package/runtime/python/okstra_ctl/phases/implementation_option_selection/profile.md +1 -1
- package/runtime/python/okstra_ctl/phases/implementation_option_selection/votes.py +11 -11
- package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +16 -9
- package/runtime/python/okstra_ctl/phases/implementation_planning/host-rules.md +3 -6
- package/runtime/python/okstra_ctl/phases/implementation_planning/instructions/plan-body-verification.md +12 -10
- package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +6 -6
- package/runtime/python/okstra_ctl/phases/improvement_discovery/lenses.py +12 -0
- package/runtime/python/okstra_ctl/phases/improvement_discovery/profile.md +7 -6
- package/runtime/python/okstra_ctl/phases/improvement_discovery/resolved_census.py +159 -0
- package/runtime/python/okstra_ctl/phases/improvement_discovery/spec.md +5 -2
- package/runtime/python/okstra_ctl/phases/improvement_discovery/validation.py +21 -7
- package/runtime/python/okstra_ctl/phases/release_handoff/boundary.json +1 -1
- package/runtime/python/okstra_ctl/phases/release_handoff/profile.md +4 -1
- package/runtime/python/okstra_ctl/plan_verify_cli.py +6 -4
- package/runtime/python/okstra_ctl/render.py +28 -2
- package/runtime/python/okstra_ctl/report_assembly.py +53 -11
- package/runtime/python/okstra_ctl/report_contract.py +26 -0
- package/runtime/python/okstra_ctl/report_corrections.py +36 -20
- package/runtime/python/okstra_ctl/report_inputs.py +1 -0
- package/runtime/python/okstra_ctl/report_language.py +4 -1
- package/runtime/python/okstra_ctl/report_narrative.py +182 -7
- package/runtime/python/okstra_ctl/report_projections.py +64 -18
- package/runtime/python/okstra_ctl/report_synthesis_packet.py +97 -38
- package/runtime/python/okstra_ctl/review_policy.py +359 -0
- package/runtime/python/okstra_ctl/review_verdicts.py +291 -0
- package/runtime/python/okstra_ctl/run.py +67 -36
- package/runtime/python/okstra_ctl/run_context.py +10 -1
- package/runtime/python/okstra_ctl/set_work_status.py +4 -15
- package/runtime/python/okstra_ctl/stage_done.py +11 -0
- package/runtime/python/okstra_ctl/standalone_review_audit.py +28 -0
- package/runtime/python/okstra_ctl/task_list_cli.py +34 -8
- package/runtime/python/okstra_ctl/task_query.py +239 -0
- package/runtime/python/okstra_ctl/trace_review.py +264 -0
- package/runtime/python/okstra_ctl/trace_tasks.py +197 -0
- package/runtime/python/okstra_ctl/user_authorization.py +14 -0
- package/runtime/python/okstra_ctl/verification_generation.py +23 -1
- package/runtime/python/okstra_ctl/verification_input_types.py +15 -1
- package/runtime/python/okstra_ctl/verification_inputs.py +28 -6
- package/runtime/python/okstra_ctl/verification_invocation.py +7 -1
- package/runtime/python/okstra_ctl/verification_target.py +2 -0
- package/runtime/python/okstra_ctl/wizard/confirmation.py +7 -3
- package/runtime/python/okstra_ctl/wizard/launch.py +52 -0
- package/runtime/python/okstra_ctl/wizard/launch_cli.py +39 -0
- package/runtime/python/okstra_ctl/wizard/outcome.py +17 -16
- package/runtime/python/okstra_ctl/wizard/registry.py +1 -1
- package/runtime/python/okstra_ctl/wizard/render.py +8 -0
- package/runtime/python/okstra_ctl/wizard/state.py +2 -1
- package/runtime/python/okstra_ctl/worker_prompt_headers.py +24 -9
- package/runtime/python/okstra_ctl/worker_runner.py +66 -10
- package/runtime/python/okstra_ctl/write_policy.py +34 -1
- package/runtime/python/okstra_project/__init__.py +2 -0
- package/runtime/python/okstra_project/dirs.py +18 -0
- package/runtime/python/okstra_project/state.py +45 -20
- package/runtime/python/okstra_token_usage/blocks.py +74 -0
- package/runtime/python/okstra_token_usage/cli.py +23 -10
- package/runtime/python/okstra_token_usage/collect.py +25 -22
- package/runtime/python/okstra_token_usage/policy.py +193 -0
- package/runtime/schemas/doyouknow-config-v1.schema.json +20 -0
- package/runtime/schemas/doyouknow-v1.schema.json +65 -0
- package/runtime/schemas/final-report-v2.0.schema.json +157 -0
- package/runtime/schemas/final-report-v3.0.schema.json +157 -0
- package/runtime/schemas/memory-entry-contract-v1.json +11 -0
- package/runtime/schemas/record-secret-patterns.json +41 -0
- package/runtime/schemas/report-synthesis-packet-v1.0.schema.json +1 -1
- package/runtime/skills/_fragments/wizard-confirm-step.md +1 -1
- package/runtime/skills/_fragments/wizard-preflight.md +1 -1
- package/runtime/skills/_fragments/wizard-prompt-loop.md +3 -5
- package/runtime/skills/_fragments/wizard-relay-protocol.md +1 -1
- package/runtime/skills/_fragments/wizard-render-bundle.md +15 -29
- package/runtime/skills/okstra-brief-gen/SKILL.md +7 -7
- package/runtime/skills/okstra-brief-gen/references/tracker-recursion.md +1 -1
- package/runtime/skills/okstra-code-review/SKILL.md +92 -136
- package/runtime/skills/okstra-code-review/references/census-rules.md +29 -105
- package/runtime/skills/okstra-code-review/references/review-calibration.md +37 -61
- package/runtime/skills/okstra-discussion/SKILL.md +22 -38
- package/runtime/skills/okstra-explain-flow/SKILL.md +6 -2
- package/runtime/skills/okstra-manager/SKILL.md +31 -0
- package/runtime/skills/okstra-memory/SKILL.md +8 -1
- package/runtime/skills/okstra-pr-gen/SKILL.md +1 -1
- package/runtime/skills/okstra-run/SKILL.md +55 -183
- package/runtime/skills/okstra-schedule-gen/SKILL.md +9 -13
- package/runtime/skills/okstra-setup/SKILL.md +3 -2
- package/runtime/skills/okstra-setup/references/project-config.md +2 -4
- package/runtime/skills/okstra-tdd/SKILL.md +187 -0
- package/runtime/skills/okstra-user-response/SKILL.md +4 -2
- package/runtime/templates/implementation-worker-preamble.md +4 -9
- package/runtime/templates/manager/view.template.html +4 -0
- package/runtime/templates/report-writer-prompt-preamble.md +15 -3
- package/runtime/templates/trace/trace.template.md +42 -0
- package/runtime/templates/worker-prompt-preamble.md +4 -12
- package/runtime/validators/checks/fixtures-02.py +25 -33
- package/runtime/validators/validate-run.py +107 -38
|
@@ -0,0 +1,293 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { promises as fs } from "node:fs";
|
|
3
|
+
import { basename, dirname, join, resolve } from "node:path";
|
|
4
|
+
import { withFileLock } from "../../lib/file-lock.mjs";
|
|
5
|
+
import { OKSTRA_DIR, projectJsonPath } from "../../lib/okstra-dirs.mjs";
|
|
6
|
+
import { resolveReportLanguage } from "../../lib/report-language.mjs";
|
|
7
|
+
import { getPackageRoot } from "../../lib/version.mjs";
|
|
8
|
+
import { readBoundedUtf8 } from "../../lib/bounded-file.mjs";
|
|
9
|
+
import { InputLimitError, assertInputLimit } from "../../lib/input-limit.mjs";
|
|
10
|
+
import { TRACE_INPUT_LIMITS } from "./capacity.mjs";
|
|
11
|
+
import { TraceError, isTraceStep, newTraceState, parseTrace, parseTraceEvidence, traceSectionBounds } from "./model.mjs";
|
|
12
|
+
import { advanceTraceState, traceStatus } from "./progression.mjs";
|
|
13
|
+
import { planTraceReviewers, verifyTraceReviews } from "./review.mjs";
|
|
14
|
+
import { TaskSyncError, projectTraceTask, readTaskMetadata, requireTaskSummary } from "./task-link.mjs";
|
|
15
|
+
function parseOptions(argv) {
|
|
16
|
+
const command = argv[0] ?? "";
|
|
17
|
+
const allowed = {
|
|
18
|
+
new: ["--slug", "--project-root", "--task-key", "--metadata"],
|
|
19
|
+
status: ["--slug", "--path", "--project-root"],
|
|
20
|
+
advance: ["--path", "--step", "--verdict", "--approve", "--review", "--host-runtime", "--evidence", "--project-root", "--metadata"],
|
|
21
|
+
reviewers: ["--path", "--host-runtime", "--count"],
|
|
22
|
+
sync: ["--path", "--task-key", "--metadata"],
|
|
23
|
+
};
|
|
24
|
+
const flags = allowed[command];
|
|
25
|
+
if (!flags)
|
|
26
|
+
throw new TraceError("INVALID_ARGUMENT", "Use okstra trace new|status|advance|reviewers|sync");
|
|
27
|
+
const values = new Map();
|
|
28
|
+
const reviewCompletions = [];
|
|
29
|
+
for (let index = 1; index < argv.length; index += 2) {
|
|
30
|
+
const flag = argv[index] ?? "";
|
|
31
|
+
const value = argv[index + 1];
|
|
32
|
+
const isReviewCompletion = flag === "--review";
|
|
33
|
+
if (!flags.includes(flag) || (!isReviewCompletion && values.has(flag)) || value === undefined || value.startsWith("--")) {
|
|
34
|
+
throw new TraceError("INVALID_ARGUMENT", `Invalid or missing option: ${flag}`);
|
|
35
|
+
}
|
|
36
|
+
if (isReviewCompletion)
|
|
37
|
+
reviewCompletions.push(value);
|
|
38
|
+
else
|
|
39
|
+
values.set(flag, value);
|
|
40
|
+
}
|
|
41
|
+
assertInputLimit(reviewCompletions.length, TRACE_INPUT_LIMITS.reviewCompletions, "Review completions");
|
|
42
|
+
return { command, values, reviewCompletions };
|
|
43
|
+
}
|
|
44
|
+
function requireOption(values, key) {
|
|
45
|
+
const value = values.get(key);
|
|
46
|
+
if (!value)
|
|
47
|
+
throw new TraceError("INVALID_ARGUMENT", `${key} is required`);
|
|
48
|
+
return value;
|
|
49
|
+
}
|
|
50
|
+
function requireSlug(slug) {
|
|
51
|
+
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(slug)) {
|
|
52
|
+
throw new TraceError("INVALID_SLUG", "Slug must contain lowercase words or digits separated by single hyphens");
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
async function rejectTraceSymlinks(path) {
|
|
56
|
+
let current = path;
|
|
57
|
+
while (true) {
|
|
58
|
+
if ((await fs.lstat(current)).isSymbolicLink()) {
|
|
59
|
+
throw new TraceError("TRACE_MALFORMED", "Trace paths cannot traverse symbolic links below the project root");
|
|
60
|
+
}
|
|
61
|
+
if (basename(current) === OKSTRA_DIR || dirname(current) === current)
|
|
62
|
+
return;
|
|
63
|
+
current = dirname(current);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
async function readTrace(path) {
|
|
67
|
+
let text;
|
|
68
|
+
try {
|
|
69
|
+
await rejectTraceSymlinks(path);
|
|
70
|
+
text = await readBoundedUtf8(path, TRACE_INPUT_LIMITS.bytes);
|
|
71
|
+
}
|
|
72
|
+
catch (cause) {
|
|
73
|
+
if (cause instanceof Error && "code" in cause && cause.code === "ENOENT") {
|
|
74
|
+
throw new TraceError("TRACE_NOT_FOUND", `Trace not found: ${path}`, { cause });
|
|
75
|
+
}
|
|
76
|
+
throw cause;
|
|
77
|
+
}
|
|
78
|
+
const parsed = parseTrace(text);
|
|
79
|
+
if (basename(dirname(path)) !== parsed.state.slug || basename(dirname(dirname(path))) !== "traces"
|
|
80
|
+
|| basename(dirname(dirname(dirname(path)))) !== OKSTRA_DIR) {
|
|
81
|
+
throw new TraceError("TRACE_MALFORMED", "Trace path must be .okstra/traces/<slug>/<timestamp>-<slug>.md");
|
|
82
|
+
}
|
|
83
|
+
return { ...parsed, text };
|
|
84
|
+
}
|
|
85
|
+
function serializeTrace(state, body) {
|
|
86
|
+
return `---\n${JSON.stringify(state, null, 2)}\n---\n${body}`;
|
|
87
|
+
}
|
|
88
|
+
async function writeTrace(path, text, create) {
|
|
89
|
+
parseTrace(text);
|
|
90
|
+
const temporary = `${path}.${randomUUID()}.tmp`;
|
|
91
|
+
let failure;
|
|
92
|
+
try {
|
|
93
|
+
await fs.writeFile(temporary, text, { flag: "wx", encoding: "utf8" });
|
|
94
|
+
if (create)
|
|
95
|
+
await fs.link(temporary, path);
|
|
96
|
+
else
|
|
97
|
+
await fs.rename(temporary, path);
|
|
98
|
+
}
|
|
99
|
+
catch (cause) {
|
|
100
|
+
failure = cause;
|
|
101
|
+
if (create && cause instanceof Error && "code" in cause && cause.code === "EEXIST") {
|
|
102
|
+
throw new TraceError("TRACE_EXISTS", `Trace already exists: ${path}`, { cause });
|
|
103
|
+
}
|
|
104
|
+
throw cause;
|
|
105
|
+
}
|
|
106
|
+
finally {
|
|
107
|
+
try {
|
|
108
|
+
await fs.rm(temporary, { force: true });
|
|
109
|
+
}
|
|
110
|
+
catch (cleanupFailure) {
|
|
111
|
+
throw failure ? new AggregateError([failure, cleanupFailure], "Trace write and cleanup failed") : cleanupFailure;
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
async function traceTemplate(slug, language) {
|
|
116
|
+
const source = await fs.readFile(join(getPackageRoot(), "runtime", "templates", "trace", "trace.template.md"), "utf8");
|
|
117
|
+
const labels = language === "ko" ? {
|
|
118
|
+
guidance: "\uc694\uccad \uc6d0\ubb38\uacfc \uac01 \ub2e8\uacc4 \uc0b0\ucd9c\ubb3c\uc744 \uc774 \ubb38\uc11c\uc5d0 \uc791\uc131\ud558\uc138\uc694. \ub2e8\uacc4 \ud45c\uc9c0\uc640 \uace0\uc815 \uc5f4 \uc774\ub984\uc744 \uc720\uc9c0\ud558\uace0 \uc55e\uba38\ub9ac\uc640 \uadfc\uac70 \ube14\ub85d\uc740 CLI\ub85c\ub9cc \uac31\uc2e0\ud558\uc138\uc694.",
|
|
119
|
+
description: "\uc124\uba85", source: "\ucd9c\ucc98 \ubb38\uc7a5", content: "\ub0b4\uc6a9",
|
|
120
|
+
} : language === "en" ? {
|
|
121
|
+
guidance: "Record the original request and each step's deliverables here. Preserve step markers and fixed column names; update frontmatter and evidence blocks only through the CLI.",
|
|
122
|
+
description: "Description", source: "Source sentence", content: "Content",
|
|
123
|
+
} : { guidance: "", description: "", source: "", content: "" };
|
|
124
|
+
return source.replace(/\{\{(slug|guidance|description|source|content)\}\}/g, (_, key) => key === "slug" ? slug : labels[key] ?? "");
|
|
125
|
+
}
|
|
126
|
+
async function createTrace(values) {
|
|
127
|
+
const projectRoot = resolve(values.get("--project-root") || process.cwd());
|
|
128
|
+
const slug = requireOption(values, "--slug");
|
|
129
|
+
requireSlug(slug);
|
|
130
|
+
try {
|
|
131
|
+
const stat = await fs.stat(projectJsonPath(projectRoot));
|
|
132
|
+
if (!stat.isFile())
|
|
133
|
+
throw new TraceError("PROJECT_NOT_INITIALIZED", "Run /okstra-setup before creating a trace");
|
|
134
|
+
}
|
|
135
|
+
catch (cause) {
|
|
136
|
+
if (cause instanceof Error && "code" in cause && cause.code === "ENOENT") {
|
|
137
|
+
throw new TraceError("PROJECT_NOT_INITIALIZED", "Run /okstra-setup before creating a trace", { cause });
|
|
138
|
+
}
|
|
139
|
+
throw cause;
|
|
140
|
+
}
|
|
141
|
+
const state = await readTaskMetadata(newTraceState(slug, await resolveReportLanguage(projectRoot)), values.get("--task-key"), values.get("--metadata"));
|
|
142
|
+
const body = await traceTemplate(slug, state.language);
|
|
143
|
+
await rejectTraceSymlinks(join(projectRoot, OKSTRA_DIR));
|
|
144
|
+
const root = join(projectRoot, OKSTRA_DIR, "traces");
|
|
145
|
+
await fs.mkdir(root, { recursive: true });
|
|
146
|
+
await rejectTraceSymlinks(root);
|
|
147
|
+
const directory = join(root, slug);
|
|
148
|
+
await fs.mkdir(directory, { recursive: true });
|
|
149
|
+
await rejectTraceSymlinks(directory);
|
|
150
|
+
const timestamp = state.createdAt.slice(0, 19).replace(/[-:]/g, "").replace("T", "-");
|
|
151
|
+
const path = join(directory, `${timestamp}-${slug}.md`);
|
|
152
|
+
const text = serializeTrace(state, body);
|
|
153
|
+
await writeTrace(path, text, true);
|
|
154
|
+
return { path, slug, currentStep: state.currentStep, ...await projectTraceTask(path, text, state, "sync") };
|
|
155
|
+
}
|
|
156
|
+
async function resolveTracePath(values) {
|
|
157
|
+
const path = values.get("--path");
|
|
158
|
+
const slug = values.get("--slug");
|
|
159
|
+
if (path && slug)
|
|
160
|
+
throw new TraceError("INVALID_ARGUMENT", "Choose --path or --slug, not both");
|
|
161
|
+
if (path)
|
|
162
|
+
return resolve(path);
|
|
163
|
+
if (!slug)
|
|
164
|
+
throw new TraceError("INVALID_ARGUMENT", "--path or --slug is required");
|
|
165
|
+
requireSlug(slug);
|
|
166
|
+
const directory = join(resolve(values.get("--project-root") || process.cwd()), OKSTRA_DIR, "traces", slug);
|
|
167
|
+
let latest;
|
|
168
|
+
try {
|
|
169
|
+
let count = 0;
|
|
170
|
+
for await (const entry of await fs.opendir(directory)) {
|
|
171
|
+
assertInputLimit(++count, TRACE_INPUT_LIMITS.directoryEntries, "Trace directory entries");
|
|
172
|
+
const name = entry.name;
|
|
173
|
+
if (/^\d{8}-\d{6}$/.test(name.slice(0, 15)) && name.slice(15) === `-${slug}.md` && (!latest || name > latest))
|
|
174
|
+
latest = name;
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
catch (cause) {
|
|
178
|
+
if (cause instanceof Error && "code" in cause && cause.code === "ENOENT") {
|
|
179
|
+
throw new TraceError("TRACE_NOT_FOUND", `No trace exists for ${slug}`, { cause });
|
|
180
|
+
}
|
|
181
|
+
throw cause;
|
|
182
|
+
}
|
|
183
|
+
if (!latest)
|
|
184
|
+
throw new TraceError("TRACE_NOT_FOUND", `No trace exists for ${slug}`);
|
|
185
|
+
return join(directory, latest);
|
|
186
|
+
}
|
|
187
|
+
function appendEvidence(body, step, state) {
|
|
188
|
+
const evidence = state.steps[step].evidence;
|
|
189
|
+
if (!evidence?.length)
|
|
190
|
+
return body;
|
|
191
|
+
const marker = `<!-- okstra-trace:evidence:${step} -->`;
|
|
192
|
+
const block = `${marker}\n\n\`\`\`json\n${JSON.stringify(evidence, null, 2)}\n\`\`\`\n\n<!-- /okstra-trace:evidence:${step} -->\n`;
|
|
193
|
+
const lines = body.split(/\r?\n/);
|
|
194
|
+
const { start, end } = traceSectionBounds(body, step);
|
|
195
|
+
if (start < 0)
|
|
196
|
+
throw new TraceError("SECTION_EMPTY", `Missing ## ${step}`);
|
|
197
|
+
const existing = lines.slice(start + 1, end).join("\n");
|
|
198
|
+
if (existing.includes(marker))
|
|
199
|
+
throw new TraceError("TRACE_MALFORMED", "Evidence block already exists for unfinished step");
|
|
200
|
+
lines.splice(end, 0, block);
|
|
201
|
+
return lines.join("\n");
|
|
202
|
+
}
|
|
203
|
+
async function readTraceEvidence(path) {
|
|
204
|
+
let value;
|
|
205
|
+
try {
|
|
206
|
+
value = JSON.parse(await readBoundedUtf8(path, TRACE_INPUT_LIMITS.evidenceBytes));
|
|
207
|
+
}
|
|
208
|
+
catch (cause) {
|
|
209
|
+
if (cause instanceof InputLimitError)
|
|
210
|
+
throw cause;
|
|
211
|
+
throw new TraceError("EVIDENCE_REJECTED", "Evidence file must contain readable JSON", { cause });
|
|
212
|
+
}
|
|
213
|
+
return parseTraceEvidence(value);
|
|
214
|
+
}
|
|
215
|
+
async function advanceOptions(values, path, state, body, reviewCompletions) {
|
|
216
|
+
const review = reviewCompletions.length
|
|
217
|
+
? await verifyTraceReviews(path, state, body, requireOption(values, "--host-runtime"), reviewCompletions.map((completion) => resolve(completion)))
|
|
218
|
+
: undefined;
|
|
219
|
+
return {
|
|
220
|
+
...(values.has("--verdict") ? { verdict: values.get("--verdict") ?? "" } : {}),
|
|
221
|
+
...(values.has("--approve") ? { approve: values.get("--approve") ?? "" } : {}),
|
|
222
|
+
...(review ? { review } : {}),
|
|
223
|
+
...(values.has("--evidence") ? { evidence: await readTraceEvidence(requireOption(values, "--evidence")) } : {}),
|
|
224
|
+
};
|
|
225
|
+
}
|
|
226
|
+
async function advanceTrace(values, reviewCompletions) {
|
|
227
|
+
const path = resolve(requireOption(values, "--path"));
|
|
228
|
+
const step = requireOption(values, "--step");
|
|
229
|
+
if (!isTraceStep(step))
|
|
230
|
+
throw new TraceError("STEP_MISMATCH", `Unknown step: ${step}`);
|
|
231
|
+
await readTrace(path);
|
|
232
|
+
return withFileLock(`${path}.lock`, "Trace is busy", async () => {
|
|
233
|
+
const current = await readTrace(path);
|
|
234
|
+
const state = await readTaskMetadata(current.state, undefined, values.get("--metadata"));
|
|
235
|
+
const { body } = current;
|
|
236
|
+
if (step !== state.currentStep)
|
|
237
|
+
throw new TraceError("STEP_MISMATCH", `Expected ${state.currentStep}, got ${step}`);
|
|
238
|
+
const updated = advanceTraceState(state, body, await advanceOptions(values, path, state, body, reviewCompletions));
|
|
239
|
+
requireTaskSummary(updated);
|
|
240
|
+
const updatedBody = appendEvidence(body, step, updated);
|
|
241
|
+
const text = serializeTrace(updated, updatedBody);
|
|
242
|
+
await writeTrace(path, text, false);
|
|
243
|
+
return { ...traceStatus(path, updated), ...await projectTraceTask(path, text, updated, "sync") };
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
async function traceReviewers(values) {
|
|
247
|
+
const path = resolve(requireOption(values, "--path"));
|
|
248
|
+
const { state, body } = await readTrace(path);
|
|
249
|
+
return planTraceReviewers(path, state, body, requireOption(values, "--host-runtime"), values.get("--count"));
|
|
250
|
+
}
|
|
251
|
+
async function syncTrace(values) {
|
|
252
|
+
const path = resolve(requireOption(values, "--path"));
|
|
253
|
+
await readTrace(path);
|
|
254
|
+
return withFileLock(`${path}.lock`, "Trace is busy", async () => {
|
|
255
|
+
const current = await readTrace(path);
|
|
256
|
+
const state = await readTaskMetadata(current.state, values.get("--task-key"), values.get("--metadata"));
|
|
257
|
+
if (!state.task)
|
|
258
|
+
throw new TraceError("INVALID_ARGUMENT", "--task-key is required to link this attempt");
|
|
259
|
+
requireTaskSummary(state);
|
|
260
|
+
const text = state === current.state ? current.text : serializeTrace(state, current.body);
|
|
261
|
+
if (state !== current.state)
|
|
262
|
+
await writeTrace(path, text, false);
|
|
263
|
+
return { ...traceStatus(path, state), ...await projectTraceTask(path, text, state, "sync") };
|
|
264
|
+
});
|
|
265
|
+
}
|
|
266
|
+
export async function run(argv) {
|
|
267
|
+
try {
|
|
268
|
+
const { command, values, reviewCompletions } = parseOptions(argv);
|
|
269
|
+
let result;
|
|
270
|
+
if (command === "new")
|
|
271
|
+
result = await createTrace(values);
|
|
272
|
+
else if (command === "advance")
|
|
273
|
+
result = await advanceTrace(values, reviewCompletions);
|
|
274
|
+
else if (command === "reviewers")
|
|
275
|
+
result = await traceReviewers(values);
|
|
276
|
+
else if (command === "sync")
|
|
277
|
+
result = await syncTrace(values);
|
|
278
|
+
else {
|
|
279
|
+
const path = await resolveTracePath(values);
|
|
280
|
+
const { state, text } = await readTrace(path);
|
|
281
|
+
result = { ...traceStatus(path, state), ...await projectTraceTask(path, text, state, "status") };
|
|
282
|
+
}
|
|
283
|
+
process.stdout.write(`${JSON.stringify(result)}\n`);
|
|
284
|
+
return 0;
|
|
285
|
+
}
|
|
286
|
+
catch (cause) {
|
|
287
|
+
const code = cause instanceof TraceError || cause instanceof InputLimitError ? cause.code : "TRACE_ERROR";
|
|
288
|
+
const message = cause instanceof Error ? cause.message : String(cause);
|
|
289
|
+
process.stdout.write(`${JSON.stringify({ error: { code, message, ...(cause instanceof TaskSyncError ? cause.details : {}) } })}\n`);
|
|
290
|
+
return 1;
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
//# sourceMappingURL=trace.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trace.mjs","sourceRoot":"","sources":["../../../src/commands/trace/trace.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAuD,MAAM,aAAa,CAAC;AAC9K,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAA4B,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAOxG,SAAS,YAAY,CAAC,IAAuB;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAsC;QACjD,GAAG,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,CAAC;QAC7D,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC;QAC9C,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,CAAC;QACnI,SAAS,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,CAAC;QAClD,IAAI,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC;KAC7C,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,oDAAoD,CAAC,CAAC;IAC3G,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,MAAM,kBAAkB,GAAG,IAAI,KAAK,UAAU,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,kBAAkB,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxH,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,8BAA8B,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,kBAAkB;YAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YACjD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,gBAAgB,CAAC,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IACvG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;AAChD,CAAC;AACD,SAAS,aAAa,CAAC,MAAmC,EAAE,GAAW;IACrE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AACD,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,yEAAyE,CAAC,CAAC;IAClH,CAAC;AACH,CAAC;AACD,KAAK,UAAU,mBAAmB,CAAC,IAAY;IAC7C,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,mEAAmE,CAAC,CAAC;QAC/G,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO;YAAE,OAAO;QAC7E,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AACD,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,oBAAoB,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;WAC7F,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QAC9D,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,gEAAgE,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AACD,SAAS,cAAc,CAAC,KAAiB,EAAE,IAAY;IACrD,OAAO,QAAQ,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;AAChE,CAAC;AACD,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,MAAe;IACnE,UAAU,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAChD,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,IAAI,MAAM;YAAE,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;;YACtC,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,KAAK,CAAC;QAChB,IAAI,MAAM,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnF,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,yBAAyB,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,cAAc,EAAE,CAAC;YACxB,MAAM,OAAO,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,gCAAgC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;QACnH,CAAC;IACH,CAAC;AACH,CAAC;AACD,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,QAAgB;IACzD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC,CAAC;IACvH,MAAM,MAAM,GAA2B,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC;QACzD,QAAQ,EAAE,iVAAiV;QAC3V,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,2BAA2B,EAAE,OAAO,EAAE,cAAc;KAC1F,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC;QACtB,QAAQ,EAAE,2KAA2K;QACrL,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS;KAC1E,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/D,OAAO,MAAM,CAAC,OAAO,CAAC,qDAAqD,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9I,CAAC;AACD,KAAK,UAAU,WAAW,CAAC,MAAmC;IAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,WAAW,CAAC,IAAI,CAAC,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,UAAU,CAAC,yBAAyB,EAAE,2CAA2C,CAAC,CAAC;IACnH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,MAAM,IAAI,UAAU,CAAC,yBAAyB,EAAE,2CAA2C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1G,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACxJ,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,mBAAmB,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,IAAI,IAAI,KAAK,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;AAC9G,CAAC;AACD,KAAK,UAAU,gBAAgB,CAAC,MAAmC;IACjE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,IAAI,IAAI,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;IAChG,IAAI,IAAI;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,8BAA8B,CAAC,CAAC;IACpF,WAAW,CAAC,IAAI,CAAC,CAAC;IAClB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3G,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACtD,gBAAgB,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;YAC1F,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,GAAG,MAAM,CAAC;gBAAE,MAAM,GAAG,IAAI,CAAC;QAC/H,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,uBAAuB,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACpF,OAAO,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC;AACD,SAAS,cAAc,CAAC,IAAY,EAAE,IAAe,EAAE,KAAiB;IACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,MAAM,GAAG,8BAA8B,IAAI,MAAM,CAAC;IACxD,MAAM,KAAK,GAAG,GAAG,MAAM,mBAAmB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,2CAA2C,IAAI,QAAQ,CAAC;IACnI,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,mDAAmD,CAAC,CAAC;IAC5H,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AACD,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe;YAAE,MAAM,KAAK,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,mBAAmB,EAAE,0CAA0C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AACD,KAAK,UAAU,cAAc,CAAC,MAAmC,EAAE,IAAY,EAAE,KAAiB,EAAE,IAAY,EAAE,iBAAoC;IACpJ,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM;QACrC,CAAC,CAAC,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAClJ,CAAC,CAAC,SAAS,CAAC;IACd,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChH,CAAC;AACJ,CAAC;AACD,KAAK,UAAU,YAAY,CAAC,MAAmC,EAAE,iBAAoC;IACnG,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACvF,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,YAAY,CAAC,GAAG,IAAI,OAAO,EAAE,eAAe,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACzF,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QACzB,IAAI,IAAI,KAAK,KAAK,CAAC,WAAW;YAAE,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,YAAY,KAAK,CAAC,WAAW,SAAS,IAAI,EAAE,CAAC,CAAC;QACpH,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACnH,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAClD,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;IACnG,CAAC,CAAC,CAAC;AACL,CAAC;AACD,KAAK,UAAU,cAAc,CAAC,MAAmC;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AAC/G,CAAC;AACD,KAAK,UAAU,SAAS,CAAC,MAAmC;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,YAAY,CAAC,GAAG,IAAI,OAAO,EAAE,eAAe,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACxG,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,6CAA6C,CAAC,CAAC;QACzG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1F,IAAI,KAAK,KAAK,OAAO,CAAC,KAAK;YAAE,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACjE,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;IAC/F,CAAC,CAAC,CAAC;AACL,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,MAA+B,CAAC;QACpC,IAAI,OAAO,KAAK,KAAK;YAAE,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;aACrD,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;aAClF,IAAI,OAAO,KAAK,WAAW;YAAE,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;aACnE,IAAI,OAAO,KAAK,MAAM;YAAE,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;aACzD,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,GAAG,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QACnG,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,KAAK,YAAY,UAAU,IAAI,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;QAC1G,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACpI,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function readBoundedUtf8(path: string, maximumBytes: number): Promise<string>;
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { promises as fs } from "node:fs";
|
|
2
|
+
import { InputLimitError, assertInputLimit } from "./input-limit.mjs";
|
|
3
|
+
export async function readBoundedUtf8(path, maximumBytes) {
|
|
4
|
+
const handle = await fs.open(path, "r");
|
|
5
|
+
let failure;
|
|
6
|
+
try {
|
|
7
|
+
const buffer = Buffer.alloc(maximumBytes + 1);
|
|
8
|
+
let length = 0;
|
|
9
|
+
while (length < buffer.length) {
|
|
10
|
+
const { bytesRead } = await handle.read(buffer, length, buffer.length - length, null);
|
|
11
|
+
if (bytesRead === 0)
|
|
12
|
+
break;
|
|
13
|
+
length += bytesRead;
|
|
14
|
+
}
|
|
15
|
+
assertInputLimit(length, maximumBytes, "File bytes read");
|
|
16
|
+
return new TextDecoder("utf-8", { fatal: true }).decode(buffer.subarray(0, length));
|
|
17
|
+
}
|
|
18
|
+
catch (cause) {
|
|
19
|
+
failure = cause;
|
|
20
|
+
throw cause;
|
|
21
|
+
}
|
|
22
|
+
finally {
|
|
23
|
+
try {
|
|
24
|
+
await handle.close();
|
|
25
|
+
}
|
|
26
|
+
catch (cleanupFailure) {
|
|
27
|
+
if (!failure)
|
|
28
|
+
throw cleanupFailure;
|
|
29
|
+
const combined = new AggregateError([failure, cleanupFailure], "Bounded read and cleanup failed", { cause: failure });
|
|
30
|
+
if (failure instanceof InputLimitError)
|
|
31
|
+
throw new InputLimitError(failure.message, { cause: combined });
|
|
32
|
+
throw combined;
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
//# sourceMappingURL=bounded-file.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bounded-file.mjs","sourceRoot":"","sources":["../../src/lib/bounded-file.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,YAAoB;IACtE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QAC9C,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC;YACtF,IAAI,SAAS,KAAK,CAAC;gBAAE,MAAM;YAC3B,MAAM,IAAI,SAAS,CAAC;QACtB,CAAC;QACD,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;QAC1D,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,KAAK,CAAC;QAChB,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO;gBAAE,MAAM,cAAc,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,iCAAiC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACtH,IAAI,OAAO,YAAY,eAAe;gBAAE,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxG,MAAM,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
export type ConfigScope = "project" | "global";
|
|
2
|
+
export interface ConfigKeySpec {
|
|
3
|
+
readonly jsonField: string;
|
|
4
|
+
readonly scopes: readonly ConfigScope[];
|
|
5
|
+
validate(value: unknown, ctx: {
|
|
6
|
+
readonly scope: ConfigScope | null;
|
|
7
|
+
}): string | null;
|
|
8
|
+
}
|
|
9
|
+
export declare const CONFIG_KEYS: {
|
|
10
|
+
"pr-template-path": {
|
|
11
|
+
jsonField: string;
|
|
12
|
+
scopes: ("global" | "project")[];
|
|
13
|
+
validate(value: unknown, ctx: {
|
|
14
|
+
readonly scope: ConfigScope | null;
|
|
15
|
+
}): string | null;
|
|
16
|
+
};
|
|
17
|
+
"report-language": {
|
|
18
|
+
jsonField: string;
|
|
19
|
+
scopes: ("global" | "project")[];
|
|
20
|
+
validate(value: unknown): string | null;
|
|
21
|
+
};
|
|
22
|
+
};
|
|
23
|
+
export type ConfigKey = keyof typeof CONFIG_KEYS;
|
|
24
|
+
export declare function globalConfigPath(): string;
|
|
25
|
+
export declare function readConfigJson(path: string): Promise<Record<string, unknown> | null>;
|
|
26
|
+
export declare function writeConfigJsonAtomic(path: string, data: unknown): Promise<void>;
|
|
27
|
+
export interface ConfigWrite {
|
|
28
|
+
readonly key: ConfigKey;
|
|
29
|
+
readonly scope: ConfigScope;
|
|
30
|
+
readonly path: string;
|
|
31
|
+
readonly value: string;
|
|
32
|
+
}
|
|
33
|
+
export declare function prepareConfigWrite(key: ConfigKey, value: string, scope: ConfigScope, projectRoot: string | null): ConfigWrite;
|
|
34
|
+
export declare function writeConfigValue(write: ConfigWrite): Promise<void>;
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { promises as fs } from "node:fs";
|
|
2
|
+
import { dirname, isAbsolute, join } from "node:path";
|
|
3
|
+
import { projectJsonPath } from "./okstra-dirs.mjs";
|
|
4
|
+
import { resolveOkstraHome } from "./paths.mjs";
|
|
5
|
+
import { errorMessage, fileExists } from "./proc.mjs";
|
|
6
|
+
import { isReportLanguageTag } from "./report-language-tag.mjs";
|
|
7
|
+
export const CONFIG_KEYS = {
|
|
8
|
+
"pr-template-path": {
|
|
9
|
+
jsonField: "prTemplatePath",
|
|
10
|
+
scopes: ["project", "global"],
|
|
11
|
+
validate(value, ctx) {
|
|
12
|
+
if (typeof value !== "string" || value.trim() === "")
|
|
13
|
+
return "value must be a non-empty path";
|
|
14
|
+
const path = value.trim();
|
|
15
|
+
if (ctx.scope === "global" && !path.startsWith("~/") && !path.startsWith("~\\") && !isAbsolute(path)) {
|
|
16
|
+
return "global scope requires an absolute path or '~/'-prefixed path "
|
|
17
|
+
+ `(got ${JSON.stringify(path)}). Use --scope project for project-root-relative paths.`;
|
|
18
|
+
}
|
|
19
|
+
return null;
|
|
20
|
+
},
|
|
21
|
+
},
|
|
22
|
+
"report-language": {
|
|
23
|
+
jsonField: "reportLanguage",
|
|
24
|
+
scopes: ["project", "global"],
|
|
25
|
+
validate(value) {
|
|
26
|
+
return isReportLanguageTag(value) ? null
|
|
27
|
+
: "value must be a language tag such as en, ko, fr or pt-BR " + `(got ${JSON.stringify(value)})`;
|
|
28
|
+
},
|
|
29
|
+
},
|
|
30
|
+
};
|
|
31
|
+
export function globalConfigPath() {
|
|
32
|
+
return join(resolveOkstraHome(), "config.json");
|
|
33
|
+
}
|
|
34
|
+
export async function readConfigJson(path) {
|
|
35
|
+
if (!(await fileExists(path)))
|
|
36
|
+
return null;
|
|
37
|
+
const text = await fs.readFile(path, "utf8");
|
|
38
|
+
try {
|
|
39
|
+
const data = JSON.parse(text);
|
|
40
|
+
return typeof data === "object" && data !== null ? data : {};
|
|
41
|
+
}
|
|
42
|
+
catch (error) {
|
|
43
|
+
throw new Error(`failed to parse ${path}: ${errorMessage(error)}`, { cause: error });
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
export async function writeConfigJsonAtomic(path, data) {
|
|
47
|
+
await fs.mkdir(dirname(path), { recursive: true });
|
|
48
|
+
const temporary = `${path}.tmp.${process.pid}`;
|
|
49
|
+
await fs.writeFile(temporary, JSON.stringify(data, null, 2) + "\n", "utf8");
|
|
50
|
+
await fs.rename(temporary, path);
|
|
51
|
+
}
|
|
52
|
+
export function prepareConfigWrite(key, value, scope, projectRoot) {
|
|
53
|
+
const spec = CONFIG_KEYS[key];
|
|
54
|
+
const error = spec.validate(value, { scope });
|
|
55
|
+
if (error)
|
|
56
|
+
throw new Error(error);
|
|
57
|
+
if (scope === "project" && !projectRoot) {
|
|
58
|
+
throw new Error("cwd not inside an okstra project — cannot write project scope");
|
|
59
|
+
}
|
|
60
|
+
return {
|
|
61
|
+
key, value, scope,
|
|
62
|
+
path: scope === "project" && projectRoot !== null ? projectJsonPath(projectRoot) : globalConfigPath(),
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
export async function writeConfigValue(write) {
|
|
66
|
+
const existing = (await readConfigJson(write.path)) ?? {};
|
|
67
|
+
existing[CONFIG_KEYS[write.key].jsonField] = write.value;
|
|
68
|
+
await writeConfigJsonAtomic(write.path, existing);
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=config-store.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config-store.mjs","sourceRoot":"","sources":["../../src/lib/config-store.mts"],"names":[],"mappings":"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"}
|
package/dist/lib/file-lock.mjs
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { promises as fs } from "node:fs";
|
|
2
2
|
import { dirname } from "node:path";
|
|
3
|
-
// 잠금 한 번의 작업은 밀리초 단위다. 이보다 오래된 잠금은 죽은 프로세스의 잔여다.
|
|
4
3
|
const STALE_LOCK_MS = 5_000;
|
|
5
4
|
function processAlive(pid) {
|
|
6
5
|
try {
|
|
@@ -12,7 +11,6 @@ function processAlive(pid) {
|
|
|
12
11
|
return err.code !== "ESRCH";
|
|
13
12
|
}
|
|
14
13
|
}
|
|
15
|
-
// 잠금 파일에는 소유자 pid 가 있다. 소유자가 죽었거나 잠금이 오래되면 지운다.
|
|
16
14
|
async function reclaimStaleLock(lockPath) {
|
|
17
15
|
let ownerText;
|
|
18
16
|
let mtimeMs;
|
|
@@ -25,10 +23,11 @@ async function reclaimStaleLock(lockPath) {
|
|
|
25
23
|
return;
|
|
26
24
|
throw err;
|
|
27
25
|
}
|
|
28
|
-
const owner = Number
|
|
29
|
-
const
|
|
26
|
+
const owner = Number(ownerText.trim());
|
|
27
|
+
const hasOwner = Number.isInteger(owner) && owner > 0;
|
|
28
|
+
const ownerDead = hasOwner && !processAlive(owner);
|
|
30
29
|
const tooOld = Date.now() - mtimeMs > STALE_LOCK_MS;
|
|
31
|
-
if (ownerDead || tooOld)
|
|
30
|
+
if (ownerDead || (!hasOwner && tooOld))
|
|
32
31
|
await fs.rm(lockPath, { force: true });
|
|
33
32
|
}
|
|
34
33
|
export async function withFileLock(lockPath, busyMessage, fn) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"file-lock.mjs","sourceRoot":"","sources":["../../src/lib/file-lock.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,
|
|
1
|
+
{"version":3,"file":"file-lock.mjs","sourceRoot":"","sources":["../../src/lib/file-lock.mts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export class InputLimitError extends Error {
|
|
2
|
+
code = "INPUT_LIMIT_EXCEEDED";
|
|
3
|
+
}
|
|
4
|
+
export function assertInputLimit(observed, maximum, label) {
|
|
5
|
+
if (observed > maximum)
|
|
6
|
+
throw new InputLimitError(`${label} exceeds the supported limit of ${maximum}`);
|
|
7
|
+
}
|
|
8
|
+
//# sourceMappingURL=input-limit.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"input-limit.mjs","sourceRoot":"","sources":["../../src/lib/input-limit.mts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,GAAG,sBAAsB,CAAC;CACxC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAAe,EAAE,KAAa;IAC/E,IAAI,QAAQ,GAAG,OAAO;QAAE,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,mCAAmC,OAAO,EAAE,CAAC,CAAC;AAC1G,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function registerMemorySource(nativeId: string): Promise<void>;
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { promises as fs } from "node:fs";
|
|
3
|
+
import { isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
4
|
+
import { resolveOkstraHome } from "./paths.mjs";
|
|
5
|
+
import { runPythonModule } from "./python-helper.mjs";
|
|
6
|
+
import { detectRecordSecrets } from "./record-secrets.mjs";
|
|
7
|
+
import { readBoundedUtf8 } from "./bounded-file.mjs";
|
|
8
|
+
const MAX_CONFIG_BYTES = 2_000_000;
|
|
9
|
+
const REGISTRATION_WARNING = "warning: Memory Book saved; doyouknow registration did not complete. Run 'okstra doyouknow sync' to recover.\n";
|
|
10
|
+
function isMissingFile(error) {
|
|
11
|
+
return error instanceof Error && "code" in error && error.code === "ENOENT";
|
|
12
|
+
}
|
|
13
|
+
async function containedAutomaticPath(home, ...segments) {
|
|
14
|
+
const root = await fs.realpath(home);
|
|
15
|
+
let current = root;
|
|
16
|
+
for (const segment of ["doyouknow", ...segments]) {
|
|
17
|
+
current = join(current, segment);
|
|
18
|
+
try {
|
|
19
|
+
await fs.lstat(current);
|
|
20
|
+
}
|
|
21
|
+
catch (error) {
|
|
22
|
+
if (!isMissingFile(error))
|
|
23
|
+
throw error;
|
|
24
|
+
continue;
|
|
25
|
+
}
|
|
26
|
+
try {
|
|
27
|
+
current = await fs.realpath(current);
|
|
28
|
+
}
|
|
29
|
+
catch (error) {
|
|
30
|
+
throw new Error("Automatic registration path cannot be resolved", { cause: error });
|
|
31
|
+
}
|
|
32
|
+
const fromRoot = relative(root, current);
|
|
33
|
+
if (fromRoot === ".." || fromRoot.startsWith(`..${sep}`) || isAbsolute(fromRoot)) {
|
|
34
|
+
throw new Error("Automatic registration path is outside its home");
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
return current;
|
|
38
|
+
}
|
|
39
|
+
async function readBoundedConfig(path) {
|
|
40
|
+
return JSON.parse(await readBoundedUtf8(path, MAX_CONFIG_BYTES));
|
|
41
|
+
}
|
|
42
|
+
async function readAutomaticRegistrationEnabled(home) {
|
|
43
|
+
let value;
|
|
44
|
+
try {
|
|
45
|
+
value = await readBoundedConfig(await containedAutomaticPath(home, "config.json"));
|
|
46
|
+
}
|
|
47
|
+
catch (error) {
|
|
48
|
+
if (isMissingFile(error))
|
|
49
|
+
return true;
|
|
50
|
+
throw error;
|
|
51
|
+
}
|
|
52
|
+
if (typeof value !== "object" || value === null ||
|
|
53
|
+
!("schemaVersion" in value) || value.schemaVersion !== 1 ||
|
|
54
|
+
!("autoRegister" in value) || typeof value.autoRegister !== "boolean" ||
|
|
55
|
+
!("sources" in value) || !Array.isArray(value.sources) ||
|
|
56
|
+
!value.sources.every((source) => typeof source === "string"))
|
|
57
|
+
throw new Error("Automatic registration config is invalid");
|
|
58
|
+
return value.autoRegister && value.sources.includes("memory");
|
|
59
|
+
}
|
|
60
|
+
async function publishMemoryTicket(home, nativeId) {
|
|
61
|
+
const directory = await containedAutomaticPath(home, "pending");
|
|
62
|
+
await fs.mkdir(directory, { recursive: true, mode: 0o700 });
|
|
63
|
+
const checkedDirectory = await containedAutomaticPath(home, "pending");
|
|
64
|
+
const token = randomUUID();
|
|
65
|
+
const temporary = join(checkedDirectory, `.${token}.tmp`);
|
|
66
|
+
const payload = { schemaVersion: 1, sourceRef: { kind: "memory", owner_id: "memory-book", native_id: nativeId } };
|
|
67
|
+
const handle = await fs.open(temporary, "wx", 0o600);
|
|
68
|
+
try {
|
|
69
|
+
await handle.writeFile(JSON.stringify(payload) + "\n");
|
|
70
|
+
await fs.link(temporary, join(checkedDirectory, `${token}.json`));
|
|
71
|
+
}
|
|
72
|
+
finally {
|
|
73
|
+
await handle.close();
|
|
74
|
+
await fs.rm(temporary, { force: true });
|
|
75
|
+
}
|
|
76
|
+
return token;
|
|
77
|
+
}
|
|
78
|
+
export async function registerMemorySource(nativeId) {
|
|
79
|
+
try {
|
|
80
|
+
const home = resolve(resolveOkstraHome());
|
|
81
|
+
if (!(await readAutomaticRegistrationEnabled(home)))
|
|
82
|
+
return;
|
|
83
|
+
if (!nativeId.trim() || nativeId.length > 4096 || (await detectRecordSecrets(nativeId)).length > 0) {
|
|
84
|
+
throw new Error("Automatic memory source identity is invalid");
|
|
85
|
+
}
|
|
86
|
+
const token = await publishMemoryTicket(home, nativeId);
|
|
87
|
+
const result = await runPythonModule({
|
|
88
|
+
module: "okstra_ctl.doyouknow.cli", args: ["register", "--ticket", token, "--json"],
|
|
89
|
+
extraEnv: { OKSTRA_HOME: home }, stdio: "ignore", timeoutMs: 5000,
|
|
90
|
+
});
|
|
91
|
+
if (result.code !== 0)
|
|
92
|
+
process.stderr.write(REGISTRATION_WARNING);
|
|
93
|
+
}
|
|
94
|
+
catch {
|
|
95
|
+
process.stderr.write(REGISTRATION_WARNING);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
//# sourceMappingURL=memory-auto-register.mjs.map
|