@winspan/claude-forge 8.51.1 → 8.54.3
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/DEVELOPMENT.md +290 -221
- package/README.md +50 -8
- package/dist/cli/commands/skills.d.ts.map +1 -1
- package/dist/cli/commands/skills.js +121 -2
- package/dist/cli/commands/skills.js.map +1 -1
- package/dist/cli/init/hook-manager.d.ts +1 -1
- package/dist/cli/init/hook-manager.d.ts.map +1 -1
- package/dist/cli/init/hook-manager.js +1 -0
- package/dist/cli/init/hook-manager.js.map +1 -1
- package/dist/core/constants.d.ts +2 -0
- package/dist/core/constants.d.ts.map +1 -1
- package/dist/core/constants.js +4 -0
- package/dist/core/constants.js.map +1 -1
- package/dist/core/storage/events.d.ts.map +1 -1
- package/dist/core/storage/events.js +0 -1
- package/dist/core/storage/events.js.map +1 -1
- package/dist/core/storage/maintenance.d.ts +25 -3
- package/dist/core/storage/maintenance.d.ts.map +1 -1
- package/dist/core/storage/maintenance.js +33 -4
- package/dist/core/storage/maintenance.js.map +1 -1
- package/dist/core/storage/routing.d.ts +4 -0
- package/dist/core/storage/routing.d.ts.map +1 -1
- package/dist/core/storage/routing.js +10 -4
- package/dist/core/storage/routing.js.map +1 -1
- package/dist/core/storage/sessions.d.ts +17 -0
- package/dist/core/storage/sessions.d.ts.map +1 -1
- package/dist/core/storage/sessions.js +64 -0
- package/dist/core/storage/sessions.js.map +1 -1
- package/dist/core/storage/skills.d.ts +4 -0
- package/dist/core/storage/skills.d.ts.map +1 -1
- package/dist/core/storage/skills.js +10 -2
- package/dist/core/storage/skills.js.map +1 -1
- package/dist/core/storage/sqlite.d.ts +5 -0
- package/dist/core/storage/sqlite.d.ts.map +1 -1
- package/dist/core/storage/sqlite.js +6 -0
- package/dist/core/storage/sqlite.js.map +1 -1
- package/dist/core/storage/tasks.d.ts.map +1 -1
- package/dist/core/storage/tasks.js +2 -0
- package/dist/core/storage/tasks.js.map +1 -1
- package/dist/core/types.d.ts +7 -0
- package/dist/core/types.d.ts.map +1 -1
- package/dist/daemon/index.d.ts.map +1 -1
- package/dist/daemon/index.js +30 -5
- package/dist/daemon/index.js.map +1 -1
- package/dist/daemon/skill-sync.d.ts +21 -0
- package/dist/daemon/skill-sync.d.ts.map +1 -0
- package/dist/daemon/skill-sync.js +75 -0
- package/dist/daemon/skill-sync.js.map +1 -0
- package/dist/hooks/notification.sh +1 -1
- package/dist/hooks/post-tool-use.sh +1 -1
- package/dist/hooks/pre-tool-use.sh +1 -1
- package/dist/hooks/stop.sh +1 -1
- package/dist/hooks/user-prompt-submit.sh +1 -1
- package/dist/skills/official/code-simplifier.md +37 -1
- package/dist/skills/official/find-skills.md +120 -1
- package/dist/skills/official/official-api-design.md +14 -1
- package/dist/skills/official/official-architecture-decision.md +22 -1
- package/dist/skills/official/official-db-schema-design.md +19 -1
- package/dist/skills/official/official-debug.md +9 -1
- package/dist/skills/official/official-pr-review.md +1 -1
- package/dist/skills/official/official-security-hardening.md +7 -1
- package/dist/skills/official/planning-with-files.md +206 -2
- package/dist/skills/official/ui-ux-pro-max.md +88 -1
- package/dist/skills/official/webapp-testing.md +85 -1
- package/dist/skills/registry.d.ts +1 -1
- package/dist/skills/registry.d.ts.map +1 -1
- package/dist/skills/registry.js +15 -4
- package/dist/skills/registry.js.map +1 -1
- package/dist/skills/semantic-matcher.d.ts +4 -3
- package/dist/skills/semantic-matcher.d.ts.map +1 -1
- package/dist/skills/semantic-matcher.js +20 -22
- package/dist/skills/semantic-matcher.js.map +1 -1
- package/dist/skills/upgrade-engine.d.ts +93 -0
- package/dist/skills/upgrade-engine.d.ts.map +1 -0
- package/dist/skills/upgrade-engine.js +447 -0
- package/dist/skills/upgrade-engine.js.map +1 -0
- package/dist/skills/upgrade-prompt.d.ts +20 -0
- package/dist/skills/upgrade-prompt.d.ts.map +1 -0
- package/dist/skills/upgrade-prompt.js +75 -0
- package/dist/skills/upgrade-prompt.js.map +1 -0
- package/dist/web/analytics/weekly-report.d.ts.map +1 -1
- package/dist/web/analytics/weekly-report.js +21 -29
- package/dist/web/analytics/weekly-report.js.map +1 -1
- package/dist/web/routes/patch.d.ts.map +1 -1
- package/dist/web/routes/patch.js +32 -2
- package/dist/web/routes/patch.js.map +1 -1
- package/dist/web/routes/sessions.d.ts.map +1 -1
- package/dist/web/routes/sessions.js +9 -7
- package/dist/web/routes/sessions.js.map +1 -1
- package/dist/web/routes/trace.d.ts.map +1 -1
- package/dist/web/routes/trace.js +2 -3
- package/dist/web/routes/trace.js.map +1 -1
- package/dist/web/server.d.ts.map +1 -1
- package/dist/web/server.js +3 -2
- package/dist/web/server.js.map +1 -1
- package/package.json +12 -2
- package/scripts/postinstall.cjs +21 -0
- package/.claude/CLAUDE.md +0 -17
- package/.eslintrc.js +0 -23
- package/.prettierrc +0 -8
- package/ARCHITECTURE_ISSUES.md +0 -249
- package/CLAUDE.md +0 -265
- package/CLAUDE.md.backup +0 -488
- package/docs/concurrent-agents.md +0 -129
- package/docs/design/architecture-review-20260516.md +0 -232
- package/docs/design/fix-skills-data-and-set-leak-spec-20260516-1300.md +0 -219
- package/docs/design/h1-storage-aggregation-spec-20260518-1121.md +0 -299
- package/docs/design/h2-getdatabase-encapsulation-spec-20260518-1450.md +0 -191
- package/docs/design/h3-fallback-removal-spec-20260518-1245.md +0 -76
- package/docs/design/h4-index-dedup-spec-20260518-1230.md +0 -109
- package/docs/design/h6-services-migration-spec-20260518-1355.md +0 -82
- package/docs/design/hook-failure-queue-spec-20260516-1530.md +0 -204
- package/docs/design/l1-swarm-protocol-extract-spec-20260518-1605.md +0 -106
- package/docs/design/m10-forge-paths-spec-20260518-1320.md +0 -121
- package/docs/design/m2-m3-tool-input-spec-20260518-1425.md +0 -131
- package/docs/design/m7-routing-event-association-spec-20260518-1545.md +0 -103
- package/docs/design/project-path-gitroot-spec-20260518-1715.md +0 -134
- package/docs/design/refactor-phase1-spec-20260515-1600.md +0 -543
- package/docs/design/refactor-phase2-spec-20260515-1700.md +0 -424
- package/docs/design/task-active-gc-spec-20260518-1745.md +0 -146
- package/docs/design/tasks-list-filter-pagination-spec-20260518-0930.md +0 -208
- package/docs/implementation/fix-skills-data-and-set-leak-changelog-20260516-1300.md +0 -104
- package/docs/implementation/h1-storage-aggregation-changelog-20260518-1121.md +0 -82
- package/docs/implementation/h2-final-changelog-20260518-1530.md +0 -61
- package/docs/implementation/h2-phase1-safety-net-changelog-20260518-1450.md +0 -70
- package/docs/implementation/h2-phase2-operations-changelog-20260518-1450.md +0 -120
- package/docs/implementation/h2-phase3-callsites-changelog-20260518-1450.md +0 -71
- package/docs/implementation/h3-fallback-removal-changelog-20260518-1245.md +0 -71
- package/docs/implementation/h4-index-dedup-changelog-20260518-1230.md +0 -60
- package/docs/implementation/h6-services-migration-changelog-20260518-1355.md +0 -46
- package/docs/implementation/h7-m9-defaults-changelog-20260518-1300.md +0 -46
- package/docs/implementation/hook-failure-queue-changelog-20260516-1530.md +0 -196
- package/docs/implementation/hotfix-daemon-event-reject-20260516-1430.md +0 -56
- package/docs/implementation/l1-swarm-protocol-extract-changelog-20260518-1605.md +0 -45
- package/docs/implementation/l3-l4-daemon-perf-changelog-20260518-1410.md +0 -63
- package/docs/implementation/l6-l8-final-cleanup-changelog-20260518-1640.md +0 -38
- package/docs/implementation/m1-m4-m5-l7-cleanup-changelog-20260518-1310.md +0 -58
- package/docs/implementation/m10-forge-paths-changelog-20260518-1320.md +0 -60
- package/docs/implementation/m2-m3-tool-input-changelog-20260518-1425.md +0 -43
- package/docs/implementation/m6-m8-naming-shutdown-changelog-20260518-1340.md +0 -56
- package/docs/implementation/m7-routing-association-changelog-20260518-1545.md +0 -69
- package/docs/implementation/project-path-gitroot-changelog-20260518-1715.md +0 -63
- package/docs/implementation/refactor-phase1-changelog-20260515-1630.md +0 -354
- package/docs/implementation/refactor-phase2-changelog-20260515-1705.md +0 -421
- package/docs/implementation/task-active-gc-changelog-20260518-1745.md +0 -35
- package/docs/implementation/task-title-summary-changelog-20260518-1130.md +0 -39
- package/docs/implementation/tasks-detail-back-loses-filters-changelog-20260518-1100.md +0 -22
- package/docs/implementation/tasks-list-filter-pagination-changelog-20260518-0930.md +0 -72
- package/docs/implementation/tasks-page-white-screen-hotfix-changelog-20260518-1015.md +0 -56
- package/docs/reviews/claudemd-template-sync.md +0 -54
- package/docs/reviews/task-title-summary.md +0 -92
- package/docs/reviews/tasks-detail-back-loses-filters.md +0 -58
- package/docs/reviews/tasks-filter-pagination.md +0 -80
- package/docs/reviews/tasks-page-white-screen-hotfix.md +0 -126
- package/docs/ruflo-learning-strategy.md +0 -322
- package/docs/skills-deduplication-analysis.md +0 -83
- package/docs/skills-multiformat-support.md +0 -177
- package/docs/skills-third-party.md +0 -183
- package/docs/testing/tasks-filter-pagination-test-report.md +0 -86
- package/forge +0 -321
- package/playwright.config.ts +0 -40
- package/scripts/demo-v2.ts +0 -91
- package/scripts/dev-daemon.sh +0 -232
- package/scripts/dev-web.ts +0 -109
- package/scripts/e2e-mcp-link.ts +0 -423
- package/scripts/e2e-methodology-quality.ts +0 -253
- package/scripts/e2e-routing.ts +0 -456
- package/scripts/e2e-user-methodology.ts +0 -326
- package/scripts/e2e-web-workflows.ts +0 -299
- package/scripts/migrate-legacy-to-dynamic.sql +0 -108
- package/scripts/regenerate-execution-docs.ts +0 -116
- package/scripts/sync-agent-skills.ts +0 -193
- package/scripts/test-hook.sh +0 -71
- package/scripts/verify-skill-loading.ts +0 -62
- package/src/claudemd/claudemd-generator.ts +0 -568
- package/src/claudemd/convention-extractor.ts +0 -69
- package/src/claudemd/index.ts +0 -35
- package/src/claudemd/persona-manager.ts +0 -88
- package/src/claudemd/resume-manager.ts +0 -236
- package/src/claudemd/tech-detector.ts +0 -220
- package/src/claudemd/templates/swarm-protocol.md +0 -222
- package/src/cli/commands/claudemd.ts +0 -84
- package/src/cli/commands/config.ts +0 -46
- package/src/cli/commands/daemon.ts +0 -310
- package/src/cli/commands/executions.ts +0 -115
- package/src/cli/commands/init.ts +0 -204
- package/src/cli/commands/logs.ts +0 -181
- package/src/cli/commands/mcp.ts +0 -242
- package/src/cli/commands/menu.ts +0 -357
- package/src/cli/commands/skills.ts +0 -185
- package/src/cli/commands/stats.ts +0 -73
- package/src/cli/commands/status.ts +0 -69
- package/src/cli/commands/template.ts +0 -77
- package/src/cli/commands/trace.ts +0 -148
- package/src/cli/index.ts +0 -42
- package/src/cli/init/hook-manager.ts +0 -132
- package/src/core/ai/provider.ts +0 -308
- package/src/core/ai/types.ts +0 -51
- package/src/core/config.ts +0 -124
- package/src/core/constants.ts +0 -62
- package/src/core/event-fields.ts +0 -32
- package/src/core/queue/index.ts +0 -192
- package/src/core/storage/base.ts +0 -302
- package/src/core/storage/events.ts +0 -434
- package/src/core/storage/injections.ts +0 -78
- package/src/core/storage/maintenance.ts +0 -59
- package/src/core/storage/migrations/002_add_skill_tracking.sql +0 -6
- package/src/core/storage/migrations/003_add_skill_invocations.sql +0 -23
- package/src/core/storage/performance-indexes.sql +0 -23
- package/src/core/storage/routing.ts +0 -322
- package/src/core/storage/rows.ts +0 -112
- package/src/core/storage/schema.sql +0 -224
- package/src/core/storage/sessions.ts +0 -168
- package/src/core/storage/skills.ts +0 -233
- package/src/core/storage/sqlite.ts +0 -293
- package/src/core/storage/tasks.ts +0 -318
- package/src/core/storage/token-usage.ts +0 -93
- package/src/core/types.ts +0 -181
- package/src/core/utils/error-handler.ts +0 -257
- package/src/core/utils/forge-resume-block.ts +0 -74
- package/src/core/utils/format.ts +0 -69
- package/src/core/utils/git.ts +0 -23
- package/src/core/utils/logger.ts +0 -134
- package/src/core/utils/lru-cache.ts +0 -54
- package/src/core/utils/path.ts +0 -19
- package/src/core/utils/session.ts +0 -26
- package/src/core/utils/time.ts +0 -37
- package/src/core/utils/token-tracker.ts +0 -97
- package/src/daemon/event-parser.ts +0 -36
- package/src/daemon/handlers/history-exporter.ts +0 -117
- package/src/daemon/handlers/post-tool-use.ts +0 -54
- package/src/daemon/handlers/stop.ts +0 -208
- package/src/daemon/handlers/user-prompt.ts +0 -178
- package/src/daemon/hook-sync.ts +0 -91
- package/src/daemon/index.ts +0 -302
- package/src/daemon/launchd/com.claude-forge.daemon.plist.template +0 -47
- package/src/daemon/launchd-installer.ts +0 -260
- package/src/daemon/lifecycle.ts +0 -128
- package/src/daemon/router.ts +0 -40
- package/src/daemon/server.ts +0 -196
- package/src/daemon/services/task-segmenter.ts +0 -112
- package/src/hooks/hook-lib.sh +0 -118
- package/src/hooks/notification.sh +0 -35
- package/src/hooks/post-tool-use.sh +0 -61
- package/src/hooks/pre-tool-use.sh +0 -63
- package/src/hooks/stop.sh +0 -43
- package/src/hooks/user-prompt-submit.sh +0 -69
- package/src/mcp/server.ts +0 -322
- package/src/skills/index.ts +0 -2
- package/src/skills/invocation-guard.ts +0 -177
- package/src/skills/matcher.ts +0 -148
- package/src/skills/official/code-simplifier.md +0 -16
- package/src/skills/official/find-skills.md +0 -23
- package/src/skills/official/official-api-design.md +0 -17
- package/src/skills/official/official-architecture-decision.md +0 -20
- package/src/skills/official/official-bmad.md +0 -118
- package/src/skills/official/official-db-schema-design.md +0 -16
- package/src/skills/official/official-debug.md +0 -17
- package/src/skills/official/official-doc-driven.md +0 -31
- package/src/skills/official/official-harness-engineering.md +0 -108
- package/src/skills/official/official-performance-optimization.md +0 -30
- package/src/skills/official/official-pr-review.md +0 -35
- package/src/skills/official/official-release-checklist.md +0 -30
- package/src/skills/official/official-security-hardening.md +0 -26
- package/src/skills/official/official-spec-driven-design.md +0 -31
- package/src/skills/official/planning-with-files.md +0 -37
- package/src/skills/official/ui-ux-pro-max.md +0 -18
- package/src/skills/official/webapp-testing.md +0 -12
- package/src/skills/official-skills.ts +0 -89
- package/src/skills/registry.ts +0 -355
- package/src/skills/semantic-matcher.ts +0 -231
- package/src/skills/tools/pipeline-suggest.ts +0 -226
- package/src/skills/tools/skill-invoke.ts +0 -168
- package/src/skills/tools/skill-list.ts +0 -59
- package/src/templates/go.yaml +0 -53
- package/src/templates/python.yaml +0 -59
- package/src/templates/react.yaml +0 -55
- package/src/templates/template-manager.ts +0 -170
- package/src/web/analytics/anti-pattern-detector.ts +0 -367
- package/src/web/analytics/drift-detector.ts +0 -219
- package/src/web/analytics/weekly-report.ts +0 -431
- package/src/web/auth-middleware.ts +0 -54
- package/src/web/routes/_helpers.ts +0 -34
- package/src/web/routes/ai.ts +0 -204
- package/src/web/routes/auth.ts +0 -22
- package/src/web/routes/drift.ts +0 -25
- package/src/web/routes/error-handler.ts +0 -120
- package/src/web/routes/events.ts +0 -47
- package/src/web/routes/insights.ts +0 -43
- package/src/web/routes/patch.ts +0 -117
- package/src/web/routes/reports.ts +0 -34
- package/src/web/routes/rules.ts +0 -76
- package/src/web/routes/sessions.ts +0 -250
- package/src/web/routes/skill-stats.ts +0 -92
- package/src/web/routes/skills.ts +0 -350
- package/src/web/routes/static.ts +0 -67
- package/src/web/routes/stats.ts +0 -50
- package/src/web/routes/status.ts +0 -30
- package/src/web/routes/tasks.ts +0 -193
- package/src/web/routes/token-usage.ts +0 -20
- package/src/web/routes/trace.ts +0 -126
- package/src/web/routes/types.ts +0 -57
- package/src/web/server.ts +0 -134
- package/src/web/ssrf-guard.ts +0 -112
- package/src/web/static/index.html +0 -3251
- package/src/web/static/vendor/chart.umd.min.js +0 -20
- package/tests/e2e/dashboard.spec.ts +0 -205
- package/tests/e2e/routing-skill-e2e.test.ts +0 -39
- package/tests/helpers/mock-ai.ts +0 -92
- package/tests/helpers/mock-storage.ts +0 -159
- package/tests/integration/claudemd-generator.test.ts +0 -90
- package/tests/integration/queue-replay.integration.test.ts +0 -193
- package/tests/integration/tasks-filter.integration.test.ts +0 -154
- package/tests/integration/web-analytics.integration.test.ts +0 -133
- package/tests/integration/web-stats.integration.test.ts +0 -135
- package/tests/integration/web-trace.integration.test.ts +0 -175
- package/tests/performance/database.benchmark.ts +0 -161
- package/tests/semantic-matcher.test.ts +0 -99
- package/tests/skill-matcher.test.ts +0 -110
- package/tests/unit/ai-provider-retry.test.ts +0 -194
- package/tests/unit/ai-provider-vision.test.ts +0 -224
- package/tests/unit/claudemd-generator.test.ts +0 -68
- package/tests/unit/cli-mcp.test.ts +0 -141
- package/tests/unit/core/forge-paths.test.ts +0 -99
- package/tests/unit/daemon/hook-sync.test.ts +0 -71
- package/tests/unit/daemon/post-tool-use.test.ts +0 -121
- package/tests/unit/daemon/stop-handler-behavior-summary.test.ts +0 -202
- package/tests/unit/daemon/task-segmenter-recover.test.ts +0 -84
- package/tests/unit/event-fields.test.ts +0 -88
- package/tests/unit/event-parser.test.ts +0 -55
- package/tests/unit/handlers.test.ts +0 -171
- package/tests/unit/hooks/resolve-project-path.test.ts +0 -122
- package/tests/unit/invocation-guard.test.ts +0 -125
- package/tests/unit/queue.test.ts +0 -272
- package/tests/unit/router.test.ts +0 -138
- package/tests/unit/security.test.ts +0 -128
- package/tests/unit/skill-invocations-workflow.test.ts +0 -495
- package/tests/unit/skill-registry.test.ts +0 -94
- package/tests/unit/skills/invocation-guard-ttl.test.ts +0 -211
- package/tests/unit/skills/official-skills-loader.test.ts +0 -126
- package/tests/unit/skills/registry-multiformat.test.ts +0 -92
- package/tests/unit/socket-server.test.ts +0 -183
- package/tests/unit/storage/event-operations-aggregates.test.ts +0 -342
- package/tests/unit/storage/migration-idempotent.test.ts +0 -304
- package/tests/unit/storage/routing-aggregates.test.ts +0 -276
- package/tests/unit/storage/routing.test.ts +0 -117
- package/tests/unit/storage/schema-missing.test.ts +0 -81
- package/tests/unit/storage/session-operations-aggregates.test.ts +0 -120
- package/tests/unit/storage/sessions-aggregate.test.ts +0 -435
- package/tests/unit/storage/skill-operations-counts.test.ts +0 -106
- package/tests/unit/storage/skills-aggregates.test.ts +0 -104
- package/tests/unit/storage/sqlite-refactor-harness.test.ts +0 -314
- package/tests/unit/storage/task-operations-counts.test.ts +0 -46
- package/tests/unit/storage/tasks-getById.test.ts +0 -343
- package/tests/unit/storage/tasks-stale-gc.test.ts +0 -86
- package/tests/unit/storage.test.ts +0 -172
- package/tests/unit/token-usage.test.ts +0 -144
- package/tests/unit/type-guards.test.ts +0 -201
- package/tests/unit/utils/format.test.ts +0 -189
- package/tests/unit/utils/session.test.ts +0 -89
- package/tests/unit/utils/time.test.ts +0 -112
- package/tests/unit/web/navigation-back-contract.test.ts +0 -134
- package/tests/unit/web/routes-auth.test.ts +0 -93
- package/tests/unit/web/routes-events.test.ts +0 -101
- package/tests/unit/web/routes-rules.test.ts +0 -182
- package/tests/unit/web/routes-sessions.test.ts +0 -181
- package/tests/unit/web/routes-skill-stats.test.ts +0 -179
- package/tests/unit/web/routes-stats.test.ts +0 -92
- package/tests/unit/web/routes-tasks.test.ts +0 -385
- package/tests/unit/web/task-title-contract.test.ts +0 -210
- package/tests/unit/web/tasks-component-contract.test.ts +0 -179
- package/tsconfig.json +0 -22
- package/vitest.config.ts +0 -21
- package/vitest.integration.config.ts +0 -16
- package/web/CLAUDE.md +0 -20
- package/web/index.html +0 -13
- package/web/package-lock.json +0 -4854
- package/web/package.json +0 -35
- package/web/postcss.config.js +0 -6
- package/web/src/App.tsx +0 -110
- package/web/src/components/CodeBlock.tsx +0 -31
- package/web/src/components/Confirm.tsx +0 -96
- package/web/src/components/Drawer.tsx +0 -60
- package/web/src/components/Layout.tsx +0 -145
- package/web/src/components/MarkdownRenderer.tsx +0 -77
- package/web/src/components/SearchInput.tsx +0 -31
- package/web/src/components/SessionDetailContent.tsx +0 -157
- package/web/src/components/Toast.tsx +0 -92
- package/web/src/index.css +0 -19
- package/web/src/main.tsx +0 -31
- package/web/src/pages/AIConfig.tsx +0 -233
- package/web/src/pages/Dashboard.tsx +0 -572
- package/web/src/pages/Events.tsx +0 -271
- package/web/src/pages/Reports.tsx +0 -428
- package/web/src/pages/SessionDetail.tsx +0 -162
- package/web/src/pages/Sessions.tsx +0 -205
- package/web/src/pages/Skills.tsx +0 -180
- package/web/src/pages/TaskDetail.tsx +0 -515
- package/web/src/pages/Tasks.tsx +0 -415
- package/web/src/utils/auth.ts +0 -59
- package/web/src/utils/export.ts +0 -54
- package/web/src/utils/navigation.ts +0 -25
- package/web/src/utils/task-title.ts +0 -49
- package/web/src/utils/time.ts +0 -13
- package/web/tailwind.config.js +0 -11
- package/web/tsconfig.json +0 -21
- package/web/tsconfig.node.json +0 -10
- package/web/vite.config.ts +0 -76
- package/winspan-claude-forge-8.43.0.tgz +0 -0
package/src/daemon/hook-sync.ts
DELETED
|
@@ -1,91 +0,0 @@
|
|
|
1
|
-
import { existsSync, readFileSync, copyFileSync, chmodSync } from 'node:fs';
|
|
2
|
-
import { createHash } from 'node:crypto';
|
|
3
|
-
import { join, dirname } from 'node:path';
|
|
4
|
-
import { fileURLToPath } from 'node:url';
|
|
5
|
-
import { FORGE_PATHS } from '../core/constants.js';
|
|
6
|
-
import { logger } from '../core/utils/logger.js';
|
|
7
|
-
|
|
8
|
-
// All hook files to sync (5 hooks + shared lib)
|
|
9
|
-
const HOOK_FILES = [
|
|
10
|
-
'pre-tool-use.sh',
|
|
11
|
-
'post-tool-use.sh',
|
|
12
|
-
'user-prompt-submit.sh',
|
|
13
|
-
'notification.sh',
|
|
14
|
-
'stop.sh',
|
|
15
|
-
'hook-lib.sh',
|
|
16
|
-
];
|
|
17
|
-
|
|
18
|
-
function sha256(content: Buffer): string {
|
|
19
|
-
return createHash('sha256').update(content).digest('hex');
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
function getSourceHooksDir(): string {
|
|
23
|
-
// Compiled: dist/daemon/hook-sync.js → dist/hooks
|
|
24
|
-
// Dev (vitest): src/daemon/hook-sync.ts → src/hooks
|
|
25
|
-
return join(dirname(fileURLToPath(import.meta.url)), '..', 'hooks');
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
export interface SyncResult {
|
|
29
|
-
copied: number;
|
|
30
|
-
checked: number;
|
|
31
|
-
skipped: number;
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
/**
|
|
35
|
-
* Sync hooks from the package source (dist/hooks) to ~/.claude-forge/hooks/.
|
|
36
|
-
* Uses SHA-256 comparison to skip identical files.
|
|
37
|
-
*
|
|
38
|
-
* Accepts optional overrides for source/target dirs — used in unit tests.
|
|
39
|
-
* Any failure logs a warning and continues; never throws.
|
|
40
|
-
*/
|
|
41
|
-
export function syncHooks(opts?: { sourceDir?: string; targetDir?: string }): SyncResult {
|
|
42
|
-
const result: SyncResult = { copied: 0, checked: 0, skipped: 0 };
|
|
43
|
-
const sourceDir = opts?.sourceDir ?? getSourceHooksDir();
|
|
44
|
-
const targetDir = opts?.targetDir ?? FORGE_PATHS.hooks();
|
|
45
|
-
|
|
46
|
-
if (!existsSync(sourceDir)) {
|
|
47
|
-
logger.warn(`[HookSync] source hooks dir not found at ${sourceDir}, skipping`);
|
|
48
|
-
return result;
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
if (!existsSync(targetDir)) {
|
|
52
|
-
// User has not run `claude-forge init` yet — skip silently
|
|
53
|
-
logger.debug(`[HookSync] target dir not found: ${targetDir} (user may not have run \`claude-forge init\`)`);
|
|
54
|
-
return result;
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
for (const file of HOOK_FILES) {
|
|
58
|
-
const src = join(sourceDir, file);
|
|
59
|
-
const dest = join(targetDir, file);
|
|
60
|
-
|
|
61
|
-
if (!existsSync(src)) {
|
|
62
|
-
result.skipped++;
|
|
63
|
-
continue;
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
result.checked++;
|
|
67
|
-
|
|
68
|
-
try {
|
|
69
|
-
const srcContent = readFileSync(src);
|
|
70
|
-
if (existsSync(dest)) {
|
|
71
|
-
const destContent = readFileSync(dest);
|
|
72
|
-
if (sha256(srcContent) === sha256(destContent)) {
|
|
73
|
-
continue; // identical — no copy needed
|
|
74
|
-
}
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
copyFileSync(src, dest);
|
|
78
|
-
chmodSync(dest, 0o755);
|
|
79
|
-
result.copied++;
|
|
80
|
-
logger.info(`[HookSync] updated ${file}`);
|
|
81
|
-
} catch (err) {
|
|
82
|
-
logger.warn(`[HookSync] failed to sync ${file}: ${err instanceof Error ? err.message : String(err)}`);
|
|
83
|
-
}
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
if (result.copied > 0) {
|
|
87
|
-
logger.info(`[HookSync] synced ${result.copied}/${result.checked} hook files`);
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
return result;
|
|
91
|
-
}
|
package/src/daemon/index.ts
DELETED
|
@@ -1,302 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Daemon entry point — starts the Forge daemon process
|
|
3
|
-
*
|
|
4
|
-
* Responsibilities:
|
|
5
|
-
* 1. Load config and initialize logging
|
|
6
|
-
* 2. Manage lifecycle (PID, socket, auth token)
|
|
7
|
-
* 3. Initialize storage, AI provider, and core services
|
|
8
|
-
* 4. Create event handlers and start socket server
|
|
9
|
-
* 5. Handle graceful shutdown
|
|
10
|
-
*/
|
|
11
|
-
|
|
12
|
-
import { SocketServer } from './server.js';
|
|
13
|
-
import {
|
|
14
|
-
writePidFile,
|
|
15
|
-
removePidFile,
|
|
16
|
-
cleanSocket,
|
|
17
|
-
getSocketPath,
|
|
18
|
-
writeAuthToken,
|
|
19
|
-
syncMcpToken,
|
|
20
|
-
removeAuthToken,
|
|
21
|
-
} from './lifecycle.js';
|
|
22
|
-
import { routeEvent, type Handlers } from './router.js';
|
|
23
|
-
import { logger } from '../core/utils/logger.js';
|
|
24
|
-
import { ConfigManager } from '../core/config.js';
|
|
25
|
-
import { SQLiteStorage } from '../core/storage/sqlite.js';
|
|
26
|
-
import { expandPath } from '../core/utils/path.js';
|
|
27
|
-
import { ClaudeProvider } from '../core/ai/provider.js';
|
|
28
|
-
import { TaskSegmenter } from './services/task-segmenter.js';
|
|
29
|
-
import { SkillRegistry } from '../skills/registry.js';
|
|
30
|
-
import { InvocationGuard } from '../skills/invocation-guard.js';
|
|
31
|
-
import { HistoryExporter } from './handlers/history-exporter.js';
|
|
32
|
-
import { ResumeManager } from '../claudemd/resume-manager.js';
|
|
33
|
-
import { ConventionExtractor } from '../claudemd/convention-extractor.js';
|
|
34
|
-
import { UserPromptHandler } from './handlers/user-prompt.js';
|
|
35
|
-
import { PostToolUseHandler } from './handlers/post-tool-use.js';
|
|
36
|
-
import { StopHandler } from './handlers/stop.js';
|
|
37
|
-
import { syncHooks } from './hook-sync.js';
|
|
38
|
-
import { replayQueue } from '../core/queue/index.js';
|
|
39
|
-
import { DEFAULTS } from '../core/constants.js';
|
|
40
|
-
import type { ForgeEvent } from '../core/types.js';
|
|
41
|
-
import { getUserPrompt } from '../core/event-fields.js';
|
|
42
|
-
import type { HookResponse } from './server.js';
|
|
43
|
-
|
|
44
|
-
export interface DaemonOptions {
|
|
45
|
-
/** Whether to enable the web server (default: use config value) */
|
|
46
|
-
web?: boolean;
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
export async function startDaemon(foreground: boolean = false, options: DaemonOptions = {}): Promise<void> {
|
|
50
|
-
// ── 0. Global Exception Handlers ───────────────────────────────────────────
|
|
51
|
-
process.on('uncaughtException', (err) => {
|
|
52
|
-
logger.error(`[Daemon] Uncaught exception: ${err.message}`);
|
|
53
|
-
logger.error(err.stack || '');
|
|
54
|
-
// Don't exit — let daemon continue running
|
|
55
|
-
});
|
|
56
|
-
|
|
57
|
-
process.on('unhandledRejection', (reason, promise) => {
|
|
58
|
-
logger.error(`[Daemon] Unhandled rejection at ${promise}: ${reason}`);
|
|
59
|
-
});
|
|
60
|
-
|
|
61
|
-
// ── 1. Config & Logging ────────────────────────────────────────────────────
|
|
62
|
-
// Log level is auto-parsed from LOG_LEVEL env var at logger module load time.
|
|
63
|
-
const config = new ConfigManager().get();
|
|
64
|
-
logger.info('Claude Forge daemon starting...');
|
|
65
|
-
|
|
66
|
-
// ── 2. Lifecycle (PID, socket, auth token) ─────────────────────────────────
|
|
67
|
-
cleanSocket();
|
|
68
|
-
writePidFile();
|
|
69
|
-
const authToken = writeAuthToken();
|
|
70
|
-
logger.info('[Security] Auth token generated');
|
|
71
|
-
syncMcpToken(authToken, config.web?.port ?? DEFAULTS.WEB_PORT);
|
|
72
|
-
|
|
73
|
-
// ── 3. Storage ─────────────────────────────────────────────────────────────
|
|
74
|
-
const dbPath = expandPath(config.storage.path);
|
|
75
|
-
const storage = new SQLiteStorage(dbPath);
|
|
76
|
-
logger.info(`Storage initialized: ${dbPath}`);
|
|
77
|
-
|
|
78
|
-
// ── 3.5. Auto-sync hooks ────────────────────────────────────────────────
|
|
79
|
-
// npm upgrade 不会自动更新 ~/.claude-forge/hooks/,每次 daemon 启动
|
|
80
|
-
// 用 SHA-256 比对源 dist/hooks 与本地副本,不一致则覆盖。
|
|
81
|
-
try {
|
|
82
|
-
syncHooks();
|
|
83
|
-
} catch (err) {
|
|
84
|
-
logger.warn(`[HookSync] unexpected error: ${err}`);
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
// ── 4. AI Provider ─────────────────────────────────────────────────────────
|
|
88
|
-
const apiKey = config.ai.api_key || process.env.ANTHROPIC_API_KEY || '';
|
|
89
|
-
if (!apiKey) {
|
|
90
|
-
logger.warn('No API key configured — AI features disabled');
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
const ai = apiKey
|
|
94
|
-
? new ClaudeProvider(apiKey, config.ai.model, config.ai.base_url)
|
|
95
|
-
: null;
|
|
96
|
-
|
|
97
|
-
// ── 5. Initialize services ─────────────────────────────────────────────────
|
|
98
|
-
const skillApiKey = config.skill_matching?.api_key || apiKey;
|
|
99
|
-
const skillRegistry = new SkillRegistry(skillApiKey);
|
|
100
|
-
const invocationGuard = new InvocationGuard();
|
|
101
|
-
if (skillApiKey) {
|
|
102
|
-
logger.info('[Skills] Registry loaded with semantic matching support');
|
|
103
|
-
} else {
|
|
104
|
-
logger.info('[Skills] Registry loaded (keyword matching)');
|
|
105
|
-
}
|
|
106
|
-
logger.info('[Skills] InvocationGuard ready (idempotent + depth/total limits)');
|
|
107
|
-
|
|
108
|
-
const exporter = new HistoryExporter(storage);
|
|
109
|
-
const resume = new ResumeManager(storage);
|
|
110
|
-
const conventionExtractor = new ConventionExtractor();
|
|
111
|
-
const taskSegmenter = new TaskSegmenter(storage);
|
|
112
|
-
|
|
113
|
-
logger.info('[Services] Initialized: ResumeManager, TaskSegmenter, SkillRegistry');
|
|
114
|
-
|
|
115
|
-
// ── 5.5. Schedule daily maintenance ────────────────────────────────────────
|
|
116
|
-
// Clean old events every 24 hours
|
|
117
|
-
const MAINTENANCE_INTERVAL = 24 * 60 * 60 * 1000; // 24 hours
|
|
118
|
-
const maintenanceInterval = setInterval(() => {
|
|
119
|
-
logger.info('[Daemon] Running daily maintenance: cleaning old events');
|
|
120
|
-
try {
|
|
121
|
-
storage.cleanOldEvents(30);
|
|
122
|
-
} catch (err) {
|
|
123
|
-
logger.error(`[Daemon] Maintenance failed: ${err}`);
|
|
124
|
-
}
|
|
125
|
-
}, MAINTENANCE_INTERVAL);
|
|
126
|
-
logger.info('[Daemon] Scheduled daily maintenance (clean events older than 30 days)');
|
|
127
|
-
|
|
128
|
-
// ── 5.6. Stale task GC (every 5 minutes) ──────────────────────────────────
|
|
129
|
-
const STALE_TASK_GC_INTERVAL = 5 * 60 * 1000; // 5 分钟
|
|
130
|
-
const STALE_TASK_IDLE_MINUTES = 10; // idle 超 10 分钟视为滞留
|
|
131
|
-
|
|
132
|
-
const staleTaskGcInterval = setInterval(() => {
|
|
133
|
-
try {
|
|
134
|
-
const closed = storage.completeStaleActiveTasks(STALE_TASK_IDLE_MINUTES);
|
|
135
|
-
if (closed > 0) {
|
|
136
|
-
logger.info(`[Maintenance] Auto-completed ${closed} stale active task(s)`);
|
|
137
|
-
}
|
|
138
|
-
} catch (err) {
|
|
139
|
-
logger.error(`[Maintenance] Stale task GC failed: ${err}`);
|
|
140
|
-
}
|
|
141
|
-
}, STALE_TASK_GC_INTERVAL);
|
|
142
|
-
|
|
143
|
-
// ── 6. Create handlers ─────────────────────────────────────────────────────
|
|
144
|
-
const userPromptHandler = new UserPromptHandler(
|
|
145
|
-
resume,
|
|
146
|
-
conventionExtractor,
|
|
147
|
-
storage,
|
|
148
|
-
skillRegistry,
|
|
149
|
-
);
|
|
150
|
-
|
|
151
|
-
const handlers: Handlers = {
|
|
152
|
-
UserPromptSubmit: userPromptHandler,
|
|
153
|
-
PostToolUse: new PostToolUseHandler(storage),
|
|
154
|
-
Stop: new StopHandler(
|
|
155
|
-
exporter,
|
|
156
|
-
resume,
|
|
157
|
-
taskSegmenter,
|
|
158
|
-
storage,
|
|
159
|
-
invocationGuard,
|
|
160
|
-
userPromptHandler,
|
|
161
|
-
),
|
|
162
|
-
};
|
|
163
|
-
|
|
164
|
-
// ── 7. Event handler ───────────────────────────────────────────────────────
|
|
165
|
-
const handleEvent = async (event: ForgeEvent): Promise<HookResponse | void> => {
|
|
166
|
-
try {
|
|
167
|
-
try {
|
|
168
|
-
storage.writeEvent(event);
|
|
169
|
-
} catch (writeErr) {
|
|
170
|
-
const writeMsg = writeErr instanceof Error ? writeErr.message : String(writeErr);
|
|
171
|
-
if (writeMsg.includes('UNIQUE constraint failed')) {
|
|
172
|
-
// Duplicate event_id — already in DB (e.g. replayed from queue then re-sent).
|
|
173
|
-
// Log at debug level and continue processing the event normally.
|
|
174
|
-
logger.debug(`[Event] Duplicate event_id ignored: ${event.event_id}`);
|
|
175
|
-
} else {
|
|
176
|
-
throw writeErr;
|
|
177
|
-
}
|
|
178
|
-
}
|
|
179
|
-
logger.debug(`[Event] ${event.hook_type} | tool=${event.tool_name ?? 'N/A'}`);
|
|
180
|
-
|
|
181
|
-
// Task segmentation: UserPromptSubmit starts/continues tasks
|
|
182
|
-
const prompt = getUserPrompt(event);
|
|
183
|
-
if (event.hook_type === 'UserPromptSubmit' && prompt) {
|
|
184
|
-
taskSegmenter.processPrompt(event.session_id, prompt, event.timestamp, event.event_id);
|
|
185
|
-
} else if (event.event_id) {
|
|
186
|
-
taskSegmenter.linkEvent(event.session_id, event.event_id);
|
|
187
|
-
}
|
|
188
|
-
|
|
189
|
-
// PreToolUse: always allow (governance removed)
|
|
190
|
-
if (event.hook_type === 'PreToolUse') {
|
|
191
|
-
return { allow: true };
|
|
192
|
-
}
|
|
193
|
-
|
|
194
|
-
const result = await routeEvent(event, handlers);
|
|
195
|
-
|
|
196
|
-
if (result) {
|
|
197
|
-
const handlerName = event.hook_type + 'Handler';
|
|
198
|
-
if (result.systemMessage) {
|
|
199
|
-
storage.writeInjection({
|
|
200
|
-
event_id: event.event_id,
|
|
201
|
-
session_id: event.session_id,
|
|
202
|
-
timestamp: event.timestamp,
|
|
203
|
-
source_handler: handlerName,
|
|
204
|
-
injection_type: 'systemMessage',
|
|
205
|
-
content: result.systemMessage,
|
|
206
|
-
});
|
|
207
|
-
const preview = result.systemMessage.slice(0, 200).replace(/\n/g, ' ');
|
|
208
|
-
console.error(`\x1b[36m[${handlerName}] systemMessage (${result.systemMessage.length} chars): ${preview}\x1b[0m`);
|
|
209
|
-
}
|
|
210
|
-
if (result.additionalContext) {
|
|
211
|
-
storage.writeInjection({
|
|
212
|
-
event_id: event.event_id,
|
|
213
|
-
session_id: event.session_id,
|
|
214
|
-
timestamp: event.timestamp,
|
|
215
|
-
source_handler: handlerName,
|
|
216
|
-
injection_type: 'additionalContext',
|
|
217
|
-
content: result.additionalContext,
|
|
218
|
-
});
|
|
219
|
-
const preview = result.additionalContext.slice(0, 200).replace(/\n/g, ' ');
|
|
220
|
-
console.error(`\x1b[36m[${handlerName}] additionalContext: ${preview}\x1b[0m`);
|
|
221
|
-
}
|
|
222
|
-
}
|
|
223
|
-
|
|
224
|
-
return result;
|
|
225
|
-
} catch (err) {
|
|
226
|
-
logger.error(`Event handling failed: ${err}`);
|
|
227
|
-
throw err;
|
|
228
|
-
}
|
|
229
|
-
};
|
|
230
|
-
|
|
231
|
-
// ── 8. Start socket server ─────────────────────────────────────────────────
|
|
232
|
-
const socketPath = getSocketPath();
|
|
233
|
-
const server = new SocketServer(socketPath, handleEvent, authToken);
|
|
234
|
-
|
|
235
|
-
// ── 8.1. Replay queued events (hook failures during daemon downtime) ────────
|
|
236
|
-
// Run after the socket is created so the daemon is ready to receive events.
|
|
237
|
-
// setImmediate ensures the event loop has had a chance to process the listen
|
|
238
|
-
// callback before we touch storage (not strictly required, but defensive).
|
|
239
|
-
setImmediate(() => {
|
|
240
|
-
replayQueue(storage).then(({ replayed, skipped, dead }) => {
|
|
241
|
-
if (replayed > 0 || skipped > 0 || dead > 0) {
|
|
242
|
-
logger.info(`[Queue] Replay: ${replayed} replayed, ${skipped} skipped (dup), ${dead} dead-lettered`);
|
|
243
|
-
}
|
|
244
|
-
}).catch((err) => {
|
|
245
|
-
logger.error(`[Queue] replayQueue failed: ${err}`);
|
|
246
|
-
});
|
|
247
|
-
});
|
|
248
|
-
|
|
249
|
-
// ── 8.5. Start web server (optional) ───────────────────────────────────────
|
|
250
|
-
// Priority: CLI option > env var > config file
|
|
251
|
-
const webEnabled = options.web ?? (process.env.FORGE_DAEMON_NO_WEB === '1' ? false : config.web.enabled);
|
|
252
|
-
let webServer: any = null;
|
|
253
|
-
if (webEnabled) {
|
|
254
|
-
const { WebServer } = await import('../web/server.js');
|
|
255
|
-
webServer = new WebServer({
|
|
256
|
-
port: config.web.port,
|
|
257
|
-
storage,
|
|
258
|
-
skillRegistry,
|
|
259
|
-
invocationGuard,
|
|
260
|
-
});
|
|
261
|
-
await webServer.start();
|
|
262
|
-
} else {
|
|
263
|
-
logger.info('[Web] Server disabled (--no-web or config.web.enabled=false)');
|
|
264
|
-
}
|
|
265
|
-
|
|
266
|
-
// ── 9. Graceful shutdown ───────────────────────────────────────────────────
|
|
267
|
-
let shuttingDown = false;
|
|
268
|
-
const shutdown = async () => {
|
|
269
|
-
if (shuttingDown) return;
|
|
270
|
-
shuttingDown = true;
|
|
271
|
-
logger.info('Shutting down...');
|
|
272
|
-
|
|
273
|
-
if (ai) logger.info(`[AI Stats] ${ai.formatStats()}`);
|
|
274
|
-
|
|
275
|
-
clearInterval(maintenanceInterval);
|
|
276
|
-
clearInterval(staleTaskGcInterval);
|
|
277
|
-
if (webServer) await webServer.stop();
|
|
278
|
-
await server.close();
|
|
279
|
-
storage.close();
|
|
280
|
-
removePidFile();
|
|
281
|
-
cleanSocket();
|
|
282
|
-
removeAuthToken();
|
|
283
|
-
process.exit(0);
|
|
284
|
-
};
|
|
285
|
-
|
|
286
|
-
process.on('SIGTERM', shutdown);
|
|
287
|
-
process.on('SIGINT', shutdown);
|
|
288
|
-
|
|
289
|
-
logger.info(`Daemon started (PID: ${process.pid})`);
|
|
290
|
-
if (foreground) {
|
|
291
|
-
process.stdout.write(`Claude Forge daemon running (PID: ${process.pid})\n`);
|
|
292
|
-
process.stdout.write('Press Ctrl+C to stop\n');
|
|
293
|
-
}
|
|
294
|
-
}
|
|
295
|
-
|
|
296
|
-
// Allow running as standalone script (spawned by `cf daemon start`)
|
|
297
|
-
if (process.env.FORGE_DAEMON_FOREGROUND === '1') {
|
|
298
|
-
startDaemon(true).catch((err) => {
|
|
299
|
-
console.error('Daemon failed to start:', err);
|
|
300
|
-
process.exit(1);
|
|
301
|
-
});
|
|
302
|
-
}
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
<?xml version="1.0" encoding="UTF-8"?>
|
|
2
|
-
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
|
3
|
-
<plist version="1.0">
|
|
4
|
-
<dict>
|
|
5
|
-
<key>Label</key>
|
|
6
|
-
<string>com.claude-forge.daemon</string>
|
|
7
|
-
|
|
8
|
-
<key>ProgramArguments</key>
|
|
9
|
-
<array>
|
|
10
|
-
<string>{{NODE_PATH}}</string>
|
|
11
|
-
<string>{{DAEMON_PATH}}</string>
|
|
12
|
-
</array>
|
|
13
|
-
|
|
14
|
-
<key>WorkingDirectory</key>
|
|
15
|
-
<string>{{HOME}}</string>
|
|
16
|
-
|
|
17
|
-
<key>EnvironmentVariables</key>
|
|
18
|
-
<dict>
|
|
19
|
-
<key>PATH</key>
|
|
20
|
-
<string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
|
|
21
|
-
<key>NODE_ENV</key>
|
|
22
|
-
<string>production</string>
|
|
23
|
-
<key>FORGE_DAEMON_FOREGROUND</key>
|
|
24
|
-
<string>1</string>
|
|
25
|
-
</dict>
|
|
26
|
-
|
|
27
|
-
<key>RunAtLoad</key>
|
|
28
|
-
<true/>
|
|
29
|
-
|
|
30
|
-
<key>KeepAlive</key>
|
|
31
|
-
<dict>
|
|
32
|
-
<key>SuccessfulExit</key>
|
|
33
|
-
<false/>
|
|
34
|
-
<key>Crashed</key>
|
|
35
|
-
<true/>
|
|
36
|
-
</dict>
|
|
37
|
-
|
|
38
|
-
<key>ThrottleInterval</key>
|
|
39
|
-
<integer>10</integer>
|
|
40
|
-
|
|
41
|
-
<key>StandardOutPath</key>
|
|
42
|
-
<string>{{HOME}}/.claude-forge/daemon-stdout.log</string>
|
|
43
|
-
|
|
44
|
-
<key>StandardErrorPath</key>
|
|
45
|
-
<string>{{HOME}}/.claude-forge/daemon-stderr.log</string>
|
|
46
|
-
</dict>
|
|
47
|
-
</plist>
|
|
@@ -1,260 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* macOS LaunchAgent integration for the Forge daemon.
|
|
3
|
-
*
|
|
4
|
-
* Renders the plist template, installs/uninstalls the LaunchAgent via launchctl,
|
|
5
|
-
* and reports status. Intended to give the daemon supervisor-grade auto-restart
|
|
6
|
-
* behavior on darwin without depending on systemd.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
import fs from 'fs';
|
|
10
|
-
import os from 'os';
|
|
11
|
-
import path from 'path';
|
|
12
|
-
import { execSync, execFileSync } from 'child_process';
|
|
13
|
-
import { fileURLToPath } from 'url';
|
|
14
|
-
|
|
15
|
-
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
16
|
-
|
|
17
|
-
export const LAUNCHD_LABEL = 'com.claude-forge.daemon';
|
|
18
|
-
export const LAUNCH_AGENTS_DIR = path.join(os.homedir(), 'Library', 'LaunchAgents');
|
|
19
|
-
export const PLIST_PATH = path.join(LAUNCH_AGENTS_DIR, `${LAUNCHD_LABEL}.plist`);
|
|
20
|
-
|
|
21
|
-
export const TEMPLATE_PATH = path.resolve(
|
|
22
|
-
__dirname,
|
|
23
|
-
'launchd',
|
|
24
|
-
'com.claude-forge.daemon.plist.template'
|
|
25
|
-
);
|
|
26
|
-
|
|
27
|
-
export function ensureDarwin(): void {
|
|
28
|
-
if (process.platform !== 'darwin') {
|
|
29
|
-
throw new Error(
|
|
30
|
-
`LaunchAgent commands are only supported on macOS (current platform: ${process.platform}). ` +
|
|
31
|
-
`Use './scripts/dev-daemon.sh' or 'cf daemon start' on other platforms.`
|
|
32
|
-
);
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
export function getUid(): number {
|
|
37
|
-
if (typeof process.getuid === 'function') {
|
|
38
|
-
return process.getuid();
|
|
39
|
-
}
|
|
40
|
-
// Fallback: shell out (process.getuid is undefined on Windows but always defined on darwin).
|
|
41
|
-
return parseInt(execSync('id -u', { encoding: 'utf-8' }).trim(), 10);
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
export interface RenderOptions {
|
|
45
|
-
/**
|
|
46
|
-
* If true, points ProgramArguments at the local development build
|
|
47
|
-
* (`<repo>/dist/daemon/index.js` resolved from this module's location).
|
|
48
|
-
* Otherwise, resolves the daemon entry from the globally-installed package.
|
|
49
|
-
*/
|
|
50
|
-
dev?: boolean;
|
|
51
|
-
/**
|
|
52
|
-
* Optional explicit path to the daemon entrypoint.
|
|
53
|
-
* Takes precedence over `dev`.
|
|
54
|
-
*/
|
|
55
|
-
daemonPath?: string;
|
|
56
|
-
/**
|
|
57
|
-
* Optional explicit node path. Defaults to `process.execPath`.
|
|
58
|
-
*/
|
|
59
|
-
nodePath?: string;
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
/**
|
|
63
|
-
* Resolve the path to `dist/daemon/index.js`.
|
|
64
|
-
*
|
|
65
|
-
* - In dev mode: resolves relative to this module (works in both src and dist).
|
|
66
|
-
* - In production mode: prefers a globally-installed `claude-forge` binary,
|
|
67
|
-
* falling back to the path resolved from this module.
|
|
68
|
-
*/
|
|
69
|
-
export function resolveDaemonPath(opts: RenderOptions = {}): string {
|
|
70
|
-
if (opts.daemonPath) {
|
|
71
|
-
if (!fs.existsSync(opts.daemonPath)) {
|
|
72
|
-
throw new Error(`Provided daemon path does not exist: ${opts.daemonPath}`);
|
|
73
|
-
}
|
|
74
|
-
return opts.daemonPath;
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
// From `dist/daemon/launchd-installer.js` -> `dist/daemon/index.js`
|
|
78
|
-
// From `src/daemon/launchd-installer.ts` -> would resolve to src path; but we only ship dist.
|
|
79
|
-
const localGuess = path.resolve(__dirname, 'index.js');
|
|
80
|
-
|
|
81
|
-
if (opts.dev) {
|
|
82
|
-
if (!fs.existsSync(localGuess)) {
|
|
83
|
-
throw new Error(
|
|
84
|
-
`Local daemon entry not found at ${localGuess}. Run 'npm run build' first.`
|
|
85
|
-
);
|
|
86
|
-
}
|
|
87
|
-
return localGuess;
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
// Production mode: try to find global install via `which claude-forge`.
|
|
91
|
-
try {
|
|
92
|
-
const cliPath = execSync('command -v claude-forge', { encoding: 'utf-8' }).trim();
|
|
93
|
-
if (cliPath) {
|
|
94
|
-
const resolved = fs.realpathSync(cliPath);
|
|
95
|
-
// The CLI lives at <pkg>/dist/cli/index.js; daemon at <pkg>/dist/daemon/index.js.
|
|
96
|
-
const pkgRoot = path.resolve(path.dirname(resolved), '..');
|
|
97
|
-
const candidate = path.join(pkgRoot, 'daemon', 'index.js');
|
|
98
|
-
if (fs.existsSync(candidate)) {
|
|
99
|
-
return candidate;
|
|
100
|
-
}
|
|
101
|
-
}
|
|
102
|
-
} catch {
|
|
103
|
-
// Ignore — fall through to local guess.
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
if (fs.existsSync(localGuess)) {
|
|
107
|
-
return localGuess;
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
throw new Error(
|
|
111
|
-
`Could not locate daemon entry. Install claude-forge globally (npm i -g @winspan/claude-forge) ` +
|
|
112
|
-
`or run with --dev after 'npm run build'.`
|
|
113
|
-
);
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
export function renderPlist(opts: RenderOptions = {}): string {
|
|
117
|
-
if (!fs.existsSync(TEMPLATE_PATH)) {
|
|
118
|
-
throw new Error(`plist template missing at ${TEMPLATE_PATH}. Did you run 'npm run build'?`);
|
|
119
|
-
}
|
|
120
|
-
const template = fs.readFileSync(TEMPLATE_PATH, 'utf-8');
|
|
121
|
-
const nodePath = opts.nodePath ?? process.execPath;
|
|
122
|
-
const daemonPath = resolveDaemonPath(opts);
|
|
123
|
-
const home = os.homedir();
|
|
124
|
-
|
|
125
|
-
return template
|
|
126
|
-
.replace(/{{NODE_PATH}}/g, nodePath)
|
|
127
|
-
.replace(/{{DAEMON_PATH}}/g, daemonPath)
|
|
128
|
-
.replace(/{{HOME}}/g, home);
|
|
129
|
-
}
|
|
130
|
-
|
|
131
|
-
function runLaunchctl(args: string[]): { stdout: string; stderr: string; code: number } {
|
|
132
|
-
try {
|
|
133
|
-
const stdout = execFileSync('launchctl', args, {
|
|
134
|
-
encoding: 'utf-8',
|
|
135
|
-
stdio: ['ignore', 'pipe', 'pipe'],
|
|
136
|
-
});
|
|
137
|
-
return { stdout, stderr: '', code: 0 };
|
|
138
|
-
} catch (err) {
|
|
139
|
-
const e = err as NodeJS.ErrnoException & { stdout?: Buffer; stderr?: Buffer; status?: number };
|
|
140
|
-
return {
|
|
141
|
-
stdout: e.stdout?.toString() ?? '',
|
|
142
|
-
stderr: e.stderr?.toString() ?? e.message ?? '',
|
|
143
|
-
code: e.status ?? 1,
|
|
144
|
-
};
|
|
145
|
-
}
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
export interface InstallResult {
|
|
149
|
-
plistPath: string;
|
|
150
|
-
nodePath: string;
|
|
151
|
-
daemonPath: string;
|
|
152
|
-
reloaded: boolean;
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
export function install(opts: RenderOptions = {}): InstallResult {
|
|
156
|
-
ensureDarwin();
|
|
157
|
-
fs.mkdirSync(LAUNCH_AGENTS_DIR, { recursive: true });
|
|
158
|
-
|
|
159
|
-
const uid = getUid();
|
|
160
|
-
const target = `gui/${uid}/${LAUNCHD_LABEL}`;
|
|
161
|
-
|
|
162
|
-
// Idempotent: bootout existing service before re-installing.
|
|
163
|
-
let reloaded = false;
|
|
164
|
-
if (fs.existsSync(PLIST_PATH)) {
|
|
165
|
-
const r = runLaunchctl(['bootout', `gui/${uid}`, PLIST_PATH]);
|
|
166
|
-
if (r.code === 0 || /No such process|Could not find specified service/.test(r.stderr)) {
|
|
167
|
-
reloaded = true;
|
|
168
|
-
} else {
|
|
169
|
-
// Non-fatal; proceed and let bootstrap surface real errors.
|
|
170
|
-
reloaded = true;
|
|
171
|
-
}
|
|
172
|
-
}
|
|
173
|
-
|
|
174
|
-
const rendered = renderPlist(opts);
|
|
175
|
-
fs.writeFileSync(PLIST_PATH, rendered, { mode: 0o644 });
|
|
176
|
-
|
|
177
|
-
const bootstrap = runLaunchctl(['bootstrap', `gui/${uid}`, PLIST_PATH]);
|
|
178
|
-
if (bootstrap.code !== 0) {
|
|
179
|
-
throw new Error(
|
|
180
|
-
`launchctl bootstrap failed (exit ${bootstrap.code}): ${bootstrap.stderr.trim() || bootstrap.stdout.trim()}\n` +
|
|
181
|
-
`Service target: ${target}`
|
|
182
|
-
);
|
|
183
|
-
}
|
|
184
|
-
|
|
185
|
-
// Best-effort kickstart so the daemon comes up immediately.
|
|
186
|
-
runLaunchctl(['kickstart', '-k', target]);
|
|
187
|
-
|
|
188
|
-
// Read back rendered values to report.
|
|
189
|
-
const nodePath = opts.nodePath ?? process.execPath;
|
|
190
|
-
const daemonPath = resolveDaemonPath(opts);
|
|
191
|
-
|
|
192
|
-
return { plistPath: PLIST_PATH, nodePath, daemonPath, reloaded };
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
export interface UninstallResult {
|
|
196
|
-
removedPlist: boolean;
|
|
197
|
-
bootedOut: boolean;
|
|
198
|
-
}
|
|
199
|
-
|
|
200
|
-
export function uninstall(): UninstallResult {
|
|
201
|
-
ensureDarwin();
|
|
202
|
-
const uid = getUid();
|
|
203
|
-
|
|
204
|
-
let bootedOut = false;
|
|
205
|
-
if (fs.existsSync(PLIST_PATH)) {
|
|
206
|
-
const r = runLaunchctl(['bootout', `gui/${uid}`, PLIST_PATH]);
|
|
207
|
-
bootedOut =
|
|
208
|
-
r.code === 0 || /No such process|Could not find specified service/.test(r.stderr);
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
let removedPlist = false;
|
|
212
|
-
if (fs.existsSync(PLIST_PATH)) {
|
|
213
|
-
fs.unlinkSync(PLIST_PATH);
|
|
214
|
-
removedPlist = true;
|
|
215
|
-
}
|
|
216
|
-
|
|
217
|
-
return { bootedOut, removedPlist };
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
export interface LaunchdStatus {
|
|
221
|
-
installed: boolean;
|
|
222
|
-
loaded: boolean;
|
|
223
|
-
pid: number | null;
|
|
224
|
-
lastExitCode: number | null;
|
|
225
|
-
state: string | null;
|
|
226
|
-
raw: string;
|
|
227
|
-
}
|
|
228
|
-
|
|
229
|
-
export function status(): LaunchdStatus {
|
|
230
|
-
ensureDarwin();
|
|
231
|
-
const uid = getUid();
|
|
232
|
-
const target = `gui/${uid}/${LAUNCHD_LABEL}`;
|
|
233
|
-
const installed = fs.existsSync(PLIST_PATH);
|
|
234
|
-
|
|
235
|
-
const r = runLaunchctl(['print', target]);
|
|
236
|
-
if (r.code !== 0) {
|
|
237
|
-
return {
|
|
238
|
-
installed,
|
|
239
|
-
loaded: false,
|
|
240
|
-
pid: null,
|
|
241
|
-
lastExitCode: null,
|
|
242
|
-
state: null,
|
|
243
|
-
raw: r.stderr.trim() || r.stdout.trim(),
|
|
244
|
-
};
|
|
245
|
-
}
|
|
246
|
-
|
|
247
|
-
const out = r.stdout;
|
|
248
|
-
const pidMatch = out.match(/^\s*pid\s*=\s*(\d+)/m);
|
|
249
|
-
const stateMatch = out.match(/^\s*state\s*=\s*([\w-]+)/m);
|
|
250
|
-
const exitMatch = out.match(/^\s*last exit code\s*=\s*(-?\d+)/mi);
|
|
251
|
-
|
|
252
|
-
return {
|
|
253
|
-
installed,
|
|
254
|
-
loaded: true,
|
|
255
|
-
pid: pidMatch ? parseInt(pidMatch[1], 10) : null,
|
|
256
|
-
state: stateMatch ? stateMatch[1] : null,
|
|
257
|
-
lastExitCode: exitMatch ? parseInt(exitMatch[1], 10) : null,
|
|
258
|
-
raw: out,
|
|
259
|
-
};
|
|
260
|
-
}
|