kortext 3.0.0 → 3.1.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 +159 -139
- package/agents/architect.md +85 -0
- package/agents/compliance-expert.md +36 -75
- package/agents/copywriter.md +36 -92
- package/agents/db-admin.md +43 -91
- package/agents/designer.md +40 -77
- package/agents/devops-engineer.md +37 -113
- package/agents/growth-expert.md +45 -88
- package/agents/product-manager.md +38 -83
- package/agents/qa-engineer.md +51 -99
- package/agents/security-engineer.md +47 -92
- package/bin/kortext.js +1 -22
- package/dist/app.js +829 -0
- package/dist/cli-spawn.js +137 -0
- package/dist/daemon.js +40 -0
- package/dist/db.js +78 -0
- package/dist/design-preview.js +533 -0
- package/dist/docs.js +701 -0
- package/dist/engines.js +225 -0
- package/dist/index.js +109 -0
- package/dist/pick-directory.js +38 -0
- package/dist/projects.js +189 -0
- package/dist/readiness.js +288 -0
- package/dist/runner.js +771 -0
- package/dist/update.js +55 -0
- package/docs/CHANGELOG.md +11 -0
- package/package.json +25 -57
- package/templates/AGENTS.md +62 -0
- package/templates/docs/API.md +67 -0
- package/templates/docs/ARCHITECTURE.md +31 -0
- package/templates/docs/BRIEF.md +27 -0
- package/templates/docs/CONTENT.md +66 -0
- package/templates/docs/DATABASE.md +63 -0
- package/templates/docs/DESIGN.md +124 -0
- package/templates/docs/ENGINEERING.md +66 -0
- package/templates/docs/ENVIRONMENT.md +102 -0
- package/templates/docs/GROWTH.md +44 -0
- package/templates/docs/LEGAL.md +48 -0
- package/templates/docs/PRODUCT.md +43 -0
- package/templates/docs/SECURITY.md +65 -0
- package/templates/docs/STACK.md +57 -0
- package/templates/docs/STRUCTURE.md +73 -0
- package/templates/docs/TEST.md +62 -0
- package/ui/dist/assets/abnfDiagram-VCTEODGH-Bm7Q2BML.js +1 -0
- package/ui/dist/assets/arc-BV9hs0Hu.js +1 -0
- package/ui/dist/assets/architecture-7GRP2DOG-RckR3gBI.js +1 -0
- package/ui/dist/assets/architectureDiagram-5GKGNRK7-CHiJ6JFT.js +36 -0
- package/ui/dist/assets/array-BifhSqXX.js +1 -0
- package/ui/dist/assets/blockDiagram-I7D4REHJ-qCbaKVhd.js +129 -0
- package/ui/dist/assets/c4Diagram-7LVT6UL2-DidCDJrv.js +38 -0
- package/ui/dist/assets/channel-CNUQ11ne.js +1 -0
- package/ui/dist/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
- package/ui/dist/assets/chunk-4HAMMTFA-CDGFjfVp.js +62 -0
- package/ui/dist/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -0
- package/ui/dist/assets/chunk-75Z2AOVW-CbNT4sDh.js +2 -0
- package/ui/dist/assets/chunk-DU6HZSFF-Cq2BVv26.js +127 -0
- package/ui/dist/assets/chunk-F27PBJKO-CE365m0v.js +1 -0
- package/ui/dist/assets/chunk-FOHPRMQF-DHwB1DNv.js +161 -0
- package/ui/dist/assets/chunk-GMAD6QVW-DxWL1VC-.js +72 -0
- package/ui/dist/assets/chunk-GVQU2GXP-aARV8YbK.js +1 -0
- package/ui/dist/assets/chunk-IMKFNOWR-CC790Kt2.js +231 -0
- package/ui/dist/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
- package/ui/dist/assets/chunk-L3NEJ4N5-BfE4VE8J.js +1 -0
- package/ui/dist/assets/chunk-OSK3NFVY-BImQbSWH.js +10 -0
- package/ui/dist/assets/chunk-P2QGCYS3-CN3XD313.js +1 -0
- package/ui/dist/assets/chunk-POPQ4Y6H-Dqb6jOrX.js +1 -0
- package/ui/dist/assets/chunk-PWAF6VOD-DfXX6rBk.js +1 -0
- package/ui/dist/assets/chunk-SHT3W25Y-DATyyqPK.js +168 -0
- package/ui/dist/assets/chunk-SVP7TREG-r1chwRmg.js +88 -0
- package/ui/dist/assets/chunk-TICWLB2K-DL4atHUC.js +206 -0
- package/ui/dist/assets/chunk-XXDRQBXY-DXrM6jh7.js +1 -0
- package/ui/dist/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
- package/ui/dist/assets/classDiagram-ZZMXUADV-BpQxfIQ7.js +1 -0
- package/ui/dist/assets/classDiagram-v2-VYDZK3BY-BpQxfIQ7.js +1 -0
- package/ui/dist/assets/cose-bilkent-JH36ORCC-Bhe-ZBlS.js +1 -0
- package/ui/dist/assets/cynefin-OW5HDTMX-D1koLd-G.js +1 -0
- package/ui/dist/assets/cynefinDiagram-5FMLGOSQ-BMcw40hV.js +62 -0
- package/ui/dist/assets/cytoscape.esm-CGd-uY3x.js +321 -0
- package/ui/dist/assets/dagre-GXQ25YYZ-DBun-Rs2.js +4 -0
- package/ui/dist/assets/dagre-PrKaheQc.js +1 -0
- package/ui/dist/assets/defaultLocale-BFoDCU3G.js +1 -0
- package/ui/dist/assets/diagram-S7CK7UJ4-C1fUIGvo.js +30 -0
- package/ui/dist/assets/diagram-UQ7AKVKN-B5FDfkvB.js +41 -0
- package/ui/dist/assets/diagram-VSXAHHWV-CCIpOCNC.js +3 -0
- package/ui/dist/assets/diagram-VX7I27RA-DV0q2xo_.js +24 -0
- package/ui/dist/assets/diagram-Z3DM3KII-B3LCdNgI.js +24 -0
- package/ui/dist/assets/dist-EcW76Zvr.js +1 -0
- package/ui/dist/assets/ebnfDiagram-PWID7BFC-De_oRbYe.js +1 -0
- package/ui/dist/assets/erDiagram-RLTQ6QDP-B9NikMr1.js +99 -0
- package/ui/dist/assets/eventmodeling-NTZA5JFV-DZ4t581k.js +1 -0
- package/ui/dist/assets/flowDiagram-HODETNUW-DuTOJp1C.js +1 -0
- package/ui/dist/assets/ganttDiagram-EL5Y4UJY-BVTqqlPw.js +292 -0
- package/ui/dist/assets/gitGraph-4MIJSDKK-xRFaEJdZ.js +1 -0
- package/ui/dist/assets/gitGraphDiagram-WWUBYQGX-CK5_GCmX.js +106 -0
- package/ui/dist/assets/graphlib-DS17s2tU.js +1 -0
- package/ui/dist/assets/index-CjkpNftW.js +46 -0
- package/ui/dist/assets/index-DVIDTWin.css +1 -0
- package/ui/dist/assets/info-A6RAGUB7-Dg7z-CTI.js +1 -0
- package/ui/dist/assets/infoDiagram-27XIBGKW-YaqsOXh0.js +2 -0
- package/ui/dist/assets/init-C-OQMol4.js +1 -0
- package/ui/dist/assets/ishikawaDiagram-5VMMS53U-C-wtxZPa.js +70 -0
- package/ui/dist/assets/journeyDiagram-3NMN7TZE-DsXSXf16.js +139 -0
- package/ui/dist/assets/kanban-definition-UXKFOSKX-Ct59fuWk.js +89 -0
- package/ui/dist/assets/katex-CXMH3UgJ.js +257 -0
- package/ui/dist/assets/line-BUVw9Mhs.js +1 -0
- package/ui/dist/assets/linear-D8ncLO0X.js +1 -0
- package/ui/dist/assets/mermaid-parser.core-BDC4bG-O.js +7 -0
- package/ui/dist/assets/mermaid.core-DZY3WwzX.js +44 -0
- package/ui/dist/assets/mindmap-definition-YA3MSWOX-DtiuF6Ce.js +96 -0
- package/ui/dist/assets/ordinal-BDEzSJ7C.js +1 -0
- package/ui/dist/assets/packet-AYTQ26CC-BX2-w9rD.js +1 -0
- package/ui/dist/assets/path-fybaL0A-.js +1 -0
- package/ui/dist/assets/pegDiagram-XKGWAZYB-CotwuIHB.js +1 -0
- package/ui/dist/assets/pie-WAS4IAKB-Hth8ZVpm.js +1 -0
- package/ui/dist/assets/pieDiagram-E7YTZNPT-D9-INs8B.js +39 -0
- package/ui/dist/assets/quadrantDiagram-AXDQQJYC-CMtBXZGV.js +7 -0
- package/ui/dist/assets/radar-RG4KPBEZ-6UuwQPsw.js +1 -0
- package/ui/dist/assets/railroad-74A4TZTK-BF5TZgj0.js +1 -0
- package/ui/dist/assets/railroad-abnf-HS5TGJTU-3KYovtYT.js +1 -0
- package/ui/dist/assets/railroad-ebnf-LZEXJU2U-DeP4WedE.js +1 -0
- package/ui/dist/assets/railroad-peg-WCYAUIDC-i42N1-yk.js +1 -0
- package/ui/dist/assets/railroadDiagram-O6MQD6OU-BS6zkU3Z.js +1 -0
- package/ui/dist/assets/requirementDiagram-BXWQKSXE-J4IOB-kP.js +84 -0
- package/ui/dist/assets/rough.esm-Dy-Kn_BL.js +1 -0
- package/ui/dist/assets/sankeyDiagram-P5KCCOFB-jYTCuYzQ.js +40 -0
- package/ui/dist/assets/sequenceDiagram-WJ2MYXX4-Cd2r6PW-.js +162 -0
- package/ui/dist/assets/sizeCapture-INFHLROL-B0uUizjq.js +1 -0
- package/ui/dist/assets/src-7TsfZXRO.js +1 -0
- package/ui/dist/assets/stateDiagram-D77RDMKH-DXOdtOKe.js +1 -0
- package/ui/dist/assets/stateDiagram-v2-MP3YSRHH-9h7sIf3R.js +1 -0
- package/ui/dist/assets/swimlanes-42K2YHIH-BvJGmGs1.js +1 -0
- package/ui/dist/assets/swimlanesDiagram-VR7AAH4N-QA4gPi6a.js +8 -0
- package/ui/dist/assets/timeline-definition-24CTP7MA-CAaD6-yd.js +120 -0
- package/ui/dist/assets/treeView-Q6P3EWNA-4gDEXIyJ.js +1 -0
- package/ui/dist/assets/treemap-WGGIJYW6-CGel5TwW.js +1 -0
- package/ui/dist/assets/vennDiagram-4TSXK5OY-DpxsKboL.js +34 -0
- package/ui/dist/assets/wardley-WFR3VGLG-Ck38v5ns.js +1 -0
- package/ui/dist/assets/wardleyDiagram-VM6X3IG4-Ba0grrqs.js +78 -0
- package/ui/dist/assets/xychartDiagram-S5SC5T6Z-DH_gC96K.js +7 -0
- package/ui/dist/index.html +13 -0
- package/ui/dist/kortext-logo-dark.svg +41 -0
- package/ui/dist/kortext-logo.svg +41 -0
- package/workflows/existing-project-analysis.md +87 -0
- package/workflows/new-project-analysis.md +98 -0
- package/workflows/planning-pipeline.md +61 -0
- package/AGENTS.md +0 -24
- package/CHANGELOG.md +0 -81
- package/USER-GUIDE.md +0 -505
- package/agents/backend-developer.md +0 -132
- package/agents/delivery-manager.md +0 -121
- package/agents/engineering-manager.md +0 -208
- package/agents/frontend-developer.md +0 -174
- package/agents/operation-manager.md +0 -122
- package/bin/kortext.ts +0 -377
- package/dist/bin/kortext.js +0 -346
- package/dist/bin/kortext.js.map +0 -1
- package/dist/mcp/index.js +0 -4
- package/dist/mcp/index.js.map +0 -1
- package/dist/mcp/server.js +0 -553
- package/dist/mcp/server.js.map +0 -1
- package/dist/mcp/sse.js +0 -38
- package/dist/mcp/sse.js.map +0 -1
- package/dist/mcp/stdio.js +0 -44
- package/dist/mcp/stdio.js.map +0 -1
- package/dist/server/cli/cleanup.js +0 -73
- package/dist/server/cli/cleanup.js.map +0 -1
- package/dist/server/cli/commands.js +0 -73
- package/dist/server/cli/commands.js.map +0 -1
- package/dist/server/cli/doctor.js +0 -118
- package/dist/server/cli/doctor.js.map +0 -1
- package/dist/server/cli/executor-factory.js +0 -39
- package/dist/server/cli/executor-factory.js.map +0 -1
- package/dist/server/cli/init.js +0 -121
- package/dist/server/cli/init.js.map +0 -1
- package/dist/server/cli/logs.js +0 -28
- package/dist/server/cli/logs.js.map +0 -1
- package/dist/server/cli/serve.js +0 -72
- package/dist/server/cli/serve.js.map +0 -1
- package/dist/server/config/env.js +0 -12
- package/dist/server/config/env.js.map +0 -1
- package/dist/server/db/client.js +0 -32
- package/dist/server/db/client.js.map +0 -1
- package/dist/server/db/json.js +0 -21
- package/dist/server/db/json.js.map +0 -1
- package/dist/server/db/migrate.js +0 -70
- package/dist/server/db/migrate.js.map +0 -1
- package/dist/server/db/migrations/001_init.sql +0 -243
- package/dist/server/db/repositories/audit-log.js +0 -58
- package/dist/server/db/repositories/audit-log.js.map +0 -1
- package/dist/server/db/repositories/backlog.js +0 -96
- package/dist/server/db/repositories/backlog.js.map +0 -1
- package/dist/server/db/repositories/contexts.js +0 -54
- package/dist/server/db/repositories/contexts.js.map +0 -1
- package/dist/server/db/repositories/decisions.js +0 -71
- package/dist/server/db/repositories/decisions.js.map +0 -1
- package/dist/server/db/repositories/handovers.js +0 -53
- package/dist/server/db/repositories/handovers.js.map +0 -1
- package/dist/server/db/repositories/index.js +0 -30
- package/dist/server/db/repositories/index.js.map +0 -1
- package/dist/server/db/repositories/locks.js +0 -59
- package/dist/server/db/repositories/locks.js.map +0 -1
- package/dist/server/db/repositories/notifications.js +0 -63
- package/dist/server/db/repositories/notifications.js.map +0 -1
- package/dist/server/db/repositories/pending-questions.js +0 -63
- package/dist/server/db/repositories/pending-questions.js.map +0 -1
- package/dist/server/db/repositories/runs.js +0 -138
- package/dist/server/db/repositories/runs.js.map +0 -1
- package/dist/server/db/repositories/runtime-artifacts.js +0 -39
- package/dist/server/db/repositories/runtime-artifacts.js.map +0 -1
- package/dist/server/db/repositories/secrets.js +0 -65
- package/dist/server/db/repositories/secrets.js.map +0 -1
- package/dist/server/db/repositories/sessions.js +0 -48
- package/dist/server/db/repositories/sessions.js.map +0 -1
- package/dist/server/db/schemas.js +0 -308
- package/dist/server/db/schemas.js.map +0 -1
- package/dist/server/engine/consistency.js +0 -25
- package/dist/server/engine/consistency.js.map +0 -1
- package/dist/server/engine/dag.js +0 -86
- package/dist/server/engine/dag.js.map +0 -1
- package/dist/server/engine/executor.js +0 -2
- package/dist/server/engine/executor.js.map +0 -1
- package/dist/server/engine/executors/claude-cli-executor.js +0 -83
- package/dist/server/engine/executors/claude-cli-executor.js.map +0 -1
- package/dist/server/engine/executors/cli-spawn.js +0 -127
- package/dist/server/engine/executors/cli-spawn.js.map +0 -1
- package/dist/server/engine/executors/codex-cli-executor.js +0 -69
- package/dist/server/engine/executors/codex-cli-executor.js.map +0 -1
- package/dist/server/engine/executors/gemini-cli-executor.js +0 -69
- package/dist/server/engine/executors/gemini-cli-executor.js.map +0 -1
- package/dist/server/engine/executors/mock-executor.js +0 -52
- package/dist/server/engine/executors/mock-executor.js.map +0 -1
- package/dist/server/engine/executors/persona-routed-executor.js +0 -17
- package/dist/server/engine/executors/persona-routed-executor.js.map +0 -1
- package/dist/server/engine/gate-enforcer.js +0 -75
- package/dist/server/engine/gate-enforcer.js.map +0 -1
- package/dist/server/engine/git-commit.js +0 -42
- package/dist/server/engine/git-commit.js.map +0 -1
- package/dist/server/engine/handover.js +0 -120
- package/dist/server/engine/handover.js.map +0 -1
- package/dist/server/engine/item-lifecycle.js +0 -74
- package/dist/server/engine/item-lifecycle.js.map +0 -1
- package/dist/server/engine/persona-registry.js +0 -108
- package/dist/server/engine/persona-registry.js.map +0 -1
- package/dist/server/engine/worker-pool.js +0 -324
- package/dist/server/engine/worker-pool.js.map +0 -1
- package/dist/server/engine/workflow-loader.js +0 -55
- package/dist/server/engine/workflow-loader.js.map +0 -1
- package/dist/server/engine/workflow-parser.js +0 -158
- package/dist/server/engine/workflow-parser.js.map +0 -1
- package/dist/server/engine/worktree.js +0 -176
- package/dist/server/engine/worktree.js.map +0 -1
- package/dist/server/index.js +0 -99
- package/dist/server/index.js.map +0 -1
- package/dist/server/notifications/dispatcher.js +0 -60
- package/dist/server/notifications/dispatcher.js.map +0 -1
- package/dist/server/notifications/slack.js +0 -37
- package/dist/server/notifications/slack.js.map +0 -1
- package/dist/server/notifications/telegram.js +0 -33
- package/dist/server/notifications/telegram.js.map +0 -1
- package/dist/server/orchestrator/approval-queue.js +0 -83
- package/dist/server/orchestrator/approval-queue.js.map +0 -1
- package/dist/server/orchestrator/blueprint-watcher.js +0 -94
- package/dist/server/orchestrator/blueprint-watcher.js.map +0 -1
- package/dist/server/orchestrator/orchestrator.js +0 -283
- package/dist/server/orchestrator/orchestrator.js.map +0 -1
- package/dist/server/orchestrator/pipeline-chainer.js +0 -96
- package/dist/server/orchestrator/pipeline-chainer.js.map +0 -1
- package/dist/server/orchestrator/resume.js +0 -36
- package/dist/server/orchestrator/resume.js.map +0 -1
- package/dist/server/routes/approvals.js +0 -52
- package/dist/server/routes/approvals.js.map +0 -1
- package/dist/server/routes/backlog.js +0 -44
- package/dist/server/routes/backlog.js.map +0 -1
- package/dist/server/routes/db-info.js +0 -21
- package/dist/server/routes/db-info.js.map +0 -1
- package/dist/server/routes/docs.js +0 -70
- package/dist/server/routes/docs.js.map +0 -1
- package/dist/server/routes/doctor.js +0 -19
- package/dist/server/routes/doctor.js.map +0 -1
- package/dist/server/routes/handovers.js +0 -25
- package/dist/server/routes/handovers.js.map +0 -1
- package/dist/server/routes/health.js +0 -11
- package/dist/server/routes/health.js.map +0 -1
- package/dist/server/routes/personas.js +0 -96
- package/dist/server/routes/personas.js.map +0 -1
- package/dist/server/routes/runs.js +0 -41
- package/dist/server/routes/runs.js.map +0 -1
- package/dist/server/routes/workflows.js +0 -38
- package/dist/server/routes/workflows.js.map +0 -1
- package/dist/server/safety/harmful-output-filter.js +0 -40
- package/dist/server/safety/harmful-output-filter.js.map +0 -1
- package/dist/server/safety/secret-scanner.js +0 -169
- package/dist/server/safety/secret-scanner.js.map +0 -1
- package/dist/server/services/markdown-sync.js +0 -101
- package/dist/server/services/markdown-sync.js.map +0 -1
- package/dist/web/assets/index-B80d5ZPZ.js +0 -75
- package/dist/web/assets/index-B80d5ZPZ.js.map +0 -1
- package/dist/web/assets/index-Bge5Gzqv.css +0 -1
- package/dist/web/index.html +0 -13
- package/docs/architecture.md +0 -413
- package/rules/behavior.md +0 -252
- package/rules/branching.md +0 -82
- package/rules/commands.md +0 -112
- package/rules/emergency.md +0 -160
- package/rules/mcp.md +0 -47
- package/rules/models.md +0 -93
- package/scripts/copy-migrations.mjs +0 -29
- package/workflows/00-kortext-setup.md +0 -53
- package/workflows/01a-analysis-pipeline.md +0 -117
- package/workflows/01b-onboarding-pipeline.md +0 -110
- package/workflows/02-planning-pipeline.md +0 -146
- package/workflows/02b-spike-workflow.md +0 -120
- package/workflows/03-environment-setup.md +0 -99
- package/workflows/04-development-cycle.md +0 -203
- package/workflows/05-test-cycle.md +0 -123
- package/workflows/06-deployment-cycle.md +0 -224
- package/workflows/07-rollback-pipeline.md +0 -203
- package/workflows/08-hotfix-pipeline.md +0 -196
- package/workflows/09-maintenance-cycle.md +0 -133
- package/workspace/.locks/workspace_handover.md.lock +0 -3
- package/workspace/archive/.gitkeep +0 -0
- package/workspace/backups/.gitkeep +0 -0
- package/workspace/memory/backlog/.gitkeep +0 -0
- package/workspace/memory/backlog/BXX-[bug-name].md +0 -2
- package/workspace/memory/backlog/DXX-[debt-name].md +0 -2
- package/workspace/memory/backlog/README.md +0 -31
- package/workspace/memory/backlog/TXX-[task-name].md +0 -2
- package/workspace/memory/backlog/debt-dashboard.md +0 -3
- package/workspace/memory/backlog/epic-dashboard.md +0 -10
- package/workspace/memory/backlog/version-dashboard.md +0 -7
- package/workspace/memory/context/.gitkeep +0 -0
- package/workspace/memory/context/README.md +0 -35
- package/workspace/memory/context/[agent-name]-active.md +0 -2
- package/workspace/memory/decisions.md +0 -17
- package/workspace/memory/handover.md +0 -40
- package/workspace/memory/learned.md +0 -21
- package/workspace/references/access.md +0 -47
- package/workspace/references/api-reference.md +0 -59
- package/workspace/references/blueprint.md +0 -29
- package/workspace/references/content-strategy.md +0 -39
- package/workspace/references/db-schema.md +0 -51
- package/workspace/references/design-system.md +0 -107
- package/workspace/references/dictionary.md +0 -42
- package/workspace/references/file-system.md +0 -42
- package/workspace/references/growth-strategy.md +0 -46
- package/workspace/references/legal-strategy.md +0 -35
- package/workspace/references/required-skills.md +0 -11
- package/workspace/references/security-rules.md +0 -34
- package/workspace/references/tech-stack.md +0 -49
- package/workspace/references/test-strategy.md +0 -48
- package/workspace/reports/analysis-reports.md +0 -40
- package/workspace/reports/content-reports.md +0 -29
- package/workspace/reports/delivery-reports.md +0 -26
- package/workspace/reports/growth-reports.md +0 -9
- package/workspace/reports/legal-reports.md +0 -29
- package/workspace/reports/product-requirements.md +0 -28
- package/workspace/reports/release-notes.md +0 -20
- package/workspace/reports/security-reports.md +0 -27
- package/workspace/reports/status-reports.md +0 -48
- package/workspace/reports/tech-requirements.md +0 -30
- package/workspace/reports/test-reports.md +0 -61
- package/workspace/templates/BXX-[bug-name].md +0 -34
- package/workspace/templates/DXX-[debt-name].md +0 -35
- package/workspace/templates/EXX-[epic-name].md +0 -48
- package/workspace/templates/HXX-[hotfix-name].md +0 -73
- package/workspace/templates/SXX-[spike-name].md +0 -51
- package/workspace/templates/TXX-[task-name].md +0 -34
- package/workspace/templates/[agent-name]-active.md +0 -4
- package/workspace/templates/[original-name]_[YYYY-MM-DD_HHMMSS].md +0 -5
- package/workspace/templates/adr-XXX.md +0 -66
- package/workspace/templates/debt-dashboard.md +0 -10
- package/workspace/templates/epic-dashboard.md +0 -10
- package/workspace/templates/version-dashboard.md +0 -10
|
@@ -1,169 +0,0 @@
|
|
|
1
|
-
import { readFileSync, readdirSync, statSync } from 'node:fs';
|
|
2
|
-
import { basename, join } from 'node:path';
|
|
3
|
-
const EXCLUSION_RE = /process\.env|import\.meta\.env|os\.environ|getenv|YOUR_|<YOUR|PLACEHOLDER|example|EXAMPLE|\[VALUE\]|\[fill\]/i;
|
|
4
|
-
const P1_QUOTED_RE = /\b(api[_-]?key|secret[_-]?key|password|token|bearer|credential|private[_-]?key|access[_-]?key|auth[_-]?token)\s*[:=]\s*['"][^'"]{8,}['"]/i;
|
|
5
|
-
const P2_ENV_RE = /\b(API_KEY|SECRET_KEY|ACCESS_KEY|AUTH_TOKEN|DB_PASSWORD|DATABASE_URL)\s*=\s*[^'"\s]{8,}/;
|
|
6
|
-
const P3_SERVICE_RE = /(sk-[a-zA-Z0-9-]{20,}|AKIA[0-9A-Z]{16}|ghp_[a-zA-Z0-9]{20,}|ghs_[a-zA-Z0-9]{20,}|xox[baprs]-[0-9a-zA-Z-]{20,})/;
|
|
7
|
-
// Bearer tokens, with or without an explicit Authorization prefix. Real tokens
|
|
8
|
-
// are typically 30+ chars; shorter values are too noisy.
|
|
9
|
-
const P4_AUTH_RE = /Bearer\s+[a-zA-Z0-9._-]{20,}/;
|
|
10
|
-
const SKIP_DIRS = new Set(['node_modules', '.git', '.kortext', 'dist', 'build']);
|
|
11
|
-
const SKIP_EXTS = new Set([
|
|
12
|
-
'.png',
|
|
13
|
-
'.jpg',
|
|
14
|
-
'.jpeg',
|
|
15
|
-
'.gif',
|
|
16
|
-
'.pdf',
|
|
17
|
-
'.zip',
|
|
18
|
-
'.tar',
|
|
19
|
-
'.gz',
|
|
20
|
-
'.tgz',
|
|
21
|
-
'.lock',
|
|
22
|
-
'.svg',
|
|
23
|
-
'.ico',
|
|
24
|
-
]);
|
|
25
|
-
export function scanText(body, sourcePath) {
|
|
26
|
-
const findings = [];
|
|
27
|
-
const lines = body.split(/\r?\n/);
|
|
28
|
-
for (let i = 0; i < lines.length; i += 1) {
|
|
29
|
-
const line = lines[i] ?? '';
|
|
30
|
-
if (EXCLUSION_RE.test(line))
|
|
31
|
-
continue;
|
|
32
|
-
const m1 = line.match(P1_QUOTED_RE);
|
|
33
|
-
if (m1) {
|
|
34
|
-
findings.push(make(sourcePath, 'quoted-assignment', 'high', i + 1, line, m1[0]));
|
|
35
|
-
}
|
|
36
|
-
const m2 = line.match(P2_ENV_RE);
|
|
37
|
-
if (m2) {
|
|
38
|
-
findings.push(make(sourcePath, 'env-assignment', 'high', i + 1, line, m2[0]));
|
|
39
|
-
}
|
|
40
|
-
const m3 = line.match(P3_SERVICE_RE);
|
|
41
|
-
if (m3) {
|
|
42
|
-
findings.push(make(sourcePath, 'service-token', 'critical', i + 1, line, m3[0]));
|
|
43
|
-
}
|
|
44
|
-
const m4 = line.match(P4_AUTH_RE);
|
|
45
|
-
if (m4) {
|
|
46
|
-
findings.push(make(sourcePath, 'auth-header', 'high', i + 1, line, m4[0]));
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
return findings;
|
|
50
|
-
}
|
|
51
|
-
export function scanFile(path) {
|
|
52
|
-
const name = basename(path);
|
|
53
|
-
// skip .env (not .env.example, not .env.production.example)
|
|
54
|
-
if (name === '.env' || (/\.env$/.test(name) && !/\.example$/.test(name))) {
|
|
55
|
-
return [];
|
|
56
|
-
}
|
|
57
|
-
let body;
|
|
58
|
-
try {
|
|
59
|
-
body = readFileSync(path, 'utf8');
|
|
60
|
-
}
|
|
61
|
-
catch {
|
|
62
|
-
return [];
|
|
63
|
-
}
|
|
64
|
-
return scanText(body, path);
|
|
65
|
-
}
|
|
66
|
-
export function scanWorkArea(rootPath) {
|
|
67
|
-
const out = [];
|
|
68
|
-
walk(rootPath, out);
|
|
69
|
-
return out;
|
|
70
|
-
}
|
|
71
|
-
function walk(dir, acc) {
|
|
72
|
-
let entries;
|
|
73
|
-
try {
|
|
74
|
-
entries = readdirSync(dir);
|
|
75
|
-
}
|
|
76
|
-
catch {
|
|
77
|
-
return;
|
|
78
|
-
}
|
|
79
|
-
for (const entry of entries) {
|
|
80
|
-
if (SKIP_DIRS.has(entry))
|
|
81
|
-
continue;
|
|
82
|
-
const full = join(dir, entry);
|
|
83
|
-
let s;
|
|
84
|
-
try {
|
|
85
|
-
s = statSync(full);
|
|
86
|
-
}
|
|
87
|
-
catch {
|
|
88
|
-
continue;
|
|
89
|
-
}
|
|
90
|
-
if (s.isDirectory()) {
|
|
91
|
-
walk(full, acc);
|
|
92
|
-
}
|
|
93
|
-
else if (s.isFile()) {
|
|
94
|
-
const dot = entry.lastIndexOf('.');
|
|
95
|
-
const ext = dot >= 0 ? entry.slice(dot).toLowerCase() : '';
|
|
96
|
-
if (SKIP_EXTS.has(ext))
|
|
97
|
-
continue;
|
|
98
|
-
// arbitrary file-size cap so we don't OOM on huge artifacts
|
|
99
|
-
if (s.size > 2 * 1024 * 1024)
|
|
100
|
-
continue;
|
|
101
|
-
acc.push(...scanFile(full));
|
|
102
|
-
}
|
|
103
|
-
}
|
|
104
|
-
}
|
|
105
|
-
function make(path, type, severity, line, context, matched) {
|
|
106
|
-
return {
|
|
107
|
-
scanned_path: path,
|
|
108
|
-
finding_type: type,
|
|
109
|
-
severity,
|
|
110
|
-
line_number: line,
|
|
111
|
-
context: context.slice(0, 200),
|
|
112
|
-
masked_snippet: maskSnippet(matched),
|
|
113
|
-
};
|
|
114
|
-
}
|
|
115
|
-
function maskSnippet(s) {
|
|
116
|
-
// Reveal first 4 and last 2 chars, mask the middle.
|
|
117
|
-
if (s.length <= 8)
|
|
118
|
-
return '*'.repeat(s.length);
|
|
119
|
-
const head = s.slice(0, 4);
|
|
120
|
-
const tail = s.slice(-2);
|
|
121
|
-
return `${head}${'*'.repeat(Math.max(4, s.length - 6))}${tail}`;
|
|
122
|
-
}
|
|
123
|
-
// ---------------------------------------------------------------------------
|
|
124
|
-
const SEVERITY_RANK = {
|
|
125
|
-
low: 1,
|
|
126
|
-
medium: 2,
|
|
127
|
-
high: 3,
|
|
128
|
-
critical: 4,
|
|
129
|
-
};
|
|
130
|
-
export class SecretScanner {
|
|
131
|
-
opts;
|
|
132
|
-
constructor(opts) {
|
|
133
|
-
this.opts = opts;
|
|
134
|
-
}
|
|
135
|
-
async scanForRun(runId, rootPath) {
|
|
136
|
-
return this.persist(runId, scanWorkArea(rootPath));
|
|
137
|
-
}
|
|
138
|
-
/**
|
|
139
|
-
* Scan only the listed files (e.g. a step's declared outputs + its log).
|
|
140
|
-
* Files that don't exist are silently skipped.
|
|
141
|
-
*/
|
|
142
|
-
async scanForStep(runId, files) {
|
|
143
|
-
const all = [];
|
|
144
|
-
for (const f of files)
|
|
145
|
-
all.push(...scanFile(f));
|
|
146
|
-
return this.persist(runId, all);
|
|
147
|
-
}
|
|
148
|
-
persist(runId, findings) {
|
|
149
|
-
let highest = null;
|
|
150
|
-
for (const f of findings) {
|
|
151
|
-
this.opts.secretsRepo.create({
|
|
152
|
-
run_id: runId,
|
|
153
|
-
scanned_path: f.scanned_path,
|
|
154
|
-
finding_type: f.finding_type,
|
|
155
|
-
severity: f.severity,
|
|
156
|
-
line_number: f.line_number,
|
|
157
|
-
context: f.context,
|
|
158
|
-
masked_snippet: f.masked_snippet,
|
|
159
|
-
});
|
|
160
|
-
if (highest === null || SEVERITY_RANK[f.severity] > SEVERITY_RANK[highest]) {
|
|
161
|
-
highest = f.severity;
|
|
162
|
-
}
|
|
163
|
-
}
|
|
164
|
-
const failAt = this.opts.failAtSeverity ?? 'high';
|
|
165
|
-
const shouldFailRun = highest !== null && SEVERITY_RANK[highest] >= SEVERITY_RANK[failAt];
|
|
166
|
-
return { runId, findings, highestSeverity: highest, shouldFailRun };
|
|
167
|
-
}
|
|
168
|
-
}
|
|
169
|
-
//# sourceMappingURL=secret-scanner.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"secret-scanner.js","sourceRoot":"","sources":["../../../server/safety/secret-scanner.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,101 +0,0 @@
|
|
|
1
|
-
import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
|
|
2
|
-
import { dirname, join, relative, resolve } from 'node:path';
|
|
3
|
-
const DECISIONS_SUBDIR = 'workspace/memory/decisions';
|
|
4
|
-
const HANDOVERS_SUBDIR = 'workspace/memory/handovers';
|
|
5
|
-
function writeAtomic(path, content) {
|
|
6
|
-
mkdirSync(dirname(path), { recursive: true });
|
|
7
|
-
writeFileSync(path, content, { encoding: 'utf8' });
|
|
8
|
-
}
|
|
9
|
-
function todayIsoDate(now = new Date()) {
|
|
10
|
-
return now.toISOString().slice(0, 10);
|
|
11
|
-
}
|
|
12
|
-
export class MarkdownSyncService {
|
|
13
|
-
repos;
|
|
14
|
-
layout;
|
|
15
|
-
constructor(repos, layout) {
|
|
16
|
-
this.repos = repos;
|
|
17
|
-
this.layout = layout;
|
|
18
|
-
}
|
|
19
|
-
/**
|
|
20
|
-
* Persist an ADR markdown file and index it in decisions_index.
|
|
21
|
-
* Returns the relative markdown path.
|
|
22
|
-
*/
|
|
23
|
-
writeDecision(input) {
|
|
24
|
-
const filename = `${input.decision_id.toLowerCase()}.md`;
|
|
25
|
-
const absolutePath = resolve(this.layout.root, DECISIONS_SUBDIR, filename);
|
|
26
|
-
const relPath = relative(this.layout.root, absolutePath);
|
|
27
|
-
const frontmatter = [
|
|
28
|
-
'---',
|
|
29
|
-
`decision_id: ${input.decision_id}`,
|
|
30
|
-
`title: ${JSON.stringify(input.title)}`,
|
|
31
|
-
`status: ${input.status ?? 'proposed'}`,
|
|
32
|
-
`date: ${todayIsoDate()}`,
|
|
33
|
-
input.item_id ? `item_id: ${input.item_id}` : null,
|
|
34
|
-
input.tags && input.tags.length > 0 ? `tags: [${input.tags.join(', ')}]` : null,
|
|
35
|
-
'---',
|
|
36
|
-
'',
|
|
37
|
-
]
|
|
38
|
-
.filter((line) => line !== null)
|
|
39
|
-
.join('\n');
|
|
40
|
-
writeAtomic(absolutePath, frontmatter + input.body_md);
|
|
41
|
-
const existing = this.repos.decisions.get(input.decision_id);
|
|
42
|
-
if (existing) {
|
|
43
|
-
this.repos.decisions.transition(input.decision_id, input.status ?? existing.status);
|
|
44
|
-
}
|
|
45
|
-
else {
|
|
46
|
-
this.repos.decisions.create({
|
|
47
|
-
decision_id: input.decision_id,
|
|
48
|
-
title: input.title,
|
|
49
|
-
status: input.status ?? 'proposed',
|
|
50
|
-
markdown_path: relPath,
|
|
51
|
-
item_id: input.item_id ?? null,
|
|
52
|
-
tags: input.tags ?? [],
|
|
53
|
-
});
|
|
54
|
-
}
|
|
55
|
-
return { markdown_path: relPath, absolutePath };
|
|
56
|
-
}
|
|
57
|
-
/**
|
|
58
|
-
* Persist a handover markdown file and insert a handovers row.
|
|
59
|
-
* The markdown_path is stored on the row for round-trip lookup.
|
|
60
|
-
*/
|
|
61
|
-
writeHandover(input) {
|
|
62
|
-
const ts = new Date();
|
|
63
|
-
const stamp = ts.toISOString().replace(/[:.]/g, '-');
|
|
64
|
-
const slug = input.item_id ? `${input.item_id}-${stamp}` : `general-${stamp}`;
|
|
65
|
-
const absolutePath = resolve(this.layout.root, HANDOVERS_SUBDIR, `${slug}.md`);
|
|
66
|
-
const relPath = relative(this.layout.root, absolutePath);
|
|
67
|
-
const frontmatter = [
|
|
68
|
-
'---',
|
|
69
|
-
`from: ${input.from_persona}`,
|
|
70
|
-
`to: ${input.to_persona}`,
|
|
71
|
-
input.item_id ? `item_id: ${input.item_id}` : null,
|
|
72
|
-
`created_at: ${ts.toISOString()}`,
|
|
73
|
-
input.reason ? `reason: ${JSON.stringify(input.reason)}` : null,
|
|
74
|
-
'---',
|
|
75
|
-
'',
|
|
76
|
-
]
|
|
77
|
-
.filter((line) => line !== null)
|
|
78
|
-
.join('\n');
|
|
79
|
-
writeAtomic(absolutePath, frontmatter + input.body_md);
|
|
80
|
-
const row = this.repos.handovers.create({
|
|
81
|
-
item_id: input.item_id,
|
|
82
|
-
from_persona: input.from_persona,
|
|
83
|
-
to_persona: input.to_persona,
|
|
84
|
-
reason: input.reason ?? null,
|
|
85
|
-
context_payload: input.context,
|
|
86
|
-
markdown_path: relPath,
|
|
87
|
-
});
|
|
88
|
-
return { handoverId: row.id, markdown_path: relPath };
|
|
89
|
-
}
|
|
90
|
-
/**
|
|
91
|
-
* Reads a previously written markdown file given its stored relative path.
|
|
92
|
-
* Returns null if the file no longer exists on disk (orphan index row).
|
|
93
|
-
*/
|
|
94
|
-
readArtifact(relPath) {
|
|
95
|
-
const abs = join(this.layout.root, relPath);
|
|
96
|
-
if (!existsSync(abs))
|
|
97
|
-
return null;
|
|
98
|
-
return readFileSync(abs, 'utf8');
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
//# sourceMappingURL=markdown-sync.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"markdown-sync.js","sourceRoot":"","sources":["../../../server/services/markdown-sync.ts"],"names":[],"mappings":"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"}
|