@ktpartners/dgs-platform 2.7.5 → 2.8.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.
Files changed (55) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/agents/dgs-executor.md +0 -52
  3. package/deliver-great-systems/bin/dgs-tools.cjs +66 -10
  4. package/deliver-great-systems/bin/lib/commands.cjs +1 -8
  5. package/deliver-great-systems/bin/lib/config.cjs +9 -90
  6. package/deliver-great-systems/bin/lib/context.cjs +2 -2
  7. package/deliver-great-systems/bin/lib/context.test.cjs +100 -100
  8. package/deliver-great-systems/bin/lib/core.cjs +17 -57
  9. package/deliver-great-systems/bin/lib/core.test.cjs +166 -170
  10. package/deliver-great-systems/bin/lib/docs.cjs +3 -3
  11. package/deliver-great-systems/bin/lib/docs.test.cjs +14 -7
  12. package/deliver-great-systems/bin/lib/execution.cjs +2 -2
  13. package/deliver-great-systems/bin/lib/execution.test.cjs +65 -67
  14. package/deliver-great-systems/bin/lib/ideas.cjs +4 -4
  15. package/deliver-great-systems/bin/lib/ideas.test.cjs +45 -44
  16. package/deliver-great-systems/bin/lib/init.cjs +9 -4
  17. package/deliver-great-systems/bin/lib/init.test.cjs +242 -175
  18. package/deliver-great-systems/bin/lib/jobs.cjs +1 -1
  19. package/deliver-great-systems/bin/lib/jobs.test.cjs +203 -202
  20. package/deliver-great-systems/bin/lib/migration.cjs +256 -281
  21. package/deliver-great-systems/bin/lib/migration.test.cjs +385 -440
  22. package/deliver-great-systems/bin/lib/milestone.cjs +1 -1
  23. package/deliver-great-systems/bin/lib/overlap.cjs +4 -4
  24. package/deliver-great-systems/bin/lib/overlap.test.cjs +45 -44
  25. package/deliver-great-systems/bin/lib/path-audit.test.cjs +16 -22
  26. package/deliver-great-systems/bin/lib/paths.cjs +60 -59
  27. package/deliver-great-systems/bin/lib/paths.test.cjs +192 -225
  28. package/deliver-great-systems/bin/lib/phase.cjs +5 -4
  29. package/deliver-great-systems/bin/lib/projects.cjs +8 -8
  30. package/deliver-great-systems/bin/lib/projects.test.cjs +75 -74
  31. package/deliver-great-systems/bin/lib/repos.cjs +94 -230
  32. package/deliver-great-systems/bin/lib/repos.test.cjs +84 -75
  33. package/deliver-great-systems/bin/lib/search.cjs +4 -4
  34. package/deliver-great-systems/bin/lib/specs.cjs +2 -2
  35. package/deliver-great-systems/bin/lib/sync.cjs +1 -1
  36. package/deliver-great-systems/bin/lib/template.cjs +3 -3
  37. package/deliver-great-systems/bin/lib/test-helpers.cjs +59 -162
  38. package/deliver-great-systems/bin/lib/verify.cjs +3 -3
  39. package/deliver-great-systems/references/planning-config.md +7 -8
  40. package/deliver-great-systems/workflows/add-tests.md +1 -1
  41. package/deliver-great-systems/workflows/approve-spec.md +1 -11
  42. package/deliver-great-systems/workflows/complete-milestone.md +2 -2
  43. package/deliver-great-systems/workflows/consolidate-ideas.md +1 -1
  44. package/deliver-great-systems/workflows/create-milestone-job.md +2 -2
  45. package/deliver-great-systems/workflows/discuss-phase.md +2 -2
  46. package/deliver-great-systems/workflows/execute-phase.md +63 -4
  47. package/deliver-great-systems/workflows/execute-plan.md +0 -51
  48. package/deliver-great-systems/workflows/find-related-ideas.md +1 -1
  49. package/deliver-great-systems/workflows/help.md +25 -58
  50. package/deliver-great-systems/workflows/init-product.md +14 -451
  51. package/deliver-great-systems/workflows/map-codebase.md +109 -0
  52. package/deliver-great-systems/workflows/new-project.md +0 -1
  53. package/deliver-great-systems/workflows/quick.md +2 -2
  54. package/deliver-great-systems/workflows/run-job.md +56 -0
  55. package/package.json +1 -1
