@cluesmith/codev 1.1.0 → 1.2.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 (146) hide show
  1. package/dist/agent-farm/cli.d.ts.map +1 -1
  2. package/dist/agent-farm/cli.js +19 -0
  3. package/dist/agent-farm/cli.js.map +1 -1
  4. package/dist/agent-farm/commands/cleanup.d.ts.map +1 -1
  5. package/dist/agent-farm/commands/cleanup.js +18 -1
  6. package/dist/agent-farm/commands/cleanup.js.map +1 -1
  7. package/dist/agent-farm/commands/consult.d.ts +16 -0
  8. package/dist/agent-farm/commands/consult.d.ts.map +1 -0
  9. package/dist/agent-farm/commands/consult.js +51 -0
  10. package/dist/agent-farm/commands/consult.js.map +1 -0
  11. package/dist/agent-farm/commands/open.js +6 -6
  12. package/dist/agent-farm/commands/open.js.map +1 -1
  13. package/dist/agent-farm/commands/spawn.d.ts.map +1 -1
  14. package/dist/agent-farm/commands/spawn.js +51 -42
  15. package/dist/agent-farm/commands/spawn.js.map +1 -1
  16. package/dist/agent-farm/commands/start.d.ts.map +1 -1
  17. package/dist/agent-farm/commands/start.js +9 -14
  18. package/dist/agent-farm/commands/start.js.map +1 -1
  19. package/dist/agent-farm/commands/util.js +2 -2
  20. package/dist/agent-farm/commands/util.js.map +1 -1
  21. package/dist/agent-farm/db/errors.d.ts +4 -0
  22. package/dist/agent-farm/db/errors.d.ts.map +1 -1
  23. package/dist/agent-farm/db/errors.js +8 -0
  24. package/dist/agent-farm/db/errors.js.map +1 -1
  25. package/dist/agent-farm/servers/dashboard-server.js +125 -71
  26. package/dist/agent-farm/servers/dashboard-server.js.map +1 -1
  27. package/dist/agent-farm/servers/open-server.d.ts +9 -0
  28. package/dist/agent-farm/servers/open-server.d.ts.map +1 -0
  29. package/dist/agent-farm/servers/{annotate-server.js → open-server.js} +17 -15
  30. package/dist/agent-farm/servers/open-server.js.map +1 -0
  31. package/dist/agent-farm/servers/tower-server.js +4 -7
  32. package/dist/agent-farm/servers/tower-server.js.map +1 -1
  33. package/dist/agent-farm/state.d.ts +5 -0
  34. package/dist/agent-farm/state.d.ts.map +1 -1
  35. package/dist/agent-farm/state.js +17 -0
  36. package/dist/agent-farm/state.js.map +1 -1
  37. package/dist/agent-farm/types.d.ts +1 -1
  38. package/dist/agent-farm/types.d.ts.map +1 -1
  39. package/dist/agent-farm/utils/config.d.ts.map +1 -1
  40. package/dist/agent-farm/utils/config.js +13 -7
  41. package/dist/agent-farm/utils/config.js.map +1 -1
  42. package/dist/agent-farm/utils/port-registry.d.ts +1 -1
  43. package/dist/agent-farm/utils/port-registry.d.ts.map +1 -1
  44. package/dist/agent-farm/utils/port-registry.js +1 -1
  45. package/dist/agent-farm/utils/port-registry.js.map +1 -1
  46. package/dist/agent-farm/utils/shell.d.ts +19 -0
  47. package/dist/agent-farm/utils/shell.d.ts.map +1 -1
  48. package/dist/agent-farm/utils/shell.js +28 -0
  49. package/dist/agent-farm/utils/shell.js.map +1 -1
  50. package/dist/cli.d.ts.map +1 -1
  51. package/dist/cli.js +33 -0
  52. package/dist/cli.js.map +1 -1
  53. package/dist/commands/adopt.d.ts +3 -0
  54. package/dist/commands/adopt.d.ts.map +1 -1
  55. package/dist/commands/adopt.js +31 -25
  56. package/dist/commands/adopt.js.map +1 -1
  57. package/dist/commands/consult/index.d.ts +3 -2
  58. package/dist/commands/consult/index.d.ts.map +1 -1
  59. package/dist/commands/consult/index.js +128 -54
  60. package/dist/commands/consult/index.js.map +1 -1
  61. package/dist/commands/doctor.d.ts.map +1 -1
  62. package/dist/commands/doctor.js +88 -36
  63. package/dist/commands/doctor.js.map +1 -1
  64. package/dist/commands/eject.d.ts +18 -0
  65. package/dist/commands/eject.d.ts.map +1 -0
  66. package/dist/commands/eject.js +149 -0
  67. package/dist/commands/eject.js.map +1 -0
  68. package/dist/commands/import.d.ts +16 -0
  69. package/dist/commands/import.d.ts.map +1 -0
  70. package/dist/commands/import.js +278 -0
  71. package/dist/commands/import.js.map +1 -0
  72. package/dist/commands/init.d.ts +3 -0
  73. package/dist/commands/init.d.ts.map +1 -1
  74. package/dist/commands/init.js +32 -27
  75. package/dist/commands/init.js.map +1 -1
  76. package/dist/lib/projectlist-parser.d.ts +70 -0
  77. package/dist/lib/projectlist-parser.d.ts.map +1 -0
  78. package/dist/lib/projectlist-parser.js +200 -0
  79. package/dist/lib/projectlist-parser.js.map +1 -0
  80. package/dist/lib/skeleton.d.ts +41 -0
  81. package/dist/lib/skeleton.d.ts.map +1 -0
  82. package/dist/lib/skeleton.js +110 -0
  83. package/dist/lib/skeleton.js.map +1 -0
  84. package/dist/lib/templates.d.ts +2 -1
  85. package/dist/lib/templates.d.ts.map +1 -1
  86. package/dist/lib/templates.js +11 -10
  87. package/dist/lib/templates.js.map +1 -1
  88. package/package.json +5 -4
  89. package/{templates → skeleton}/DEPENDENCIES.md +3 -48
  90. package/skeleton/bin/agent-farm +7 -0
  91. package/skeleton/docs/commands/agent-farm.md +469 -0
  92. package/skeleton/docs/commands/codev.md +253 -0
  93. package/skeleton/docs/commands/consult.md +286 -0
  94. package/skeleton/docs/commands/overview.md +108 -0
  95. package/skeleton/maintain/.gitkeep +2 -0
  96. package/{templates → skeleton}/protocols/experiment/protocol.md +2 -2
  97. package/skeleton/protocols/maintain/protocol.md +502 -0
  98. package/skeleton/protocols/maintain/templates/maintenance-run.md +64 -0
  99. package/{templates → skeleton}/protocols/spider/protocol.md +9 -9
  100. package/{templates/protocols/spider-solo → skeleton/protocols/spider}/templates/plan.md +22 -1
  101. package/{templates/protocols/spider-solo → skeleton/protocols/spider}/templates/spec.md +30 -1
  102. package/skeleton/protocols/tick/protocol.md +277 -0
  103. package/skeleton/resources/lessons-learned.md +30 -0
  104. package/skeleton/resources/workflow-reference.md +242 -0
  105. package/skeleton/roles/architect.md +283 -0
  106. package/{templates → skeleton}/roles/builder.md +2 -0
  107. package/skeleton/roles/review-types/impl-review.md +56 -0
  108. package/skeleton/roles/review-types/integration-review.md +68 -0
  109. package/skeleton/roles/review-types/plan-review.md +59 -0
  110. package/skeleton/roles/review-types/pr-ready.md +72 -0
  111. package/skeleton/roles/review-types/spec-review.md +55 -0
  112. package/skeleton/templates/lessons-learned.md +28 -0
  113. package/{templates → skeleton}/templates/projectlist.md +17 -16
  114. package/dist/agent-farm/servers/annotate-server.d.ts +0 -9
  115. package/dist/agent-farm/servers/annotate-server.d.ts.map +0 -1
  116. package/dist/agent-farm/servers/annotate-server.js.map +0 -1
  117. package/templates/agents/architecture-documenter.md +0 -189
  118. package/templates/agents/codev-updater.md +0 -276
  119. package/templates/agents/spider-protocol-updater.md +0 -118
  120. package/templates/annotate.html +0 -903
  121. package/templates/bin/agent-farm +0 -18
  122. package/templates/bin/annotate-server.js +0 -140
  123. package/templates/dashboard-split.html +0 -1679
  124. package/templates/dashboard.html +0 -149
  125. package/templates/protocols/maintain/protocol.md +0 -235
  126. package/templates/protocols/spider/templates/plan.md +0 -169
  127. package/templates/protocols/spider/templates/review.md +0 -207
  128. package/templates/protocols/spider/templates/spec.md +0 -140
  129. package/templates/protocols/spider-solo/protocol.md +0 -619
  130. package/templates/protocols/tick/protocol.md +0 -250
  131. package/templates/roles/architect.md +0 -230
  132. package/templates/tower.html +0 -1032
  133. /package/{templates/AGENTS.md → skeleton/AGENTS.md.template} +0 -0
  134. /package/{templates/CLAUDE.md → skeleton/CLAUDE.md.template} +0 -0
  135. /package/{templates → skeleton}/bin/codev-doctor +0 -0
  136. /package/{templates → skeleton}/builders.md +0 -0
  137. /package/{templates → skeleton}/config.json +0 -0
  138. /package/{templates → skeleton}/plans/.gitkeep +0 -0
  139. /package/{templates → skeleton}/protocols/experiment/templates/notes.md +0 -0
  140. /package/{templates/protocols/spider-solo → skeleton/protocols/spider}/templates/review.md +0 -0
  141. /package/{templates → skeleton}/protocols/tick/templates/plan.md +0 -0
  142. /package/{templates → skeleton}/protocols/tick/templates/review.md +0 -0
  143. /package/{templates → skeleton}/protocols/tick/templates/spec.md +0 -0
  144. /package/{templates → skeleton}/reviews/.gitkeep +0 -0
  145. /package/{templates → skeleton}/roles/consultant.md +0 -0
  146. /package/{templates → skeleton}/specs/.gitkeep +0 -0
