maestro-flow 0.4.19 → 0.4.20

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.
Files changed (122) hide show
  1. package/.agents/agents/workflow-collab-planner.md +4 -1
  2. package/.agents/agents/workflow-plan-checker.md +11 -1
  3. package/.agents/agents/workflow-planner.md +4 -1
  4. package/.agents/skills/maestro/SKILL.md +8 -5
  5. package/.agents/skills/maestro-analyze/SKILL.md +1 -1
  6. package/.agents/skills/maestro-brainstorm/SKILL.md +2 -1
  7. package/.agents/skills/maestro-companion/SKILL.md +533 -0
  8. package/.agents/skills/maestro-grill/SKILL.md +116 -0
  9. package/.agents/skills/maestro-plan/SKILL.md +4 -0
  10. package/.agents/skills/maestro-ralph/SKILL.md +11 -7
  11. package/.agents/skills/maestro-swarm-workflow/SKILL.md +258 -0
  12. package/.agents/skills/manage-codebase-rebuild/SKILL.md +13 -1
  13. package/.agents/skills/manage-codebase-refresh/SKILL.md +3 -0
  14. package/.agents/skills/spec-setup/SKILL.md +9 -5
  15. package/.agy/agents/workflow-collab-planner.md +4 -1
  16. package/.agy/agents/workflow-plan-checker.md +11 -1
  17. package/.agy/agents/workflow-planner.md +4 -1
  18. package/.agy/skills/maestro/SKILL.md +8 -5
  19. package/.agy/skills/maestro-analyze/SKILL.md +1 -1
  20. package/.agy/skills/maestro-brainstorm/SKILL.md +2 -1
  21. package/.agy/skills/maestro-companion/SKILL.md +529 -0
  22. package/.agy/skills/maestro-grill/SKILL.md +116 -0
  23. package/.agy/skills/maestro-plan/SKILL.md +4 -0
  24. package/.agy/skills/maestro-ralph/SKILL.md +11 -7
  25. package/.agy/skills/maestro-swarm-workflow/SKILL.md +255 -0
  26. package/.agy/skills/manage-codebase-rebuild/SKILL.md +13 -1
  27. package/.agy/skills/manage-codebase-refresh/SKILL.md +3 -0
  28. package/.agy/skills/spec-setup/SKILL.md +9 -5
  29. package/.claude/agents/workflow-collab-planner.md +4 -1
  30. package/.claude/agents/workflow-plan-checker.md +11 -1
  31. package/.claude/agents/workflow-planner.md +4 -1
  32. package/.claude/commands/maestro-analyze.md +1 -1
  33. package/.claude/commands/maestro-brainstorm.md +2 -1
  34. package/.claude/commands/maestro-companion.md +531 -0
  35. package/.claude/commands/maestro-grill.md +114 -0
  36. package/.claude/commands/maestro-plan.md +4 -0
  37. package/.claude/commands/maestro-ralph.md +11 -7
  38. package/.claude/commands/maestro-swarm-workflow.md +256 -0
  39. package/.claude/commands/maestro.md +8 -5
  40. package/.claude/commands/manage-codebase-rebuild.md +13 -1
  41. package/.claude/commands/manage-codebase-refresh.md +3 -0
  42. package/.claude/commands/spec-setup.md +9 -5
  43. package/.codex/skills/maestro/SKILL.md +7 -2
  44. package/.codex/skills/maestro-companion/SKILL.md +485 -0
  45. package/.codex/skills/maestro-grill/SKILL.md +111 -0
  46. package/.codex/skills/maestro-ralph/SKILL.md +11 -7
  47. package/.codex/skills/manage-codebase-rebuild/SKILL.md +6 -0
  48. package/.codex/skills/manage-codebase-refresh/SKILL.md +6 -0
  49. package/dashboard/dist-server/dashboard/src/server/wiki/graph-analysis.d.ts +36 -0
  50. package/dashboard/dist-server/dashboard/src/server/wiki/graph-analysis.js +138 -2
  51. package/dashboard/dist-server/dashboard/src/server/wiki/graph-analysis.js.map +1 -1
  52. package/dashboard/dist-server/dashboard/src/server/wiki/search.js +13 -0
  53. package/dashboard/dist-server/dashboard/src/server/wiki/search.js.map +1 -1
  54. package/dashboard/dist-server/dashboard/src/server/wiki/virtual-wiki-adapters.d.ts +11 -0
  55. package/dashboard/dist-server/dashboard/src/server/wiki/virtual-wiki-adapters.js +178 -0
  56. package/dashboard/dist-server/dashboard/src/server/wiki/virtual-wiki-adapters.js.map +1 -1
  57. package/dashboard/dist-server/dashboard/src/server/wiki/wiki-indexer.d.ts +1 -0
  58. package/dashboard/dist-server/dashboard/src/server/wiki/wiki-indexer.js +39 -23
  59. package/dashboard/dist-server/dashboard/src/server/wiki/wiki-indexer.js.map +1 -1
  60. package/dist/src/cli.js +1 -0
  61. package/dist/src/cli.js.map +1 -1
  62. package/dist/src/commands/install-backend.d.ts +7 -0
  63. package/dist/src/commands/install-backend.d.ts.map +1 -1
  64. package/dist/src/commands/install-backend.js +14 -0
  65. package/dist/src/commands/install-backend.js.map +1 -1
  66. package/dist/src/commands/install.d.ts.map +1 -1
  67. package/dist/src/commands/install.js +18 -0
  68. package/dist/src/commands/install.js.map +1 -1
  69. package/dist/src/commands/kg.d.ts +11 -0
  70. package/dist/src/commands/kg.d.ts.map +1 -0
  71. package/dist/src/commands/kg.js +515 -0
  72. package/dist/src/commands/kg.js.map +1 -0
  73. package/dist/src/i18n/locales/en.d.ts.map +1 -1
  74. package/dist/src/i18n/locales/en.js +10 -0
  75. package/dist/src/i18n/locales/en.js.map +1 -1
  76. package/dist/src/i18n/locales/zh.d.ts.map +1 -1
  77. package/dist/src/i18n/locales/zh.js +10 -0
  78. package/dist/src/i18n/locales/zh.js.map +1 -1
  79. package/dist/src/i18n/types.d.ts +9 -0
  80. package/dist/src/i18n/types.d.ts.map +1 -1
  81. package/dist/src/tui/install-ui/InstallConfirm.d.ts +1 -0
  82. package/dist/src/tui/install-ui/InstallConfirm.d.ts.map +1 -1
  83. package/dist/src/tui/install-ui/InstallConfirm.js +1 -1
  84. package/dist/src/tui/install-ui/InstallConfirm.js.map +1 -1
  85. package/dist/src/tui/install-ui/InstallExecution.d.ts +1 -0
  86. package/dist/src/tui/install-ui/InstallExecution.d.ts.map +1 -1
  87. package/dist/src/tui/install-ui/InstallExecution.js +22 -0
  88. package/dist/src/tui/install-ui/InstallExecution.js.map +1 -1
  89. package/dist/src/tui/install-ui/InstallFlow.d.ts +1 -1
  90. package/dist/src/tui/install-ui/InstallFlow.d.ts.map +1 -1
  91. package/dist/src/tui/install-ui/InstallFlow.js +23 -5
  92. package/dist/src/tui/install-ui/InstallFlow.js.map +1 -1
  93. package/dist/src/tui/install-ui/InstallHub.d.ts +2 -0
  94. package/dist/src/tui/install-ui/InstallHub.d.ts.map +1 -1
  95. package/dist/src/tui/install-ui/InstallHub.js +6 -0
  96. package/dist/src/tui/install-ui/InstallHub.js.map +1 -1
  97. package/dist/src/tui/install-ui/InstallResult.d.ts.map +1 -1
  98. package/dist/src/tui/install-ui/InstallResult.js +1 -1
  99. package/dist/src/tui/install-ui/InstallResult.js.map +1 -1
  100. package/dist/src/tui/install-ui/KgVendorConfig.d.ts +7 -0
  101. package/dist/src/tui/install-ui/KgVendorConfig.d.ts.map +1 -0
  102. package/dist/src/tui/install-ui/KgVendorConfig.js +9 -0
  103. package/dist/src/tui/install-ui/KgVendorConfig.js.map +1 -0
  104. package/dist/src/utils/update-notices.js +11 -0
  105. package/dist/src/utils/update-notices.js.map +1 -1
  106. package/package.json +1 -1
  107. package/workflows/analyze.md +2 -1
  108. package/workflows/brainstorm.md +24 -1
  109. package/workflows/codebase-rebuild.md +141 -1
  110. package/workflows/codebase-refresh.md +20 -0
  111. package/workflows/finish-work.md +7 -2
  112. package/workflows/grill.md +513 -0
  113. package/workflows/plan.md +7 -4
  114. package/workflows/specs-setup.md +99 -3
  115. package/workflows/swarm/wf-analyze.js +186 -0
  116. package/workflows/swarm/wf-brainstorm.js +284 -0
  117. package/workflows/swarm/wf-execute.js +203 -0
  118. package/workflows/swarm/wf-grill.js +198 -0
  119. package/workflows/swarm/wf-milestone-audit.js +236 -0
  120. package/workflows/swarm/wf-plan.js +233 -0
  121. package/workflows/swarm/wf-review.js +226 -0
  122. package/workflows/swarm/wf-verify.js +298 -0
