specweave 0.29.2 → 0.30.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +65 -16
- package/bin/specweave.js +16 -0
- package/dist/plugins/specweave-ado/lib/ado-spec-commit-sync.d.ts +1 -1
- package/dist/plugins/specweave-ado/lib/ado-spec-commit-sync.d.ts.map +1 -1
- package/dist/plugins/specweave-ado/lib/ado-spec-commit-sync.js +1 -1
- package/dist/plugins/specweave-ado/lib/ado-spec-commit-sync.js.map +1 -1
- package/dist/plugins/specweave-ado/lib/ado-spec-content-sync.d.ts +1 -1
- package/dist/plugins/specweave-ado/lib/ado-spec-content-sync.d.ts.map +1 -1
- package/dist/plugins/specweave-ado/lib/ado-spec-content-sync.js +1 -1
- package/dist/plugins/specweave-ado/lib/ado-spec-content-sync.js.map +1 -1
- package/dist/plugins/specweave-ado/lib/conflict-resolver.d.ts +134 -0
- package/dist/plugins/specweave-ado/lib/conflict-resolver.d.ts.map +1 -0
- package/dist/plugins/specweave-ado/lib/conflict-resolver.js +423 -0
- package/dist/plugins/specweave-ado/lib/conflict-resolver.js.map +1 -0
- package/dist/plugins/specweave-github/lib/github-client-v2.d.ts +23 -1
- package/dist/plugins/specweave-github/lib/github-client-v2.d.ts.map +1 -1
- package/dist/plugins/specweave-github/lib/github-client-v2.js +95 -0
- package/dist/plugins/specweave-github/lib/github-client-v2.js.map +1 -1
- package/dist/plugins/specweave-github/lib/github-spec-commit-sync.d.ts +1 -1
- package/dist/plugins/specweave-github/lib/github-spec-commit-sync.d.ts.map +1 -1
- package/dist/plugins/specweave-github/lib/github-spec-commit-sync.js +1 -1
- package/dist/plugins/specweave-github/lib/github-spec-commit-sync.js.map +1 -1
- package/dist/plugins/specweave-github/lib/github-spec-content-sync.d.ts +1 -1
- package/dist/plugins/specweave-github/lib/github-spec-content-sync.d.ts.map +1 -1
- package/dist/plugins/specweave-github/lib/github-spec-content-sync.js +1 -1
- package/dist/plugins/specweave-github/lib/github-spec-content-sync.js.map +1 -1
- package/dist/plugins/specweave-github/lib/types.d.ts +20 -0
- package/dist/plugins/specweave-github/lib/types.d.ts.map +1 -1
- package/dist/plugins/specweave-jira/lib/jira-spec-commit-sync.d.ts +1 -1
- package/dist/plugins/specweave-jira/lib/jira-spec-commit-sync.d.ts.map +1 -1
- package/dist/plugins/specweave-jira/lib/jira-spec-commit-sync.js +1 -1
- package/dist/plugins/specweave-jira/lib/jira-spec-commit-sync.js.map +1 -1
- package/dist/plugins/specweave-jira/lib/jira-spec-content-sync.d.ts +1 -1
- package/dist/plugins/specweave-jira/lib/jira-spec-content-sync.d.ts.map +1 -1
- package/dist/plugins/specweave-jira/lib/jira-spec-content-sync.js +1 -1
- package/dist/plugins/specweave-jira/lib/jira-spec-content-sync.js.map +1 -1
- package/dist/plugins/specweave-jira/lib/setup-wizard.d.ts +2 -2
- package/dist/plugins/specweave-jira/lib/setup-wizard.d.ts.map +1 -1
- package/dist/plugins/specweave-jira/lib/setup-wizard.js +1 -1
- package/dist/plugins/specweave-jira/lib/setup-wizard.js.map +1 -1
- package/dist/src/adapters/claude/adapter.js +1 -1
- package/dist/src/adapters/claude/adapter.js.map +1 -1
- package/dist/src/cli/commands/detect-project.js +1 -1
- package/dist/src/cli/commands/detect-project.js.map +1 -1
- package/dist/src/cli/commands/detect-specs.js +1 -1
- package/dist/src/cli/commands/detect-specs.js.map +1 -1
- package/dist/src/cli/commands/import-docs.js +1 -1
- package/dist/src/cli/commands/import-docs.js.map +1 -1
- package/dist/src/cli/commands/init-multiproject.js +1 -1
- package/dist/src/cli/commands/init-multiproject.js.map +1 -1
- package/dist/src/cli/commands/init.d.ts.map +1 -1
- package/dist/src/cli/commands/init.js +31 -1
- package/dist/src/cli/commands/init.js.map +1 -1
- package/dist/src/cli/commands/jobs.js +15 -1
- package/dist/src/cli/commands/jobs.js.map +1 -1
- package/dist/src/cli/commands/migrate-to-multiproject.js +1 -1
- package/dist/src/cli/commands/migrate-to-multiproject.js.map +1 -1
- package/dist/src/cli/commands/switch-project.js +1 -1
- package/dist/src/cli/commands/switch-project.js.map +1 -1
- package/dist/src/cli/commands/sync-scheduled.d.ts +38 -0
- package/dist/src/cli/commands/sync-scheduled.d.ts.map +1 -0
- package/dist/src/cli/commands/sync-scheduled.js +170 -0
- package/dist/src/cli/commands/sync-scheduled.js.map +1 -0
- package/dist/src/cli/helpers/init/external-import-grouping.d.ts +53 -0
- package/dist/src/cli/helpers/init/external-import-grouping.d.ts.map +1 -0
- package/dist/src/cli/helpers/init/external-import-grouping.js +287 -0
- package/dist/src/cli/helpers/init/external-import-grouping.js.map +1 -0
- package/dist/src/cli/helpers/init/external-import.d.ts +1 -34
- package/dist/src/cli/helpers/init/external-import.d.ts.map +1 -1
- package/dist/src/cli/helpers/init/external-import.js +15 -486
- package/dist/src/cli/helpers/init/external-import.js.map +1 -1
- package/dist/src/cli/helpers/init/living-docs-preflight.d.ts +58 -0
- package/dist/src/cli/helpers/init/living-docs-preflight.d.ts.map +1 -0
- package/dist/src/cli/helpers/init/living-docs-preflight.js +290 -0
- package/dist/src/cli/helpers/init/living-docs-preflight.js.map +1 -0
- package/dist/src/cli/helpers/init/sync-profile-helpers.d.ts +48 -0
- package/dist/src/cli/helpers/init/sync-profile-helpers.d.ts.map +1 -0
- package/dist/src/cli/helpers/init/sync-profile-helpers.js +238 -0
- package/dist/src/cli/helpers/init/sync-profile-helpers.js.map +1 -0
- package/dist/src/cli/helpers/init/types.d.ts +1 -0
- package/dist/src/cli/helpers/init/types.d.ts.map +1 -1
- package/dist/src/cli/helpers/issue-tracker/ado.d.ts.map +1 -1
- package/dist/src/cli/helpers/issue-tracker/ado.js +113 -3
- package/dist/src/cli/helpers/issue-tracker/ado.js.map +1 -1
- package/dist/src/cli/helpers/issue-tracker/index.d.ts.map +1 -1
- package/dist/src/cli/helpers/issue-tracker/index.js +2 -287
- package/dist/src/cli/helpers/issue-tracker/index.js.map +1 -1
- package/dist/src/cli/helpers/issue-tracker/sync-config-writer.d.ts +25 -0
- package/dist/src/cli/helpers/issue-tracker/sync-config-writer.d.ts.map +1 -0
- package/dist/src/cli/helpers/issue-tracker/sync-config-writer.js +306 -0
- package/dist/src/cli/helpers/issue-tracker/sync-config-writer.js.map +1 -0
- package/dist/src/cli/helpers/issue-tracker/types.d.ts +27 -0
- package/dist/src/cli/helpers/issue-tracker/types.d.ts.map +1 -1
- package/dist/src/cli/helpers/issue-tracker/types.js.map +1 -1
- package/dist/src/cli/workers/living-docs-worker.d.ts +16 -0
- package/dist/src/cli/workers/living-docs-worker.d.ts.map +1 -0
- package/dist/src/cli/workers/living-docs-worker.js +395 -0
- package/dist/src/cli/workers/living-docs-worker.js.map +1 -0
- package/dist/src/core/background/job-dependency.d.ts +45 -0
- package/dist/src/core/background/job-dependency.d.ts.map +1 -0
- package/dist/src/core/background/job-dependency.js +144 -0
- package/dist/src/core/background/job-dependency.js.map +1 -0
- package/dist/src/core/background/job-launcher.d.ts +21 -1
- package/dist/src/core/background/job-launcher.d.ts.map +1 -1
- package/dist/src/core/background/job-launcher.js +93 -0
- package/dist/src/core/background/job-launcher.js.map +1 -1
- package/dist/src/core/background/types.d.ts +73 -2
- package/dist/src/core/background/types.d.ts.map +1 -1
- package/dist/src/core/brownfield/importer.js +1 -1
- package/dist/src/core/brownfield/importer.js.map +1 -1
- package/dist/src/core/comment-builder.d.ts +1 -1
- package/dist/src/core/comment-builder.d.ts.map +1 -1
- package/dist/src/core/{cost-tracker.d.ts → cost/cost-tracker.d.ts} +2 -2
- package/dist/src/core/cost/cost-tracker.d.ts.map +1 -0
- package/dist/src/core/{cost-tracker.js → cost/cost-tracker.js} +2 -2
- package/dist/src/core/cost/cost-tracker.js.map +1 -0
- package/dist/src/core/credentials/credentials-manager.d.ts.map +1 -0
- package/dist/src/core/credentials/credentials-manager.js.map +1 -0
- package/dist/src/core/increment/discipline-checker.js +1 -1
- package/dist/src/core/increment/discipline-checker.js.map +1 -1
- package/dist/src/core/increment/increment-archiver.d.ts +9 -8
- package/dist/src/core/increment/increment-archiver.d.ts.map +1 -1
- package/dist/src/core/increment/increment-archiver.js +40 -42
- package/dist/src/core/increment/increment-archiver.js.map +1 -1
- package/dist/src/core/increment/increment-status.d.ts.map +1 -0
- package/dist/src/core/{increment-status.js → increment/increment-status.js} +1 -1
- package/dist/src/core/increment/increment-status.js.map +1 -0
- package/dist/src/core/increment/increment-utils.d.ts.map +1 -0
- package/dist/src/core/increment/increment-utils.js.map +1 -0
- package/dist/src/core/increment/metadata-validator.js +1 -1
- package/dist/src/core/increment/metadata-validator.js.map +1 -1
- package/dist/src/core/living-docs/checkpoint-manager.d.ts +120 -0
- package/dist/src/core/living-docs/checkpoint-manager.d.ts.map +1 -0
- package/dist/src/core/living-docs/checkpoint-manager.js +231 -0
- package/dist/src/core/living-docs/checkpoint-manager.js.map +1 -0
- package/dist/src/core/living-docs/discovery.d.ts +91 -0
- package/dist/src/core/living-docs/discovery.d.ts.map +1 -0
- package/dist/src/core/living-docs/discovery.js +656 -0
- package/dist/src/core/living-docs/discovery.js.map +1 -0
- package/dist/src/core/living-docs/feature-archiver.d.ts +23 -4
- package/dist/src/core/living-docs/feature-archiver.d.ts.map +1 -1
- package/dist/src/core/living-docs/feature-archiver.js +133 -30
- package/dist/src/core/living-docs/feature-archiver.js.map +1 -1
- package/dist/src/core/living-docs/foundation-builder.d.ts +37 -0
- package/dist/src/core/living-docs/foundation-builder.d.ts.map +1 -0
- package/dist/src/core/living-docs/foundation-builder.js +357 -0
- package/dist/src/core/living-docs/foundation-builder.js.map +1 -0
- package/dist/src/core/living-docs/living-docs-sync.d.ts +58 -0
- package/dist/src/core/living-docs/living-docs-sync.d.ts.map +1 -1
- package/dist/src/core/living-docs/living-docs-sync.js +204 -7
- package/dist/src/core/living-docs/living-docs-sync.js.map +1 -1
- package/dist/src/core/living-docs/module-analyzer.d.ts +97 -0
- package/dist/src/core/living-docs/module-analyzer.d.ts.map +1 -0
- package/dist/src/core/living-docs/module-analyzer.js +427 -0
- package/dist/src/core/living-docs/module-analyzer.js.map +1 -0
- package/dist/src/core/living-docs/suggestions-generator.d.ts +112 -0
- package/dist/src/core/living-docs/suggestions-generator.d.ts.map +1 -0
- package/dist/src/core/living-docs/suggestions-generator.js +362 -0
- package/dist/src/core/living-docs/suggestions-generator.js.map +1 -0
- package/dist/src/core/living-docs/workitem-matcher.d.ts +116 -0
- package/dist/src/core/living-docs/workitem-matcher.d.ts.map +1 -0
- package/dist/src/core/living-docs/workitem-matcher.js +356 -0
- package/dist/src/core/living-docs/workitem-matcher.js.map +1 -0
- package/dist/src/core/{plugin-loader.d.ts → plugins/plugin-loader.d.ts} +1 -1
- package/dist/src/core/plugins/plugin-loader.d.ts.map +1 -0
- package/dist/src/core/{plugin-loader.js → plugins/plugin-loader.js} +2 -2
- package/dist/src/core/plugins/plugin-loader.js.map +1 -0
- package/dist/src/core/{project-manager.d.ts → project/project-manager.d.ts} +1 -1
- package/dist/src/core/project/project-manager.d.ts.map +1 -0
- package/dist/src/core/{project-manager.js → project/project-manager.js} +3 -3
- package/dist/src/core/project/project-manager.js.map +1 -0
- package/dist/src/core/project/project-structure-detector.d.ts.map +1 -0
- package/dist/src/core/project/project-structure-detector.js.map +1 -0
- package/dist/src/core/{rfc-generator-v2.d.ts → rfc/rfc-generator-v2.d.ts} +1 -1
- package/dist/src/core/rfc/rfc-generator-v2.d.ts.map +1 -0
- package/dist/src/core/{rfc-generator-v2.js → rfc/rfc-generator-v2.js} +1 -1
- package/dist/src/core/rfc/rfc-generator-v2.js.map +1 -0
- package/dist/src/core/scheduler/index.d.ts +1 -0
- package/dist/src/core/scheduler/index.d.ts.map +1 -1
- package/dist/src/core/scheduler/index.js +1 -0
- package/dist/src/core/scheduler/index.js.map +1 -1
- package/dist/src/core/scheduler/scheduled-job.d.ts +1 -1
- package/dist/src/core/scheduler/scheduled-job.d.ts.map +1 -1
- package/dist/src/core/scheduler/scheduled-job.js.map +1 -1
- package/dist/src/core/scheduler/session-sync-executor.d.ts +138 -0
- package/dist/src/core/scheduler/session-sync-executor.d.ts.map +1 -0
- package/dist/src/core/scheduler/session-sync-executor.js +333 -0
- package/dist/src/core/scheduler/session-sync-executor.js.map +1 -0
- package/dist/src/core/{spec-content-sync.d.ts → specs/spec-content-sync.d.ts} +2 -2
- package/dist/src/core/specs/spec-content-sync.d.ts.map +1 -0
- package/dist/src/core/{spec-content-sync.js → specs/spec-content-sync.js} +1 -1
- package/dist/src/core/specs/spec-content-sync.js.map +1 -0
- package/dist/src/core/{spec-detector.d.ts → specs/spec-detector.d.ts} +1 -1
- package/dist/src/core/specs/spec-detector.d.ts.map +1 -0
- package/dist/src/core/{spec-detector.js → specs/spec-detector.js} +1 -1
- package/dist/src/core/specs/spec-detector.js.map +1 -0
- package/dist/src/core/{spec-identifier-detector.d.ts → specs/spec-identifier-detector.d.ts} +2 -2
- package/dist/src/core/specs/spec-identifier-detector.d.ts.map +1 -0
- package/dist/src/core/{spec-identifier-detector.js → specs/spec-identifier-detector.js} +1 -1
- package/dist/src/core/specs/spec-identifier-detector.js.map +1 -0
- package/dist/src/core/specs/spec-metadata-manager.js +1 -1
- package/dist/src/core/specs/spec-metadata-manager.js.map +1 -1
- package/dist/src/core/specs/spec-task-mapper.d.ts.map +1 -0
- package/dist/src/core/specs/spec-task-mapper.js.map +1 -0
- package/dist/src/core/sync/sync-audit-logger.d.ts +62 -0
- package/dist/src/core/sync/sync-audit-logger.d.ts.map +1 -1
- package/dist/src/core/sync/sync-audit-logger.js +59 -0
- package/dist/src/core/sync/sync-audit-logger.js.map +1 -1
- package/dist/src/importers/item-converter.d.ts +51 -27
- package/dist/src/importers/item-converter.d.ts.map +1 -1
- package/dist/src/importers/item-converter.js +219 -179
- package/dist/src/importers/item-converter.js.map +1 -1
- package/dist/src/importers/markdown-generator.d.ts +75 -0
- package/dist/src/importers/markdown-generator.d.ts.map +1 -0
- package/dist/src/importers/markdown-generator.js +250 -0
- package/dist/src/importers/markdown-generator.js.map +1 -0
- package/dist/src/integrations/ado/ado-client.d.ts +93 -0
- package/dist/src/integrations/ado/ado-client.d.ts.map +1 -1
- package/dist/src/integrations/ado/ado-client.js +172 -1
- package/dist/src/integrations/ado/ado-client.js.map +1 -1
- package/dist/src/integrations/jira/jira-client.d.ts +44 -0
- package/dist/src/integrations/jira/jira-client.d.ts.map +1 -1
- package/dist/src/integrations/jira/jira-client.js +119 -1
- package/dist/src/integrations/jira/jira-client.js.map +1 -1
- package/dist/src/integrations/jira/jira-incremental-mapper.js +2 -2
- package/dist/src/integrations/jira/jira-incremental-mapper.js.map +1 -1
- package/dist/src/integrations/jira/jira-mapper.js +1 -1
- package/dist/src/integrations/jira/jira-mapper.js.map +1 -1
- package/dist/src/living-docs/epic-id-allocator.d.ts +177 -0
- package/dist/src/living-docs/epic-id-allocator.d.ts.map +1 -0
- package/dist/src/living-docs/epic-id-allocator.js +363 -0
- package/dist/src/living-docs/epic-id-allocator.js.map +1 -0
- package/dist/src/sync/external-change-puller.d.ts +94 -0
- package/dist/src/sync/external-change-puller.d.ts.map +1 -0
- package/dist/src/sync/external-change-puller.js +181 -0
- package/dist/src/sync/external-change-puller.js.map +1 -0
- package/dist/src/sync/index.d.ts +4 -0
- package/dist/src/sync/index.d.ts.map +1 -1
- package/dist/src/sync/index.js +2 -0
- package/dist/src/sync/index.js.map +1 -1
- package/dist/src/sync/living-docs-updater.d.ts +93 -0
- package/dist/src/sync/living-docs-updater.d.ts.map +1 -0
- package/dist/src/sync/living-docs-updater.js +218 -0
- package/dist/src/sync/living-docs-updater.js.map +1 -0
- package/dist/src/testing/test-generator.js +1 -1
- package/dist/src/testing/test-generator.js.map +1 -1
- package/dist/src/utils/cost-reporter.d.ts +1 -1
- package/dist/src/utils/cost-reporter.d.ts.map +1 -1
- package/dist/src/utils/model-selection.js +4 -4
- package/dist/src/utils/model-selection.js.map +1 -1
- package/dist/src/utils/pricing-constants.d.ts +2 -2
- package/dist/src/utils/pricing-constants.js +2 -2
- package/package.json +1 -1
- package/plugins/specweave/.claude-plugin/plugin.json +1 -28
- package/plugins/specweave/agents/code-standards-detective/AGENT.md +3 -3
- package/plugins/specweave/agents/infrastructure/AGENT.md +4 -0
- package/plugins/specweave/agents/performance/AGENT.md +2 -2
- package/plugins/specweave/agents/reflective-reviewer/AGENT.md +3 -3
- package/plugins/specweave/agents/translator/AGENT.md +2 -2
- package/plugins/specweave/commands/specweave-costs.md +2 -2
- package/plugins/specweave/commands/specweave-do.md +2 -2
- package/plugins/specweave/hooks/lib/scheduler-startup.sh +59 -8
- package/plugins/specweave/skills/code-reviewer/SKILL.md +1 -1
- package/plugins/specweave/skills/role-orchestrator/README.md +1 -1
- package/plugins/specweave-ado/agents/ado-manager/AGENT.md +8 -2
- package/plugins/specweave-ado/agents/ado-multi-project-mapper/AGENT.md +2 -2
- package/plugins/specweave-ado/agents/ado-sync-judge/AGENT.md +2 -2
- package/plugins/specweave-ado/lib/ado-spec-commit-sync.d.ts +1 -1
- package/plugins/specweave-ado/lib/ado-spec-commit-sync.js +1 -1
- package/plugins/specweave-ado/lib/ado-spec-commit-sync.ts +1 -1
- package/plugins/specweave-ado/lib/ado-spec-content-sync.js +1 -1
- package/plugins/specweave-ado/lib/ado-spec-content-sync.ts +1 -1
- package/plugins/specweave-ado/lib/conflict-resolver.js +87 -0
- package/plugins/specweave-ado/lib/conflict-resolver.ts +124 -0
- package/plugins/specweave-ado/skills/specweave-ado-mapper/SKILL.md +1 -1
- package/plugins/specweave-backend/agents/database-optimizer/AGENT.md +3 -3
- package/plugins/specweave-backend/skills/dotnet-backend/SKILL.md +1 -1
- package/plugins/specweave-backend/skills/nodejs-backend/SKILL.md +1 -1
- package/plugins/specweave-backend/skills/python-backend/SKILL.md +1 -1
- package/plugins/specweave-confluent/agents/confluent-architect/AGENT.md +6 -1
- package/plugins/specweave-diagrams/agents/diagrams-architect/AGENT.md +2 -2
- package/plugins/specweave-diagrams/skills/diagrams-architect/SKILL.md +1 -1
- package/plugins/specweave-frontend/agents/frontend-architect/AGENT.md +4 -0
- package/plugins/specweave-github/agents/github-manager/AGENT.md +1 -1
- package/plugins/specweave-github/agents/github-task-splitter/AGENT.md +11 -1
- package/plugins/specweave-github/agents/user-story-updater/AGENT.md +6 -1
- package/plugins/specweave-github/hooks/.specweave/logs/hooks-debug.log +90 -0
- package/plugins/specweave-github/lib/github-client-v2.js +97 -0
- package/plugins/specweave-github/lib/github-client-v2.ts +115 -1
- package/plugins/specweave-github/lib/github-spec-commit-sync.d.ts +1 -1
- package/plugins/specweave-github/lib/github-spec-commit-sync.js +1 -1
- package/plugins/specweave-github/lib/github-spec-commit-sync.ts +1 -1
- package/plugins/specweave-github/lib/github-spec-content-sync.js +1 -1
- package/plugins/specweave-github/lib/github-spec-content-sync.ts +1 -1
- package/plugins/specweave-github/lib/types.ts +21 -0
- package/plugins/specweave-infrastructure/agents/devops/AGENT.md +1 -1
- package/plugins/specweave-infrastructure/agents/network-engineer/AGENT.md +3 -3
- package/plugins/specweave-infrastructure/agents/observability-engineer/AGENT.md +2 -2
- package/plugins/specweave-infrastructure/agents/performance-engineer/AGENT.md +3 -3
- package/plugins/specweave-infrastructure/agents/sre/AGENT.md +2 -2
- package/plugins/specweave-jira/agents/jira-manager/AGENT.md +11 -1
- package/plugins/specweave-jira/commands/import-projects.js +1 -1
- package/plugins/specweave-jira/commands/import-projects.ts +1 -1
- package/plugins/specweave-jira/lib/jira-spec-commit-sync.d.ts +1 -1
- package/plugins/specweave-jira/lib/jira-spec-commit-sync.js +1 -1
- package/plugins/specweave-jira/lib/jira-spec-commit-sync.ts +1 -1
- package/plugins/specweave-jira/lib/jira-spec-content-sync.js +1 -1
- package/plugins/specweave-jira/lib/jira-spec-content-sync.ts +1 -1
- package/plugins/specweave-jira/lib/setup-wizard.js +2 -2
- package/plugins/specweave-jira/lib/setup-wizard.ts +2 -2
- package/plugins/specweave-jira/skills/specweave-jira-mapper/SKILL.md +1 -1
- package/plugins/specweave-kafka/agents/kafka-architect/AGENT.md +5 -1
- package/plugins/specweave-kafka/agents/kafka-devops/AGENT.md +6 -1
- package/plugins/specweave-kafka/agents/kafka-observability/AGENT.md +6 -1
- package/plugins/specweave-kubernetes/agents/kubernetes-architect/AGENT.md +3 -3
- package/plugins/specweave-ml/agents/data-scientist/AGENT.md +2 -1
- package/plugins/specweave-ml/agents/ml-engineer/AGENT.md +2 -1
- package/plugins/specweave-ml/agents/mlops-engineer/AGENT.md +3 -3
- package/plugins/specweave-mobile/agents/mobile-architect/AGENT.md +6 -1
- package/plugins/specweave-payments/agents/payment-integration/AGENT.md +3 -3
- package/plugins/specweave-release/agents/release-manager/AGENT.md +6 -1
- package/plugins/specweave-release/commands/specweave-release-npm.md +8 -0
- package/plugins/specweave-release/hooks/.specweave/logs/dora-tracking.log +135 -0
- package/plugins/specweave-testing/agents/qa-engineer/AGENT.md +5 -0
- package/src/templates/AGENTS.md.template +97 -0
- package/dist/src/core/cost-tracker.d.ts.map +0 -1
- package/dist/src/core/cost-tracker.js.map +0 -1
- package/dist/src/core/credentials-manager.d.ts.map +0 -1
- package/dist/src/core/credentials-manager.js.map +0 -1
- package/dist/src/core/increment-status.d.ts.map +0 -1
- package/dist/src/core/increment-status.js.map +0 -1
- package/dist/src/core/increment-utils.d.ts.map +0 -1
- package/dist/src/core/increment-utils.js.map +0 -1
- package/dist/src/core/plugin-loader.d.ts.map +0 -1
- package/dist/src/core/plugin-loader.js.map +0 -1
- package/dist/src/core/project-manager.d.ts.map +0 -1
- package/dist/src/core/project-manager.js.map +0 -1
- package/dist/src/core/project-structure-detector.d.ts.map +0 -1
- package/dist/src/core/project-structure-detector.js.map +0 -1
- package/dist/src/core/rfc-generator-v2.d.ts.map +0 -1
- package/dist/src/core/rfc-generator-v2.js.map +0 -1
- package/dist/src/core/spec-content-sync.d.ts.map +0 -1
- package/dist/src/core/spec-content-sync.js.map +0 -1
- package/dist/src/core/spec-detector.d.ts.map +0 -1
- package/dist/src/core/spec-detector.js.map +0 -1
- package/dist/src/core/spec-identifier-detector.d.ts.map +0 -1
- package/dist/src/core/spec-identifier-detector.js.map +0 -1
- package/dist/src/core/spec-task-mapper.d.ts.map +0 -1
- package/dist/src/core/spec-task-mapper.js.map +0 -1
- package/dist/src/utils/spec-parser.d.ts +0 -145
- package/dist/src/utils/spec-parser.d.ts.map +0 -1
- package/dist/src/utils/spec-parser.js +0 -640
- package/dist/src/utils/spec-parser.js.map +0 -1
- package/plugins/specweave/agents/pm/AGENT.md.bak2 +0 -1754
- package/plugins/specweave/hooks/hooks.json.bak +0 -72
- package/plugins/specweave/hooks/hooks.json.v1-backup +0 -16
- package/plugins/specweave/hooks/v2/hooks.json +0 -16
- /package/dist/src/core/{credentials-manager.d.ts → credentials/credentials-manager.d.ts} +0 -0
- /package/dist/src/core/{credentials-manager.js → credentials/credentials-manager.js} +0 -0
- /package/dist/src/core/{increment-status.d.ts → increment/increment-status.d.ts} +0 -0
- /package/dist/src/core/{increment-utils.d.ts → increment/increment-utils.d.ts} +0 -0
- /package/dist/src/core/{increment-utils.js → increment/increment-utils.js} +0 -0
- /package/dist/src/core/{project-structure-detector.d.ts → project/project-structure-detector.d.ts} +0 -0
- /package/dist/src/core/{project-structure-detector.js → project/project-structure-detector.js} +0 -0
- /package/dist/src/core/{spec-task-mapper.d.ts → specs/spec-task-mapper.d.ts} +0 -0
- /package/dist/src/core/{spec-task-mapper.js → specs/spec-task-mapper.js} +0 -0
|
@@ -0,0 +1,362 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Suggestions Generator - Final Phase of Living Docs Builder
|
|
3
|
+
*
|
|
4
|
+
* Produces actionable SUGGESTIONS.md with:
|
|
5
|
+
* 1. Summary statistics of documentation status
|
|
6
|
+
* 2. Priority zones based on work item density
|
|
7
|
+
* 3. Immediate actions with specific file paths
|
|
8
|
+
* 4. Gap analysis between modules and documentation
|
|
9
|
+
*/
|
|
10
|
+
import * as fs from '../../utils/fs-native.js';
|
|
11
|
+
import * as path from 'path';
|
|
12
|
+
/**
|
|
13
|
+
* Generate suggestions from all analysis data
|
|
14
|
+
*/
|
|
15
|
+
export async function generateSuggestions(projectPath, discovery, moduleAnalyses, matchResult, userInputs) {
|
|
16
|
+
// Build module statuses
|
|
17
|
+
const moduleStatuses = buildModuleStatuses(discovery, moduleAnalyses, matchResult);
|
|
18
|
+
// Calculate summary
|
|
19
|
+
const summary = calculateSummary(moduleStatuses, matchResult);
|
|
20
|
+
// Build priority zones
|
|
21
|
+
const priorityZones = buildPriorityZones(moduleStatuses, matchResult.priorityQueue);
|
|
22
|
+
// Generate immediate actions
|
|
23
|
+
const immediateActions = generateImmediateActions(moduleStatuses, priorityZones, userInputs);
|
|
24
|
+
// Track what wasn't analyzed
|
|
25
|
+
const notAnalyzed = trackNotAnalyzed(discovery, moduleAnalyses);
|
|
26
|
+
// Match pain points
|
|
27
|
+
const painPointsAddressed = matchPainPoints(userInputs.knownPainPoints, moduleStatuses);
|
|
28
|
+
return {
|
|
29
|
+
generatedAt: new Date().toISOString(),
|
|
30
|
+
summary,
|
|
31
|
+
priorityZones,
|
|
32
|
+
immediateActions,
|
|
33
|
+
moduleStatuses,
|
|
34
|
+
additionalSources: userInputs.additionalSources,
|
|
35
|
+
notAnalyzed,
|
|
36
|
+
painPointsAddressed
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Build documentation status for each module
|
|
41
|
+
*/
|
|
42
|
+
function buildModuleStatuses(discovery, analyses, matchResult) {
|
|
43
|
+
const statuses = [];
|
|
44
|
+
for (const module of discovery.modules) {
|
|
45
|
+
const analysis = analyses.get(module.name);
|
|
46
|
+
const mapping = matchResult.moduleMap.get(module.name);
|
|
47
|
+
const hasAnalysis = analysis?.docStatus === 'generated';
|
|
48
|
+
const hasReadme = module.hasReadme;
|
|
49
|
+
const workItemCount = mapping?.workItemCount || 0;
|
|
50
|
+
// Calculate coverage
|
|
51
|
+
let coverage = 0;
|
|
52
|
+
if (hasReadme)
|
|
53
|
+
coverage += 40;
|
|
54
|
+
if (hasAnalysis)
|
|
55
|
+
coverage += 40;
|
|
56
|
+
if (module.hasTests)
|
|
57
|
+
coverage += 20;
|
|
58
|
+
// Determine status
|
|
59
|
+
let status;
|
|
60
|
+
if (coverage >= 80)
|
|
61
|
+
status = 'complete';
|
|
62
|
+
else if (coverage > 0)
|
|
63
|
+
status = 'partial';
|
|
64
|
+
else
|
|
65
|
+
status = 'none';
|
|
66
|
+
statuses.push({
|
|
67
|
+
moduleName: module.name,
|
|
68
|
+
modulePath: module.path,
|
|
69
|
+
hasReadme,
|
|
70
|
+
hasAnalysis,
|
|
71
|
+
coverage,
|
|
72
|
+
workItemCount,
|
|
73
|
+
priority: mapping?.priority || 'low',
|
|
74
|
+
status
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
return statuses;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Calculate summary statistics
|
|
81
|
+
*/
|
|
82
|
+
function calculateSummary(statuses, matchResult) {
|
|
83
|
+
const documented = statuses.filter(s => s.status === 'complete').length;
|
|
84
|
+
const partial = statuses.filter(s => s.status === 'partial').length;
|
|
85
|
+
const undocumented = statuses.filter(s => s.status === 'none').length;
|
|
86
|
+
const totalCoverage = statuses.reduce((sum, s) => sum + s.coverage, 0);
|
|
87
|
+
const avgCoverage = statuses.length > 0 ? Math.round(totalCoverage / statuses.length) : 0;
|
|
88
|
+
return {
|
|
89
|
+
totalModules: statuses.length,
|
|
90
|
+
modulesDocumented: documented,
|
|
91
|
+
modulesPartial: partial,
|
|
92
|
+
modulesUndocumented: undocumented,
|
|
93
|
+
totalWorkItems: matchResult.stats.totalWorkItems,
|
|
94
|
+
matchedWorkItems: matchResult.stats.matchedWorkItems,
|
|
95
|
+
coveragePercent: avgCoverage
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* Build priority zones from module statuses and queue
|
|
100
|
+
*/
|
|
101
|
+
function buildPriorityZones(statuses, priorityQueue) {
|
|
102
|
+
const zones = [];
|
|
103
|
+
// Focus on top 10 by work item count
|
|
104
|
+
for (const entry of priorityQueue.slice(0, 10)) {
|
|
105
|
+
if (entry.workItemCount === 0)
|
|
106
|
+
continue;
|
|
107
|
+
const status = statuses.find(s => s.moduleName === entry.moduleName);
|
|
108
|
+
if (!status)
|
|
109
|
+
continue;
|
|
110
|
+
let action;
|
|
111
|
+
if (status.status === 'none') {
|
|
112
|
+
action = 'START HERE - Create comprehensive module documentation';
|
|
113
|
+
}
|
|
114
|
+
else if (status.status === 'partial') {
|
|
115
|
+
action = 'ENHANCE - Add detailed API docs and usage examples';
|
|
116
|
+
}
|
|
117
|
+
else {
|
|
118
|
+
action = 'REVIEW - Ensure docs match current work items';
|
|
119
|
+
}
|
|
120
|
+
zones.push({
|
|
121
|
+
name: entry.moduleName,
|
|
122
|
+
path: entry.modulePath,
|
|
123
|
+
workItems: entry.workItemCount,
|
|
124
|
+
docStatus: status.status,
|
|
125
|
+
action,
|
|
126
|
+
focusFiles: entry.topWorkItems.slice(0, 3)
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
return zones;
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* Generate immediate action items
|
|
133
|
+
*/
|
|
134
|
+
function generateImmediateActions(statuses, zones, userInputs) {
|
|
135
|
+
const actions = [];
|
|
136
|
+
let priority = 1;
|
|
137
|
+
// Action 1: Undocumented critical/high priority modules
|
|
138
|
+
const criticalUndoc = statuses
|
|
139
|
+
.filter(s => s.status === 'none' && (s.priority === 'critical' || s.priority === 'high'))
|
|
140
|
+
.slice(0, 3);
|
|
141
|
+
for (const status of criticalUndoc) {
|
|
142
|
+
actions.push({
|
|
143
|
+
priority: priority++,
|
|
144
|
+
module: status.moduleName,
|
|
145
|
+
action: 'Create README.md with module overview and key exports',
|
|
146
|
+
files: [`${status.modulePath}/README.md`],
|
|
147
|
+
reason: `${status.workItemCount} work items reference this undocumented module`
|
|
148
|
+
});
|
|
149
|
+
}
|
|
150
|
+
// Action 2: User priority areas without docs
|
|
151
|
+
for (const area of userInputs.priorityAreas) {
|
|
152
|
+
const matchingModule = statuses.find(s => s.moduleName.toLowerCase().includes(area.toLowerCase()) ||
|
|
153
|
+
s.modulePath.toLowerCase().includes(area.toLowerCase()));
|
|
154
|
+
if (matchingModule && matchingModule.status !== 'complete') {
|
|
155
|
+
actions.push({
|
|
156
|
+
priority: priority++,
|
|
157
|
+
module: matchingModule.moduleName,
|
|
158
|
+
action: `Document ${area} (user priority area)`,
|
|
159
|
+
files: [`${matchingModule.modulePath}/README.md`],
|
|
160
|
+
reason: `User identified "${area}" as priority area`
|
|
161
|
+
});
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
// Action 3: Top zones from priority queue
|
|
165
|
+
for (const zone of zones.slice(0, 3)) {
|
|
166
|
+
if (zone.docStatus === 'none') {
|
|
167
|
+
actions.push({
|
|
168
|
+
priority: priority++,
|
|
169
|
+
module: zone.name,
|
|
170
|
+
action: 'Create foundational documentation',
|
|
171
|
+
files: [
|
|
172
|
+
`${zone.path}/README.md`,
|
|
173
|
+
`${zone.path}/API.md`
|
|
174
|
+
],
|
|
175
|
+
reason: `High activity module with ${zone.workItems} related work items`
|
|
176
|
+
});
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
// Action 4: Modules with tests but no docs
|
|
180
|
+
const testedNoDoc = statuses
|
|
181
|
+
.filter(s => !s.hasReadme && s.coverage > 0)
|
|
182
|
+
.slice(0, 2);
|
|
183
|
+
for (const status of testedNoDoc) {
|
|
184
|
+
actions.push({
|
|
185
|
+
priority: priority++,
|
|
186
|
+
module: status.moduleName,
|
|
187
|
+
action: 'Add README based on existing test cases',
|
|
188
|
+
files: [`${status.modulePath}/README.md`],
|
|
189
|
+
reason: 'Has test coverage but lacks documentation'
|
|
190
|
+
});
|
|
191
|
+
}
|
|
192
|
+
// Limit to 10 actions
|
|
193
|
+
return actions.slice(0, 10);
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* Track directories not fully analyzed
|
|
197
|
+
*/
|
|
198
|
+
function trackNotAnalyzed(discovery, analyses) {
|
|
199
|
+
const notAnalyzed = [];
|
|
200
|
+
// Check for sampled modules
|
|
201
|
+
for (const module of discovery.modules) {
|
|
202
|
+
const analysis = analyses.get(module.name);
|
|
203
|
+
if (!analysis) {
|
|
204
|
+
notAnalyzed.push({
|
|
205
|
+
path: module.path,
|
|
206
|
+
reason: 'Analysis skipped',
|
|
207
|
+
filesSkipped: module.fileCount
|
|
208
|
+
});
|
|
209
|
+
}
|
|
210
|
+
else if (analysis.filesSkipped > 0) {
|
|
211
|
+
notAnalyzed.push({
|
|
212
|
+
path: module.path,
|
|
213
|
+
reason: `Sampled (tier: ${discovery.tier})`,
|
|
214
|
+
filesSkipped: analysis.filesSkipped
|
|
215
|
+
});
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
return notAnalyzed;
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
* Match user pain points to modules
|
|
222
|
+
*/
|
|
223
|
+
function matchPainPoints(painPoints, statuses) {
|
|
224
|
+
const addressed = [];
|
|
225
|
+
for (const painPoint of painPoints) {
|
|
226
|
+
const lowerPain = painPoint.toLowerCase();
|
|
227
|
+
for (const status of statuses) {
|
|
228
|
+
if (status.moduleName.toLowerCase().includes(lowerPain) ||
|
|
229
|
+
status.modulePath.toLowerCase().includes(lowerPain)) {
|
|
230
|
+
addressed.push(`"${painPoint}" → Documented in ${status.moduleName} (${status.status})`);
|
|
231
|
+
break;
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
return addressed;
|
|
236
|
+
}
|
|
237
|
+
/**
|
|
238
|
+
* Format suggestions report as markdown
|
|
239
|
+
*/
|
|
240
|
+
export function formatSuggestionsMarkdown(report) {
|
|
241
|
+
const lines = [];
|
|
242
|
+
lines.push('# Living Docs Suggestions');
|
|
243
|
+
lines.push('');
|
|
244
|
+
lines.push(`*Generated: ${new Date(report.generatedAt).toLocaleString()}*`);
|
|
245
|
+
lines.push('');
|
|
246
|
+
// Summary
|
|
247
|
+
lines.push('## Summary');
|
|
248
|
+
lines.push('');
|
|
249
|
+
lines.push('| Metric | Value |');
|
|
250
|
+
lines.push('|--------|-------|');
|
|
251
|
+
lines.push(`| Total Modules | ${report.summary.totalModules} |`);
|
|
252
|
+
lines.push(`| Fully Documented | ${report.summary.modulesDocumented} |`);
|
|
253
|
+
lines.push(`| Partially Documented | ${report.summary.modulesPartial} |`);
|
|
254
|
+
lines.push(`| Undocumented | ${report.summary.modulesUndocumented} |`);
|
|
255
|
+
lines.push(`| Documentation Coverage | ${report.summary.coveragePercent}% |`);
|
|
256
|
+
lines.push(`| Work Items Matched | ${report.summary.matchedWorkItems}/${report.summary.totalWorkItems} |`);
|
|
257
|
+
lines.push('');
|
|
258
|
+
// Priority Zones
|
|
259
|
+
if (report.priorityZones.length > 0) {
|
|
260
|
+
lines.push('## Priority Zones');
|
|
261
|
+
lines.push('');
|
|
262
|
+
lines.push('These modules have the most work items and need attention:');
|
|
263
|
+
lines.push('');
|
|
264
|
+
lines.push('| Module | Path | Work Items | Status | Action |');
|
|
265
|
+
lines.push('|--------|------|------------|--------|--------|');
|
|
266
|
+
for (const zone of report.priorityZones) {
|
|
267
|
+
const statusIcon = zone.docStatus === 'complete' ? '✅' : zone.docStatus === 'partial' ? '⚠️' : '❌';
|
|
268
|
+
lines.push(`| ${zone.name} | \`${zone.path}\` | ${zone.workItems} | ${statusIcon} | ${zone.action} |`);
|
|
269
|
+
}
|
|
270
|
+
lines.push('');
|
|
271
|
+
}
|
|
272
|
+
// Immediate Actions
|
|
273
|
+
if (report.immediateActions.length > 0) {
|
|
274
|
+
lines.push('## Immediate Actions');
|
|
275
|
+
lines.push('');
|
|
276
|
+
for (const action of report.immediateActions) {
|
|
277
|
+
lines.push(`### ${action.priority}. ${action.module}`);
|
|
278
|
+
lines.push('');
|
|
279
|
+
lines.push(`**Action**: ${action.action}`);
|
|
280
|
+
lines.push('');
|
|
281
|
+
lines.push(`**Reason**: ${action.reason}`);
|
|
282
|
+
lines.push('');
|
|
283
|
+
lines.push('**Files**:');
|
|
284
|
+
for (const file of action.files) {
|
|
285
|
+
lines.push(`- \`${file}\``);
|
|
286
|
+
}
|
|
287
|
+
lines.push('');
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
// Additional Sources
|
|
291
|
+
if (report.additionalSources.length > 0) {
|
|
292
|
+
lines.push('## Additional Sources Processed');
|
|
293
|
+
lines.push('');
|
|
294
|
+
for (const source of report.additionalSources) {
|
|
295
|
+
lines.push(`- \`${source}\``);
|
|
296
|
+
}
|
|
297
|
+
lines.push('');
|
|
298
|
+
}
|
|
299
|
+
// Pain Points
|
|
300
|
+
if (report.painPointsAddressed.length > 0) {
|
|
301
|
+
lines.push('## Known Pain Points Addressed');
|
|
302
|
+
lines.push('');
|
|
303
|
+
for (const pp of report.painPointsAddressed) {
|
|
304
|
+
lines.push(`- ${pp}`);
|
|
305
|
+
}
|
|
306
|
+
lines.push('');
|
|
307
|
+
}
|
|
308
|
+
// Not Analyzed
|
|
309
|
+
if (report.notAnalyzed.length > 0) {
|
|
310
|
+
lines.push('## Directories Not Fully Analyzed');
|
|
311
|
+
lines.push('');
|
|
312
|
+
lines.push('Due to codebase size, these directories were sampled:');
|
|
313
|
+
lines.push('');
|
|
314
|
+
lines.push('| Path | Reason | Files Skipped |');
|
|
315
|
+
lines.push('|------|--------|---------------|');
|
|
316
|
+
for (const item of report.notAnalyzed.slice(0, 20)) {
|
|
317
|
+
lines.push(`| \`${item.path}\` | ${item.reason} | ${item.filesSkipped} |`);
|
|
318
|
+
}
|
|
319
|
+
if (report.notAnalyzed.length > 20) {
|
|
320
|
+
lines.push(`| ... | ${report.notAnalyzed.length - 20} more | - |`);
|
|
321
|
+
}
|
|
322
|
+
lines.push('');
|
|
323
|
+
}
|
|
324
|
+
// Module Status Table
|
|
325
|
+
lines.push('## Module Documentation Status');
|
|
326
|
+
lines.push('');
|
|
327
|
+
lines.push('<details>');
|
|
328
|
+
lines.push('<summary>Click to expand full module list</summary>');
|
|
329
|
+
lines.push('');
|
|
330
|
+
lines.push('| Module | Path | README | Analysis | Coverage | Work Items | Priority |');
|
|
331
|
+
lines.push('|--------|------|--------|----------|----------|------------|----------|');
|
|
332
|
+
for (const status of report.moduleStatuses) {
|
|
333
|
+
const readme = status.hasReadme ? '✅' : '❌';
|
|
334
|
+
const analysis = status.hasAnalysis ? '✅' : '❌';
|
|
335
|
+
lines.push(`| ${status.moduleName} | \`${status.modulePath}\` | ${readme} | ${analysis} | ${status.coverage}% | ${status.workItemCount} | ${status.priority} |`);
|
|
336
|
+
}
|
|
337
|
+
lines.push('');
|
|
338
|
+
lines.push('</details>');
|
|
339
|
+
lines.push('');
|
|
340
|
+
// Footer
|
|
341
|
+
lines.push('---');
|
|
342
|
+
lines.push('');
|
|
343
|
+
lines.push('*Generated by SpecWeave Living Docs Builder*');
|
|
344
|
+
lines.push('');
|
|
345
|
+
lines.push('To regenerate this report, run `/specweave:jobs` and restart the living-docs job.');
|
|
346
|
+
return lines.join('\n');
|
|
347
|
+
}
|
|
348
|
+
/**
|
|
349
|
+
* Save suggestions report to disk
|
|
350
|
+
*/
|
|
351
|
+
export async function saveSuggestionsReport(projectPath, report) {
|
|
352
|
+
const outputDir = path.join(projectPath, '.specweave', 'docs');
|
|
353
|
+
fs.ensureDirSync(outputDir);
|
|
354
|
+
const markdown = formatSuggestionsMarkdown(report);
|
|
355
|
+
const outputPath = path.join(outputDir, 'SUGGESTIONS.md');
|
|
356
|
+
fs.writeFileSync(outputPath, markdown);
|
|
357
|
+
// Also save JSON for programmatic access
|
|
358
|
+
const jsonPath = path.join(outputDir, 'suggestions.json');
|
|
359
|
+
fs.writeFileSync(jsonPath, JSON.stringify(report, null, 2));
|
|
360
|
+
return outputPath;
|
|
361
|
+
}
|
|
362
|
+
//# sourceMappingURL=suggestions-generator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"suggestions-generator.js","sourceRoot":"","sources":["../../../../src/core/living-docs/suggestions-generator.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Work Item Matcher - Matches imported work items to discovered modules
|
|
3
|
+
*
|
|
4
|
+
* Used by Living Docs Builder to:
|
|
5
|
+
* 1. Load work items from .specweave/docs/internal/specs/
|
|
6
|
+
* 2. Match them to modules based on keywords and paths
|
|
7
|
+
* 3. Generate priority queue for documentation focus
|
|
8
|
+
*/
|
|
9
|
+
import type { DiscoveryResult } from './discovery.js';
|
|
10
|
+
/**
|
|
11
|
+
* Work item representation (from user story files)
|
|
12
|
+
*/
|
|
13
|
+
export interface WorkItem {
|
|
14
|
+
/** ID (e.g., "US-001", "US-002E") */
|
|
15
|
+
id: string;
|
|
16
|
+
/** Feature ID (e.g., "FS-031") */
|
|
17
|
+
featureId: string;
|
|
18
|
+
/** Title */
|
|
19
|
+
title: string;
|
|
20
|
+
/** Description */
|
|
21
|
+
description?: string;
|
|
22
|
+
/** Status */
|
|
23
|
+
status?: string;
|
|
24
|
+
/** Priority */
|
|
25
|
+
priority?: string;
|
|
26
|
+
/** Original file path */
|
|
27
|
+
filePath: string;
|
|
28
|
+
/** External source if imported */
|
|
29
|
+
externalSource?: 'github' | 'jira' | 'ado';
|
|
30
|
+
/** External ID */
|
|
31
|
+
externalId?: string;
|
|
32
|
+
/** Keywords extracted from title and description */
|
|
33
|
+
keywords: string[];
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Match between work item and module
|
|
37
|
+
*/
|
|
38
|
+
export interface WorkItemMatch {
|
|
39
|
+
/** Work item */
|
|
40
|
+
workItem: WorkItem;
|
|
41
|
+
/** Match score (0-100) */
|
|
42
|
+
score: number;
|
|
43
|
+
/** Reasons for match */
|
|
44
|
+
reasons: string[];
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Module with matched work items
|
|
48
|
+
*/
|
|
49
|
+
export interface ModuleWorkItemMapping {
|
|
50
|
+
/** Module name */
|
|
51
|
+
moduleName: string;
|
|
52
|
+
/** Module path */
|
|
53
|
+
modulePath: string;
|
|
54
|
+
/** Matched work items with scores */
|
|
55
|
+
matches: WorkItemMatch[];
|
|
56
|
+
/** Total work item count */
|
|
57
|
+
workItemCount: number;
|
|
58
|
+
/** Priority based on work item count */
|
|
59
|
+
priority: 'critical' | 'high' | 'medium' | 'low';
|
|
60
|
+
/** Documentation status */
|
|
61
|
+
docStatus: 'complete' | 'partial' | 'none';
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Priority queue entry
|
|
65
|
+
*/
|
|
66
|
+
export interface PriorityQueueEntry {
|
|
67
|
+
/** Module name */
|
|
68
|
+
moduleName: string;
|
|
69
|
+
/** Module path */
|
|
70
|
+
modulePath: string;
|
|
71
|
+
/** Work item count */
|
|
72
|
+
workItemCount: number;
|
|
73
|
+
/** Priority level */
|
|
74
|
+
priority: 'critical' | 'high' | 'medium' | 'low';
|
|
75
|
+
/** Top work items (up to 5) */
|
|
76
|
+
topWorkItems: string[];
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Work item matching result
|
|
80
|
+
*/
|
|
81
|
+
export interface WorkItemMatchResult {
|
|
82
|
+
/** Full mapping of modules to work items */
|
|
83
|
+
moduleMap: Map<string, ModuleWorkItemMapping>;
|
|
84
|
+
/** Priority queue sorted by work item count */
|
|
85
|
+
priorityQueue: PriorityQueueEntry[];
|
|
86
|
+
/** Work items that couldn't be matched */
|
|
87
|
+
unmatchedItems: WorkItem[];
|
|
88
|
+
/** Statistics */
|
|
89
|
+
stats: {
|
|
90
|
+
totalWorkItems: number;
|
|
91
|
+
matchedWorkItems: number;
|
|
92
|
+
unmatchedWorkItems: number;
|
|
93
|
+
modulesWithWorkItems: number;
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Progress callback
|
|
98
|
+
*/
|
|
99
|
+
export type MatcherProgressCallback = (phase: 'loading' | 'matching' | 'ranking', current: number, total: number) => void;
|
|
100
|
+
/**
|
|
101
|
+
* Load imported work items from specs directory
|
|
102
|
+
*/
|
|
103
|
+
export declare function loadImportedWorkItems(projectPath: string, onProgress?: MatcherProgressCallback): Promise<WorkItem[]>;
|
|
104
|
+
/**
|
|
105
|
+
* Match work items to discovered modules
|
|
106
|
+
*/
|
|
107
|
+
export declare function matchWorkItemsToModules(projectPath: string, discovery: DiscoveryResult, workItems: WorkItem[], onProgress?: MatcherProgressCallback): Promise<WorkItemMatchResult>;
|
|
108
|
+
/**
|
|
109
|
+
* Save work item matching results to files
|
|
110
|
+
*/
|
|
111
|
+
export declare function saveMatchingResults(projectPath: string, result: WorkItemMatchResult): Promise<string[]>;
|
|
112
|
+
/**
|
|
113
|
+
* Get match reason as human-readable string
|
|
114
|
+
*/
|
|
115
|
+
export declare function getMatchReason(match: WorkItemMatch): string;
|
|
116
|
+
//# sourceMappingURL=workitem-matcher.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workitem-matcher.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/workitem-matcher.ts"],"names":[],"mappings":"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"}
|