@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,401 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Tests for upgrade-engine.ts — matchToOfficial, evaluateWithAI,
|
|
3
|
-
* generateReport, applyDecisions, and pullCandidates (partial).
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
|
|
7
|
-
import path from 'node:path';
|
|
8
|
-
import { promises as fs } from 'node:fs';
|
|
9
|
-
import os from 'node:os';
|
|
10
|
-
import {
|
|
11
|
-
matchToOfficial,
|
|
12
|
-
evaluateWithAI,
|
|
13
|
-
generateReport,
|
|
14
|
-
applyDecisions,
|
|
15
|
-
} from '../../../src/skills/upgrade-engine.js';
|
|
16
|
-
import type { CandidateSkill, ReportEntry } from '../../../src/skills/upgrade-engine.js';
|
|
17
|
-
import type { OfficialSkill } from '../../../src/skills/official-skills.js';
|
|
18
|
-
import type { ClaudeProvider } from '../../../src/core/ai/provider.js';
|
|
19
|
-
|
|
20
|
-
// ── Fixtures ────────────────────────────────────────────────────────────────
|
|
21
|
-
|
|
22
|
-
const officialSkills: OfficialSkill[] = [
|
|
23
|
-
{
|
|
24
|
-
name: 'official-db-schema-design',
|
|
25
|
-
version: '1.0.0',
|
|
26
|
-
description: '数据库设计方法论',
|
|
27
|
-
keywords: ['schema', 'database', 'sql', 'migration'],
|
|
28
|
-
content: '---\nname: official-db-schema-design\nversion: 1.0.0\n---\n# DB Schema Design\n\nOfficial content.',
|
|
29
|
-
},
|
|
30
|
-
{
|
|
31
|
-
name: 'official-debug',
|
|
32
|
-
version: '1.2.0',
|
|
33
|
-
description: '系统化调试工作流',
|
|
34
|
-
keywords: ['debug', 'bug', 'troubleshooting'],
|
|
35
|
-
content: '---\nname: official-debug\nversion: 1.2.0\n---\n# Debug\n\nOfficial debug content.',
|
|
36
|
-
},
|
|
37
|
-
];
|
|
38
|
-
|
|
39
|
-
function makeCandidate(overrides: Partial<CandidateSkill> = {}): CandidateSkill {
|
|
40
|
-
return {
|
|
41
|
-
id: 'database-design',
|
|
42
|
-
source: 'agent-skills',
|
|
43
|
-
filePath: '/tmp/agent-skills/database-design/SKILL.md',
|
|
44
|
-
name: 'database-design',
|
|
45
|
-
description: 'Database schema design patterns',
|
|
46
|
-
keywords: ['database', 'schema', 'sql'],
|
|
47
|
-
content: '---\nname: database-design\n---\n# Database Design\n\nContent here.',
|
|
48
|
-
...overrides,
|
|
49
|
-
};
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
function makeMockProvider(returnValue: string): ClaudeProvider {
|
|
53
|
-
return {
|
|
54
|
-
complete: vi.fn().mockResolvedValue(returnValue),
|
|
55
|
-
} as unknown as ClaudeProvider;
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
// ── matchToOfficial ──────────────────────────────────────────────────────────
|
|
59
|
-
|
|
60
|
-
describe('matchToOfficial', () => {
|
|
61
|
-
it('returns a match for a candidate with overlapping keywords', () => {
|
|
62
|
-
const candidate = makeCandidate();
|
|
63
|
-
const result = matchToOfficial(candidate, officialSkills);
|
|
64
|
-
expect(result).not.toBeNull();
|
|
65
|
-
expect(result?.officialId).toBe('official-db-schema-design');
|
|
66
|
-
expect(result?.score).toBeGreaterThanOrEqual(30);
|
|
67
|
-
});
|
|
68
|
-
|
|
69
|
-
it('returns null when score is below threshold (30)', () => {
|
|
70
|
-
const candidate = makeCandidate({
|
|
71
|
-
id: 'cooking-recipes',
|
|
72
|
-
name: 'cooking',
|
|
73
|
-
description: 'Culinary arts and baking',
|
|
74
|
-
keywords: ['cooking', 'baking', 'recipes', 'food'],
|
|
75
|
-
});
|
|
76
|
-
const result = matchToOfficial(candidate, officialSkills);
|
|
77
|
-
expect(result).toBeNull();
|
|
78
|
-
});
|
|
79
|
-
|
|
80
|
-
it('matches debug candidate to official-debug', () => {
|
|
81
|
-
const candidate = makeCandidate({
|
|
82
|
-
id: 'debug-helper',
|
|
83
|
-
name: 'debug-helper',
|
|
84
|
-
description: 'Debugging workflow',
|
|
85
|
-
keywords: ['debug', 'bug', 'troubleshoot'],
|
|
86
|
-
});
|
|
87
|
-
const result = matchToOfficial(candidate, officialSkills);
|
|
88
|
-
expect(result?.officialId).toBe('official-debug');
|
|
89
|
-
});
|
|
90
|
-
|
|
91
|
-
it('score is within 0-100 range', () => {
|
|
92
|
-
const candidate = makeCandidate();
|
|
93
|
-
const result = matchToOfficial(candidate, officialSkills);
|
|
94
|
-
if (result) {
|
|
95
|
-
expect(result.score).toBeGreaterThanOrEqual(0);
|
|
96
|
-
expect(result.score).toBeLessThanOrEqual(100);
|
|
97
|
-
}
|
|
98
|
-
});
|
|
99
|
-
|
|
100
|
-
it('returns null for empty official skills list', () => {
|
|
101
|
-
const candidate = makeCandidate();
|
|
102
|
-
const result = matchToOfficial(candidate, []);
|
|
103
|
-
expect(result).toBeNull();
|
|
104
|
-
});
|
|
105
|
-
});
|
|
106
|
-
|
|
107
|
-
// ── evaluateWithAI — three action paths ─────────────────────────────────────
|
|
108
|
-
|
|
109
|
-
describe('evaluateWithAI', () => {
|
|
110
|
-
const official = officialSkills[0];
|
|
111
|
-
const candidate = makeCandidate();
|
|
112
|
-
|
|
113
|
-
it('returns upgrade decision when AI returns action=upgrade', async () => {
|
|
114
|
-
const json = JSON.stringify({
|
|
115
|
-
action: 'upgrade',
|
|
116
|
-
confidence: 85,
|
|
117
|
-
reasoning: '候选内容更全面',
|
|
118
|
-
merged_content: null,
|
|
119
|
-
});
|
|
120
|
-
const provider = makeMockProvider(json);
|
|
121
|
-
const result = await evaluateWithAI(candidate, official, provider);
|
|
122
|
-
expect(result.action).toBe('upgrade');
|
|
123
|
-
expect(result.confidence).toBe(85);
|
|
124
|
-
expect(result.reasoning).toBe('候选内容更全面');
|
|
125
|
-
expect(result.merged_content).toBeNull();
|
|
126
|
-
});
|
|
127
|
-
|
|
128
|
-
it('returns merge decision with merged_content', async () => {
|
|
129
|
-
const mergedMd = '---\nname: merged\n---\n# Merged Content';
|
|
130
|
-
const json = JSON.stringify({
|
|
131
|
-
action: 'merge',
|
|
132
|
-
confidence: 72,
|
|
133
|
-
reasoning: '各有独特章节',
|
|
134
|
-
merged_content: mergedMd,
|
|
135
|
-
});
|
|
136
|
-
const provider = makeMockProvider(json);
|
|
137
|
-
const result = await evaluateWithAI(candidate, official, provider);
|
|
138
|
-
expect(result.action).toBe('merge');
|
|
139
|
-
expect(result.merged_content).toBe(mergedMd);
|
|
140
|
-
});
|
|
141
|
-
|
|
142
|
-
it('returns skip decision when AI returns action=skip', async () => {
|
|
143
|
-
const json = JSON.stringify({
|
|
144
|
-
action: 'skip',
|
|
145
|
-
confidence: 30,
|
|
146
|
-
reasoning: '主题不重叠',
|
|
147
|
-
merged_content: null,
|
|
148
|
-
});
|
|
149
|
-
const provider = makeMockProvider(json);
|
|
150
|
-
const result = await evaluateWithAI(candidate, official, provider);
|
|
151
|
-
expect(result.action).toBe('skip');
|
|
152
|
-
});
|
|
153
|
-
|
|
154
|
-
it('returns needs_review when AI response is not valid JSON', async () => {
|
|
155
|
-
const provider = makeMockProvider('这不是JSON内容,AI出错了');
|
|
156
|
-
const result = await evaluateWithAI(candidate, official, provider);
|
|
157
|
-
expect(result.needs_review).toBe(true);
|
|
158
|
-
expect(result.action).toBe('skip');
|
|
159
|
-
expect(result.confidence).toBe(0);
|
|
160
|
-
});
|
|
161
|
-
|
|
162
|
-
it('strips markdown code fences before parsing', async () => {
|
|
163
|
-
const json = JSON.stringify({ action: 'skip', confidence: 50, reasoning: 'ok', merged_content: null });
|
|
164
|
-
const provider = makeMockProvider('```json\n' + json + '\n```');
|
|
165
|
-
const result = await evaluateWithAI(candidate, official, provider);
|
|
166
|
-
expect(result.action).toBe('skip');
|
|
167
|
-
expect(result.needs_review).toBeUndefined();
|
|
168
|
-
});
|
|
169
|
-
|
|
170
|
-
it('clamps confidence to 0-100 range', async () => {
|
|
171
|
-
const json = JSON.stringify({ action: 'upgrade', confidence: 150, reasoning: 'ok', merged_content: null });
|
|
172
|
-
const provider = makeMockProvider(json);
|
|
173
|
-
const result = await evaluateWithAI(candidate, official, provider);
|
|
174
|
-
expect(result.confidence).toBe(100);
|
|
175
|
-
});
|
|
176
|
-
|
|
177
|
-
it('returns needs_review when AI provider throws', async () => {
|
|
178
|
-
const provider = {
|
|
179
|
-
complete: vi.fn().mockRejectedValue(new Error('API timeout')),
|
|
180
|
-
} as unknown as ClaudeProvider;
|
|
181
|
-
const result = await evaluateWithAI(candidate, official, provider);
|
|
182
|
-
expect(result.needs_review).toBe(true);
|
|
183
|
-
expect(result.action).toBe('skip');
|
|
184
|
-
expect(result.reasoning).toContain('API timeout');
|
|
185
|
-
});
|
|
186
|
-
});
|
|
187
|
-
|
|
188
|
-
// ── generateReport ────────────────────────────────────────────────────────────
|
|
189
|
-
|
|
190
|
-
describe('generateReport', () => {
|
|
191
|
-
let tmpDir: string;
|
|
192
|
-
|
|
193
|
-
beforeEach(async () => {
|
|
194
|
-
tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'upgrade-test-'));
|
|
195
|
-
});
|
|
196
|
-
|
|
197
|
-
afterEach(async () => {
|
|
198
|
-
await fs.rm(tmpDir, { recursive: true, force: true });
|
|
199
|
-
});
|
|
200
|
-
|
|
201
|
-
const entries: ReportEntry[] = [
|
|
202
|
-
{
|
|
203
|
-
officialId: 'official-db-schema-design',
|
|
204
|
-
candidateId: 'database-design',
|
|
205
|
-
candidateSource: 'agent-skills',
|
|
206
|
-
action: 'upgrade',
|
|
207
|
-
confidence: 85,
|
|
208
|
-
reasoning: '候选更全面',
|
|
209
|
-
candidateFilePath: '/tmp/agent-skills/database-design/SKILL.md',
|
|
210
|
-
merged_content: null,
|
|
211
|
-
},
|
|
212
|
-
{
|
|
213
|
-
officialId: 'official-debug',
|
|
214
|
-
candidateId: 'debug-helper',
|
|
215
|
-
candidateSource: 'superpowers',
|
|
216
|
-
action: 'merge',
|
|
217
|
-
confidence: 70,
|
|
218
|
-
reasoning: '各有特色',
|
|
219
|
-
candidateFilePath: '/tmp/superpowers/debug-helper.md',
|
|
220
|
-
merged_content: '---\nname: merged-debug\n---\n# Merged Debug Content',
|
|
221
|
-
},
|
|
222
|
-
{
|
|
223
|
-
officialId: 'official-tdd',
|
|
224
|
-
candidateId: 'tdd-guide',
|
|
225
|
-
candidateSource: 'agent-skills',
|
|
226
|
-
action: 'skip',
|
|
227
|
-
confidence: 20,
|
|
228
|
-
reasoning: '不够好',
|
|
229
|
-
candidateFilePath: '/tmp/agent-skills/tdd-guide/SKILL.md',
|
|
230
|
-
merged_content: null,
|
|
231
|
-
},
|
|
232
|
-
];
|
|
233
|
-
|
|
234
|
-
const stats = { total: 10, matched: 3, unmatched: 7 };
|
|
235
|
-
|
|
236
|
-
it('creates report file at the specified path', async () => {
|
|
237
|
-
const reportPath = path.join(tmpDir, 'report.md');
|
|
238
|
-
await generateReport(entries, reportPath, stats);
|
|
239
|
-
const exists = await fs.access(reportPath).then(() => true).catch(() => false);
|
|
240
|
-
expect(exists).toBe(true);
|
|
241
|
-
});
|
|
242
|
-
|
|
243
|
-
it('report contains summary table with correct counts', async () => {
|
|
244
|
-
const reportPath = path.join(tmpDir, 'report.md');
|
|
245
|
-
await generateReport(entries, reportPath, stats);
|
|
246
|
-
const content = await fs.readFile(reportPath, 'utf-8');
|
|
247
|
-
expect(content).toContain('| Candidates scanned | 10 |');
|
|
248
|
-
expect(content).toContain('| Matched to official | 3 |');
|
|
249
|
-
expect(content).toContain('| Action: upgrade | 1 |');
|
|
250
|
-
expect(content).toContain('| Action: merge | 1 |');
|
|
251
|
-
expect(content).toContain('| Action: skip | 1 |');
|
|
252
|
-
});
|
|
253
|
-
|
|
254
|
-
it('report contains HTML comment machine markers for upgrade', async () => {
|
|
255
|
-
const reportPath = path.join(tmpDir, 'report.md');
|
|
256
|
-
await generateReport(entries, reportPath, stats);
|
|
257
|
-
const content = await fs.readFile(reportPath, 'utf-8');
|
|
258
|
-
expect(content).toContain(
|
|
259
|
-
'<!-- upgrade-entry: official-db-schema-design | /tmp/agent-skills/database-design/SKILL.md | upgrade -->',
|
|
260
|
-
);
|
|
261
|
-
});
|
|
262
|
-
|
|
263
|
-
it('report contains merged-content-begin/end block for merge entries', async () => {
|
|
264
|
-
const reportPath = path.join(tmpDir, 'report.md');
|
|
265
|
-
await generateReport(entries, reportPath, stats);
|
|
266
|
-
const content = await fs.readFile(reportPath, 'utf-8');
|
|
267
|
-
expect(content).toContain('<!-- merged-content-begin -->');
|
|
268
|
-
expect(content).toContain('<!-- merged-content-end -->');
|
|
269
|
-
expect(content).toContain('# Merged Debug Content');
|
|
270
|
-
});
|
|
271
|
-
|
|
272
|
-
it('report contains per-skill sections for all entries', async () => {
|
|
273
|
-
const reportPath = path.join(tmpDir, 'report.md');
|
|
274
|
-
await generateReport(entries, reportPath, stats);
|
|
275
|
-
const content = await fs.readFile(reportPath, 'utf-8');
|
|
276
|
-
expect(content).toContain('### official-db-schema-design');
|
|
277
|
-
expect(content).toContain('### official-debug');
|
|
278
|
-
expect(content).toContain('### official-tdd');
|
|
279
|
-
});
|
|
280
|
-
});
|
|
281
|
-
|
|
282
|
-
// ── applyDecisions ────────────────────────────────────────────────────────────
|
|
283
|
-
|
|
284
|
-
describe('applyDecisions', () => {
|
|
285
|
-
let tmpDir: string;
|
|
286
|
-
let officialDir: string;
|
|
287
|
-
let backupBaseDir: string;
|
|
288
|
-
let reportPath: string;
|
|
289
|
-
let candidatePath: string;
|
|
290
|
-
|
|
291
|
-
beforeEach(async () => {
|
|
292
|
-
tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'apply-test-'));
|
|
293
|
-
officialDir = path.join(tmpDir, 'official');
|
|
294
|
-
backupBaseDir = path.join(tmpDir, 'backups');
|
|
295
|
-
reportPath = path.join(tmpDir, 'report.md');
|
|
296
|
-
candidatePath = path.join(tmpDir, 'candidate.md');
|
|
297
|
-
|
|
298
|
-
await fs.mkdir(officialDir, { recursive: true });
|
|
299
|
-
await fs.mkdir(backupBaseDir, { recursive: true });
|
|
300
|
-
|
|
301
|
-
// Create a fake official skill file
|
|
302
|
-
await fs.writeFile(
|
|
303
|
-
path.join(officialDir, 'official-db-schema-design.md'),
|
|
304
|
-
'---\nname: official-db-schema-design\n---\n# Original Content',
|
|
305
|
-
'utf-8',
|
|
306
|
-
);
|
|
307
|
-
|
|
308
|
-
// Create a fake candidate file
|
|
309
|
-
await fs.writeFile(
|
|
310
|
-
candidatePath,
|
|
311
|
-
'---\nname: database-design\n---\n# Better Content from candidate',
|
|
312
|
-
'utf-8',
|
|
313
|
-
);
|
|
314
|
-
});
|
|
315
|
-
|
|
316
|
-
afterEach(async () => {
|
|
317
|
-
await fs.rm(tmpDir, { recursive: true, force: true });
|
|
318
|
-
});
|
|
319
|
-
|
|
320
|
-
it('creates a backup directory before applying', async () => {
|
|
321
|
-
const report = `# Report\n\n<!-- upgrade-entry: official-db-schema-design | ${candidatePath} | upgrade -->\n`;
|
|
322
|
-
await fs.writeFile(reportPath, report, 'utf-8');
|
|
323
|
-
|
|
324
|
-
const { backupPath } = await applyDecisions(reportPath, officialDir, backupBaseDir);
|
|
325
|
-
const backupExists = await fs.access(backupPath).then(() => true).catch(() => false);
|
|
326
|
-
expect(backupExists).toBe(true);
|
|
327
|
-
});
|
|
328
|
-
|
|
329
|
-
it('copies existing official skills to backup before applying', async () => {
|
|
330
|
-
const report = `# Report\n\n<!-- upgrade-entry: official-db-schema-design | ${candidatePath} | upgrade -->\n`;
|
|
331
|
-
await fs.writeFile(reportPath, report, 'utf-8');
|
|
332
|
-
|
|
333
|
-
const { backupPath } = await applyDecisions(reportPath, officialDir, backupBaseDir);
|
|
334
|
-
const backupFile = path.join(backupPath, 'official-db-schema-design.md');
|
|
335
|
-
const backupExists = await fs.access(backupFile).then(() => true).catch(() => false);
|
|
336
|
-
expect(backupExists).toBe(true);
|
|
337
|
-
});
|
|
338
|
-
|
|
339
|
-
it('applies upgrade action by writing candidate content to official dir', async () => {
|
|
340
|
-
const report = `# Report\n\n<!-- upgrade-entry: official-db-schema-design | ${candidatePath} | upgrade -->\n`;
|
|
341
|
-
await fs.writeFile(reportPath, report, 'utf-8');
|
|
342
|
-
|
|
343
|
-
const { applied } = await applyDecisions(reportPath, officialDir, backupBaseDir);
|
|
344
|
-
expect(applied).toBe(1);
|
|
345
|
-
|
|
346
|
-
const updatedContent = await fs.readFile(
|
|
347
|
-
path.join(officialDir, 'official-db-schema-design.md'),
|
|
348
|
-
'utf-8',
|
|
349
|
-
);
|
|
350
|
-
expect(updatedContent).toContain('Better Content from candidate');
|
|
351
|
-
});
|
|
352
|
-
|
|
353
|
-
it('skips entries with action=skip', async () => {
|
|
354
|
-
const report = `# Report\n\n<!-- upgrade-entry: official-db-schema-design | ${candidatePath} | skip -->\n`;
|
|
355
|
-
await fs.writeFile(reportPath, report, 'utf-8');
|
|
356
|
-
|
|
357
|
-
const { applied, skipped } = await applyDecisions(reportPath, officialDir, backupBaseDir);
|
|
358
|
-
expect(applied).toBe(0);
|
|
359
|
-
expect(skipped).toBe(1);
|
|
360
|
-
});
|
|
361
|
-
|
|
362
|
-
it('applies merge action using merged-content-begin/end block', async () => {
|
|
363
|
-
const mergedContent = '---\nname: merged\n---\n# Merged Result';
|
|
364
|
-
const report =
|
|
365
|
-
`# Report\n\n` +
|
|
366
|
-
`<!-- upgrade-entry: official-db-schema-design | ${candidatePath} | merge -->\n\n` +
|
|
367
|
-
`<!-- merged-content-begin -->\n${mergedContent}\n<!-- merged-content-end -->\n`;
|
|
368
|
-
await fs.writeFile(reportPath, report, 'utf-8');
|
|
369
|
-
|
|
370
|
-
const { applied } = await applyDecisions(reportPath, officialDir, backupBaseDir);
|
|
371
|
-
expect(applied).toBe(1);
|
|
372
|
-
|
|
373
|
-
const updatedContent = await fs.readFile(
|
|
374
|
-
path.join(officialDir, 'official-db-schema-design.md'),
|
|
375
|
-
'utf-8',
|
|
376
|
-
);
|
|
377
|
-
expect(updatedContent).toContain('# Merged Result');
|
|
378
|
-
});
|
|
379
|
-
|
|
380
|
-
it('uses -2 suffix for backup when timestamp conflicts', async () => {
|
|
381
|
-
const report = `# Report\n\n<!-- upgrade-entry: official-db-schema-design | ${candidatePath} | upgrade -->\n`;
|
|
382
|
-
await fs.writeFile(reportPath, report, 'utf-8');
|
|
383
|
-
|
|
384
|
-
// Run twice — second run should get -2 suffix backup
|
|
385
|
-
const { backupPath: bp1 } = await applyDecisions(reportPath, officialDir, backupBaseDir);
|
|
386
|
-
// Re-create official file (it was overwritten)
|
|
387
|
-
await fs.writeFile(
|
|
388
|
-
path.join(officialDir, 'official-db-schema-design.md'),
|
|
389
|
-
'---\nname: official-db-schema-design\n---\n# Original',
|
|
390
|
-
'utf-8',
|
|
391
|
-
);
|
|
392
|
-
|
|
393
|
-
// Manually create a directory at the same timestamp that would be used
|
|
394
|
-
const dirs1 = await fs.readdir(backupBaseDir);
|
|
395
|
-
expect(dirs1.length).toBeGreaterThanOrEqual(1);
|
|
396
|
-
|
|
397
|
-
// The first backup path should exist
|
|
398
|
-
const bp1Exists = await fs.access(bp1).then(() => true).catch(() => false);
|
|
399
|
-
expect(bp1Exists).toBe(true);
|
|
400
|
-
});
|
|
401
|
-
});
|
|
@@ -1,89 +0,0 @@
|
|
|
1
|
-
import { describe, it, expect } from 'vitest';
|
|
2
|
-
import { buildEvaluationPrompt } from '../../../src/skills/upgrade-prompt.js';
|
|
3
|
-
import type { CandidateSkill } from '../../../src/skills/upgrade-engine.js';
|
|
4
|
-
import type { OfficialSkill } from '../../../src/skills/official-skills.js';
|
|
5
|
-
|
|
6
|
-
const candidateMock: CandidateSkill = {
|
|
7
|
-
id: 'database-design',
|
|
8
|
-
source: 'agent-skills',
|
|
9
|
-
filePath: '/tmp/agent-skills/database-design/SKILL.md',
|
|
10
|
-
name: 'database-design',
|
|
11
|
-
description: 'Comprehensive database design guide with sharding strategies',
|
|
12
|
-
keywords: ['database', 'schema', 'migration', 'sharding'],
|
|
13
|
-
content: '---\nname: database-design\n---\n# Database Design\n\nContent here about schemas and migrations.',
|
|
14
|
-
};
|
|
15
|
-
|
|
16
|
-
const officialMock: OfficialSkill = {
|
|
17
|
-
name: 'official-db-schema-design',
|
|
18
|
-
version: '1.0.0',
|
|
19
|
-
description: '数据库设计方法论',
|
|
20
|
-
keywords: ['schema', 'database', 'sql'],
|
|
21
|
-
content: '---\nname: official-db-schema-design\n---\n# DB Schema Design\n\nOfficial content here.',
|
|
22
|
-
};
|
|
23
|
-
|
|
24
|
-
describe('buildEvaluationPrompt', () => {
|
|
25
|
-
it('returns an object with system and user keys', () => {
|
|
26
|
-
const result = buildEvaluationPrompt(candidateMock, officialMock);
|
|
27
|
-
expect(result).toHaveProperty('system');
|
|
28
|
-
expect(result).toHaveProperty('user');
|
|
29
|
-
});
|
|
30
|
-
|
|
31
|
-
it('system prompt contains upgrade keyword', () => {
|
|
32
|
-
const { system } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
33
|
-
expect(system.toLowerCase()).toContain('upgrade');
|
|
34
|
-
});
|
|
35
|
-
|
|
36
|
-
it('system prompt contains merge keyword', () => {
|
|
37
|
-
const { system } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
38
|
-
expect(system.toLowerCase()).toContain('merge');
|
|
39
|
-
});
|
|
40
|
-
|
|
41
|
-
it('system prompt contains skip keyword', () => {
|
|
42
|
-
const { system } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
43
|
-
expect(system.toLowerCase()).toContain('skip');
|
|
44
|
-
});
|
|
45
|
-
|
|
46
|
-
it('system prompt contains JSON format requirement', () => {
|
|
47
|
-
const { system } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
48
|
-
// Should mention JSON format with the required fields
|
|
49
|
-
expect(system).toContain('action');
|
|
50
|
-
expect(system).toContain('confidence');
|
|
51
|
-
expect(system).toContain('reasoning');
|
|
52
|
-
expect(system).toContain('merged_content');
|
|
53
|
-
});
|
|
54
|
-
|
|
55
|
-
it('user prompt contains official skill name', () => {
|
|
56
|
-
const { user } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
57
|
-
expect(user).toContain('official-db-schema-design');
|
|
58
|
-
});
|
|
59
|
-
|
|
60
|
-
it('user prompt contains candidate skill source', () => {
|
|
61
|
-
const { user } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
62
|
-
expect(user).toContain('agent-skills');
|
|
63
|
-
});
|
|
64
|
-
|
|
65
|
-
it('user prompt contains candidate skill id', () => {
|
|
66
|
-
const { user } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
67
|
-
expect(user).toContain('database-design');
|
|
68
|
-
});
|
|
69
|
-
|
|
70
|
-
it('user prompt truncates long content to ~2000 chars', () => {
|
|
71
|
-
const longContent = 'x'.repeat(5000);
|
|
72
|
-
const candidate: CandidateSkill = { ...candidateMock, content: longContent };
|
|
73
|
-
const { user } = buildEvaluationPrompt(candidate, officialMock);
|
|
74
|
-
// Content should be truncated - user prompt should not contain 5000 x's
|
|
75
|
-
expect(user).not.toContain('x'.repeat(3000));
|
|
76
|
-
// But should contain truncation marker
|
|
77
|
-
expect(user).toContain('[content truncated]');
|
|
78
|
-
});
|
|
79
|
-
|
|
80
|
-
it('user prompt includes official skill keywords', () => {
|
|
81
|
-
const { user } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
82
|
-
expect(user).toContain('schema');
|
|
83
|
-
});
|
|
84
|
-
|
|
85
|
-
it('user prompt includes JSON instruction', () => {
|
|
86
|
-
const { user } = buildEvaluationPrompt(candidateMock, officialMock);
|
|
87
|
-
expect(user.toLowerCase()).toContain('json');
|
|
88
|
-
});
|
|
89
|
-
});
|
|
@@ -1,183 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* SocketServer behavior tests
|
|
3
|
-
*
|
|
4
|
-
* 重点验证 L3 性能修复:buffer 分片到达时,仅在遇到换行符后才解析,
|
|
5
|
-
* 避免大事件每个 chunk 都跑一次完整 JSON.parse 的 N² 行为。
|
|
6
|
-
*/
|
|
7
|
-
import { describe, it, expect, afterEach, vi } from 'vitest';
|
|
8
|
-
import net from 'node:net';
|
|
9
|
-
import os from 'node:os';
|
|
10
|
-
import path from 'node:path';
|
|
11
|
-
import fs from 'node:fs';
|
|
12
|
-
import { SocketServer } from '../../src/daemon/server.js';
|
|
13
|
-
import { EventParser } from '../../src/daemon/event-parser.js';
|
|
14
|
-
|
|
15
|
-
function makeSockPath(): string {
|
|
16
|
-
const name = `forge-test-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.sock`;
|
|
17
|
-
return path.join(os.tmpdir(), name);
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
function makeEvent(overrides: Record<string, unknown> = {}): Record<string, unknown> {
|
|
21
|
-
return {
|
|
22
|
-
hook_type: 'PostToolUse',
|
|
23
|
-
timestamp: new Date().toISOString(),
|
|
24
|
-
session_id: 'test-session',
|
|
25
|
-
project_path: '/tmp/test',
|
|
26
|
-
tool_name: 'Read',
|
|
27
|
-
...overrides,
|
|
28
|
-
};
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
function sendOnSocket(sockPath: string, chunks: string[], delayMs = 5): Promise<string> {
|
|
32
|
-
return new Promise((resolve, reject) => {
|
|
33
|
-
const client = net.createConnection(sockPath);
|
|
34
|
-
let response = '';
|
|
35
|
-
client.on('connect', async () => {
|
|
36
|
-
for (const chunk of chunks) {
|
|
37
|
-
client.write(chunk);
|
|
38
|
-
if (delayMs > 0) await new Promise((r) => setTimeout(r, delayMs));
|
|
39
|
-
}
|
|
40
|
-
});
|
|
41
|
-
client.on('data', (data) => {
|
|
42
|
-
response += data.toString();
|
|
43
|
-
});
|
|
44
|
-
client.on('end', () => resolve(response));
|
|
45
|
-
client.on('close', () => resolve(response));
|
|
46
|
-
client.on('error', reject);
|
|
47
|
-
});
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
describe('SocketServer — L3 chunked-parse behavior', () => {
|
|
51
|
-
const servers: SocketServer[] = [];
|
|
52
|
-
const sockPaths: string[] = [];
|
|
53
|
-
|
|
54
|
-
afterEach(async () => {
|
|
55
|
-
for (const s of servers) await s.close();
|
|
56
|
-
servers.length = 0;
|
|
57
|
-
for (const p of sockPaths) {
|
|
58
|
-
try { fs.unlinkSync(p); } catch { /* ignore */ }
|
|
59
|
-
}
|
|
60
|
-
sockPaths.length = 0;
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
it('parses a complete single-chunk message (with trailing newline)', async () => {
|
|
64
|
-
const sockPath = makeSockPath();
|
|
65
|
-
sockPaths.push(sockPath);
|
|
66
|
-
|
|
67
|
-
const handler = vi.fn().mockReturnValue({ allow: true });
|
|
68
|
-
const server = new SocketServer(sockPath, handler);
|
|
69
|
-
servers.push(server);
|
|
70
|
-
await new Promise((r) => setTimeout(r, 30));
|
|
71
|
-
|
|
72
|
-
const event = makeEvent();
|
|
73
|
-
const payload = JSON.stringify(event) + '\n';
|
|
74
|
-
await sendOnSocket(sockPath, [payload]);
|
|
75
|
-
|
|
76
|
-
expect(handler).toHaveBeenCalledTimes(1);
|
|
77
|
-
const passed = handler.mock.calls[0][0];
|
|
78
|
-
expect(passed.hook_type).toBe('PostToolUse');
|
|
79
|
-
expect(passed.session_id).toBe('test-session');
|
|
80
|
-
});
|
|
81
|
-
|
|
82
|
-
it('parses a large message split across many chunks WITHOUT per-chunk JSON.parse', async () => {
|
|
83
|
-
const sockPath = makeSockPath();
|
|
84
|
-
sockPaths.push(sockPath);
|
|
85
|
-
|
|
86
|
-
// 监视 JSON.parse —— 用于断言不再 N²(不能为每个 chunk 都 parse 一次)
|
|
87
|
-
const parseSpy = vi.spyOn(JSON, 'parse');
|
|
88
|
-
|
|
89
|
-
const handler = vi.fn().mockReturnValue({ allow: true });
|
|
90
|
-
const server = new SocketServer(sockPath, handler);
|
|
91
|
-
servers.push(server);
|
|
92
|
-
await new Promise((r) => setTimeout(r, 30));
|
|
93
|
-
|
|
94
|
-
// 构造大事件(约 50KB tool_output),分成 ~20 个 chunk 喂入
|
|
95
|
-
const bigOutput = 'x'.repeat(50_000);
|
|
96
|
-
const event = makeEvent({ tool_output: { data: bigOutput } });
|
|
97
|
-
const payload = JSON.stringify(event) + '\n';
|
|
98
|
-
const chunkSize = Math.ceil(payload.length / 20);
|
|
99
|
-
const chunks: string[] = [];
|
|
100
|
-
for (let i = 0; i < payload.length; i += chunkSize) {
|
|
101
|
-
chunks.push(payload.slice(i, i + chunkSize));
|
|
102
|
-
}
|
|
103
|
-
expect(chunks.length).toBeGreaterThan(10);
|
|
104
|
-
|
|
105
|
-
const callsBefore = parseSpy.mock.calls.length;
|
|
106
|
-
await sendOnSocket(sockPath, chunks, 2);
|
|
107
|
-
const callsAfter = parseSpy.mock.calls.length;
|
|
108
|
-
|
|
109
|
-
// 关键断言:handler 必须收到完整事件
|
|
110
|
-
expect(handler).toHaveBeenCalledTimes(1);
|
|
111
|
-
|
|
112
|
-
// 关键断言:JSON.parse 调用次数远少于 chunk 数(旧代码会 ≈ chunks.length 次)
|
|
113
|
-
// 现在应该只有:可能 1 次(无 auth 时)或 2 次(有 auth 时——auth 检查 + EventParser)
|
|
114
|
-
const parseDelta = callsAfter - callsBefore;
|
|
115
|
-
expect(parseDelta).toBeLessThanOrEqual(3);
|
|
116
|
-
expect(parseDelta).toBeLessThan(chunks.length); // 强对比旧 N² 行为
|
|
117
|
-
|
|
118
|
-
parseSpy.mockRestore();
|
|
119
|
-
});
|
|
120
|
-
|
|
121
|
-
it('rejects oversized buffer that never sees a newline', async () => {
|
|
122
|
-
const sockPath = makeSockPath();
|
|
123
|
-
sockPaths.push(sockPath);
|
|
124
|
-
|
|
125
|
-
const handler = vi.fn();
|
|
126
|
-
const server = new SocketServer(sockPath, handler);
|
|
127
|
-
servers.push(server);
|
|
128
|
-
await new Promise((r) => setTimeout(r, 30));
|
|
129
|
-
|
|
130
|
-
// 600KB 无换行 —— 必须超过 MAX_BUFFER_SIZE (512KB) 并被丢弃
|
|
131
|
-
// 注意:服务端 destroy 后客户端继续 write 会触发 EPIPE,要容错
|
|
132
|
-
const oversized = 'a'.repeat(600 * 1024);
|
|
133
|
-
await new Promise<void>((resolve) => {
|
|
134
|
-
const client = net.createConnection(sockPath);
|
|
135
|
-
client.on('error', () => { /* EPIPE 预期 */ });
|
|
136
|
-
client.on('close', () => resolve());
|
|
137
|
-
client.on('connect', () => {
|
|
138
|
-
client.write(oversized, () => {
|
|
139
|
-
// 给服务端处理时间
|
|
140
|
-
setTimeout(() => client.destroy(), 80);
|
|
141
|
-
});
|
|
142
|
-
});
|
|
143
|
-
});
|
|
144
|
-
|
|
145
|
-
expect(handler).not.toHaveBeenCalled();
|
|
146
|
-
});
|
|
147
|
-
|
|
148
|
-
it('uses fallback parse on socket end() for messages without trailing newline', async () => {
|
|
149
|
-
const sockPath = makeSockPath();
|
|
150
|
-
sockPaths.push(sockPath);
|
|
151
|
-
|
|
152
|
-
const handler = vi.fn().mockReturnValue({ allow: true });
|
|
153
|
-
const server = new SocketServer(sockPath, handler);
|
|
154
|
-
servers.push(server);
|
|
155
|
-
await new Promise((r) => setTimeout(r, 30));
|
|
156
|
-
|
|
157
|
-
// 无换行结尾 —— 走 socket.end() 兜底
|
|
158
|
-
const event = makeEvent();
|
|
159
|
-
const payload = JSON.stringify(event);
|
|
160
|
-
await new Promise<void>((resolve, reject) => {
|
|
161
|
-
const client = net.createConnection(sockPath);
|
|
162
|
-
client.on('connect', () => {
|
|
163
|
-
client.end(payload); // 写完即关闭:触发 server 的 'end' 事件
|
|
164
|
-
});
|
|
165
|
-
client.on('close', () => resolve());
|
|
166
|
-
client.on('error', reject);
|
|
167
|
-
});
|
|
168
|
-
// 等 server 端处理完
|
|
169
|
-
await new Promise((r) => setTimeout(r, 50));
|
|
170
|
-
|
|
171
|
-
expect(handler).toHaveBeenCalledTimes(1);
|
|
172
|
-
});
|
|
173
|
-
});
|
|
174
|
-
|
|
175
|
-
describe('EventParser — sanity', () => {
|
|
176
|
-
it('parses a valid event JSON', () => {
|
|
177
|
-
const parser = new EventParser();
|
|
178
|
-
const raw = JSON.stringify(makeEvent());
|
|
179
|
-
const out = parser.parse(raw);
|
|
180
|
-
expect(out.session_id).toBe('test-session');
|
|
181
|
-
expect(out.hook_type).toBe('PostToolUse');
|
|
182
|
-
});
|
|
183
|
-
});
|