ai-delivery-workflow 0.5.0 → 0.6.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 (81) hide show
  1. package/README.md +5 -6
  2. package/bin/ai-delivery.mjs +2 -24
  3. package/docs/CLI-PARAMETER-REFERENCE.zh-CN.md +6 -67
  4. package/docs/DUAL-REPOSITORY-WORKSPACE.zh-CN.md +1 -1
  5. package/docs/FILE-REFERENCE.zh-CN.md +6 -28
  6. package/docs/MAINTENANCE-VERIFICATION.zh-CN.md +2 -2
  7. package/docs/PROJECT-MANUAL.zh-CN.md +23 -38
  8. package/docs/STATE-CLI-MAINTENANCE.zh-CN.md +8 -10
  9. package/docs/STATE-CLI-USER-GUIDE.zh-CN.md +6 -16
  10. package/docs/agents/workflow-manager-acceptance-matrix.md +9 -15
  11. package/docs/agents/workflow-manager-current-state.md +12 -15
  12. package/lib/communication-confirmation.mjs +177 -0
  13. package/lib/delivery-state.mjs +59 -910
  14. package/lib/fs-utils.mjs +0 -16
  15. package/lib/project-bootstrap.mjs +288 -61
  16. package/lib/project-installer.mjs +49 -181
  17. package/lib/project-repair.mjs +217 -0
  18. package/lib/toml-hooks.mjs +2 -4
  19. package/lib/workflow-manager-governance.mjs +3 -47
  20. package/lib/workspace.mjs +2 -3
  21. package/package.json +2 -2
  22. package/skills/ai-delivery-bootstrap/SKILL.md +5 -1
  23. package/skills/ai-delivery-bootstrap/references/bootstrap-contract.md +1 -1
  24. package/skills/ai-delivery-checkpoint-task/SKILL.md +2 -4
  25. package/skills/ai-delivery-checkpoint-task/references/checkpoint-contract.md +4 -2
  26. package/skills/ai-delivery-checkpoint-task/scripts/hook-event.mjs +2 -8
  27. package/skills/ai-delivery-checkpoint-task/scripts/task-state.mjs +26 -46
  28. package/skills/ai-delivery-close-version/SKILL.md +13 -10
  29. package/skills/ai-delivery-close-version/references/version-closeout-contract.md +2 -1
  30. package/skills/ai-delivery-define-product/SKILL.md +6 -3
  31. package/skills/ai-delivery-design-architecture/SKILL.md +10 -5
  32. package/skills/ai-delivery-design-architecture/assets/architecture-template/architecture-gate.yaml +2 -0
  33. package/skills/ai-delivery-design-architecture/assets/architecture-template/prototype-architecture-validation.yaml +2 -0
  34. package/skills/ai-delivery-design-architecture/references/architecture-contract.md +4 -0
  35. package/skills/ai-delivery-design-experience/SKILL.md +8 -6
  36. package/skills/ai-delivery-design-experience/assets/experience-template/product-prototype-reconciliation.yaml +2 -0
  37. package/skills/ai-delivery-design-experience/assets/experience-template/ui-handoff.yaml +3 -0
  38. package/skills/ai-delivery-design-experience/references/experience-contract.md +3 -13
  39. package/skills/ai-delivery-design-experience/references/prototype-management-contract.md +1 -1
  40. package/skills/ai-delivery-design-tests/SKILL.md +4 -0
  41. package/skills/ai-delivery-develop-iteration/SKILL.md +6 -1
  42. package/skills/ai-delivery-develop-iteration/assets/development-template/candidate-manifest.yaml +2 -0
  43. package/skills/ai-delivery-execute-work-package/SKILL.md +4 -2
  44. package/skills/ai-delivery-orchestrate/SKILL.md +7 -7
  45. package/skills/ai-delivery-orchestrate/assets/codebase-template/AGENTS.md +14 -0
  46. package/skills/ai-delivery-orchestrate/assets/codebase-template/CODEBASE_GUIDE.md +124 -0
  47. package/skills/ai-delivery-orchestrate/assets/codebase-template/docs/CODEBASE_INDEX.md +87 -0
  48. package/skills/ai-delivery-orchestrate/assets/communication-template/confirmation-examples.yaml +67 -0
  49. package/skills/ai-delivery-orchestrate/assets/communication-template/confirmation-summary.yaml +42 -0
  50. package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/iterations/ITER-0001/02-solution-design/product-impact-assessment.yaml +42 -0
  51. package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/tools/hooks/hook-event.mjs +2 -8
  52. package/skills/ai-delivery-orchestrate/assets/project-template/AGENTS.md +4 -5
  53. package/skills/ai-delivery-orchestrate/references/codebase-document-contract.md +91 -0
  54. package/skills/ai-delivery-orchestrate/references/communication-confirmation-contract.md +52 -0
  55. package/skills/ai-delivery-orchestrate/references/formal-state-contract.md +11 -20
  56. package/skills/ai-delivery-orchestrate/references/product-impact-assessment-contract.md +87 -0
  57. package/skills/ai-delivery-orchestrate/references/workflow-model.md +1 -3
  58. package/skills/ai-delivery-orchestrate/scripts/confirmation-state.mjs +30 -0
  59. package/skills/ai-delivery-orchestrate-release/SKILL.md +3 -1
  60. package/skills/ai-delivery-plan-iteration/SKILL.md +6 -1
  61. package/skills/ai-delivery-prepare-platform/SKILL.md +1 -1
  62. package/skills/ai-delivery-prepare-release/SKILL.md +2 -0
  63. package/skills/ai-delivery-prepare-release/assets/release-template/release-manifest.yaml +0 -2
  64. package/skills/ai-delivery-review-change/SKILL.md +3 -1
  65. package/skills/ai-delivery-validate-artifacts/SKILL.md +10 -7
  66. package/skills/ai-delivery-validate-artifacts/references/artifact-contract.md +2 -1
  67. package/skills/ai-delivery-verify-candidate/SKILL.md +5 -2
  68. package/skills/ai-delivery-verify-candidate/references/candidate-verification-contract.md +1 -1
  69. package/docs/PROTOTYPE-MIGRATION.zh-CN.md +0 -164
  70. package/docs/VIEWER-MAINTENANCE.zh-CN.md +0 -150
  71. package/docs/VIEWER-USER-GUIDE.zh-CN.md +0 -113
  72. package/lib/project-migration.mjs +0 -1193
  73. package/lib/prototype-migration.mjs +0 -713
  74. package/skills/ai-delivery-design-experience/assets/experience-template/LEGACY-COMPATIBILITY.md +0 -16
  75. package/skills/ai-delivery-design-experience/assets/experience-template/canvas-catalog.csv +0 -1
  76. package/skills/ai-delivery-design-experience/assets/experience-template/canvas-pages.csv +0 -1
  77. package/skills/ai-delivery-design-experience/assets/experience-template/page-catalog.csv +0 -1
  78. package/skills/ai-delivery-design-experience/assets/experience-template/prototype-file-terminals.csv +0 -1
  79. package/skills/ai-delivery-design-experience/assets/experience-template/prototype-files.csv +0 -1
  80. package/skills/ai-delivery-design-experience/assets/experience-template/prototype-manifest.yaml +0 -76
  81. package/skills/ai-delivery-design-experience/assets/experience-template/prototype-set.yaml +0 -24