@@ -256,7 +256,7 @@ After adding the row, trigger archival to keep the table within 20 rows:
256
256
  ARCHIVE_RESULT=$(node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" state archive-quick-tasks --raw 2>/dev/null)
257
257
  ```
258
258
 
259
- If archival occurred (result contains `"archived": true`), `.planning/quick/HISTORY.md` was created or updated. Both STATE.md and HISTORY.md will be committed together in the next step.
259
+ If archival occurred (result contains `"archived": true`), `quick/HISTORY.md` was created or updated. Both STATE.md and HISTORY.md will be committed together in the next step.
260
260
 
261
261
  **F6c. Commit tracking (fast path only)**
262
262
 
@@ -749,7 +749,7 @@ After adding the row, trigger archival to keep the table within 20 rows:
749
749
  node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" state archive-quick-tasks 2>/dev/null
750
750
  ```
751
751
 
752
- If archival occurred, `.planning/quick/HISTORY.md` was created or updated. Include it in Step 8's commit file list.
752
+ If archival occurred, `quick/HISTORY.md` was created or updated. Include it in Step 8's commit file list.
753
753
 
754
754
  **7d. Update "Last activity" line:**
755
755
 
@@ -144,6 +144,13 @@ if ! grep -q '^\*\*StartShas:\*\*' "$JOB_PATH"; then
144
144
  fi
145
145
  ```
146
146
 
147
+ **Commit and push job status:**
148
+
149
+ ```bash
150
+ git add -A "$(dirname "$JOB_PATH")/../"
151
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): start ${VERSION}" --push
152
+ ```
153
+
147
154
  This captures the current HEAD of every registered code repo and the planning repo before any execution begins. The SHAs are written into the job file header as `**StartShas:**` and used by `/dgs:rollback-job` to reset repos if the job produces unwanted results.
148
155
  </step>
149
156
 
@@ -248,6 +255,12 @@ Loop through steps starting from `nextStepIndex`.
248
255
  node ~/.claude/deliver-great-systems/bin/dgs-tools.cjs jobs update-step "$JOB_PATH" $INDEX in-progress --timestamp "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
249
256
  ```
250
257
 
258
+ **Commit and push job status:**
259
+
260
+ ```bash
261
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): step $((INDEX+1)) in-progress" --files "$JOB_PATH" --push
262
+ ```
263
+
251
264
  3. **Spawn subagent** via Task tool:
252
265
  ```
253
266
  Task(
@@ -266,6 +279,13 @@ Loop through steps starting from `nextStepIndex`.
266
279
  ```bash
267
280
  node ~/.claude/deliver-great-systems/bin/dgs-tools.cjs jobs update-step "$JOB_PATH" $INDEX completed --timestamp "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
268
281
  ```
282
+
283
+ **Commit and push job status:**
284
+
285
+ ```bash
286
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): step $((INDEX+1)) completed" --files "$JOB_PATH" --push
287
+ ```
288
+
269
289
  Display one-line result:
270
290
  ```
271
291
  OK {command} {args_display} ({duration})
@@ -293,6 +313,13 @@ Loop through steps starting from `nextStepIndex`.
293
313
  ```bash
294
314
  node ~/.claude/deliver-great-systems/bin/dgs-tools.cjs jobs update-header "$JOB_PATH" Status failed
295
315
  ```
316
+
317
+ **Commit and push job status:**
318
+
319
+ ```bash
320
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): step $((INDEX+1)) failed" --files "$JOB_PATH" --push
321
+ ```
322
+
296
323
  Display error summary and restart hint:
