@namewta/speculo 1.0.16 → 1.0.18

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 (106) hide show
  1. package/README.md +17 -5
  2. package/dist/src/agent-files.d.ts +9 -0
  3. package/dist/src/agent-files.js +106 -0
  4. package/dist/src/agent-files.js.map +1 -0
  5. package/dist/src/cli.js +64 -14
  6. package/dist/src/cli.js.map +1 -1
  7. package/dist/src/doctor.d.ts +2 -0
  8. package/dist/src/doctor.js +120 -53
  9. package/dist/src/doctor.js.map +1 -1
  10. package/dist/src/external-files.d.ts +22 -0
  11. package/dist/src/external-files.js +110 -0
  12. package/dist/src/external-files.js.map +1 -0
  13. package/dist/src/index.d.ts +3 -0
  14. package/dist/src/index.js +29 -182
  15. package/dist/src/index.js.map +1 -1
  16. package/dist/src/paths.d.ts +12 -0
  17. package/dist/src/paths.js +57 -0
  18. package/dist/src/paths.js.map +1 -0
  19. package/dist/src/transaction.d.ts +27 -0
  20. package/dist/src/transaction.js +187 -0
  21. package/dist/src/transaction.js.map +1 -0
  22. package/dist/src/utils.js +4 -2
  23. package/dist/src/utils.js.map +1 -1
  24. package/dist/src/workflows.js +3 -4
  25. package/dist/src/workflows.js.map +1 -1
  26. package/package.json +6 -4
  27. package/template/.speculo/README.md +9 -3
  28. package/template/.speculo/refresh-contract.json +6 -2
  29. package/template/AGENTS.md +1 -1
  30. package/template/commands/docs-sync.md +13 -11
  31. package/template/skills/archive-and-consolidate/SKILL.md +2 -4
  32. package/template/skills/docs-sync/SKILL.md +22 -11
  33. package/template/skills/docs-sync/references/agents-contract.md +6 -4
  34. package/template/skills/docs-sync/references/document-lifecycle-contract.md +2 -0
  35. package/template/skills/docs-sync/references/entry-procedure.md +2 -17
  36. package/template/skills/docs-sync/references/git-state-contract.md +1 -1
  37. package/template/skills/docs-sync/references/mode-contract.md +21 -0
  38. package/template/skills/docs-sync/references/workflow-scope-contract.md +5 -3
  39. package/template/skills/engineering-standards-builder/SKILL.md +3 -1
  40. package/template/skills/engineering-standards-builder/scripts/validate-builder.mjs +5 -1
  41. package/template/skills/git-history-squash/SKILL.md +3 -3
  42. package/template/skills/github-npm-ops/SKILL.md +2 -4
  43. package/template/skills/source-code-zip/SKILL.md +0 -1
  44. package/template/skills/speculo-retro/SKILL.md +2 -4
  45. package/template/skills/upstream-fork-sync/SKILL.md +1 -3
  46. package/template/skills/writing-great-skills/SKILL.md +3 -3
  47. package/template/workflows/learning/A-archive/A-archive.md +2 -0
  48. package/template/workflows/learning/A-assess-and-plan/A-assess-and-plan.md +2 -0
  49. package/template/workflows/learning/C-consolidate/C-consolidate.md +2 -0
  50. package/template/workflows/learning/G-goal/G-goal.md +6 -0
  51. package/template/workflows/learning/G-goal/references/external-goal-runner.md +4 -0
  52. package/template/workflows/learning/H-homework/H-homework.md +2 -0
  53. package/template/workflows/learning/L-lesson/L-lesson.md +2 -0
  54. package/template/workflows/learning/Q-question/Q-question.md +2 -0
  55. package/template/workflows/learning/R-review/R-review.md +2 -0
  56. package/template/workflows/learning/README.md +4 -53
  57. package/template/workflows/learning/common/rules/artifact-layouts.md +46 -0
  58. package/template/workflows/learning/common/rules/consolidation-contract.md +5 -0
  59. package/template/workflows/learning/common/rules/homework-contract.md +3 -0
  60. package/template/workflows/learning/common/rules/lesson-contract.md +7 -0
  61. package/template/workflows/learning/common/skills/socratic-questioning/SKILL.md +1 -0
  62. package/template/workflows/learning/common/skills/topic-synthesis/SKILL.md +1 -0
  63. package/template/workflows/ops/D-project-deploy/D-project-deploy.md +11 -9
  64. package/template/workflows/ops/H-host-manage/H-host-manage.md +11 -10
  65. package/template/workflows/ops/I-initialize/I-initialize.md +7 -7
  66. package/template/workflows/ops/INDEX.md +20 -16
  67. package/template/workflows/ops/README.md +34 -12
  68. package/template/workflows/ops/S-server-connect/S-server-connect.md +28 -0
  69. package/template/workflows/ops/V-inventory-view/V-inventory-view.md +30 -0
  70. package/template/workflows/ops/_state/status.json +2 -1
  71. package/template/workflows/ops/common/CAPABILITIES.md +22 -15
  72. package/template/workflows/ops/common/USAGE.md +4 -0
  73. package/template/workflows/ops/common/WORKSPACE-USAGE.md +78 -0
  74. package/template/workflows/ops/common/examples/task-host.example.json +64 -0
  75. package/template/workflows/ops/common/rules/activation-and-memory.md +5 -3
  76. package/template/workflows/ops/common/rules/inventory-and-records.md +55 -0
  77. package/template/workflows/ops/common/rules/persistence-and-secrets.md +4 -2
  78. package/template/workflows/ops/common/rules/research-and-decisions.md +18 -0
  79. package/template/workflows/ops/common/rules/server-onboarding.md +21 -0
  80. package/template/workflows/ops/common/rules/workspace-and-authorization.md +39 -0
  81. package/template/workflows/ops/common/schemas/fleet-view.schema.json +487 -0
  82. package/template/workflows/ops/common/schemas/plan.schema.json +4 -0
  83. package/template/workflows/ops/common/schemas/server-check.schema.json +95 -0
  84. package/template/workflows/ops/common/schemas/spec.schema.json +4 -0
  85. package/template/workflows/ops/common/schemas/status.schema.json +4 -0
  86. package/template/workflows/ops/common/schemas/task-request.schema.json +138 -0
  87. package/template/workflows/ops/common/templates/FLEET.html +61 -0
  88. package/template/workflows/ops/common/tests/test_ops.mjs +33 -2
  89. package/template/workflows/ops/common/tests/test_ops_workspace.mjs +246 -0
  90. package/template/workflows/ops/common/tools/ops.mjs +5 -3
  91. package/template/workflows/ops/common/tools/opslib/core.mjs +1 -1
  92. package/template/workflows/ops/common/tools/opslib/docs.mjs +12 -7
  93. package/template/workflows/ops/common/tools/opslib/fleet.mjs +155 -0
  94. package/template/workflows/ops/common/tools/opslib/planner.mjs +7 -1
  95. package/template/workflows/ops/common/tools/opslib/server_checks.mjs +149 -0
  96. package/template/workflows/ops/common/tools/opslib/tasks.mjs +313 -0
  97. package/template/workflows/ops/common/tools/opslib/workspace.mjs +107 -0
  98. package/template/workflows/ops/common/tools/opslib/workspace_cli.mjs +80 -0
  99. package/template/workflows/ops/common/tools/validate-ops.mjs +11 -8
  100. package/template/workflows/ops/manifest.json +43 -7
  101. package/template/workflows/specdev/common/rules/path-reference-contract.md +6 -0
  102. package/template/workflows/specdev/common/skills/code-review/SKILL.md +3 -1
  103. package/template/workflows/specdev/common/skills/dev-worktree/SKILL.md +1 -0
  104. package/template/workflows/specdev/common/skills/plan-quality-review/SKILL.md +3 -1
  105. package/template/workflows/specdev/common/skills/research/SKILL.md +3 -1
  106. package/template/workflows/specdev/common/skills/subagent-delivery/SKILL.md +1 -0