@@ -1,16 +0,0 @@
1
- # Legacy Prototype Compatibility Inputs
2
-
3
- The current flow does not create or update the following files. They remain in
4
- the package only so historical iterations can be inspected, verified, rebuilt,
5
- or explicitly migrated until downstream consumers complete their migration:
6
-
7
- - `prototype-set.yaml`
8
- - `prototype-manifest.yaml`
9
- - `page-catalog.csv`
10
- - `canvas-catalog.csv`
11
- - `canvas-pages.csv`
12
- - `prototype-files.csv`
13
- - `prototype-file-terminals.csv`
14
-
15
- Treat these files as read-only. Normalize their identities in memory and never
16
- use them as the output model for a new iteration.
@@ -1 +0,0 @@
1
- canvas_id,prototype_artifact_id,prototype_file_id,canvas_name,main_page_id,terminal_id,lifecycle_status,split_rationale
@@ -1 +0,0 @@
1
- canvas_id,page_id,placement_order,is_primary
@@ -1 +0,0 @@
1
- page_id,page_name,display_label,parent_page_id,page_level,prototype_artifact_id,terminal_id,route_ref,lifecycle_status,notes
@@ -1 +0,0 @@
1
- prototype_file_id,prototype_artifact_id,authoring_candidate_id,file_ref,source_revision,lifecycle_scope,review_scope,lifecycle_status
@@ -1,76 +0,0 @@
1
- artifact_id: PROTOTYPE-0001
2
- artifact_type: experience-prototype
3
- version: 1
4
- iteration_id: ITER-0001
5
- status: draft
6
- producer_skill: ai-delivery-design-experience
7
- compatibility_mode: read-only-legacy
8
- current_flow_output: false
9
- inputs:
10
- product_baseline: PRODUCT-BASELINE-0001@1
11
- architecture_initial: ARCH-INITIAL-0001@1
12
- architecture_gate: ARCH-GATE-0001@1
13
- prototype_tool_selection: PROTOTYPE-TOOL-SELECTION-0001@1
14
- prototype_review_decision: PROTOTYPE-REVIEW-DECISION-0001@1
15
- prototype_impact_assessment: PROTOTYPE-IMPACT-ASSESSMENT-0001@1
16
- input_checksums:
17
- product_baseline: REPLACE_WITH_SHA256
18
- architecture_initial: REPLACE_WITH_SHA256
19
- architecture_gate: REPLACE_WITH_SHA256
20
- tool_selection_ref: prototype-tool-selection-PROTOTYPE-0001.yaml
21
- tool_selection_algorithm: sha256
22
- tool_selection_checksum: REPLACE_WITH_SHA256
23
- prototype:
24
- prototype_type: interactive
25
- fidelity: low
26
- source_ref: prototype/source
27
- source_revision: REVISION-0001
28
- review_entrypoint_in_bundle: index.html
29
- review_bundle: prototype/review/prototype-review.zip
30
- review_bundle_algorithm: sha256
31
- review_bundle_checksum: REPLACE_WITH_SHA256
32
- coverage:
33
- terminal_ids: []
34
- flow_ids: []
35
- screen_ids: []
36
- state_ids: []
37
- page_catalog_ref: page-catalog-PROTOTYPE-0001.csv
38
- page_catalog_algorithm: sha256
39
- page_catalog_checksum: REPLACE_WITH_SHA256
40
- canvas_catalog_ref: canvas-catalog-PROTOTYPE-0001.csv
41
- canvas_catalog_algorithm: sha256
42
- canvas_catalog_checksum: REPLACE_WITH_SHA256
43
- canvas_pages_ref: canvas-pages-PROTOTYPE-0001.csv
44
- canvas_pages_algorithm: sha256
45
- canvas_pages_checksum: REPLACE_WITH_SHA256
46
- prototype_files_ref: prototype-files-PROTOTYPE-0001.csv
47
- prototype_files_algorithm: sha256
48
- prototype_files_checksum: REPLACE_WITH_SHA256
49
- prototype_file_terminals_ref: prototype-file-terminals-PROTOTYPE-0001.csv
50
- prototype_file_terminals_algorithm: sha256
51
- prototype_file_terminals_checksum: REPLACE_WITH_SHA256
52
- prototype_review_decision_ref: prototype-review-decision-PROTOTYPE-0001.yaml
53
- prototype_review_decision_algorithm: sha256
54
- prototype_review_decision_checksum: REPLACE_WITH_SHA256
55
- prototype_review_sessions_ref: prototype-review-sessions-PROTOTYPE-0001.csv
56
- prototype_review_sessions_algorithm: sha256
57
- prototype_review_sessions_checksum: REPLACE_WITH_SHA256
58
- prototype_review_comments_ref: prototype-review-comments-PROTOTYPE-0001.csv
59
- prototype_review_comments_algorithm: sha256
60
- prototype_review_comments_checksum: REPLACE_WITH_SHA256
61
- prototype_adjustment_log_ref: prototype-adjustment-log-PROTOTYPE-0001.csv
62
- prototype_adjustment_log_algorithm: sha256
63
- prototype_adjustment_log_checksum: REPLACE_WITH_SHA256
64
- prototype_impact_assessment_ref: prototype-impact-assessment-PROTOTYPE-0001.yaml
65
- prototype_impact_assessment_algorithm: sha256
66
- prototype_impact_assessment_checksum: REPLACE_WITH_SHA256
67
- traceability_ref: prototype-traceability.csv
68
- traceability_algorithm: sha256
69
- traceability_checksum: REPLACE_WITH_SHA256
70
- state_catalog_ref: screen-states.csv
71
- state_catalog_algorithm: sha256
72
- state_catalog_checksum: REPLACE_WITH_SHA256
73
- feature_screen_coverage_ref: feature-screen-coverage.csv
74
- feature_screen_coverage_algorithm: sha256
75
- feature_screen_coverage_checksum: REPLACE_WITH_SHA256
76
- standards: []
@@ -1,24 +0,0 @@
1
- artifact_id: PROTOTYPE-SET-0001
2
- artifact_type: experience-prototype-set
3
- version: 1
4
- iteration_id: ITER-0001
5
- status: draft
6
- producer_skill: ai-delivery-design-experience
7
- compatibility_mode: read-only-legacy
8
- current_flow_output: false
9
- input_artifacts:
10
- product_baseline: PRODUCT-BASELINE-0001@1
11
- architecture_initial: ARCH-INITIAL-0001@1
12
- architecture_gate: ARCH-GATE-0001@1
13
- input_checksums:
14
- product_baseline: REPLACE_WITH_SHA256
15
- architecture_initial: REPLACE_WITH_SHA256
16
- architecture_gate: REPLACE_WITH_SHA256
17
- standards: []
18
- members:
19
- - prototype_artifact_id: PROTOTYPE-0001
20
- prototype_version: 1
21
- terminal_ids: []
22
- manifest_ref: prototype-manifest-PROTOTYPE-0001.yaml
23
- manifest_algorithm: sha256
24
- manifest_checksum: REPLACE_WITH_SHA256