@@ -0,0 +1,9 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { Box, Text } from 'ink';
3
+ import { t } from '../../i18n/index.js';
4
+ import { C, SYM, SectionHeader, KeyHints } from '../shared/index.js';
5
+ export function KgVendorConfig({ status }) {
6
+ const isReady = status.installed && status.coreBuilt;
7
+ return (_jsxs(Box, { flexDirection: "column", children: [_jsx(SectionHeader, { title: t.install.kgVendorTitle }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsxs(Text, { bold: true, children: [t.install.kgVendorStatusLabel, " "] }), isReady ? (_jsxs(Text, { color: C.success, children: [SYM.checkOn, " ", t.install.kgVendorInstalled, status.version ? ` (v${status.version})` : ''] })) : (_jsxs(Text, { color: C.warning, children: [SYM.checkOff, " ", t.install.kgVendorNotInstalled] }))] }), _jsxs(Box, { children: [_jsxs(Text, { bold: true, children: [t.install.kgVendorPathLabel, " "] }), _jsxs(Text, { dimColor: true, children: [status.path, "/understand-anything-plugin/"] })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: t.install.kgVendorDesc }) }), !isReady && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: C.primary, children: "Enable this item in the hub and install to clone + build the vendor." }) })), _jsx(KeyHints, { hints: t.install.kgVendorHint })] }));
8
+ }
9
+ //# sourceMappingURL=KgVendorConfig.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KgVendorConfig.js","sourceRoot":"","sources":["../../../../src/tui/install-ui/KgVendorConfig.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,CAAC,EAAE,MAAM,qBAAqB,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAarE,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAuB;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;IAErD,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,aAAa,IAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,GAAI,EAEjD,MAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aACvC,MAAC,GAAG,eACF,MAAC,IAAI,IAAC,IAAI,mBAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,SAAS,EACjD,OAAO,CAAC,CAAC,CAAC,CACT,MAAC,IAAI,IAAC,KAAK,EAAE,CAAC,CAAC,OAAO,aACnB,GAAG,CAAC,OAAO,OAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,EACzC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,IACzC,CACR,CAAC,CAAC,CAAC,CACF,MAAC,IAAI,IAAC,KAAK,EAAE,CAAC,CAAC,OAAO,aACnB,GAAG,CAAC,QAAQ,OAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,IACzC,CACR,IACG,EAEN,MAAC,GAAG,eACF,MAAC,IAAI,IAAC,IAAI,mBAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,SAAS,EAChD,MAAC,IAAI,IAAC,QAAQ,mBAAE,MAAM,CAAC,IAAI,oCAAoC,IAC3D,IACF,EAEN,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,KAAC,IAAI,IAAC,QAAQ,kBAAE,CAAC,CAAC,OAAO,CAAC,YAAY,GAAQ,GAC1C,EAEL,CAAC,OAAO,IAAI,CACX,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,KAAC,IAAI,IAAC,KAAK,EAAE,CAAC,CAAC,OAAO,qFAEf,GACH,CACP,EAED,KAAC,QAAQ,IAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,GAAI,IACvC,CACP,CAAC;AACJ,CAAC"}
@@ -241,4 +241,15 @@ registerNotice({
241
241
  ],
242
242
  actions: [],
243
243
  });