package/template/workflows/specdev/common/rules/path-reference-contract.md CHANGED
@@ -116,3 +116,9 @@ SpecDev 不假定运行时一定提供项目根变量。Ticket、Evidence、诊
116
116
  - 目录引用是否以 `/` 结束且文件引用是否不以 `/` 结束。
117
117
 
118
118
  路径检查通过仅表示引用结构正确，不代表工件语义、需求、设计或实现正确。
119
+
120
+ ## 9. 与标准 Skill 的分发边界
121
+
122
+ 本文件是 SpecDev 内部动态工件协议，不是通用 Agent Skills 的文件格式规范。独立标准 Skill 的静态 references/assets 使用相对路径；workflow 私有 Skill 声明 compatibility 后继续使用本 Path 合同。已有持久化引用不批量迁移。
123
+
124
+ 实际执行前可以使用只读 `speculo resolve <project-root> --path '<Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path>'` 展开单个指针。解析器先打开字面 workspace 路径，拒绝未知 alias、未替换变量、通配符、越界路径与链接跳转；不执行 shell、不授予文件写入权限。完整命令由已获授权调用方使用参数数组构造，不把 Path 标记或用户文本直接交给 shell。
package/template/workflows/specdev/common/skills/code-review/SKILL.md CHANGED
@@ -1,6 +1,8 @@
1
1
  ---
