pi-harness-runtime 0.10.11 → 0.10.12
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/cli.ts +111 -0
- package/footer-status.ts +204 -0
- package/harness/agent-handoff.ts +189 -0
- package/harness/auto-compact.ts +309 -0
- package/harness/auto-quota-resume.ts +132 -0
- package/harness/autonomous-review.ts +88 -0
- package/harness/blackboard.ts +291 -0
- package/harness/context-compact-orchestrator.ts +551 -0
- package/harness/context-window-manager.ts +464 -0
- package/harness/continue-prompt.ts +242 -0
- package/harness/e2e/index.ts +44 -0
- package/harness/e2e/minimax-quota-parser.ts +88 -0
- package/harness/e2e/minimax-quota-scraper.ts +609 -0
- package/harness/e2e/openai-quota-scraper.ts +447 -0
- package/harness/e2e/playwright-runner.ts +204 -0
- package/harness/e2e/quota-status.ts +194 -0
- package/harness/e2e/test-engine.ts +398 -0
- package/harness/forked-summarizer.ts +304 -0
- package/harness/herdr-agents.ts +91 -0
- package/harness/index.ts +232 -0
- package/harness/job-state-machine.ts +363 -0
- package/harness/loop-code-agent.ts +284 -0
- package/harness/loop-controller.ts +201 -0
- package/harness/loop-review-agent.ts +295 -0
- package/harness/loop-runtime.ts +760 -0
- package/harness/loop-types.ts +118 -0
- package/harness/master-planner.ts +327 -0
- package/harness/notification-events.ts +299 -0
- package/harness/output-limit-handler.ts +316 -0
- package/harness/partial-recovery.ts +531 -0
- package/harness/project-detector/detector.ts +328 -0
- package/harness/repair-engine.ts +340 -0
- package/harness/session-memory.ts +401 -0
- package/harness/task-graph.d.ts +51 -0
- package/harness/task-graph.ts +143 -0
- package/mirror.ts +278 -0
- package/package.json +8 -12
- package/packages/a2a-adapter/src/agent.ts +139 -0
- package/packages/a2a-adapter/src/client.ts +107 -0
- package/packages/a2a-adapter/src/discovery.ts +106 -0
- package/packages/a2a-adapter/src/index.ts +38 -0
- package/packages/a2a-adapter/src/protocol.ts +46 -0
- package/packages/a2a-adapter/src/transport.ts +142 -0
- package/packages/a2a-adapter/src/types.ts +117 -0
- package/packages/auth/src/minimax-browser-auth.ts +1109 -0
- package/packages/auth/src/run-minimax-auth.ts +150 -0
- package/packages/autonomous-refactor/src/detector.ts +219 -0
- package/packages/autonomous-refactor/src/index.ts +16 -0
- package/packages/autonomous-refactor/src/planner.ts +99 -0
- package/packages/autonomous-refactor/src/types.ts +57 -0
- package/packages/autonomous-runtime/src/inbox.ts +266 -0
- package/packages/autonomous-runtime/src/index.ts +22 -0
- package/packages/autonomous-runtime/src/lease.ts +318 -0
- package/packages/autonomous-runtime/src/types.ts +257 -0
- package/packages/cache-strategy/src/cache.ts +213 -0
- package/packages/cache-strategy/src/index.ts +6 -0
- package/packages/cache-strategy/src/types.ts +40 -0
- package/packages/capability-registry/src/defaults.ts +247 -0
- package/packages/capability-registry/src/index.ts +43 -0
- package/packages/capability-registry/src/query.ts +99 -0
- package/packages/capability-registry/src/registry.ts +222 -0
- package/packages/capability-registry/src/types.d.ts +47 -0
- package/packages/capability-registry/src/types.js +10 -0
- package/packages/capability-registry/src/types.ts +83 -0
- package/packages/checkpoint/src/checkpoint-manager.ts +33 -0
- package/packages/checkpoint/src/differ.ts +281 -0
- package/packages/checkpoint/src/engine.ts +532 -0
- package/packages/checkpoint/src/index.ts +48 -0
- package/packages/checkpoint/src/storage.ts +439 -0
- package/packages/checkpoint/src/types.ts +348 -0
- package/packages/cli-plugin-sdk/src/index.ts +169 -0
- package/packages/cli-plugin-sdk/src/plugin-fs.ts +91 -0
- package/packages/cli-plugin-sdk/src/registry.ts +55 -0
- package/packages/cli-plugin-sdk/src/types.ts +32 -0
- package/packages/clipboard/dist/src/clipboard.d.ts +11 -0
- package/packages/clipboard/dist/src/clipboard.js +51 -0
- package/packages/clipboard/dist/src/copy-sync.d.ts +27 -0
- package/packages/clipboard/dist/src/copy-sync.js +170 -0
- package/packages/clipboard/dist/src/gist-relay.d.ts +48 -0
- package/packages/clipboard/dist/src/gist-relay.js +186 -0
- package/packages/clipboard/dist/src/github-login.d.ts +16 -0
- package/packages/clipboard/dist/src/github-login.js +69 -0
- package/packages/clipboard/dist/src/index.d.ts +4 -0
- package/packages/clipboard/dist/src/index.js +3 -0
- package/packages/clipboard/dist/src/types.d.ts +13 -0
- package/packages/clipboard/dist/src/types.js +5 -0
- package/packages/clipboard/src/clipboard.ts +59 -0
- package/packages/clipboard/src/copy-sync.ts +201 -0
- package/packages/clipboard/src/gist-relay.ts +240 -0
- package/packages/clipboard/src/github-login.ts +107 -0
- package/packages/clipboard/src/index.ts +3 -0
- package/packages/clipboard/src/types.ts +14 -0
- package/packages/code-generation/src/faker.ts +461 -0
- package/packages/code-generation/src/generator.ts +421 -0
- package/packages/code-generation/src/index.ts +56 -0
- package/packages/code-generation/src/templates/ejs-renderer.ts +142 -0
- package/packages/code-generation/src/templates/registry.ts +174 -0
- package/packages/code-generation/src/types.ts +373 -0
- package/packages/code-review/src/engine.ts +408 -0
- package/packages/code-review/src/index.ts +46 -0
- package/packages/code-review/src/reports/html.ts +143 -0
- package/packages/code-review/src/reports/markdown.ts +197 -0
- package/packages/code-review/src/reports/text.ts +171 -0
- package/packages/code-review/src/types.ts +324 -0
- package/packages/codex-adapter/src/executor.ts +83 -0
- package/packages/codex-adapter/src/index.ts +16 -0
- package/packages/codex-adapter/src/provider.ts +213 -0
- package/packages/codex-adapter/src/types.ts +118 -0
- package/packages/config-capture/src/index.ts +357 -0
- package/packages/context-compiler/src/budget.ts +122 -0
- package/packages/context-compiler/src/cache.ts +134 -0
- package/packages/context-compiler/src/compiler.ts +314 -0
- package/packages/context-compiler/src/deduplicate.ts +171 -0
- package/packages/context-compiler/src/filter.ts +135 -0
- package/packages/context-compiler/src/index.ts +61 -0
- package/packages/context-compiler/src/okf-loader.ts +86 -0
- package/packages/context-compiler/src/score.ts +130 -0
- package/packages/context-compiler/src/types.ts +246 -0
- package/packages/context-discovery/dist/src/discover.d.ts +3 -0
- package/packages/context-discovery/dist/src/discover.js +42 -0
- package/packages/context-discovery/dist/src/discovery.d.ts +28 -0
- package/packages/context-discovery/dist/src/discovery.js +21 -0
- package/packages/context-discovery/dist/src/index.d.ts +3 -0
- package/packages/context-discovery/dist/src/index.js +2 -0
- package/packages/context-discovery/dist/src/types.d.ts +16 -0
- package/packages/context-discovery/dist/src/types.js +2 -0
- package/packages/context-discovery/src/discover.ts +42 -0
- package/packages/context-discovery/src/discovery.ts +44 -0
- package/packages/context-discovery/src/index.ts +2 -0
- package/packages/context-discovery/src/types.ts +15 -0
- package/packages/context-manager/src/compaction.ts +139 -0
- package/packages/context-manager/src/core.ts +85 -0
- package/packages/context-manager/src/index.ts +22 -0
- package/packages/context-manager/src/types.ts +44 -0
- package/packages/cookie-sanitizer/src/atomic-write.ts +79 -0
- package/packages/cookie-sanitizer/src/detect-format.ts +102 -0
- package/packages/cookie-sanitizer/src/index.ts +89 -0
- package/packages/cookie-sanitizer/src/infer-provider.ts +103 -0
- package/packages/cookie-sanitizer/src/normalize.ts +92 -0
- package/packages/cookie-sanitizer/src/parse-json.ts +122 -0
- package/packages/cookie-sanitizer/src/parse-netscape.ts +118 -0
- package/packages/cookie-sanitizer/src/sync.ts +312 -0
- package/packages/cookie-sanitizer/src/types.ts +101 -0
- package/packages/cookie-sanitizer/src/watcher.ts +180 -0
- package/packages/cost-optimizer/src/budget.ts +138 -0
- package/packages/cost-optimizer/src/config.ts +34 -0
- package/packages/cost-optimizer/src/forecast.ts +59 -0
- package/packages/cost-optimizer/src/index.ts +74 -0
- package/packages/cost-optimizer/src/optimizer.ts +277 -0
- package/packages/cost-optimizer/src/selection.ts +264 -0
- package/packages/cost-optimizer/src/tracker.ts +122 -0
- package/packages/cost-optimizer/src/types.ts +134 -0
- package/packages/dependency-analyzer/dist/src/analyzer.d.ts +17 -0
- package/packages/dependency-analyzer/dist/src/analyzer.js +119 -0
- package/packages/dependency-analyzer/dist/src/imports.d.ts +12 -0
- package/packages/dependency-analyzer/dist/src/imports.js +73 -0
- package/packages/dependency-analyzer/dist/src/index.d.ts +4 -0
- package/packages/dependency-analyzer/dist/src/index.js +3 -0
- package/packages/dependency-analyzer/dist/src/types.d.ts +28 -0
- package/packages/dependency-analyzer/dist/src/types.js +5 -0
- package/packages/dependency-analyzer/src/analyzer.ts +140 -0
- package/packages/dependency-analyzer/src/imports.ts +93 -0
- package/packages/dependency-analyzer/src/index.ts +9 -0
- package/packages/dependency-analyzer/src/types.ts +38 -0
- package/packages/django-plugin/src/analyzer.ts +284 -0
- package/packages/django-plugin/src/index.ts +39 -0
- package/packages/django-plugin/src/types.ts +35 -0
- package/packages/doc-generator/src/detector.ts +113 -0
- package/packages/doc-generator/src/docs.ts +158 -0
- package/packages/doc-generator/src/index.ts +7 -0
- package/packages/doc-generator/src/types.ts +58 -0
- package/packages/evaluation-engine/src/engine.ts +488 -0
- package/packages/evaluation-engine/src/index.ts +23 -0
- package/packages/evaluation-engine/src/types.ts +136 -0
- package/packages/evaluation-runner/src/index.ts +6 -0
- package/packages/evaluation-runner/src/runner.ts +182 -0
- package/packages/evaluation-runner/src/types.ts +51 -0
- package/packages/event-bus/dist/src/bus.d.ts +15 -0
- package/packages/event-bus/dist/src/bus.js +98 -0
- package/packages/event-bus/dist/src/herdr-bus.d.ts +121 -0
- package/packages/event-bus/dist/src/herdr-bus.js +322 -0
- package/packages/event-bus/dist/src/index.d.ts +6 -0
- package/packages/event-bus/dist/src/index.js +4 -0
- package/packages/event-bus/dist/src/types.d.ts +27 -0
- package/packages/event-bus/dist/src/types.js +10 -0
- package/packages/event-bus/src/bus.ts +111 -0
- package/packages/event-bus/src/herdr-bus.ts +525 -0
- package/packages/event-bus/src/index.ts +38 -0
- package/packages/event-bus/src/types.ts +59 -0
- package/packages/event-store/dist/src/index.d.ts +3 -0
- package/packages/event-store/dist/src/index.js +2 -0
- package/packages/event-store/dist/src/store.d.ts +15 -0
- package/packages/event-store/dist/src/store.js +139 -0
- package/packages/event-store/dist/src/types.d.ts +48 -0
- package/packages/event-store/dist/src/types.js +5 -0
- package/packages/event-store/src/index.ts +11 -0
- package/packages/event-store/src/store.ts +168 -0
- package/packages/event-store/src/types.d.ts +48 -0
- package/packages/event-store/src/types.js +5 -0
- package/packages/event-store/src/types.ts +65 -0
- package/packages/experience-replay/src/index.ts +19 -0
- package/packages/experience-replay/src/replay.ts +348 -0
- package/packages/experience-replay/src/types.ts +128 -0
- package/packages/feedback-collector/src/collector.ts +160 -0
- package/packages/feedback-collector/src/index.ts +6 -0
- package/packages/feedback-collector/src/types.ts +51 -0
- package/packages/framework-detector/src/detector.ts +586 -0
- package/packages/framework-detector/src/index.ts +46 -0
- package/packages/framework-detector/src/signatures/registry.ts +648 -0
- package/packages/framework-detector/src/types.ts +299 -0
- package/packages/framework-plugin-sdk/src/index.ts +45 -0
- package/packages/framework-plugin-sdk/src/manager.ts +525 -0
- package/packages/framework-plugin-sdk/src/types.ts +449 -0
- package/packages/frappe-plugin/src/analyzer.ts +454 -0
- package/packages/frappe-plugin/src/index.ts +72 -0
- package/packages/frappe-plugin/src/types.ts +135 -0
- package/packages/generic-web-plugin/src/analyzer.ts +347 -0
- package/packages/generic-web-plugin/src/index.ts +61 -0
- package/packages/generic-web-plugin/src/types.ts +41 -0
- package/packages/health-monitor/src/index.ts +16 -0
- package/packages/health-monitor/src/monitor.ts +216 -0
- package/packages/health-monitor/src/types.ts +45 -0
- package/packages/intent-analyzer/dist/src/analyzer.d.ts +13 -0
- package/packages/intent-analyzer/dist/src/analyzer.js +239 -0
- package/packages/intent-analyzer/dist/src/index.d.ts +3 -0
- package/packages/intent-analyzer/dist/src/index.js +2 -0
- package/packages/intent-analyzer/dist/src/types.d.ts +26 -0
- package/packages/intent-analyzer/dist/src/types.js +7 -0
- package/packages/intent-analyzer/src/analyzer.ts +259 -0
- package/packages/intent-analyzer/src/index.ts +8 -0
- package/packages/intent-analyzer/src/types.ts +44 -0
- package/packages/knowledge-retrieval/src/index.ts +18 -0
- package/packages/knowledge-retrieval/src/mcp-client.ts +212 -0
- package/packages/knowledge-retrieval/src/types.ts +112 -0
- package/packages/laravel-plugin/src/analyzer.ts +323 -0
- package/packages/laravel-plugin/src/index.ts +40 -0
- package/packages/laravel-plugin/src/types.ts +24 -0
- package/packages/learning-engine/src/engine.ts +391 -0
- package/packages/learning-engine/src/index.ts +26 -0
- package/packages/learning-engine/src/types.ts +201 -0
- package/packages/mcp-adapter/src/index.ts +20 -0
- package/packages/mcp-adapter/src/server.ts +273 -0
- package/packages/mcp-adapter/src/tools.ts +220 -0
- package/packages/mcp-adapter/src/types.ts +79 -0
- package/packages/memory-engine/src/engine.ts +615 -0
- package/packages/memory-engine/src/index.ts +20 -0
- package/packages/memory-engine/src/types.ts +159 -0
- package/packages/model-registry/src/cost.ts +80 -0
- package/packages/model-registry/src/defaults.ts +178 -0
- package/packages/model-registry/src/index.ts +57 -0
- package/packages/model-registry/src/query.ts +85 -0
- package/packages/model-registry/src/registry.ts +188 -0
- package/packages/model-registry/src/types.d.ts +63 -0
- package/packages/model-registry/src/types.js +5 -0
- package/packages/model-registry/src/types.ts +69 -0
- package/packages/nextjs-plugin/src/analyzer.ts +247 -0
- package/packages/nextjs-plugin/src/index.ts +41 -0
- package/packages/nextjs-plugin/src/types.ts +36 -0
- package/packages/notification/src/adapters/email-adapter.ts +126 -0
- package/packages/notification/src/adapters/ntfy-adapter.ts +100 -0
- package/packages/notification/src/adapters/telegram-adapter.ts +107 -0
- package/packages/notification/src/adapters/webhook-adapter.ts +75 -0
- package/packages/notification/src/base-adapter.ts +75 -0
- package/packages/notification/src/index.ts +9 -0
- package/packages/notification/src/notification-center.ts +286 -0
- package/packages/notification/src/types.ts +89 -0
- package/packages/observability/src/alerts.ts +355 -0
- package/packages/observability/src/health.ts +325 -0
- package/packages/observability/src/index.ts +79 -0
- package/packages/observability/src/logger.ts +373 -0
- package/packages/observability/src/metrics.ts +475 -0
- package/packages/observability/src/tracer.ts +336 -0
- package/packages/observability/src/types.ts +391 -0
- package/packages/okf-indexer/src/cli.ts +25 -0
- package/packages/okf-indexer/src/indexer.ts +186 -0
- package/packages/performance-optimizer/src/index.ts +20 -0
- package/packages/performance-optimizer/src/optimizer.ts +428 -0
- package/packages/performance-optimizer/src/types.ts +112 -0
- package/packages/privilege-broker/src/approval.ts +70 -0
- package/packages/privilege-broker/src/audit.ts +142 -0
- package/packages/privilege-broker/src/executor.ts +110 -0
- package/packages/privilege-broker/src/index.ts +46 -0
- package/packages/privilege-broker/src/registry.ts +98 -0
- package/packages/privilege-broker/src/types.ts +105 -0
- package/packages/project-analyzer/src/analyzer.ts +683 -0
- package/packages/project-analyzer/src/cache.ts +329 -0
- package/packages/project-analyzer/src/command-discovery.ts +239 -0
- package/packages/project-analyzer/src/index.ts +123 -0
- package/packages/project-analyzer/src/plugins/index.ts +16 -0
- package/packages/project-analyzer/src/rule-discovery.ts +282 -0
- package/packages/project-analyzer/src/signals.ts +355 -0
- package/packages/project-analyzer/src/types.ts +412 -0
- package/packages/project-analyzer/src/walker.ts +366 -0
- package/packages/projection-engine/dist/src/engine.d.ts +61 -0
- package/packages/projection-engine/dist/src/engine.js +87 -0
- package/packages/projection-engine/dist/src/index.d.ts +2 -0
- package/packages/projection-engine/dist/src/index.js +2 -0
- package/packages/projection-engine/dist/src/project.d.ts +3 -0
- package/packages/projection-engine/dist/src/project.js +24 -0
- package/packages/projection-engine/dist/src/types.d.ts +55 -0
- package/packages/projection-engine/dist/src/types.js +5 -0
- package/packages/projection-engine/src/engine.ts +134 -0
- package/packages/projection-engine/src/index.ts +8 -0
- package/packages/projection-engine/src/project.ts +24 -0
- package/packages/projection-engine/src/types.d.ts +55 -0
- package/packages/projection-engine/src/types.js +5 -0
- package/packages/projection-engine/src/types.ts +60 -0
- package/packages/prompt-compiler/src/budget.ts +170 -0
- package/packages/prompt-compiler/src/compiler.ts +188 -0
- package/packages/prompt-compiler/src/deduplicate.ts +84 -0
- package/packages/prompt-compiler/src/index.ts +50 -0
- package/packages/prompt-compiler/src/normalize.ts +140 -0
- package/packages/prompt-compiler/src/render.ts +105 -0
- package/packages/prompt-compiler/src/section-builder.ts +279 -0
- package/packages/prompt-compiler/src/types.ts +263 -0
- package/packages/prompt-compiler/src/validate.ts +157 -0
- package/packages/prompt-versioning/src/index.ts +6 -0
- package/packages/prompt-versioning/src/types.ts +41 -0
- package/packages/prompt-versioning/src/versioning.ts +149 -0
- package/packages/provider-adapter-sdk/dist/src/builder.d.ts +140 -0
- package/packages/provider-adapter-sdk/dist/src/builder.js +332 -0
- package/packages/provider-adapter-sdk/dist/src/errors.d.ts +71 -0
- package/packages/provider-adapter-sdk/dist/src/errors.js +111 -0
- package/packages/provider-adapter-sdk/dist/src/index.d.ts +15 -0
- package/packages/provider-adapter-sdk/dist/src/index.js +19 -0
- package/packages/provider-adapter-sdk/dist/src/registry.d.ts +108 -0
- package/packages/provider-adapter-sdk/dist/src/registry.js +301 -0
- package/packages/provider-adapter-sdk/dist/src/tester.d.ts +71 -0
- package/packages/provider-adapter-sdk/dist/src/tester.js +392 -0
- package/packages/provider-adapter-sdk/dist/src/types.d.ts +182 -0
- package/packages/provider-adapter-sdk/dist/src/types.js +11 -0
- package/packages/provider-adapter-sdk/src/builder.ts +442 -0
- package/packages/provider-adapter-sdk/src/errors.ts +153 -0
- package/packages/provider-adapter-sdk/src/index.ts +84 -0
- package/packages/provider-adapter-sdk/src/registry.ts +486 -0
- package/packages/provider-adapter-sdk/src/tester.ts +483 -0
- package/packages/provider-adapter-sdk/src/types.ts +293 -0
- package/packages/provider-router/dist/capability-registry/src/types.d.ts +47 -0
- package/packages/provider-router/dist/capability-registry/src/types.js +10 -0
- package/packages/provider-router/dist/provider-router/src/index.d.ts +23 -0
- package/packages/provider-router/dist/provider-router/src/index.js +25 -0
- package/packages/provider-router/dist/provider-router/src/policy.d.ts +10 -0
- package/packages/provider-router/dist/provider-router/src/policy.js +45 -0
- package/packages/provider-router/dist/provider-router/src/provider-router.d.ts +56 -0
- package/packages/provider-router/dist/provider-router/src/provider-router.js +222 -0
- package/packages/provider-router/dist/provider-router/src/strategies.d.ts +19 -0
- package/packages/provider-router/dist/provider-router/src/strategies.js +110 -0
- package/packages/provider-router/dist/provider-router/src/types.d.ts +91 -0
- package/packages/provider-router/dist/provider-router/src/types.js +10 -0
- package/packages/provider-router/dist/src/index.d.ts +23 -0
- package/packages/provider-router/dist/src/index.js +25 -0
- package/packages/provider-router/dist/src/policy.d.ts +10 -0
- package/packages/provider-router/dist/src/policy.js +45 -0
- package/packages/provider-router/dist/src/provider-router.d.ts +56 -0
- package/packages/provider-router/dist/src/provider-router.js +222 -0
- package/packages/provider-router/dist/src/strategies.d.ts +19 -0
- package/packages/provider-router/dist/src/strategies.js +110 -0
- package/packages/provider-router/dist/src/types.d.ts +91 -0
- package/packages/provider-router/dist/src/types.js +10 -0
- package/packages/provider-router/dist/types/src/runtime-types.d.ts +412 -0
- package/packages/provider-router/dist/types/src/runtime-types.js +2 -0
- package/packages/provider-router/src/index.ts +49 -0
- package/packages/provider-router/src/policy.ts +50 -0
- package/packages/provider-router/src/provider-router.ts +315 -0
- package/packages/provider-router/src/strategies.ts +158 -0
- package/packages/provider-router/src/types.ts +130 -0
- package/packages/provider-selector/src/index.ts +13 -0
- package/packages/provider-selector/src/selector.ts +120 -0
- package/packages/provider-selector/src/types.ts +33 -0
- package/packages/providers/dist/src/adapters.d.ts +133 -0
- package/packages/providers/dist/src/adapters.js +236 -0
- package/packages/providers/dist/src/deepagents-adapter.d.ts +78 -0
- package/packages/providers/dist/src/deepagents-adapter.js +323 -0
- package/packages/providers/dist/src/glm-usage.d.ts +102 -0
- package/packages/providers/dist/src/glm-usage.js +197 -0
- package/packages/providers/dist/src/index.d.ts +11 -0
- package/packages/providers/dist/src/index.js +11 -0
- package/packages/providers/dist/src/openai-usage.d.ts +103 -0
- package/packages/providers/dist/src/openai-usage.js +208 -0
- package/packages/providers/dist/src/provider-id.d.ts +46 -0
- package/packages/providers/dist/src/provider-id.js +113 -0
- package/packages/providers/src/adapters.ts +362 -0
- package/packages/providers/src/deepagents-adapter.ts +458 -0
- package/packages/providers/src/glm-usage.ts +248 -0
- package/packages/providers/src/index.ts +11 -0
- package/packages/providers/src/openai-usage.ts +263 -0
- package/packages/providers/src/provider-id.ts +129 -0
- package/packages/quota-manager/dist/src/examples/tui-usage-integration.d.ts +35 -0
- package/packages/quota-manager/dist/src/examples/tui-usage-integration.js +73 -0
- package/packages/quota-manager/dist/src/index.d.ts +8 -0
- package/packages/quota-manager/dist/src/index.js +8 -0
- package/packages/quota-manager/dist/src/quota-manager.d.ts +70 -0
- package/packages/quota-manager/dist/src/quota-manager.js +260 -0
- package/packages/quota-manager/dist/src/tui-usage-monitor.d.ts +96 -0
- package/packages/quota-manager/dist/src/tui-usage-monitor.js +268 -0
- package/packages/quota-manager/src/examples/tui-usage-integration.ts +72 -0
- package/packages/quota-manager/src/index.ts +8 -0
- package/packages/quota-manager/src/quota-manager.ts +336 -0
- package/packages/quota-manager/src/tui-usage-monitor.ts +355 -0
- package/packages/rate-limiter/src/index.ts +6 -0
- package/packages/rate-limiter/src/limiter.ts +122 -0
- package/packages/rate-limiter/src/types.ts +41 -0
- package/packages/react-vite-plugin/src/analyzer.ts +226 -0
- package/packages/react-vite-plugin/src/index.ts +39 -0
- package/packages/react-vite-plugin/src/types.ts +28 -0
- package/packages/release-manager/src/changelog.ts +148 -0
- package/packages/release-manager/src/index.ts +21 -0
- package/packages/release-manager/src/types.ts +50 -0
- package/packages/release-manager/src/version.ts +52 -0
- package/packages/requirement-compiler/src/ambiguity-detector.ts +302 -0
- package/packages/requirement-compiler/src/classifier.ts +145 -0
- package/packages/requirement-compiler/src/compiler.ts +328 -0
- package/packages/requirement-compiler/src/extractor.ts +155 -0
- package/packages/requirement-compiler/src/index.ts +36 -0
- package/packages/requirement-compiler/src/normalizer.ts +161 -0
- package/packages/requirement-compiler/src/risk-detector.ts +58 -0
- package/packages/requirement-compiler/src/types.ts +596 -0
- package/packages/runtime/dist/src/command-executor.d.ts +129 -0
- package/packages/runtime/dist/src/command-executor.js +383 -0
- package/packages/runtime/dist/src/index.d.ts +11 -0
- package/packages/runtime/dist/src/index.js +11 -0
- package/packages/runtime/dist/src/local-runtime-agent.d.ts +111 -0
- package/packages/runtime/dist/src/local-runtime-agent.js +356 -0
- package/packages/runtime/dist/src/policy-engine.d.ts +203 -0
- package/packages/runtime/dist/src/policy-engine.js +592 -0
- package/packages/runtime/dist/src/runtime-api.d.ts +137 -0
- package/packages/runtime/dist/src/runtime-api.js +454 -0
- package/packages/runtime/dist/src/workspace-manager.d.ts +162 -0
- package/packages/runtime/dist/src/workspace-manager.js +451 -0
- package/packages/runtime/src/command-executor.ts +523 -0
- package/packages/runtime/src/index.ts +11 -0
- package/packages/runtime/src/local-runtime-agent.ts +480 -0
- package/packages/runtime/src/policy-engine.ts +813 -0
- package/packages/runtime/src/runtime-api.ts +665 -0
- package/packages/runtime/src/workspace-manager.ts +591 -0
- package/packages/scheduler/src/scheduler.ts +50 -0
- package/packages/scheduler-adapter/src/cron.ts +123 -0
- package/packages/scheduler-adapter/src/index.ts +9 -0
- package/packages/scheduler-adapter/src/interface.ts +61 -0
- package/packages/scheduler-adapter/src/internal.ts +99 -0
- package/packages/scheduler-adapter/src/systemd.ts +221 -0
- package/packages/session/src/history.ts +353 -0
- package/packages/session/src/index.ts +53 -0
- package/packages/session/src/manager.ts +481 -0
- package/packages/session/src/policy.ts +363 -0
- package/packages/session/src/store.ts +348 -0
- package/packages/session/src/types.ts +275 -0
- package/packages/session-api/dist/src/api.d.ts +83 -0
- package/packages/session-api/dist/src/api.js +49 -0
- package/packages/session-api/dist/src/index.d.ts +2 -0
- package/packages/session-api/dist/src/index.js +2 -0
- package/packages/session-api/dist/src/types.d.ts +22 -0
- package/packages/session-api/dist/src/types.js +5 -0
- package/packages/session-api/src/api.ts +117 -0
- package/packages/session-api/src/index.ts +1 -0
- package/packages/session-api/src/types.ts +23 -0
- package/packages/session-export/dist/src/exporter.d.ts +28 -0
- package/packages/session-export/dist/src/exporter.js +42 -0
- package/packages/session-export/dist/src/index.d.ts +2 -0
- package/packages/session-export/dist/src/index.js +2 -0
- package/packages/session-export/dist/src/types.d.ts +20 -0
- package/packages/session-export/dist/src/types.js +5 -0
- package/packages/session-export/src/exporter.ts +81 -0
- package/packages/session-export/src/index.ts +1 -0
- package/packages/session-export/src/types.ts +22 -0
- package/packages/shared-context/src/index.ts +7 -0
- package/packages/shared-context/src/shared-context.ts +42 -0
- package/packages/skill-registry/src/defaults.ts +146 -0
- package/packages/skill-registry/src/index.ts +48 -0
- package/packages/skill-registry/src/matching.ts +118 -0
- package/packages/skill-registry/src/registry.ts +211 -0
- package/packages/skill-registry/src/types.ts +97 -0
- package/packages/sprint-planner/src/decomposer.ts +57 -0
- package/packages/sprint-planner/src/index.ts +16 -0
- package/packages/sprint-planner/src/planner.ts +150 -0
- package/packages/sprint-planner/src/types.ts +59 -0
- package/packages/subscription-engine/dist/src/engine.d.ts +13 -0
- package/packages/subscription-engine/dist/src/engine.js +40 -0
- package/packages/subscription-engine/dist/src/index.d.ts +2 -0
- package/packages/subscription-engine/dist/src/index.js +2 -0
- package/packages/subscription-engine/dist/src/subscriptions.d.ts +19 -0
- package/packages/subscription-engine/dist/src/subscriptions.js +39 -0
- package/packages/subscription-engine/dist/src/types.d.ts +24 -0
- package/packages/subscription-engine/dist/src/types.js +5 -0
- package/packages/subscription-engine/src/engine.ts +55 -0
- package/packages/subscription-engine/src/index.ts +6 -0
- package/packages/subscription-engine/src/subscriptions.ts +55 -0
- package/packages/subscription-engine/src/types.ts +27 -0
- package/packages/task-compiler/src/command-policy.ts +193 -0
- package/packages/task-compiler/src/compiler.ts +114 -0
- package/packages/task-compiler/src/decompose.ts +265 -0
- package/packages/task-compiler/src/file-scope.ts +240 -0
- package/packages/task-compiler/src/graph.ts +144 -0
- package/packages/task-compiler/src/index.ts +38 -0
- package/packages/task-compiler/src/types.ts +225 -0
- package/packages/task-compiler/src/validate.ts +218 -0
- package/packages/task-compiler/src/verification.ts +248 -0
- package/packages/tencentdb-memory/src/client.ts +130 -0
- package/packages/tencentdb-memory/src/index.ts +32 -0
- package/packages/tencentdb-memory/src/loader.ts +150 -0
- package/packages/tencentdb-memory/src/mcp-tools.ts +213 -0
- package/packages/tencentdb-memory/src/types.ts +101 -0
- package/packages/tencentdb-sync/src/cli.ts +363 -0
- package/packages/tencentdb-sync/src/client.ts +268 -0
- package/packages/tencentdb-sync/src/config.ts +139 -0
- package/packages/tencentdb-sync/src/index.ts +15 -0
- package/packages/test-data-generator/src/faker-adapter.ts +657 -0
- package/packages/test-data-generator/src/generator.ts +461 -0
- package/packages/test-data-generator/src/index.ts +48 -0
- package/packages/test-data-generator/src/types.ts +421 -0
- package/packages/test-generator/src/generator.ts +144 -0
- package/packages/test-generator/src/index.ts +11 -0
- package/packages/test-generator/src/types.ts +39 -0
- package/packages/todo-bd-sync/src/detector.ts +171 -0
- package/packages/todo-bd-sync/src/extension.ts +129 -0
- package/packages/todo-bd-sync/src/index.ts +401 -0
- package/packages/todo-bd-sync/src/sync.ts +322 -0
- package/packages/todo-bd-sync/src/task-analyzer.ts +314 -0
- package/packages/todo-bd-sync/src/todo-reminder.ts +418 -0
- package/packages/todo-bd-sync/src/types.ts +137 -0
- package/packages/token-estimation/src/index.ts +192 -0
- package/packages/token-optimizer/src/index.ts +15 -0
- package/packages/token-optimizer/src/optimizer.ts +150 -0
- package/packages/token-optimizer/src/types.ts +47 -0
- package/packages/types/src/agent-worker-types.d.ts +206 -0
- package/packages/types/src/agent-worker-types.js +41 -0
- package/packages/types/src/agent-worker-types.ts +264 -0
- package/packages/types/src/ai-providers.d.ts +36 -0
- package/packages/types/src/ai-providers.js +66 -0
- package/packages/types/src/ai-providers.ts +73 -0
- package/packages/types/src/runtime-types.d.ts +418 -0
- package/packages/types/src/runtime-types.js +3 -0
- package/packages/types/src/runtime-types.ts +588 -0
- package/packages/workflow-events/dist/src/events.d.ts +38 -0
- package/packages/workflow-events/dist/src/events.js +55 -0
- package/packages/workflow-events/dist/src/index.d.ts +2 -0
- package/packages/workflow-events/dist/src/index.js +2 -0
- package/packages/workflow-events/dist/src/pipeline.d.ts +21 -0
- package/packages/workflow-events/dist/src/pipeline.js +36 -0
- package/packages/workflow-events/dist/src/types.d.ts +110 -0
- package/packages/workflow-events/dist/src/types.js +5 -0
- package/packages/workflow-events/src/events.ts +86 -0
- package/packages/workflow-events/src/index.ts +19 -0
- package/packages/workflow-events/src/pipeline.ts +41 -0
- package/packages/workflow-events/src/types.d.ts +110 -0
- package/packages/workflow-events/src/types.js +5 -0
- package/packages/workflow-events/src/types.ts +139 -0
- package/packages/workspace-scanner/dist/src/detect.d.ts +3 -0
- package/packages/workspace-scanner/dist/src/detect.js +60 -0
- package/packages/workspace-scanner/dist/src/git.d.ts +7 -0
- package/packages/workspace-scanner/dist/src/git.js +75 -0
- package/packages/workspace-scanner/dist/src/index.d.ts +5 -0
- package/packages/workspace-scanner/dist/src/index.js +4 -0
- package/packages/workspace-scanner/dist/src/scanner.d.ts +11 -0
- package/packages/workspace-scanner/dist/src/scanner.js +59 -0
- package/packages/workspace-scanner/dist/src/types.d.ts +35 -0
- package/packages/workspace-scanner/dist/src/types.js +5 -0
- package/packages/workspace-scanner/src/detect.ts +77 -0
- package/packages/workspace-scanner/src/git.ts +83 -0
- package/packages/workspace-scanner/src/index.ts +9 -0
- package/packages/workspace-scanner/src/scanner.ts +73 -0
- package/packages/workspace-scanner/src/types.ts +48 -0
- package/packages/worktree/dist/src/index.d.ts +7 -0
- package/packages/worktree/dist/src/index.js +7 -0
- package/packages/worktree/dist/src/worktree.d.ts +88 -0
- package/packages/worktree/dist/src/worktree.js +239 -0
- package/packages/worktree/src/index.ts +7 -0
- package/packages/worktree/src/worktree.ts +290 -0
- package/packages/write-review/src/blackboard.ts +249 -0
- package/packages/write-review/src/gate.ts +169 -0
- package/packages/write-review/src/index.ts +18 -0
- package/packages/write-review/src/injection.ts +170 -0
- package/packages/write-review/src/review.ts +206 -0
- package/packages/write-review/src/trigger.ts +133 -0
- package/packages/write-review/src/types.ts +90 -0
- package/proactive-compact.ts +90 -0
- package/prompts/tencentdb-connect.md +35 -0
- package/prompts/tencentdb-setup.md +101 -0
- package/prompts/tencentdb.md +88 -0
- package/renderer.ts +205 -0
- package/skills/harness-runtime/SKILL.md +237 -0
- package/status-parsers.ts +84 -0
- package/tracker.ts +72 -0
- package/windows.ts +121 -0
|
@@ -0,0 +1,266 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Task Inbox — RFC-0101 §2
|
|
3
|
+
*
|
|
4
|
+
* Append-only durable store for TaskRecords backed by `tasks.jsonl`.
|
|
5
|
+
* One JSONL line per task — easy to tail, grep, and replay.
|
|
6
|
+
*/
|
|
7
|
+
import {
|
|
8
|
+
appendFileSync,
|
|
9
|
+
existsSync,
|
|
10
|
+
mkdirSync,
|
|
11
|
+
readFileSync,
|
|
12
|
+
writeFileSync,
|
|
13
|
+
} from "node:fs";
|
|
14
|
+
import { dirname } from "node:path";
|
|
15
|
+
import type { TaskRecord, TaskStatus, TaskEvent } from "./types.js";
|
|
16
|
+
import { getInboxDir, getTasksPath } from "./types.js";
|
|
17
|
+
|
|
18
|
+
// --- Errors -------------------------------------------------------------------
|
|
19
|
+
|
|
20
|
+
export class InboxError extends Error {
|
|
21
|
+
constructor(msg: string) {
|
|
22
|
+
super(`[InboxError] ${msg}`);
|
|
23
|
+
this.name = "InboxError";
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
// --- TaskInbox ----------------------------------------------------------------
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Manages the append-only task inbox at `~/.pi/harness/inbox/tasks.jsonl`.
|
|
31
|
+
*
|
|
32
|
+
* Storage layout:
|
|
33
|
+
* ```
|
|
34
|
+
* ~/.pi/harness/inbox/
|
|
35
|
+
* +-- tasks.jsonl # append-only log (one JSON line per task)
|
|
36
|
+
* +-- claimed/ # active leases (one JSON file per task)
|
|
37
|
+
* +-- BACKLOG.md # human-friendly authoring surface (optional)
|
|
38
|
+
* ```
|
|
39
|
+
*
|
|
40
|
+
* Operations are:
|
|
41
|
+
* - **append** — append a new task to tasks.jsonl
|
|
42
|
+
* - **list** — read all tasks, filterable by status
|
|
43
|
+
* - **transition** — update a task's status in-place (rewrite)
|
|
44
|
+
* - **get** — read one task by id
|
|
45
|
+
* - **reindex** — compact tasks.jsonl by rewriting it from in-memory state
|
|
46
|
+
*/
|
|
47
|
+
export class TaskInbox {
|
|
48
|
+
private readonly tasksPath: string;
|
|
49
|
+
private readonly inboxDir: string;
|
|
50
|
+
private _cache: TaskRecord[] | null = null;
|
|
51
|
+
|
|
52
|
+
constructor(options: { tasksPath?: string; inboxDir?: string } = {}) {
|
|
53
|
+
this.inboxDir = options.inboxDir ?? getInboxDir();
|
|
54
|
+
this.tasksPath = options.tasksPath ?? getTasksPath();
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** Ensure the inbox directory exists. Call before any write. */
|
|
58
|
+
ensureDir(): void {
|
|
59
|
+
if (!existsSync(this.inboxDir)) {
|
|
60
|
+
mkdirSync(this.inboxDir, { recursive: true });
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
// --- append --------------------------------------------------------------
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Append a new task to tasks.jsonl.
|
|
68
|
+
* The task is validated before writing. Duplicate ids are rejected.
|
|
69
|
+
*
|
|
70
|
+
* @throws {InboxError} if the task id already exists or validation fails
|
|
71
|
+
*/
|
|
72
|
+
append(task: TaskRecord): void {
|
|
73
|
+
this.ensureDir();
|
|
74
|
+
|
|
75
|
+
// Guard against duplicate ids
|
|
76
|
+
const existing = this.list().find((t) => t.id === task.id);
|
|
77
|
+
if (existing) {
|
|
78
|
+
throw new InboxError(
|
|
79
|
+
`Task ${task.id} already exists in inbox (status=${existing.status})`,
|
|
80
|
+
);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
const line = JSON.stringify(task) + "\n";
|
|
84
|
+
appendFileSync(this.tasksPath, line, "utf8");
|
|
85
|
+
this._cache = null; // invalidate
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// --- list -----------------------------------------------------------------
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* Read all tasks from tasks.jsonl.
|
|
92
|
+
* Results are sorted by priority ASC then createdAt ASC (oldest first).
|
|
93
|
+
*
|
|
94
|
+
* @param filter Optionally filter by status. If omitted, returns all.
|
|
95
|
+
*/
|
|
96
|
+
list(filter?: { status?: TaskStatus | TaskStatus[] }): TaskRecord[] {
|
|
97
|
+
if (!existsSync(this.tasksPath)) {
|
|
98
|
+
return [];
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
const raw = readFileSync(this.tasksPath, "utf8");
|
|
102
|
+
const tasks: TaskRecord[] = [];
|
|
103
|
+
|
|
104
|
+
for (const line of raw.split("\n")) {
|
|
105
|
+
const trimmed = line.trim();
|
|
106
|
+
if (!trimmed) continue;
|
|
107
|
+
try {
|
|
108
|
+
const task = JSON.parse(trimmed) as TaskRecord;
|
|
109
|
+
tasks.push(task);
|
|
110
|
+
} catch {
|
|
111
|
+
// Corrupt line — skip but don't fail the whole list
|
|
112
|
+
console.warn(`[TaskInbox] Skipping corrupt line in ${this.tasksPath}`);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
// Filter by status
|
|
117
|
+
let filtered = tasks;
|
|
118
|
+
if (filter?.status !== undefined) {
|
|
119
|
+
const statuses = Array.isArray(filter.status)
|
|
120
|
+
? filter.status
|
|
121
|
+
: [filter.status];
|
|
122
|
+
filtered = tasks.filter((t) => statuses.includes(t.status));
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// Sort: priority ASC, then createdAt ASC
|
|
126
|
+
filtered.sort((a, b) => {
|
|
127
|
+
if (a.priority !== b.priority) return a.priority - b.priority;
|
|
128
|
+
return a.createdAt.localeCompare(b.createdAt);
|
|
129
|
+
});
|
|
130
|
+
|
|
131
|
+
return filtered;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
// --- get -----------------------------------------------------------------
|
|
135
|
+
|
|
136
|
+
/** Retrieve a single task by id, or null if not found. */
|
|
137
|
+
get(id: string): TaskRecord | null {
|
|
138
|
+
const tasks = this.list();
|
|
139
|
+
return tasks.find((t) => t.id === id) ?? null;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// --- transition ----------------------------------------------------------
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* Update a task's status in-place inside tasks.jsonl.
|
|
146
|
+
*
|
|
147
|
+
* Uses read→parse→update→rewrite to avoid corrupting the JSONL file.
|
|
148
|
+
* The rewrite is atomic (write-tmp-then-rename).
|
|
149
|
+
*
|
|
150
|
+
* @param taskId The id of the task to transition
|
|
151
|
+
* @param newStatus The target status
|
|
152
|
+
* @param extra Optional additional fields to merge into the task record
|
|
153
|
+
* @param event Optional TaskEvent to append to the history
|
|
154
|
+
* @throws {InboxError} if the task does not exist
|
|
155
|
+
*/
|
|
156
|
+
transition(
|
|
157
|
+
taskId: string,
|
|
158
|
+
newStatus: TaskStatus,
|
|
159
|
+
extra?: Partial<TaskRecord>,
|
|
160
|
+
event?: TaskEvent,
|
|
161
|
+
): TaskRecord {
|
|
162
|
+
if (!existsSync(this.tasksPath)) {
|
|
163
|
+
throw new InboxError(`tasks.jsonl does not exist at ${this.tasksPath}`);
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
const tasks = this.list();
|
|
167
|
+
const idx = tasks.findIndex((t) => t.id === taskId);
|
|
168
|
+
if (idx === -1) {
|
|
169
|
+
throw new InboxError(`Task ${taskId} not found in inbox`);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
const updated: TaskRecord = {
|
|
173
|
+
...tasks[idx],
|
|
174
|
+
...extra,
|
|
175
|
+
status: newStatus,
|
|
176
|
+
updatedAt: new Date().toISOString(),
|
|
177
|
+
history: event
|
|
178
|
+
? [...tasks[idx].history, event]
|
|
179
|
+
: [
|
|
180
|
+
...tasks[idx].history,
|
|
181
|
+
{
|
|
182
|
+
ts: new Date().toISOString(),
|
|
183
|
+
kind: "transitioned",
|
|
184
|
+
payload: { from: tasks[idx].status, to: newStatus },
|
|
185
|
+
},
|
|
186
|
+
],
|
|
187
|
+
};
|
|
188
|
+
|
|
189
|
+
// Rewrite tasks.jsonl atomically
|
|
190
|
+
this._rewriteAll([
|
|
191
|
+
...tasks.slice(0, idx),
|
|
192
|
+
updated,
|
|
193
|
+
...tasks.slice(idx + 1),
|
|
194
|
+
]);
|
|
195
|
+
this._cache = null;
|
|
196
|
+
|
|
197
|
+
return updated;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
// --- markDone / markFailed -----------------------------------------------
|
|
201
|
+
|
|
202
|
+
/** Convenience: mark a task as completed with a result. */
|
|
203
|
+
complete(taskId: string, result: TaskRecord["result"]): TaskRecord {
|
|
204
|
+
return this.transition(
|
|
205
|
+
taskId,
|
|
206
|
+
"completed",
|
|
207
|
+
{ result },
|
|
208
|
+
{
|
|
209
|
+
ts: new Date().toISOString(),
|
|
210
|
+
kind: "completed",
|
|
211
|
+
payload: { result },
|
|
212
|
+
},
|
|
213
|
+
);
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
/** Convenience: mark a task as failed with a reason. */
|
|
217
|
+
fail(taskId: string, reason: string): TaskRecord {
|
|
218
|
+
const task = this.get(taskId);
|
|
219
|
+
const attempts = (task?.attempts ?? 0) + 1;
|
|
220
|
+
const newStatus =
|
|
221
|
+
attempts >= (task?.maxAttempts ?? 3) ? "dead_letter" : "retrying";
|
|
222
|
+
return this.transition(
|
|
223
|
+
taskId,
|
|
224
|
+
newStatus,
|
|
225
|
+
{ failureReason: reason, attempts },
|
|
226
|
+
{
|
|
227
|
+
ts: new Date().toISOString(),
|
|
228
|
+
kind: newStatus === "dead_letter" ? "dead_lettered" : "failed",
|
|
229
|
+
payload: { reason, attempts },
|
|
230
|
+
},
|
|
231
|
+
);
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
// --- reindex -------------------------------------------------------------
|
|
235
|
+
|
|
236
|
+
/** Rewrite tasks.jsonl from the given task list. */
|
|
237
|
+
private _rewriteAll(tasks: TaskRecord[]): void {
|
|
238
|
+
const tmp = `${this.tasksPath}.tmp`;
|
|
239
|
+
const content = tasks.map((t) => JSON.stringify(t)).join("\n") + "\n";
|
|
240
|
+
writeFileSync(tmp, content, "utf8");
|
|
241
|
+
// Atomic rename (POSIX guarantees atomicity)
|
|
242
|
+
// Bun/Node will use the native rename which is atomic on POSIX
|
|
243
|
+
const { renameSync } = require("node:fs");
|
|
244
|
+
renameSync(tmp, this.tasksPath);
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/** Force a full reindex. Call after manual edits to tasks.jsonl. */
|
|
248
|
+
reindex(): void {
|
|
249
|
+
if (!existsSync(this.tasksPath)) return;
|
|
250
|
+
const tasks = this.list(); // reads and validates
|
|
251
|
+
this._rewriteAll(tasks);
|
|
252
|
+
this._cache = null;
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
// --- count ---------------------------------------------------------------
|
|
256
|
+
|
|
257
|
+
/** Return counts of tasks grouped by status. */
|
|
258
|
+
stats(): Record<TaskStatus, number> {
|
|
259
|
+
const tasks = this.list();
|
|
260
|
+
const counts: Record<string, number> = {};
|
|
261
|
+
for (const t of tasks) {
|
|
262
|
+
counts[t.status] = (counts[t.status] ?? 0) + 1;
|
|
263
|
+
}
|
|
264
|
+
return counts as Record<TaskStatus, number>;
|
|
265
|
+
}
|
|
266
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Autonomous Operations Runtime — Public API
|
|
3
|
+
*
|
|
4
|
+
* Phase 1 exports (RFC-0101 §1-2):
|
|
5
|
+
* - TaskRecord, TaskLease, TaskEvent, TaskStatus, CapabilityName, ApprovalClass types
|
|
6
|
+
* - TaskInbox: append, list, get, transition, complete, fail
|
|
7
|
+
* - LeaseManager: claim, heartbeat, release, reap, recoverOnStartup
|
|
8
|
+
*
|
|
9
|
+
* Phase 2+ exports (added as implemented):
|
|
10
|
+
* - Worker lifecycle (worker.ts)
|
|
11
|
+
* - Privilege broker (privilege-broker package)
|
|
12
|
+
* - Scheduler adapter (scheduler-adapter package)
|
|
13
|
+
*/
|
|
14
|
+
export * from "./types.js";
|
|
15
|
+
export { TaskInbox, InboxError } from "./inbox.js";
|
|
16
|
+
export {
|
|
17
|
+
LeaseManager,
|
|
18
|
+
LeaseError,
|
|
19
|
+
DEFAULT_LEASE_TTL_MS,
|
|
20
|
+
HEARTBEAT_INTERVAL_MS,
|
|
21
|
+
HEARTBEAT_EXTENSION_MS,
|
|
22
|
+
} from "./lease.js";
|
|
@@ -0,0 +1,318 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Lease Manager — RFC-0101 §4
|
|
3
|
+
*
|
|
4
|
+
* Manages task leases on disk using atomic write-tmp-then-rename.
|
|
5
|
+
* This prevents double-execution when two workers claim the same task concurrently.
|
|
6
|
+
*
|
|
7
|
+
* Filesystem layout:
|
|
8
|
+
* ```
|
|
9
|
+
* ~/.pi/harness/inbox/
|
|
10
|
+
* +-- tasks.jsonl # task records
|
|
11
|
+
* +-- claimed/
|
|
12
|
+
* +-- <task-id>.lease.json # one lease file per claimed task
|
|
13
|
+
* ```
|
|
14
|
+
*
|
|
15
|
+
* Safety properties:
|
|
16
|
+
* - Claiming is single-execution: POSIX rename is atomic, so only one writer wins.
|
|
17
|
+
* - A worker that dies: its lease expires, the reaper releases it back to queued.
|
|
18
|
+
* - On startup, recoverOrphanLeases() cleans up any stale leases.
|
|
19
|
+
*/
|
|
20
|
+
import {
|
|
21
|
+
closeSync,
|
|
22
|
+
existsSync,
|
|
23
|
+
mkdirSync,
|
|
24
|
+
openSync,
|
|
25
|
+
readFileSync,
|
|
26
|
+
readdirSync,
|
|
27
|
+
renameSync,
|
|
28
|
+
unlinkSync,
|
|
29
|
+
writeFileSync,
|
|
30
|
+
writeSync,
|
|
31
|
+
} from "node:fs";
|
|
32
|
+
import { join } from "node:path";
|
|
33
|
+
import type { TaskLease } from "./types.js";
|
|
34
|
+
import { getLeasesDir } from "./types.js";
|
|
35
|
+
|
|
36
|
+
// --- Errors -------------------------------------------------------------------
|
|
37
|
+
|
|
38
|
+
export class LeaseError extends Error {
|
|
39
|
+
constructor(msg: string) {
|
|
40
|
+
super(`[LeaseError] ${msg}`);
|
|
41
|
+
this.name = "LeaseError";
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// --- Constants ----------------------------------------------------------------
|
|
46
|
+
|
|
47
|
+
/** Default lease duration before heartbeat extension is required. */
|
|
48
|
+
export const DEFAULT_LEASE_TTL_MS = 30_000; // 30 s
|
|
49
|
+
|
|
50
|
+
/** Heartbeat interval sent by the worker. */
|
|
51
|
+
export const HEARTBEAT_INTERVAL_MS = 5_000; // 5 s
|
|
52
|
+
|
|
53
|
+
/** Default worker heartbeat interval extension. */
|
|
54
|
+
export const HEARTBEAT_EXTENSION_MS = 30_000; // extend by 30 s
|
|
55
|
+
|
|
56
|
+
// --- LeaseManager -------------------------------------------------------------
|
|
57
|
+
|
|
58
|
+
export interface LeaseOptions {
|
|
59
|
+
leasesDir?: string;
|
|
60
|
+
/** TTL in ms for new leases. Default: DEFAULT_LEASE_TTL_MS */
|
|
61
|
+
leaseTtlMs?: number;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Manages task leases on disk using atomic write-tmp-then-rename.
|
|
66
|
+
*/
|
|
67
|
+
export class LeaseManager {
|
|
68
|
+
private readonly leasesDir: string;
|
|
69
|
+
private readonly leaseTtlMs: number;
|
|
70
|
+
|
|
71
|
+
constructor(options: LeaseOptions = {}) {
|
|
72
|
+
this.leasesDir = options.leasesDir ?? getLeasesDir();
|
|
73
|
+
this.leaseTtlMs = options.leaseTtlMs ?? DEFAULT_LEASE_TTL_MS;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** Ensure the claimed/ directory exists. */
|
|
77
|
+
ensureDir(): void {
|
|
78
|
+
if (!existsSync(this.leasesDir)) {
|
|
79
|
+
mkdirSync(this.leasesDir, { recursive: true });
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
// --- claim ---------------------------------------------------------------
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Atomically claim a task for a worker.
|
|
87
|
+
*
|
|
88
|
+
* Algorithm:
|
|
89
|
+
* 1. Write lease to a temp file in the same directory (same filesystem → fast rename)
|
|
90
|
+
* 2. Attempt atomic rename to `claimed/<taskId>.lease.json`
|
|
91
|
+
* 3. If rename fails (EEXIST) → another worker won → return null
|
|
92
|
+
*
|
|
93
|
+
* @param taskId The task to claim
|
|
94
|
+
* @param workerId The worker claiming it
|
|
95
|
+
* @param attempt Which attempt number (for retry)
|
|
96
|
+
* @returns The TaskLease if won, null if another worker claimed first
|
|
97
|
+
*/
|
|
98
|
+
claim(taskId: string, workerId: string, attempt = 1): TaskLease | null {
|
|
99
|
+
this.ensureDir();
|
|
100
|
+
|
|
101
|
+
const now = new Date().toISOString();
|
|
102
|
+
const expiresAt = new Date(Date.now() + this.leaseTtlMs).toISOString();
|
|
103
|
+
const lease: TaskLease = {
|
|
104
|
+
taskId,
|
|
105
|
+
workerId,
|
|
106
|
+
acquiredAt: now,
|
|
107
|
+
expiresAt,
|
|
108
|
+
heartbeatAt: now,
|
|
109
|
+
attempt,
|
|
110
|
+
};
|
|
111
|
+
|
|
112
|
+
const targetPath = this._leasePath(taskId);
|
|
113
|
+
|
|
114
|
+
// Use open() with O_CREAT | O_EXCL — this is atomic and fails immediately
|
|
115
|
+
// if another worker has already created the lease file. No tmp file needed.
|
|
116
|
+
let fd: number;
|
|
117
|
+
try {
|
|
118
|
+
fd = openSync(targetPath, "wx", 0o644); // mode 0644 = rw-r--r--
|
|
119
|
+
} catch (err: unknown) {
|
|
120
|
+
const code = (err as NodeJS.ErrnoException).code;
|
|
121
|
+
if (code === "EEXIST") {
|
|
122
|
+
return null; // another worker already claimed
|
|
123
|
+
}
|
|
124
|
+
throw err;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
try {
|
|
128
|
+
writeSync(fd, JSON.stringify(lease) + "\n");
|
|
129
|
+
closeSync(fd);
|
|
130
|
+
return lease;
|
|
131
|
+
} catch (err: unknown) {
|
|
132
|
+
try {
|
|
133
|
+
closeSync(fd);
|
|
134
|
+
} catch {
|
|
135
|
+
/* ignore */
|
|
136
|
+
}
|
|
137
|
+
try {
|
|
138
|
+
unlinkSync(targetPath);
|
|
139
|
+
} catch {
|
|
140
|
+
/* ignore */
|
|
141
|
+
}
|
|
142
|
+
throw err;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
// --- heartbeat ------------------------------------------------------------
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* Extend a lease's expiry time.
|
|
150
|
+
* Only the worker that holds the lease can extend it.
|
|
151
|
+
*
|
|
152
|
+
* @returns Updated lease, or null if the lease no longer exists
|
|
153
|
+
*/
|
|
154
|
+
heartbeat(taskId: string, workerId: string): TaskLease | null {
|
|
155
|
+
const lease = this.get(taskId);
|
|
156
|
+
if (!lease) return null;
|
|
157
|
+
if (lease.workerId !== workerId) {
|
|
158
|
+
throw new LeaseError(
|
|
159
|
+
`Worker ${workerId} cannot heartbeat lease for ${taskId}: held by ${lease.workerId}`,
|
|
160
|
+
);
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
const updated: TaskLease = {
|
|
164
|
+
...lease,
|
|
165
|
+
heartbeatAt: new Date().toISOString(),
|
|
166
|
+
expiresAt: new Date(Date.now() + this.leaseTtlMs).toISOString(),
|
|
167
|
+
};
|
|
168
|
+
|
|
169
|
+
this._writeLease(updated);
|
|
170
|
+
return updated;
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
// --- release -------------------------------------------------------------
|
|
174
|
+
|
|
175
|
+
/**
|
|
176
|
+
* Explicitly release a lease (task completed or failed without retry).
|
|
177
|
+
*/
|
|
178
|
+
release(taskId: string, workerId: string): void {
|
|
179
|
+
const lease = this.get(taskId);
|
|
180
|
+
if (!lease) return;
|
|
181
|
+
if (lease.workerId !== workerId) {
|
|
182
|
+
throw new LeaseError(
|
|
183
|
+
`Worker ${workerId} cannot release lease for ${taskId}: held by ${lease.workerId}`,
|
|
184
|
+
);
|
|
185
|
+
}
|
|
186
|
+
this._removeLease(taskId);
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
// --- get -----------------------------------------------------------------
|
|
190
|
+
|
|
191
|
+
/** Read a lease by taskId. Returns null if not found. */
|
|
192
|
+
get(taskId: string): TaskLease | null {
|
|
193
|
+
const path = this._leasePath(taskId);
|
|
194
|
+
if (!existsSync(path)) return null;
|
|
195
|
+
try {
|
|
196
|
+
return JSON.parse(readFileSync(path, "utf8")) as TaskLease;
|
|
197
|
+
} catch {
|
|
198
|
+
return null;
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
// --- isExpired ------------------------------------------------------------
|
|
203
|
+
|
|
204
|
+
/** Check if a lease has expired (expiresAt is in the past). */
|
|
205
|
+
isExpired(lease: TaskLease): boolean {
|
|
206
|
+
return new Date(lease.expiresAt).getTime() < Date.now();
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
// --- reap ----------------------------------------------------------------
|
|
210
|
+
|
|
211
|
+
/**
|
|
212
|
+
* Scan all leases and return the ones that have expired.
|
|
213
|
+
* Does NOT remove them — call reapAndRelease() to remove atomically.
|
|
214
|
+
*/
|
|
215
|
+
reap(): TaskLease[] {
|
|
216
|
+
if (!existsSync(this.leasesDir)) return [];
|
|
217
|
+
const now = Date.now();
|
|
218
|
+
const expired: TaskLease[] = [];
|
|
219
|
+
|
|
220
|
+
for (const filename of readdirSync(this.leasesDir)) {
|
|
221
|
+
if (!filename.endsWith(".lease.json")) continue;
|
|
222
|
+
const path = join(this.leasesDir, filename);
|
|
223
|
+
try {
|
|
224
|
+
const lease = JSON.parse(readFileSync(path, "utf8")) as TaskLease;
|
|
225
|
+
if (new Date(lease.expiresAt).getTime() < now) {
|
|
226
|
+
expired.push(lease);
|
|
227
|
+
}
|
|
228
|
+
} catch {
|
|
229
|
+
// Corrupt file — remove it
|
|
230
|
+
try {
|
|
231
|
+
unlinkSync(path);
|
|
232
|
+
} catch {
|
|
233
|
+
/* ignore */
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
return expired;
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/**
|
|
242
|
+
* Release all expired leases and return their taskIds.
|
|
243
|
+
* Idempotent — safe to call on every heartbeat interval.
|
|
244
|
+
*/
|
|
245
|
+
reapAndRelease(): string[] {
|
|
246
|
+
const expired = this.reap();
|
|
247
|
+
const released: string[] = [];
|
|
248
|
+
for (const lease of expired) {
|
|
249
|
+
try {
|
|
250
|
+
this._removeLease(lease.taskId);
|
|
251
|
+
released.push(lease.taskId);
|
|
252
|
+
} catch {
|
|
253
|
+
// Already removed — ignore
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
return released;
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
// --- recoverOrphanLeases -------------------------------------------------
|
|
260
|
+
|
|
261
|
+
/**
|
|
262
|
+
* On worker startup, release any leases held by dead workers.
|
|
263
|
+
* A lease is orphaned if its worker has not re-claimed it since startup.
|
|
264
|
+
*
|
|
265
|
+
* Strategy: remove all leases whose expiresAt has passed.
|
|
266
|
+
* Safe because the next claim will succeed (no other worker holds it).
|
|
267
|
+
*/
|
|
268
|
+
recoverOnStartup(): string[] {
|
|
269
|
+
return this.reapAndRelease();
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
// --- listActive -----------------------------------------------------------
|
|
273
|
+
|
|
274
|
+
/** Return all active (non-expired) leases. */
|
|
275
|
+
listActive(): TaskLease[] {
|
|
276
|
+
if (!existsSync(this.leasesDir)) return [];
|
|
277
|
+
const now = Date.now();
|
|
278
|
+
const active: TaskLease[] = [];
|
|
279
|
+
|
|
280
|
+
for (const filename of readdirSync(this.leasesDir)) {
|
|
281
|
+
if (!filename.endsWith(".lease.json")) continue;
|
|
282
|
+
const path = join(this.leasesDir, filename);
|
|
283
|
+
try {
|
|
284
|
+
const lease = JSON.parse(readFileSync(path, "utf8")) as TaskLease;
|
|
285
|
+
if (new Date(lease.expiresAt).getTime() >= now) {
|
|
286
|
+
active.push(lease);
|
|
287
|
+
}
|
|
288
|
+
} catch {
|
|
289
|
+
// Corrupt — remove
|
|
290
|
+
try {
|
|
291
|
+
unlinkSync(path);
|
|
292
|
+
} catch {
|
|
293
|
+
/* ignore */
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
return active;
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
// --- internals -----------------------------------------------------------
|
|
302
|
+
|
|
303
|
+
private _leasePath(taskId: string): string {
|
|
304
|
+
return join(this.leasesDir, `${taskId}.lease.json`);
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
private _writeLease(lease: TaskLease): void {
|
|
308
|
+
this.ensureDir();
|
|
309
|
+
const tmp = `${this._leasePath(lease.taskId)}.tmp`;
|
|
310
|
+
writeFileSync(tmp, JSON.stringify(lease), "utf8");
|
|
311
|
+
renameSync(tmp, this._leasePath(lease.taskId));
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
private _removeLease(taskId: string): void {
|
|
315
|
+
const path = this._leasePath(taskId);
|
|
316
|
+
if (existsSync(path)) unlinkSync(path);
|
|
317
|
+
}
|
|
318
|
+
}
|