244
+ registerNotice({
245
+ version: '0.4.20',
246
+ title: 'UA 知识图谱集成 + Swarm Workflow 并行加速',
247
+ highlights: [
248
+ '新增 Understand-Anything 知识图谱:深度集成 Wiki 搜索与 codebase-rebuild 管道',
249
+ '新增 maestro-swarm-workflow 并行加速层:8 个固定 Workflow 脚本覆盖核心命令',
250
+ '新增 maestro-companion 技能:任务上下文管理与知识路由',
251
+ 'plan 命令修复:P3 agent 强制调用 + read_first/action 字段对齐',
252
+ ],
253
+ actions: [],
254
+ });
244
255
  //# sourceMappingURL=update-notices.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"update-notices.js","sourceRoot":"","sources":["../../../src/utils/update-notices.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"update-notices.js","sourceRoot":"","sources":["../../../src/utils/update-notices.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "maestro-flow",
3
- "version": "0.4.19",
3
+ "version": "0.4.20",
4
4
  "description": "Workflow orchestration CLI with MCP endpoint support and extensible architecture",
5
5
  "type": "module",
6
6
  "imports": {
@@ -49,7 +49,7 @@ $ARGUMENTS: "[phase|topic] [-y] [-c] [-q] [--from <source>]"
49
49
  -y / --yes -- Auto mode, skip interactive scoping, auto-deepen
50
50
  -c / --continue -- Resume from existing session
51
51
  -q / --quick -- Quick mode, skip exploration + scoring, go straight to decision extraction
52
- --from <source> -- Load upstream context package (brainstorm:ID, analyze:ID, @file, or path). Replaces --from-brainstorm
52
+ --from <source> -- Load upstream context package (grill:ID, brainstorm:ID, analyze:ID, @file, or path). Replaces --from-brainstorm
53
53
  ```
54
54
 
55
55
  ## Scope Routing
@@ -128,6 +128,7 @@ Parse $ARGUMENTS to determine mode and flags:
128
128
  4. Find prior analyze artifacts from `state.json.artifacts[]` where type=analyze and same milestone → load their `context.md` to skip already-decided areas
129
129
  5. **Load upstream context** (priority order):
130
130
  a. If `--from` specified: resolve source → load `context-package.json` (see §9 of workflow-structure-guide.md)
131
+ - `--from grill:ID` → `state.json.artifacts[type=grill, id=ID].context_package` → load
131
132
  - `--from brainstorm:ID` → `state.json.artifacts[type=brainstorm, id=ID].context_package` → load
132
133
  - `--from @file` → create import session, delegate extraction → load context-package.json
133
134
  - `--from path/` → load `path/context-package.json`
@@ -125,6 +125,7 @@ Parse $ARGUMENTS to determine execution mode:
125
125
  **Parameter Parsing**:
126
126
  - `--count N`: cap at 9, default 3
127
127
  - `--session ID`: target specific session
128
+ - `--from <source>`: load upstream context package (grill:ID, blueprint:ID, @file, or path)
128
129
  - `--style-skill PKG`: validate `.claude/skills/style-{PKG}/SKILL.md` exists
129
130
  - Missing/empty args without flags = error E001
130
131
 
@@ -141,6 +142,26 @@ Parse $ARGUMENTS to determine execution mode:
141
142
 
142
143
  ---
143
144
 
145
+ ### Step 1.3: Load Upstream Context (if `--from` specified)
146
+
147
+ Resolve upstream source and load `context-package.json`:
148
+ - `--from grill:ID` → `state.json.artifacts[type=grill, id=ID].context_package` → load
149
+ - `--from blueprint:ID` → `state.json.artifacts[type=blueprint, id=ID].context_package` → load
150
+ - `--from @file` → read file directly as upstream material
151
+ - `--from path/` → load `path/context-package.json`
152
+
153
+ From loaded context-package, pre-seed brainstorm session:
154
+ - `domain.terminology[]` → pre-populate Step 2 terminology (skip re-extraction for locked terms)
155
+ - `constraints[status=locked]` → inject into guidance §4-N as pre-decided constraints (skip re-asking)
156
+ - `non_goals[]` → pre-populate Step 2 non-goals (skip re-asking for these)
157
+ - `open_questions[]` → seed Step 3 Phase 1 probing questions
158
+ - `insights[]` → pass to role-design-author in Step 4 as additional context
159
+ - `requirements[]` → seed Step 3 Phase 4.5 feature decomposition
160
+
161
+ Store as `upstream_context` (in-memory). If source not found, warn (W007) and continue without upstream.
162
+
163
+ ---
164
+
144
165
  ### Step 1.5: Load Project Specs
145
166
 
146
167
  ```
@@ -229,8 +250,10 @@ Extract core terminology and define scope boundaries before framework generation
229
250
  1. Analyze topic description and any project context (project.md, roadmap.md, project_context from Step 1.8)
230
251
  2. Extract 5-10 core domain terms:
231
252
  - term (canonical), definition, aliases, category (core|technical|business)
253
+ - If `upstream_context` loaded (Step 1.3): merge `upstream_context.domain.terminology[]` — locked terms are pre-populated, only extract NEW terms not already in upstream
232
254
  3. AskUserQuestion for Non-Goals (multiSelect=true):
233
- - Generate 4-5 context-aware exclusion candidates based on topic
255
+ - If `upstream_context` loaded: pre-select `upstream_context.non_goals[]`, ask only for additions
256
+ - Else: generate 4-5 context-aware exclusion candidates based on topic
234
257
  - Include "其他(请补充)" option for custom exclusions
235
258
  - If user selects "其他", follow up with free-text question
236
259
  4. Store terminology table and non_goals to session state
@@ -181,9 +181,143 @@ b. Update project.md Tech Stack (if exists):
181
181
 
182
182
  ```
183
183
  Display summary: component/feature/requirement/ADR/file counts.
184
+ If KG pipeline ran: include KG node/edge/layer/tour counts.
184
185
  If mapper agents failed: log W001.
185
186
  If not --skip-commit: suggest committing generated docs.
186
- Suggest next: manage-status (review) or manage-codebase-refresh (incremental updates).
187
+ Suggest next:
188
+ - manage-status (review)
189
+ - manage-codebase-refresh (incremental updates)
190
+ - maestro kg stats (verify KG)
191
+ - maestro wiki list --keyword kg (verify wiki integration)
192
+ - maestro kg diff-wiki (future change impact analysis)
193
+ ```
194
+
195
+ ---
196
+
197
+ ## Knowledge Graph Pipeline (Steps 10–17)
198
+
199
+ > **Optional.** Only runs when UA vendor is installed at
200
+ > `~/.maestro/vendor/ua/understand-anything-plugin/packages/core/dist/index.js`.
201
+ > If not found, skip Steps 10–17 with warning:
202
+ > *"KG pipeline skipped: run `scripts/ua-vendor-setup.sh` first"*
203
+
204
+ All intermediate artifacts are written to `.workflow/codebase/.kg-tmp/`.
205
+
206
+ ### Step 10: KG Pipeline — Project Scan
207
+
208
+ ```
209
+ node ~/.maestro/vendor/ua/understand-anything-plugin/skills/understand/scan-project.mjs \
210
+ "$PROJECT_ROOT" \
211
+ "$PROJECT_ROOT/.workflow/codebase/.kg-tmp/scan-result.json"
212
+ ```
213
+
214
+ Output: `.workflow/codebase/.kg-tmp/scan-result.json`
215
+
216
+ ### Step 11: KG Pipeline — Compute Batches
217
+
218
+ ```
219
+ node ~/.maestro/vendor/ua/understand-anything-plugin/skills/understand/compute-batches.mjs \
220
+ "$PROJECT_ROOT"
221
+ ```
222
+
223
+ Output: `.workflow/codebase/.kg-tmp/batches.json`
224
+
225
+ ### Step 12: KG Pipeline — File Analysis (Parallel Delegates)
226
+
227
+ ```
228
+ For each batch in batches.json, dispatch a delegate:
229
+
230
+ maestro delegate "<prompt from kg-file-analyze template>" \
231
+ --rule kg-file-analyze --mode analysis --cd "$PROJECT_ROOT"
232
+
233
+ Run up to 5 delegates concurrently (run_in_background: true).
234
+ Each produces batch-N.json in .kg-tmp/
235
+ ```
236
+
237
+ ### Step 13: KG Pipeline — Merge Batch Graphs
238
+
239
+ ```
240
+ node scripts/merge-batch-graphs.mjs "$PROJECT_ROOT" \
241
+ --intermediate-dir "$PROJECT_ROOT/.workflow/codebase/.kg-tmp"
242
+ ```
243
+
244
+ Output: `.workflow/codebase/.kg-tmp/assembled-graph.json`
245
+
246
+ ### Step 14: KG Pipeline — Architecture Analysis
247
+
248
+ ```
249
+ maestro delegate "<prompt>" --rule kg-architecture --mode analysis
250
+ ```
251
+
252
+ This **replaces** the original Architecture mapper (Mapper 2).
253
+ Mapper 2 no longer runs independently — its output is produced here instead.
254
+
255
+ Output: `.workflow/codebase/.kg-tmp/layers.json`
256
+
257
+ ### Step 15: KG Pipeline — Tour Generation
258
+
259
+ ```
260
+ maestro delegate "<prompt>" --rule kg-tour-build --mode analysis
261
+ ```
262
+
263
+ Output: `.workflow/codebase/.kg-tmp/tour.json`
264
+
265
+ ### Step 16: KG Pipeline — Validation
266
+
267
+ ```
268
+ Run inline validation (Node.js script from UA, adapted):
269
+ - Check all nodes have required fields (id, type, name, filePath)
270
+ - Check referential integrity (all edge source/target refs exist as node ids)
271
+ - Check layer coverage (every file-type node appears in exactly 1 layer)
272
+ - Check tour structure (all tour step refs resolve to valid nodes)
273
+
274
+ If validation fails: log errors but still write the graph (with "valid": false flag).
275
+ ```
276
+
277
+ ### Step 17: KG Pipeline — Save Knowledge Graph
278
+
279
+ ```
280
+ Assemble final KnowledgeGraph JSON:
281
+
282
+ {
283
+ "version": "1.0.0",
284
+ "valid": true|false,
285
+ "project": {
286
+ "name": "<from state.json or package.json>",
287
+ "languages": [<detected>],
288
+ "frameworks": [<detected>],
289
+ "description": "<from project.md>",
290
+ "analyzedAt": "<ISO timestamp>",
291
+ "gitCommitHash": "<current HEAD>"
292
+ },
293
+ "nodes": [<from assembled-graph.json>],
294
+ "edges": [<from assembled-graph.json>],
295
+ "layers": [<from Step 14 layers.json>],
296
+ "tour": [<from Step 15 tour.json>]
297
+ }
298
+
299
+ Write to: .workflow/codebase/knowledge-graph.json
300
+ Clean up: remove .workflow/codebase/.kg-tmp/ directory
301
+ ```
302
+
303
+ ### Step 18: KG → Wiki Index Integration
304
+
305
+ ```
306
+ When knowledge-graph.json is successfully written:
307
+ The WikiIndexer will automatically index KG nodes as virtual wiki entries
308
+ on next wiki access (via adaptUaKgGraph virtual adapter).
309
+
310
+ Generated virtual entries:
311
+ - uakg-{node-id} for each GraphNode (type: knowhow, virtualKind: ua-kg-node)
312
+ - uakg-layer-{id} for each Layer (virtualKind: ua-kg-layer)
313
+ - uakg-tour-{order} for each TourStep (virtualKind: ua-kg-tour-step)
314
+
315
+ Cross-referencing:
316
+ - KG nodes are linked to existing codebase-comp-* entries via filePath matching
317
+ - Edge semantics preserved in ext.kgEdges for downstream semantic traversal
318
+
319
+ No manual action required — indexing is lazy and triggered on first wiki access.
320
+ To verify: run `maestro wiki list --keyword kg` after rebuild.
187
321
  ```
188
322
 
189
323
  ---
@@ -196,6 +330,10 @@ Suggest next: manage-status (review) or manage-codebase-refresh (incremental upd
196
330
  | .workflow/ missing | Fail: "Run /workflow:init first" |
197
331
  | File read errors | Log warning, skip file, continue scan |
198
332
  | Existing codebase/ without --force | Prompt user for confirmation |
333
+ | UA vendor not installed | Skip Steps 10–18 with warning, continue normally |
334
+ | KG batch delegate failed | Log warning, continue with remaining batches |
335
+ | KG validation failed | Write knowledge-graph.json with `"valid": false`, log errors |
336
+ | Wiki index rebuild failed | Non-fatal — KG data still written, wiki indexing retries on next access |
199
337
 
200
338
  ## Output Files
201
339
 
@@ -206,5 +344,7 @@ Suggest next: manage-status (review) or manage-codebase-refresh (incremental upd
206
344
  | `.workflow/codebase/tech-registry/{slug}.md` | Per-component documentation |
207
345
  | `.workflow/codebase/feature-maps/_index.md` | Feature index |
208
346
  | `.workflow/codebase/feature-maps/{slug}.md` | Per-feature documentation |
347
+ | `.workflow/codebase/knowledge-graph.json` | Knowledge Graph with nodes, edges, layers, and tour (if UA vendor installed) |
348
+ | `.workflow/wiki-index.json` | Updated on next wiki access: KG nodes indexed as virtual entries (automatic) |
209
349
  | `.workflow/state.json` | Updated: last_codebase_rebuild timestamp |
210
350
  | `.workflow/project.md` | Updated: Tech Stack section refreshed |
@@ -57,6 +57,26 @@ specs_content = maestro spec load --category arch
57
57
 
58
58
  Used in Step 4-5 to validate refreshed docs against architectural expectations.
59
59
 
60
+ ### Step 3.6: KG Impact Analysis (if KG exists)
61
+
62
+ ```
63
+ If .workflow/codebase/knowledge-graph.json exists:
64
+ Run: maestro kg diff-wiki --json
65
+ Parse output for affectedWiki entries.
66
+
67
+ If affectedWiki is non-empty:
68
+ Log WARNING for each affected wiki entry:
69
+ "KG impact: code changes affect [entry.id] — [entry.title] (via [reason])"
70
+
71
+ Add affected entry IDs to the refresh queue for human review.
72
+
73
+ Log summary: "KG analysis: {directNodes} direct, {impactedNodes} impacted KG nodes,
74
+ {affectedWiki.length} wiki entries flagged"
75
+
76
+ If .workflow/codebase/knowledge-graph.json does not exist:
77
+ Skip silently (KG not generated).
78
+ ```
79
+
60
80
  ---
61
81
 
62
82
  ### Step 4: Re-scan Affected Components
@@ -4,7 +4,7 @@ Last step of session commands. Inline-extracts spec/knowhow from this single ses
4
4
 
5
5
  ## Inputs
6
6
 
7
- Caller passes: `SESSION_DIR`, `SESSION_TYPE` (brainstorm | analyze | blueprint | plan | execute | verify), `SESSION_ID`, `LINKED_MILESTONE` (optional).
7
+ Caller passes: `SESSION_DIR`, `SESSION_TYPE` (grill | brainstorm | analyze | blueprint | plan | execute | verify), `SESSION_ID`, `LINKED_MILESTONE` (optional).
8
8
 
9
9
  ## Steps
10
10
 
@@ -14,7 +14,9 @@ Scan `SESSION_DIR` for any of these files (any absent → skip silently):
14
14
 
15
15
  | File | Source | Used for |
16
16
  |------|--------|----------|
17
- | `context-package.json` | brainstorm/analyze/blueprint | constraints + insights |
17
+ | `context-package.json` | grill/brainstorm/analyze/blueprint | constraints + insights |
18
+ | `terminology.md` | grill | domain terms with code references |
19
+ | `grill-report.md` | grill | stress-test decisions + risk register |
18
20
  | `conclusions.json` | analyze | decisions |
19
21
  | `reflection-log.md` | execute | lessons + pitfalls |
20
22
  | `{role}/analysis.md` | brainstorm | role decisions |
@@ -33,6 +35,9 @@ Iterate detected files; build a `fragments[]` array. Each fragment: `{ kind, cat
33
35
  | `conclusions.json#recommendations[]` (priority ≥ medium) | knowhow | knowhow (`REF`) | derived from area |
34
36
  | `reflection-log.md` "## Lessons" / "## Pitfalls" sections | learning | spec (category `learning`) or knowhow (`KNW`) by length: < 200 chars → spec, else knowhow | `learning` |
35
37
  | `{role}/analysis.md` §2 Decisions[status=locked] | rule | spec | role-derived (`arch` for system-architect, `coding` for code-quality, etc.) |
38
+ | `grill-report.md` "## Synthesis" locked decisions | rule | spec | `arch` if scope/integration/security branch, else `coding` |
39
+ | `grill-report.md` "## Risk Register" items (severity ≥ medium) | knowhow | knowhow (`REF`) | `debug` |
40
+ | `terminology.md` locked terms | knowhow | knowhow (`REF`) | `coding` |
36
41
 
37
42
  **Confidence scoring** (drop if < 0.5):
38
43
  - +0.3 if `status == "locked"` or section is explicit "## Decisions"