2
- name: specdev-code-review
2
+ name: code-review
3
3
  description: 从不可变固定点对本地 diff 执行隔离的标准轴与规范轴审查，供独立 C Work 和 I Work 最终审查共同调用。
4
+ compatibility: Requires the owning Speculo workflow and its workspace path resolver.
5
+ metadata: {"speculo-legacy-name": "specdev-code-review"}
4
6
  ---
5
7
 
6
8
  # SpecDev Code Review
package/template/workflows/specdev/common/skills/dev-worktree/SKILL.md CHANGED
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: dev-worktree
3
3
  description: 管理 SpecDev required Ticket 的 Git worktree；创建隔离来源 workspace、固定实现 commit，并由 Lead 在 parent-candidate checkout 验证后推进父分支。
4
+ compatibility: Requires the owning Speculo workflow and its workspace path resolver.
4
5
  ---
5
6
 
6
7
  # Dev Worktree
package/template/workflows/specdev/common/skills/plan-quality-review/SKILL.md CHANGED
@@ -1,6 +1,8 @@
1
1
  ---
2
- name: specdev-plan-quality-review
2
+ name: plan-quality-review
3
3
  description: T 发布计划型 Ticket 或 P 发布/重规划 Goal 前检查决策完备、Skill 调用和执行门禁；不执行代码审查或代替用户批准。
4
+ compatibility: Requires the owning Speculo workflow and its workspace path resolver.
5
+ metadata: {"speculo-legacy-name": "specdev-plan-quality-review"}
4
6
  ---
5
7
 
6
8
  # Plan Quality Review
package/template/workflows/specdev/common/skills/research/SKILL.md CHANGED
@@ -1,6 +1,8 @@
1
1
  ---
2
- name: specdev-research
2
+ name: research
3
3
  description: 为调用 Work 的具体决定研究外部技术、依赖、标准或未知行为，逐声明返回一手来源、限制与不确定性，由调用方写入其拥有的工件。
4
+ compatibility: Requires the owning Speculo workflow and its workspace path resolver.
5
+ metadata: {"speculo-legacy-name": "specdev-research"}
4
6
  ---
5
7
 
6
8
  # SpecDev Research
package/template/workflows/specdev/common/skills/subagent-delivery/SKILL.md CHANGED
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: subagent-delivery
3
3
  description: 仅在 Lead 规划派单合同、发出受限任务或验收其返回时调用；不是通用实现入口，外部网页交付仍为 ZIP-only。
4
+ compatibility: Requires the owning Speculo workflow and its workspace path resolver.
4
5
  ---
5
6
 
6
7
  # Subagent Delivery