@@ -1,118 +0,0 @@
1
- ---
2
- name: spider-protocol-updater
3
- description: Use this agent when you need to analyze remote GitHub repositories that implement the SPIDER protocol and determine if their improvements or lessons learned should be incorporated back into the main codev/ and codev-skeleton/ protocol.md files. This agent should be triggered periodically or when notified of significant SPIDER implementations in other repositories.\n\nExamples:\n- <example>\n Context: The user wants to check if a remote repository has made improvements to SPIDER that should be incorporated.\n user: "Check the ansari-project/webapp repo for any SPIDER improvements we should adopt"\n assistant: "I'll use the spider-protocol-updater agent to analyze their SPIDER implementation and identify potential protocol improvements."\n <commentary>\n Since the user wants to analyze a remote SPIDER implementation for improvements, use the spider-protocol-updater agent.\n </commentary>\n</example>\n- <example>\n Context: Regular maintenance check for protocol improvements across SPIDER implementations.\n user: "It's been a month since we last checked for SPIDER improvements in other repos"\n assistant: "Let me use the spider-protocol-updater agent to scan recent SPIDER implementations and identify any protocol enhancements we should consider."\n <commentary>\n For periodic reviews of SPIDER implementations, use the spider-protocol-updater agent.\n </commentary>\n</example>
4
- model: opus
5
- ---
6
-
7
- You are a SPIDER Protocol Evolution Specialist, an expert in analyzing software development methodologies and identifying patterns of improvement across distributed implementations. Your deep understanding of the SPIDER (Specify, Plan, Implement, Defend, Evaluate, Review) protocol allows you to recognize valuable enhancements and distinguish between project-specific customizations and universally beneficial improvements.
8
-
9
- ## Your Core Mission
10
-
11
- You analyze remote GitHub repositories that implement the SPIDER protocol to identify improvements, lessons learned, and refinements that should be incorporated back into the canonical codev/ and codev-skeleton/ versions of protocol.md.
12
-
13
- ## Analysis Workflow
14
-
15
- ### 1. Repository Discovery and Validation
16
- - Locate and access the specified remote GitHub repository
17
- - Verify it uses SPIDER by checking for the codev/ directory structure
18
- - Identify the protocol.md file in their codev/protocols/spider/ directory
19
- - Map out their specs/, plans/, and lessons/ directories
20
-
21
- ### 2. Protocol Comparison
22
- - Compare their protocol.md with the canonical version in codev/protocols/spider/protocol.md
23
- - Identify additions, modifications, or clarifications they've made
24
- - Note any new phases, checkpoints, or consultation patterns they've introduced
25
- - Document any streamlining or simplification improvements
26
-
27
- ### 3. Review File Analysis
28
- - Examine recent review files in their codev/lessons/ directory
29
- - Focus on reviews from the last 3-6 months for relevance
30
- - Extract patterns of success and failure
31
- - Identify recurring themes in lessons learned
32
- - Look for process improvements discovered through experience
33
-
34
- ### 4. Improvement Classification
35
-
36
- Classify each identified improvement as:
37
- - **Universal**: Benefits all SPIDER implementations (should be adopted)
38
- - **Domain-specific**: Only relevant to their project type (document but don't adopt)
39
- - **Experimental**: Interesting but needs more validation (flag for monitoring)
40
- - **Anti-pattern**: Something that didn't work (add as a warning to protocol)
41
-
42
- ### 5. Implementation Impact Assessment
43
-
44
- For universal improvements, assess:
45
- - Backward compatibility with existing SPIDER projects
46
- - Complexity vs benefit trade-off
47
- - Integration effort required
48
- - Potential conflicts with existing protocol principles
49
-
50
- ## Decision Framework
51
-
52
- Recommend protocol updates when:
53
- 1. The improvement has been successfully used in at least 3 completed SPIDER cycles
54
- 2. The change simplifies the protocol without losing essential functionality
55
- 3. Multiple projects would benefit from the enhancement
56
- 4. The improvement addresses a known pain point in the current protocol
57
- 5. The change maintains or improves the protocol's core principles
58
-
59
- ## Output Format
60
-
61
- Provide your analysis in this structure:
62
-
63
- ```markdown
64
- # SPIDER Protocol Update Analysis
65
- ## Repository: [owner/repo]
66
- ## Analysis Date: [date]
67
-
68
- ### Protocol Differences Identified
69
- 1. [Difference description]
70
- - Location: [file/section]
71
- - Classification: [Universal/Domain-specific/Experimental]
72
- - Rationale: [why this classification]
73
-
74
- ### Lessons Learned Review
75
- 1. [Pattern/theme]
76
- - Evidence: [which review files]
77
- - Frequency: [how often observed]
78
- - Applicability: [universal or specific]
79
-
80
- ### Recommended Updates to codev/protocol.md
81
- 1. [Specific change]
82
- - Current text: [quote]
83
- - Proposed text: [new version]
84
- - Justification: [why this improves the protocol]
85
-
86
- ### Recommended Updates to codev-skeleton/protocol.md
87
- [Similar structure]
88
-
89
- ### Monitoring Recommendations
90
- - [Experimental features to watch]
91
- - [Repositories to check again in future]
92
- ```
93
-
94
- ## Quality Checks
95
-
96
- Before recommending any update:
97
- 1. Verify the improvement has been battle-tested in real projects
98
- 2. Ensure it doesn't contradict SPIDER's fail-fast principle
99
- 3. Confirm it maintains the protocol's emphasis on documentation
100
- 4. Check that it preserves the multi-agent consultation model
101
- 5. Validate that it keeps the protocol simple and actionable
102
-
103
- ## Edge Cases
104
-
105
- - If the repository has abandoned SPIDER mid-project, analyze why and document as anti-patterns
106
- - If they've created a variant protocol, evaluate if it should be a separate protocol option
107
- - If improvements are language/framework specific, consider creating protocol extensions
108
- - If you cannot access the repository, clearly state this limitation and suggest alternatives
109
-
110
- ## Continuous Learning
111
-
112
- Maintain awareness that:
113
- - SPIDER is an evolving protocol that improves through community usage
114
- - Not all customizations are improvements; some are necessary adaptations
115
- - The best improvements often come from simplification, not addition
116
- - Failed experiments provide valuable negative evidence
117
-
118
- You are the guardian of protocol evolution, ensuring SPIDER grows stronger through the collective wisdom of its implementations while maintaining its core simplicity and effectiveness.