@winspan/claude-forge 8.53.2 → 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 +7 -3
- 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/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 +19 -4
- package/dist/daemon/index.js.map +1 -1
- package/dist/skills/registry.d.ts.map +1 -1
- package/dist/skills/registry.js +13 -2
- package/dist/skills/registry.js.map +1 -1
- package/dist/skills/semantic-matcher.d.ts +2 -2
- package/dist/skills/semantic-matcher.d.ts.map +1 -1
- package/dist/skills/semantic-matcher.js +14 -19
- package/dist/skills/semantic-matcher.js.map +1 -1
- package/dist/skills/upgrade-engine.d.ts +3 -1
- package/dist/skills/upgrade-engine.d.ts.map +1 -1
- package/dist/skills/upgrade-engine.js +25 -14
- package/dist/skills/upgrade-engine.js.map +1 -1
- 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/skill-ai-upgrade-spec-20260518-1930.md +0 -297
- 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/daemon-skill-sync-changelog-20260518-2000.md +0 -22
- 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/skill-ai-upgrade-changelog-20260518-1930.md +0 -49
- 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 -328
- 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 -67
- 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 -312
- 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/daemon/skill-sync.ts +0 -88
- 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 -52
- package/src/skills/official/find-skills.md +0 -142
- package/src/skills/official/official-api-design.md +0 -30
- package/src/skills/official/official-architecture-decision.md +0 -41
- package/src/skills/official/official-bmad.md +0 -118
- package/src/skills/official/official-db-schema-design.md +0 -34
- package/src/skills/official/official-debug.md +0 -25
- 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 -32
- package/src/skills/official/official-spec-driven-design.md +0 -31
- package/src/skills/official/planning-with-files.md +0 -241
- package/src/skills/official/ui-ux-pro-max.md +0 -105
- package/src/skills/official/webapp-testing.md +0 -96
- package/src/skills/official-skills.ts +0 -89
- package/src/skills/registry.ts +0 -355
- package/src/skills/semantic-matcher.ts +0 -234
- 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/skills/upgrade-engine.ts +0 -541
- package/src/skills/upgrade-prompt.ts +0 -84
- 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/skill-sync.test.ts +0 -75
- 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/skills/upgrade-engine-parse.test.ts +0 -138
- package/tests/unit/skills/upgrade-engine.test.ts +0 -401
- package/tests/unit/skills/upgrade-prompt.test.ts +0 -89
- 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
|
@@ -1,222 +0,0 @@
|
|
|
1
|
-
# claude-forge 工作区规范
|
|
2
|
-
|
|
3
|
-
## 自检(每次响应前必读)
|
|
4
|
-
|
|
5
|
-
**在开始任何操作前,先问自己**:
|
|
6
|
-
|
|
7
|
-
1. 我是否要修改 ≥2 个文件?
|
|
8
|
-
2. 我是否要修改 ≥10 行代码?
|
|
9
|
-
3. 这是否是新功能/重构/Bug 修复?
|
|
10
|
-
4. 我修改的代码所在模块**测试覆盖率 < 50%** 吗?
|
|
11
|
-
|
|
12
|
-
**如果 1-3 任一答案是"是",且我没有 spawn Agent**:
|
|
13
|
-
- ❌ 停下来 → 重新评估例外 → 否则立即 spawn Agent
|
|
14
|
-
|
|
15
|
-
**如果 4 答案是"是"**(改老代码 + 测试薄弱):
|
|
16
|
-
- ❌ 不要 spawn 普通 `coder` / `planner`
|
|
17
|
-
- ✅ 必须走 **Harness 或 Hybrid 工作流**(详见下方「工作流升级判定」)
|
|
18
|
-
|
|
19
|
-
**违规示例**:
|
|
20
|
-
- "修复 daemon handler bug(改老代码 + 0 测试)" → 应走 `harness-hotfix`,不是 `coder`
|
|
21
|
-
- "重构 738 行字面量为 .md 文件" → 应走 `refactor-safe`,不是 `coder`
|
|
22
|
-
- "新功能加在 hook 脚本" → 应走 `hybrid-feature-with-safety`,不是 `planner+coder`
|
|
23
|
-
|
|
24
|
-
---
|
|
25
|
-
|
|
26
|
-
## 核心行为规则
|
|
27
|
-
|
|
28
|
-
- Do what has been asked; nothing more, nothing less
|
|
29
|
-
- NEVER create files unless absolutely necessary
|
|
30
|
-
- ALWAYS prefer editing existing files to creating new ones
|
|
31
|
-
- ALWAYS read a file before editing it
|
|
32
|
-
- Never continuously check status after spawning agents — wait for results
|
|
33
|
-
|
|
34
|
-
---
|
|
35
|
-
|
|
36
|
-
## Two-Phase Workflow (BMAD 默认路径)
|
|
37
|
-
|
|
38
|
-
**适用范围**:≥3 文件改动 / 新功能 / 重构 / 架构调整
|
|
39
|
-
**前提**:通过「工作流升级判定」确认为 BMAD 路径(测试覆盖充分 / 全新模块)
|
|
40
|
-
**如果改老代码 + 测试薄弱** → 改走 Harness/Hybrid 三阶段(见下方)
|
|
41
|
-
|
|
42
|
-
### Phase 1: Generate Spec
|
|
43
|
-
|
|
44
|
-
1. Spawn planner/researcher agent with `run_in_background: true`
|
|
45
|
-
2. Agent 输出 `docs/design/[task]-spec-YYYYMMDD-HHMM.md`,包含:
|
|
46
|
-
- 目标、改动文件清单、关键设计决策、风险点、测试策略
|
|
47
|
-
- **禁止写任何代码**
|
|
48
|
-
3. 主线程告诉用户"已 spawn planner,等待 spec 生成",**然后结束响应**
|
|
49
|
-
|
|
50
|
-
### Phase 1.5: User Review (Critical Gate)
|
|
51
|
-
|
|
52
|
-
Agent 完成后,**主线程必须停止并等待用户确认**:
|
|
53
|
-
|
|
54
|
-
```
|
|
55
|
-
设计方案已生成:docs/design/xxx-spec.md
|
|
56
|
-
|
|
57
|
-
请 review 后回复:
|
|
58
|
-
- "批准" / "approve" → 我会 spawn coder 实现
|
|
59
|
-
- "修改 [意见]" → 我会调整 spec
|
|
60
|
-
- "取消" → 停止任务
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
**绝对禁止**:
|
|
64
|
-
- ❌ 主线程自行判断 spec 质量并进入 Phase 2
|
|
65
|
-
- ❌ 主线程直接 spawn coder 而不等用户确认
|
|
66
|
-
|
|
67
|
-
### Phase 2: Implement per Spec
|
|
68
|
-
|
|
69
|
-
收到用户"批准"后:
|
|
70
|
-
1. Spawn coder agent with `run_in_background: true`
|
|
71
|
-
2. 严格按 spec 执行,完成后写 `docs/implementation/[task]-changelog-YYYYMMDD-HHMM.md`
|
|
72
|
-
|
|
73
|
-
### 例外
|
|
74
|
-
|
|
75
|
-
可跳过两阶段:
|
|
76
|
-
- 单文件 1-2 行修改
|
|
77
|
-
- 用户明确说"不需要 spec"
|
|
78
|
-
- 纯查询/调研任务
|
|
79
|
-
|
|
80
|
-
---
|
|
81
|
-
|
|
82
|
-
## Agent 委托规则
|
|
83
|
-
|
|
84
|
-
### 默认行为:spawn Agent
|
|
85
|
-
|
|
86
|
-
接到任务时,**第一反应是 spawn Agent**。主线程只做协调。
|
|
87
|
-
|
|
88
|
-
### 不 spawn 的例外(仅 4 条)
|
|
89
|
-
|
|
90
|
-
1. **单行 typo**:1 文件 1 行拼写错误
|
|
91
|
-
2. **协调与汇总**:整合 Agent 结果
|
|
92
|
-
3. **元任务(极小改动)**:git commit/push、daemon 启停、单行规则调整
|
|
93
|
-
4. **即时问答**:不涉及代码/文件的纯对话
|
|
94
|
-
|
|
95
|
-
**注意**:
|
|
96
|
-
- 例外 #3 不包括"重构 CLAUDE.md"、"修改多个配置文件"等大改动
|
|
97
|
-
- 如果改动 ≥2 文件或 ≥10 行,必须 spawn Agent
|
|
98
|
-
|
|
99
|
-
### 强制 spawn 的场景
|
|
100
|
-
|
|
101
|
-
以下必须 spawn Agent:
|
|
102
|
-
- 查/找/看/列出 → Explore agent
|
|
103
|
-
- 函数分析/代码阅读 → doc-reviewer
|
|
104
|
-
- 单文件 2+ 行修改 → coder
|
|
105
|
-
- 实现/修复/重构/优化 → 对应 agent
|
|
106
|
-
|
|
107
|
-
### 强制理由声明
|
|
108
|
-
|
|
109
|
-
每次不 spawn 时,必须在响应开头说明:
|
|
110
|
-
|
|
111
|
-
> 不 spawn 理由:例外 #N [具体原因]
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
## 工作流升级判定(spawn agent 前必查)
|
|
116
|
-
|
|
117
|
-
**默认是 BMAD(planner+coder)**,但满足下表条件**必须升级到 Harness/Hybrid**。
|
|
118
|
-
|
|
119
|
-
### 判定表
|
|
120
|
-
|
|
121
|
-
| 任务特征 | 推荐 agent | 工作流序列 |
|
|
122
|
-
|---------|-----------|----------|
|
|
123
|
-
| **改老代码 + 模块测试覆盖 < 50%** | `refactor-safe` | safety-net → design → implement → test → review |
|
|
124
|
-
| **已知原因的 Bug 修复**(紧急/明确)| `harness-hotfix` | safety-net → fix → verify |
|
|
125
|
-
| **未知/偶发 Bug**(需先定位)| `harness-debug-full` | reproduce → safety-net → root-cause → fix → verify |
|
|
126
|
-
| **新功能改老代码 + 测试薄弱** | `hybrid-feature-with-safety` | safety-net → analyze → design → implement → test → review |
|
|
127
|
-
| **先修 bug 再加功能** | `hybrid-fix-then-feature` | reproduce → fix → verify → design → implement → review |
|
|
128
|
-
| **全新模块 / 测试充分**(覆盖 ≥50%)| `planner` + `coder` | BMAD analyze → design → implement |
|
|
129
|
-
| **纯调研 / 单行 typo / 元任务** | 不 spawn 或 `Explore` | — |
|
|
130
|
-
|
|
131
|
-
### 测试覆盖快速判定
|
|
132
|
-
|
|
133
|
-
修改 `src/<module>/` 前必查:
|
|
134
|
-
|
|
135
|
-
```bash
|
|
136
|
-
SRC=$(find src/<module> -name "*.ts" -not -name "*.test.ts" 2>/dev/null | wc -l)
|
|
137
|
-
TST=$(find tests/unit/<module> src/tests -name "*.test.ts" 2>/dev/null | wc -l)
|
|
138
|
-
echo "ratio: $TST / $SRC"
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
`TST/SRC < 50%` → **触发 Harness safety-net 阶段**(不要直接改代码)
|
|
142
|
-
|
|
143
|
-
### 项目模块覆盖现状(提醒)
|
|
144
|
-
|
|
145
|
-
| 模块 | 覆盖判定 | 默认走 |
|
|
146
|
-
|------|---------|--------|
|
|
147
|
-
| `src/daemon/handlers/` | 部分(≥50%)| BMAD,但 hotfix 类 bug 走 `harness-hotfix` |
|
|
148
|
-
| `src/daemon/services/` | **零测试** | **Harness/Hybrid 强制** |
|
|
149
|
-
| `src/core/storage/` | 高(≥80%)| BMAD |
|
|
150
|
-
| `src/core/queue/` | 高(新写时已加)| BMAD |
|
|
151
|
-
| `src/skills/` | 中(~40%)| 大改走 `refactor-safe` |
|
|
152
|
-
| `src/web/routes/` | 中 | BMAD |
|
|
153
|
-
| `src/hooks/*.sh` | 0(无 sh 测试)| 改 hook 必走 Hybrid |
|
|
154
|
-
| `src/claudemd/` | 低 | `refactor-safe` |
|
|
155
|
-
|
|
156
|
-
### 违规自查
|
|
157
|
-
|
|
158
|
-
过去 5 次任务全踩坑,请引以为戒:
|
|
159
|
-
|
|
160
|
-
- ❌ "修复 daemon schema 收紧拒收 bug"(改 events.ts + 5 个 hook)→ 走了 `coder`,应走 `harness-hotfix`
|
|
161
|
-
- ❌ "Official Skills 数据分离"(重构 738 行老代码)→ 走了 `planner+coder`,应走 `refactor-safe`
|
|
162
|
-
- ❌ "Hook 失败缓冲队列"(新功能 + 改 4 个老 hook)→ 走了 `planner+coder`,应走 `hybrid-feature-with-safety`
|
|
163
|
-
|
|
164
|
-
**判定时机**:在「自检」之后、「Two-Phase Workflow」之前。判定结果若是 Harness/Hybrid,跳过 Two-Phase,直接 spawn 对应 agent。
|
|
165
|
-
|
|
166
|
-
---
|
|
167
|
-
|
|
168
|
-
## 并发规则
|
|
169
|
-
|
|
170
|
-
- All operations MUST be concurrent/parallel in ONE message
|
|
171
|
-
- ALWAYS batch ALL agents in ONE message with `run_in_background: true`
|
|
172
|
-
- ALWAYS batch ALL file reads/writes/edits in ONE message
|
|
173
|
-
- ALWAYS batch ALL terminal operations in ONE Bash message
|
|
174
|
-
|
|
175
|
-
---
|
|
176
|
-
|
|
177
|
-
## 项目特定信息
|
|
178
|
-
|
|
179
|
-
### 技术栈
|
|
180
|
-
|
|
181
|
-
- **语言**: TypeScript (Node.js 24+)
|
|
182
|
-
- **数据库**: SQLite (better-sqlite3)
|
|
183
|
-
- **前端**: React 18 + Vite + Tailwind + react-router-dom + react-query + Recharts(`web/` 目录,build 后被 cp 到 dist/web/static/)
|
|
184
|
-
- **测试**: Vitest
|
|
185
|
-
|
|
186
|
-
### 架构要点
|
|
187
|
-
|
|
188
|
-
**分层**:
|
|
189
|
-
- `src/cli/` — CLI 命令
|
|
190
|
-
- `src/daemon/` — 后台守护进程(事件处理)
|
|
191
|
-
- `src/web/` — Web 仪表盘
|
|
192
|
-
- `src/core/` — 共享核心(storage/config/types)
|
|
193
|
-
- `src/claudemd/` — CLAUDE.md 生成器
|
|
194
|
-
- `src/skills/` — Skill 匹配与注入
|
|
195
|
-
|
|
196
|
-
**存储**:
|
|
197
|
-
- 主库:`~/.claude-forge/data.db`
|
|
198
|
-
- 表:sessions, events, tasks, routing_events, skill_invocations, token_usage
|
|
199
|
-
|
|
200
|
-
### 开发规范
|
|
201
|
-
|
|
202
|
-
**构建与测试**:
|
|
203
|
-
```bash
|
|
204
|
-
npm run build # 构建前后端
|
|
205
|
-
npm test # 运行测试
|
|
206
|
-
./scripts/dev-daemon.sh restart # 重启 daemon
|
|
207
|
-
```
|
|
208
|
-
|
|
209
|
-
**守护进程事件推送**:
|
|
210
|
-
- PreToolUse / PostToolUse / UserPromptSubmit / Stop / Notification
|
|
211
|
-
- 通过 Unix socket 推送到 daemon
|
|
212
|
-
|
|
213
|
-
**注意**:
|
|
214
|
-
- daemon 和 CLI 都用系统 node(v26)
|
|
215
|
-
- better-sqlite3 12.10.0 支持 v26
|
|
216
|
-
- 修改 schema 需要手动迁移(无自动 migration)
|
|
217
|
-
|
|
218
|
-
---
|
|
219
|
-
|
|
220
|
-
## 上次工作续接
|
|
221
|
-
|
|
222
|
-
(由 daemon 自动更新,记录最近任务上下文)
|
|
@@ -1,84 +0,0 @@
|
|
|
1
|
-
import fs from 'fs';
|
|
2
|
-
import path from 'path';
|
|
3
|
-
import type { Command } from 'commander';
|
|
4
|
-
import { ClaudeMdManager } from '../../claudemd/index.js';
|
|
5
|
-
import { SQLiteStorage } from '../../core/storage/sqlite.js';
|
|
6
|
-
import { ClaudeProvider } from '../../core/ai/provider.js';
|
|
7
|
-
import { ConfigManager } from '../../core/config.js';
|
|
8
|
-
import { expandPath } from '../../core/utils/path.js';
|
|
9
|
-
|
|
10
|
-
export function register(program: Command): void {
|
|
11
|
-
const cmd = program.command('claudemd').description('Manage CLAUDE.md files');
|
|
12
|
-
|
|
13
|
-
cmd
|
|
14
|
-
.command('init')
|
|
15
|
-
.description('Generate CLAUDE.md for current project')
|
|
16
|
-
.option('--force', 'Overwrite existing CLAUDE.md')
|
|
17
|
-
.action(async (opts) => {
|
|
18
|
-
const projectPath = process.cwd();
|
|
19
|
-
const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
|
|
20
|
-
|
|
21
|
-
// Check if CLAUDE.md already exists
|
|
22
|
-
if (fs.existsSync(claudeMdPath) && !opts.force) {
|
|
23
|
-
console.error('CLAUDE.md already exists. Use --force to overwrite.');
|
|
24
|
-
process.exit(1);
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
// Load config and AI provider
|
|
28
|
-
const config = new ConfigManager().get();
|
|
29
|
-
const apiKey = config.ai.api_key || process.env.ANTHROPIC_API_KEY;
|
|
30
|
-
if (!apiKey) {
|
|
31
|
-
console.error('Error: No API key configured.');
|
|
32
|
-
console.error('Set ANTHROPIC_API_KEY environment variable or run: cf config edit');
|
|
33
|
-
process.exit(1);
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
const storage = new SQLiteStorage(expandPath(config.storage.path));
|
|
37
|
-
const ai = new ClaudeProvider(apiKey, config.ai.model, config.ai.base_url);
|
|
38
|
-
const manager = new ClaudeMdManager(storage, ai);
|
|
39
|
-
|
|
40
|
-
console.log('Detecting tech stack...');
|
|
41
|
-
const stack = manager.generator.detector.detect(projectPath);
|
|
42
|
-
console.log(`Found: ${stack.language.join(', ')} | ${stack.framework.join(', ')}`);
|
|
43
|
-
|
|
44
|
-
console.log('Generating CLAUDE.md...');
|
|
45
|
-
const content = await manager.generator.generate(projectPath);
|
|
46
|
-
|
|
47
|
-
fs.writeFileSync(claudeMdPath, content, 'utf-8');
|
|
48
|
-
console.log(`✓ CLAUDE.md created at ${claudeMdPath}`);
|
|
49
|
-
|
|
50
|
-
storage.close();
|
|
51
|
-
});
|
|
52
|
-
|
|
53
|
-
cmd
|
|
54
|
-
.command('show')
|
|
55
|
-
.description('Show current CLAUDE.md content')
|
|
56
|
-
.action(() => {
|
|
57
|
-
const projectPath = process.cwd();
|
|
58
|
-
const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
|
|
59
|
-
|
|
60
|
-
if (!fs.existsSync(claudeMdPath)) {
|
|
61
|
-
console.error('CLAUDE.md not found. Run: cf claudemd init');
|
|
62
|
-
process.exit(1);
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
const content = fs.readFileSync(claudeMdPath, 'utf-8');
|
|
66
|
-
console.log(content);
|
|
67
|
-
});
|
|
68
|
-
|
|
69
|
-
cmd
|
|
70
|
-
.command('persona')
|
|
71
|
-
.description('Show detected persona for current project')
|
|
72
|
-
.action(() => {
|
|
73
|
-
const projectPath = process.cwd();
|
|
74
|
-
const config = new ConfigManager().get();
|
|
75
|
-
const storage = new SQLiteStorage(expandPath(config.storage.path));
|
|
76
|
-
const ai = new ClaudeProvider('dummy', 'dummy'); // Not used for persona detection
|
|
77
|
-
const manager = new ClaudeMdManager(storage, ai);
|
|
78
|
-
|
|
79
|
-
const persona = manager.persona.load(projectPath);
|
|
80
|
-
console.log(persona);
|
|
81
|
-
|
|
82
|
-
storage.close();
|
|
83
|
-
});
|
|
84
|
-
}
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
import fs from 'fs';
|
|
2
|
-
import type { Command } from 'commander';
|
|
3
|
-
import { FORGE_PATHS } from '../../core/constants.js';
|
|
4
|
-
|
|
5
|
-
export function register(program: Command): void {
|
|
6
|
-
const config = program.command('config').description('Manage configuration');
|
|
7
|
-
|
|
8
|
-
config
|
|
9
|
-
.command('show')
|
|
10
|
-
.description('Print current configuration')
|
|
11
|
-
.action(() => {
|
|
12
|
-
const configPath = FORGE_PATHS.config();
|
|
13
|
-
if (!fs.existsSync(configPath)) {
|
|
14
|
-
console.log('No config file found. Run: cf init');
|
|
15
|
-
return;
|
|
16
|
-
}
|
|
17
|
-
const content = fs.readFileSync(configPath, 'utf-8');
|
|
18
|
-
console.log(content);
|
|
19
|
-
});
|
|
20
|
-
|
|
21
|
-
config
|
|
22
|
-
.command('path')
|
|
23
|
-
.description('Print config file path')
|
|
24
|
-
.action(() => {
|
|
25
|
-
console.log(FORGE_PATHS.config());
|
|
26
|
-
});
|
|
27
|
-
|
|
28
|
-
config
|
|
29
|
-
.command('edit')
|
|
30
|
-
.description('Open config in default editor')
|
|
31
|
-
.action(async () => {
|
|
32
|
-
const configPath = FORGE_PATHS.config();
|
|
33
|
-
if (!fs.existsSync(configPath)) {
|
|
34
|
-
console.log('No config file found. Run: cf init');
|
|
35
|
-
return;
|
|
36
|
-
}
|
|
37
|
-
const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
|
|
38
|
-
const { spawn } = await import('child_process');
|
|
39
|
-
const child = spawn(editor, [configPath], { stdio: 'inherit' });
|
|
40
|
-
child.on('exit', (code) => {
|
|
41
|
-
if (code !== 0) {
|
|
42
|
-
console.error(`Editor exited with code ${code}`);
|
|
43
|
-
}
|
|
44
|
-
});
|
|
45
|
-
});
|
|
46
|
-
}
|
|
@@ -1,310 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Forge daemon management CLI.
|
|
3
|
-
*
|
|
4
|
-
* Three ways to run the daemon:
|
|
5
|
-
* 1. Manual one-shot: `cf daemon start` / `cf daemon stop`
|
|
6
|
-
* Spawns a detached child process; no auto-restart on crash.
|
|
7
|
-
*
|
|
8
|
-
* 2. Local development: `./scripts/dev-daemon.sh start`
|
|
9
|
-
* Always uses the repo's `dist/daemon/index.js` build.
|
|
10
|
-
*
|
|
11
|
-
* 3. System service: `cf daemon install`
|
|
12
|
-
* Installs a macOS LaunchAgent at
|
|
13
|
-
* `~/Library/LaunchAgents/com.claude-forge.daemon.plist`. With
|
|
14
|
-
* `KeepAlive = { Crashed: true }` the daemon auto-restarts on crash
|
|
15
|
-
* (OOM-kill, signal kill, uncaught exception). Normal exits via
|
|
16
|
-
* `cf daemon stop` do NOT trigger a restart (`SuccessfulExit: false`).
|
|
17
|
-
* `ThrottleInterval=10s` rate-limits restart loops.
|
|
18
|
-
*
|
|
19
|
-
* LaunchAgent logs:
|
|
20
|
-
* ~/.claude-forge/daemon-stdout.log
|
|
21
|
-
* ~/.claude-forge/daemon-stderr.log
|
|
22
|
-
*
|
|
23
|
-
* Uninstall:
|
|
24
|
-
* cf daemon uninstall # bootouts the service and removes the plist
|
|
25
|
-
*
|
|
26
|
-
* Platform: install/uninstall/launchd-status are macOS-only. On other platforms
|
|
27
|
-
* the commands print a clear "not supported" error.
|
|
28
|
-
*/
|
|
29
|
-
|
|
30
|
-
import fs from 'fs';
|
|
31
|
-
import path from 'path';
|
|
32
|
-
import { spawn, execSync } from 'child_process';
|
|
33
|
-
import type { Command } from 'commander';
|
|
34
|
-
import { FORGE_PATHS, DEFAULTS } from '../../core/constants.js';
|
|
35
|
-
import { fileURLToPath } from 'url';
|
|
36
|
-
import {
|
|
37
|
-
install as installLaunchAgent,
|
|
38
|
-
uninstall as uninstallLaunchAgent,
|
|
39
|
-
status as launchdStatus,
|
|
40
|
-
PLIST_PATH,
|
|
41
|
-
LAUNCHD_LABEL,
|
|
42
|
-
} from '../../daemon/launchd-installer.js';
|
|
43
|
-
|
|
44
|
-
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
45
|
-
const PID_FILE = FORGE_PATHS.daemonPid();
|
|
46
|
-
const DEFAULT_PORT = DEFAULTS.WEB_PORT;
|
|
47
|
-
const STDOUT_LOG = FORGE_PATHS.daemonStdout();
|
|
48
|
-
const STDERR_LOG = FORGE_PATHS.daemonStderr();
|
|
49
|
-
|
|
50
|
-
function readPid(): number | null {
|
|
51
|
-
if (!fs.existsSync(PID_FILE)) return null;
|
|
52
|
-
const content = fs.readFileSync(PID_FILE, 'utf-8').trim();
|
|
53
|
-
const pid = parseInt(content, 10);
|
|
54
|
-
return isNaN(pid) ? null : pid;
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
function findPidByPort(port: number): number | null {
|
|
58
|
-
try {
|
|
59
|
-
const out = execSync(`lsof -iTCP:${port} -sTCP:LISTEN -t 2>/dev/null`, { encoding: 'utf-8' });
|
|
60
|
-
const pid = parseInt(out.trim().split('\n')[0], 10);
|
|
61
|
-
return isNaN(pid) ? null : pid;
|
|
62
|
-
} catch {
|
|
63
|
-
return null;
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
function isAlive(pid: number): boolean {
|
|
68
|
-
try {
|
|
69
|
-
process.kill(pid, 0);
|
|
70
|
-
return true;
|
|
71
|
-
} catch {
|
|
72
|
-
return false;
|
|
73
|
-
}
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
function resolveRunningPid(): number | null {
|
|
77
|
-
const pid = readPid();
|
|
78
|
-
if (pid && isAlive(pid)) return pid;
|
|
79
|
-
return findPidByPort(DEFAULT_PORT);
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
function tailFile(filePath: string, lines: number): string {
|
|
83
|
-
if (!fs.existsSync(filePath)) return '';
|
|
84
|
-
try {
|
|
85
|
-
return execSync(`tail -n ${lines} ${JSON.stringify(filePath)}`, { encoding: 'utf-8' });
|
|
86
|
-
} catch {
|
|
87
|
-
return '';
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
export function register(program: Command): void {
|
|
92
|
-
const daemon = program.command('daemon').description('Manage the Forge daemon');
|
|
93
|
-
|
|
94
|
-
daemon
|
|
95
|
-
.command('start')
|
|
96
|
-
.description('Start the daemon')
|
|
97
|
-
.option('-f, --foreground', 'Run in foreground')
|
|
98
|
-
.option('--no-web', 'Start daemon without the web server')
|
|
99
|
-
.action(async (opts) => {
|
|
100
|
-
const existingPid = resolveRunningPid();
|
|
101
|
-
if (existingPid) {
|
|
102
|
-
console.log(`Daemon already running (PID: ${existingPid})`);
|
|
103
|
-
return;
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
if (opts.foreground) {
|
|
107
|
-
console.log('Starting daemon in foreground...');
|
|
108
|
-
const { startDaemon } = await import('../../daemon/index.js');
|
|
109
|
-
await startDaemon(true, { web: opts.web });
|
|
110
|
-
return;
|
|
111
|
-
}
|
|
112
|
-
|
|
113
|
-
// Background mode: spawn detached child process
|
|
114
|
-
const daemonScript = path.resolve(__dirname, '../../daemon/index.js');
|
|
115
|
-
const logFile = FORGE_PATHS.daemonLog();
|
|
116
|
-
const out = fs.openSync(logFile, 'a');
|
|
117
|
-
|
|
118
|
-
const env: Record<string, string> = {
|
|
119
|
-
...process.env as Record<string, string>,
|
|
120
|
-
FORGE_DAEMON_FOREGROUND: '1',
|
|
121
|
-
};
|
|
122
|
-
if (!opts.web) {
|
|
123
|
-
env.FORGE_DAEMON_NO_WEB = '1';
|
|
124
|
-
}
|
|
125
|
-
|
|
126
|
-
const child = spawn(process.execPath, [daemonScript], {
|
|
127
|
-
detached: true,
|
|
128
|
-
stdio: ['ignore', out, out],
|
|
129
|
-
env,
|
|
130
|
-
});
|
|
131
|
-
|
|
132
|
-
child.unref();
|
|
133
|
-
console.log(`Daemon started (PID: ${child.pid})`);
|
|
134
|
-
console.log(`Log: ${logFile}`);
|
|
135
|
-
});
|
|
136
|
-
|
|
137
|
-
daemon
|
|
138
|
-
.command('stop')
|
|
139
|
-
.description('Stop the daemon')
|
|
140
|
-
.action(async () => {
|
|
141
|
-
const pid = resolveRunningPid();
|
|
142
|
-
if (!pid) {
|
|
143
|
-
console.log('Daemon not running');
|
|
144
|
-
return;
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
try {
|
|
148
|
-
process.kill(pid, 'SIGTERM');
|
|
149
|
-
if (fs.existsSync(PID_FILE)) fs.unlinkSync(PID_FILE);
|
|
150
|
-
console.log(`Daemon stopped (PID: ${pid})`);
|
|
151
|
-
} catch (err) {
|
|
152
|
-
console.error('Failed to stop daemon:', err);
|
|
153
|
-
}
|
|
154
|
-
});
|
|
155
|
-
|
|
156
|
-
daemon
|
|
157
|
-
.command('install')
|
|
158
|
-
.description('Install the daemon as a macOS LaunchAgent (auto-restart on crash)')
|
|
159
|
-
.option('--dev', 'Use the local dist build instead of the global install')
|
|
160
|
-
.option('--node <path>', 'Override the node binary path')
|
|
161
|
-
.option('--daemon-path <path>', 'Override the daemon entry path')
|
|
162
|
-
.action(async (opts) => {
|
|
163
|
-
try {
|
|
164
|
-
const result = installLaunchAgent({
|
|
165
|
-
dev: Boolean(opts.dev),
|
|
166
|
-
nodePath: opts.node,
|
|
167
|
-
daemonPath: opts.daemonPath,
|
|
168
|
-
});
|
|
169
|
-
console.log('LaunchAgent installed.');
|
|
170
|
-
console.log(` plist: ${result.plistPath}`);
|
|
171
|
-
console.log(` node: ${result.nodePath}`);
|
|
172
|
-
console.log(` daemon: ${result.daemonPath}`);
|
|
173
|
-
if (result.reloaded) {
|
|
174
|
-
console.log(' (reloaded existing LaunchAgent)');
|
|
175
|
-
}
|
|
176
|
-
console.log('');
|
|
177
|
-
console.log(`Logs: ${STDOUT_LOG}`);
|
|
178
|
-
console.log(` ${STDERR_LOG}`);
|
|
179
|
-
console.log(`Run 'cf daemon status' to verify.`);
|
|
180
|
-
} catch (err) {
|
|
181
|
-
console.error(
|
|
182
|
-
`Install failed: ${err instanceof Error ? err.message : String(err)}`
|
|
183
|
-
);
|
|
184
|
-
process.exitCode = 1;
|
|
185
|
-
}
|
|
186
|
-
});
|
|
187
|
-
|
|
188
|
-
daemon
|
|
189
|
-
.command('uninstall')
|
|
190
|
-
.description('Uninstall the daemon LaunchAgent')
|
|
191
|
-
.action(async () => {
|
|
192
|
-
try {
|
|
193
|
-
const result = uninstallLaunchAgent();
|
|
194
|
-
if (!result.bootedOut && !result.removedPlist) {
|
|
195
|
-
console.log('LaunchAgent not installed (nothing to do).');
|
|
196
|
-
return;
|
|
197
|
-
}
|
|
198
|
-
console.log('LaunchAgent uninstalled.');
|
|
199
|
-
if (result.bootedOut) console.log(' bootout: ok');
|
|
200
|
-
if (result.removedPlist) console.log(` removed: ${PLIST_PATH}`);
|
|
201
|
-
} catch (err) {
|
|
202
|
-
console.error(
|
|
203
|
-
`Uninstall failed: ${err instanceof Error ? err.message : String(err)}`
|
|
204
|
-
);
|
|
205
|
-
process.exitCode = 1;
|
|
206
|
-
}
|
|
207
|
-
});
|
|
208
|
-
|
|
209
|
-
daemon
|
|
210
|
-
.command('status')
|
|
211
|
-
.description('Show daemon status (process + LaunchAgent on macOS)')
|
|
212
|
-
.action(async () => {
|
|
213
|
-
const pid = resolveRunningPid();
|
|
214
|
-
if (pid) {
|
|
215
|
-
console.log(`Daemon process: running (PID: ${pid})`);
|
|
216
|
-
} else {
|
|
217
|
-
console.log('Daemon process: not running');
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
if (process.platform !== 'darwin') {
|
|
221
|
-
return;
|
|
222
|
-
}
|
|
223
|
-
|
|
224
|
-
try {
|
|
225
|
-
const s = launchdStatus();
|
|
226
|
-
console.log('');
|
|
227
|
-
console.log(`LaunchAgent (${LAUNCHD_LABEL}):`);
|
|
228
|
-
console.log(` installed: ${s.installed ? 'yes' : 'no'}`);
|
|
229
|
-
console.log(` loaded: ${s.loaded ? 'yes' : 'no'}`);
|
|
230
|
-
if (s.loaded) {
|
|
231
|
-
console.log(` pid: ${s.pid ?? '(not running)'}`);
|
|
232
|
-
if (s.state) console.log(` state: ${s.state}`);
|
|
233
|
-
if (s.lastExitCode !== null) {
|
|
234
|
-
console.log(` last exit: ${s.lastExitCode}`);
|
|
235
|
-
}
|
|
236
|
-
} else if (s.installed) {
|
|
237
|
-
console.log(` note: plist exists but not loaded — try 'cf daemon install'`);
|
|
238
|
-
} else if (s.raw) {
|
|
239
|
-
// Hide the noisy "Could not find" error when not installed.
|
|
240
|
-
if (!/Could not find specified service/i.test(s.raw)) {
|
|
241
|
-
console.log(` detail: ${s.raw.split('\n')[0]}`);
|
|
242
|
-
}
|
|
243
|
-
}
|
|
244
|
-
} catch (err) {
|
|
245
|
-
console.error(
|
|
246
|
-
`LaunchAgent status unavailable: ${err instanceof Error ? err.message : String(err)}`
|
|
247
|
-
);
|
|
248
|
-
}
|
|
249
|
-
});
|
|
250
|
-
|
|
251
|
-
daemon
|
|
252
|
-
.command('logs')
|
|
253
|
-
.description('Show recent daemon logs (LaunchAgent stdout/stderr)')
|
|
254
|
-
.option('-n, --lines <count>', 'Number of lines to show', '40')
|
|
255
|
-
.option('-f, --follow', 'Follow stderr log (Ctrl+C to exit)')
|
|
256
|
-
.action(async (opts) => {
|
|
257
|
-
const lines = parseInt(opts.lines, 10) || 40;
|
|
258
|
-
|
|
259
|
-
if (opts.follow) {
|
|
260
|
-
if (!fs.existsSync(STDERR_LOG)) {
|
|
261
|
-
console.error(`Log file not found: ${STDERR_LOG}`);
|
|
262
|
-
process.exitCode = 1;
|
|
263
|
-
return;
|
|
264
|
-
}
|
|
265
|
-
const child = spawn('tail', ['-f', '-n', String(lines), STDERR_LOG], {
|
|
266
|
-
stdio: 'inherit',
|
|
267
|
-
});
|
|
268
|
-
child.on('exit', (code) => {
|
|
269
|
-
process.exitCode = code ?? 0;
|
|
270
|
-
});
|
|
271
|
-
return;
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
const stdout = tailFile(STDOUT_LOG, lines);
|
|
275
|
-
const stderr = tailFile(STDERR_LOG, lines);
|
|
276
|
-
|
|
277
|
-
if (!stdout && !stderr) {
|
|
278
|
-
console.log('No LaunchAgent logs yet.');
|
|
279
|
-
console.log(` expected: ${STDOUT_LOG}`);
|
|
280
|
-
console.log(` ${STDERR_LOG}`);
|
|
281
|
-
return;
|
|
282
|
-
}
|
|
283
|
-
|
|
284
|
-
if (stdout) {
|
|
285
|
-
console.log(`=== ${STDOUT_LOG} (last ${lines} lines) ===`);
|
|
286
|
-
console.log(stdout.trimEnd());
|
|
287
|
-
}
|
|
288
|
-
if (stderr) {
|
|
289
|
-
if (stdout) console.log('');
|
|
290
|
-
console.log(`=== ${STDERR_LOG} (last ${lines} lines) ===`);
|
|
291
|
-
console.log(stderr.trimEnd());
|
|
292
|
-
}
|
|
293
|
-
|
|
294
|
-
// Show launchctl restart counter on darwin.
|
|
295
|
-
if (process.platform === 'darwin') {
|
|
296
|
-
try {
|
|
297
|
-
const s = launchdStatus();
|
|
298
|
-
if (s.loaded && s.raw) {
|
|
299
|
-
const exitsMatch = s.raw.match(/^\s*last exit code\s*=\s*(-?\d+)/mi);
|
|
300
|
-
if (exitsMatch) {
|
|
301
|
-
console.log('');
|
|
302
|
-
console.log(`launchd last exit code: ${exitsMatch[1]}`);
|
|
303
|
-
}
|
|
304
|
-
}
|
|
305
|
-
} catch {
|
|
306
|
-
// ignore
|
|
307
|
-
}
|
|
308
|
-
}
|
|
309
|
-
});
|
|
310
|
-
}
|