297
324
  ```
298
325
  FAILED {command} {args_display} ({duration})
@@ -308,6 +335,12 @@ Loop through steps starting from `nextStepIndex`.
308
335
  Parse the result. If `found: true`, write the `content` field to `${jobs_root}/in-progress/job-{version}-SUMMARY.md` using the Write tool (job stays in in-progress/ on failure).
309
336
  Display: `Job summary written to ${jobs_root}/in-progress/job-{version}-SUMMARY.md`
310
337
 
338
+ **Commit and push failure summary:**
339
+
340
+ ```bash
341
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): ${VERSION} failure summary" --files "${jobs_root}/in-progress/job-${VERSION}-SUMMARY.md" --push
342
+ ```
343
+
311
344
  **HALT immediately.** Do not proceed to the next step.
312
345
 
313
346
  6. **After an audit-milestone step completes successfully:** Execute the `handle_audit_result` logic (see below).
@@ -375,6 +408,10 @@ deferring complete-milestone. This is correct -- complete-milestone only runs af
375
408
  ```bash
376
409
  node ~/.claude/deliver-great-systems/bin/dgs-tools.cjs jobs update-header "$JOB_PATH" Status failed
377
410
  ```
411
+ - **Commit and push job status:**
412
+ ```bash
413
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): ${VERSION} audit failed (cycle limit)" --files "$JOB_PATH" --push
414
+ ```
378
415
  - **HALT immediately.**
379
416
 
380
417
  **3b. Auto-approve gap-fix insertion:**
@@ -468,6 +505,10 @@ After an `audit-phase` step completes successfully, check the phase audit outcom
468
505
  ```bash
469
506
  node ~/.claude/deliver-great-systems/bin/dgs-tools.cjs jobs update-header "$JOB_PATH" Status failed
470
507
  ```
508
+ - **Commit and push job status:**
509
+ ```bash
510
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): ${VERSION} phase ${PHASE_NUMBER} audit failed (cycle limit)" --files "$JOB_PATH" --push
511
+ ```
471
512
  - **HALT immediately.**
472
513
 
473
514
  **4b. Insert gap-fix steps:**
@@ -505,6 +546,15 @@ When all steps are completed (`nextStepIndex` is null after the loop):
505
546
  node ~/.claude/deliver-great-systems/bin/dgs-tools.cjs jobs move "$JOB_PATH" "${jobs_root}/completed"
506
547
  ```
507
548
 
549
+ Update `JOB_PATH` to reflect the new location under `completed/`.
550
+
551
+ **Commit and push job status:**
552
+
553
+ ```bash
554
+ git add -A "$(dirname "$JOB_PATH")/../"
555
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): ${VERSION} completed" --push
556
+ ```
557
+
508
558
  3. **Generate job summary:**
509
559
  ```bash
510
560
  SUMMARY=$(node ~/.claude/deliver-great-systems/bin/dgs-tools.cjs jobs generate-summary "$VERSION")
@@ -512,6 +562,12 @@ When all steps are completed (`nextStepIndex` is null after the loop):
512
562
  Parse the result. If `found: true`, write the `content` field to `${jobs_root}/completed/job-{version}-SUMMARY.md` using the Write tool.
513
563
  Display: `Job summary written to ${jobs_root}/completed/job-{version}-SUMMARY.md`
514
564
 
565
+ **Commit and push completion summary:**
566
+
567
+ ```bash
568
+ node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" commit "docs(job): ${VERSION} completion summary" --files "${jobs_root}/completed/job-${VERSION}-SUMMARY.md" --push
569
+ ```
570
+
515
571
  4. **Post-workflow push (sync_after):**
516
572
 
517
573
  Follow the sync-hooks post-workflow push pattern with `WORKFLOW_NAME = "run-job"`:
package/package.json CHANGED
@@ -8,7 +8,7 @@
8
8
  "bugs": {
9
9
  "url": "https://github.com/KT-Partners-Ltd/dgs-platform-docs/issues"
10
10
  },
11
- "version": "2.7.5",
11
+ "version": "2.8.0",
12
12
  "description": "Deliver Great Systems Platform — A meta-prompting, context engineering and spec-driven development system for Claude Code and Gemini by KT Partners.",
13
13
  "bin": {
14
14
  "dgs": "bin/install.js"