thoth-agents 0.4.2 → 0.5.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 (115) hide show
  1. package/LICENSE +30 -0
  2. package/README.md +86 -58
  3. package/dist/agents/prompt-sections.d.ts +5 -3
  4. package/dist/agents/prompt-utils.d.ts +1 -1
  5. package/dist/agents/worker.d.ts +2 -0
  6. package/dist/{chunk-STCURXAQ.js → chunk-MRFCA3U2.js} +33 -67
  7. package/dist/{chunk-EFGSGPYM.js → chunk-OW6I7ZUU.js} +391 -416
  8. package/dist/chunk-V7HSGRMB.js +1016 -0
  9. package/dist/{chunk-WCLUZZHI.js → chunk-VUNYH263.js} +1580 -351
  10. package/dist/cli/claude-code-paths.d.ts +2 -2
  11. package/dist/cli/codex-install.d.ts +5 -2
  12. package/dist/cli/codex-paths.d.ts +2 -2
  13. package/dist/cli/index.js +47 -11
  14. package/dist/cli/operations/pi.d.ts +1 -0
  15. package/dist/cli/pi-effort.d.ts +1 -1
  16. package/dist/cli/pi-external-package.d.ts +24 -0
  17. package/dist/cli/pi-git-source.d.ts +1 -0
  18. package/dist/cli/pi-install.d.ts +92 -15
  19. package/dist/cli/pi-managed-write.d.ts +3 -0
  20. package/dist/cli/pi-model-config.d.ts +17 -0
  21. package/dist/cli/pi-native-probe.d.ts +2 -0
  22. package/dist/cli/pi-paths.d.ts +2 -0
  23. package/dist/cli/pi-resources.d.ts +3 -1
  24. package/dist/cli/pi-tool-config.d.ts +32 -0
  25. package/dist/cli/tui/index.js +3 -3
  26. package/dist/cli/types.d.ts +2 -0
  27. package/dist/config/constants.d.ts +4 -8
  28. package/dist/config/schema.d.ts +7 -36
  29. package/dist/harness/adapters/claude-code.d.ts +2 -4
  30. package/dist/harness/core/agent-pack.d.ts +52 -42
  31. package/dist/harness/core/memory-governance.d.ts +2 -2
  32. package/dist/harness/core/sdd.d.ts +159 -319
  33. package/dist/harness/writers/pi-agent.d.ts +3 -1
  34. package/dist/index.js +12 -6
  35. package/dist/pi/tools-panel.d.ts +51 -0
  36. package/dist/pi.d.ts +44 -2
  37. package/dist/pi.js +471 -9
  38. package/dist/utils/subprocess.d.ts +1 -0
  39. package/package.json +18 -4
  40. package/pi/.thoth-agents-assets.json +5 -6
  41. package/pi/agents/thoth-designer.md +23 -8
  42. package/pi/agents/thoth-explorer.md +29 -9
  43. package/pi/agents/thoth-librarian.md +30 -8
  44. package/pi/agents/thoth-oracle.md +18 -10
  45. package/pi/agents/thoth-worker.md +96 -0
  46. package/plugin/.claude-plugin/.thoth-agents-plugin-assets.json +7 -12
  47. package/plugin/.claude-plugin/plugin.json +2 -2
  48. package/plugin/.codex-plugin/plugin.json +2 -2
  49. package/plugin/agents/designer.md +13 -5
  50. package/plugin/agents/explorer.md +16 -5
  51. package/plugin/agents/librarian.md +15 -4
  52. package/plugin/agents/oracle.md +13 -7
  53. package/plugin/agents/orchestrator.md +82 -91
  54. package/plugin/agents/worker.md +76 -0
  55. package/plugin/skills/plan-reviewer/SKILL.md +39 -141
  56. package/plugin/skills/thoth-archive/SKILL.md +50 -47
  57. package/plugin/skills/thoth-archive/scripts/archive.mjs +287 -654
  58. package/plugin/skills/thoth-constitution/SKILL.md +23 -42
  59. package/plugin/skills/thoth-constitution/templates/constitution.md +54 -44
  60. package/plugin/skills/thoth-init/SKILL.md +19 -29
  61. package/plugin/skills/thoth-init/scripts/init.mjs +73 -66
  62. package/plugin/skills/thoth-sdd/SKILL.md +164 -117
  63. package/plugin/skills/thoth-sdd/references/phases/checklist.md +2 -22
  64. package/plugin/skills/thoth-sdd/references/phases/clarify.md +14 -12
  65. package/plugin/skills/thoth-sdd/references/phases/converge.md +2 -13
  66. package/plugin/skills/thoth-sdd/references/phases/explore.md +3 -8
  67. package/plugin/skills/thoth-sdd/references/phases/implement.md +58 -57
  68. package/plugin/skills/thoth-sdd/references/phases/plan.md +2 -18
  69. package/plugin/skills/thoth-sdd/references/phases/specify.md +2 -33
  70. package/plugin/skills/thoth-sdd/references/phases/tasks.md +4 -45
  71. package/plugin/skills/thoth-sdd/references/phases/verify.md +4 -22
  72. package/plugin/skills/thoth-sdd/scripts/validate.mjs +610 -1232
  73. package/plugin/skills/thoth-sdd/templates/change.md +94 -0
  74. package/skills/README.md +11 -13
  75. package/skills/plan-reviewer/SKILL.md +39 -141
  76. package/skills/thoth-archive/SKILL.md +50 -47
  77. package/skills/thoth-archive/scripts/archive.mjs +287 -654
  78. package/skills/thoth-constitution/SKILL.md +23 -42
  79. package/skills/thoth-constitution/templates/constitution.md +54 -44
  80. package/skills/thoth-init/SKILL.md +19 -29
  81. package/skills/thoth-init/scripts/init.mjs +73 -66
  82. package/skills/thoth-sdd/SKILL.md +164 -117
  83. package/skills/thoth-sdd/references/phases/checklist.md +2 -22
  84. package/skills/thoth-sdd/references/phases/clarify.md +14 -12
  85. package/skills/thoth-sdd/references/phases/converge.md +2 -13
  86. package/skills/thoth-sdd/references/phases/explore.md +3 -8
  87. package/skills/thoth-sdd/references/phases/implement.md +58 -57
  88. package/skills/thoth-sdd/references/phases/plan.md +2 -18
  89. package/skills/thoth-sdd/references/phases/specify.md +2 -33
  90. package/skills/thoth-sdd/references/phases/tasks.md +4 -45
  91. package/skills/thoth-sdd/references/phases/verify.md +4 -22
  92. package/skills/thoth-sdd/scripts/validate.mjs +610 -1232
  93. package/skills/thoth-sdd/templates/change.md +94 -0
  94. package/thoth-agents.schema.json +9 -77
  95. package/dist/agents/deep.d.ts +0 -2
  96. package/dist/agents/quick.d.ts +0 -2
  97. package/dist/chunk-2U5MBLLV.js +0 -312
  98. package/pi/agents/thoth-deep.md +0 -81
  99. package/pi/agents/thoth-quick.md +0 -81
  100. package/plugin/agents/deep.md +0 -68
  101. package/plugin/agents/quick.md +0 -68
  102. package/plugin/skills/plan-reviewer/templates/plan-review.md +0 -65
  103. package/plugin/skills/thoth-sdd/templates/archive-report.md +0 -25
  104. package/plugin/skills/thoth-sdd/templates/checklist.md +0 -27
  105. package/plugin/skills/thoth-sdd/templates/plan.md +0 -46
  106. package/plugin/skills/thoth-sdd/templates/spec.md +0 -62
  107. package/plugin/skills/thoth-sdd/templates/tasks.md +0 -58
  108. package/plugin/skills/thoth-sdd/templates/verify-report.md +0 -28
  109. package/skills/plan-reviewer/templates/plan-review.md +0 -65
  110. package/skills/thoth-sdd/templates/archive-report.md +0 -25
  111. package/skills/thoth-sdd/templates/checklist.md +0 -27
  112. package/skills/thoth-sdd/templates/plan.md +0 -46
  113. package/skills/thoth-sdd/templates/spec.md +0 -62
  114. package/skills/thoth-sdd/templates/tasks.md +0 -58
  115. package/skills/thoth-sdd/templates/verify-report.md +0 -28
@@ -1,46 +0,0 @@
1
- # Implementation Plan: [Feature name]
2
-
3
- ## Technical context
4
-
5
- [Current behavior, constraints, and affected surfaces.]
6
-
7
- ## Constitution Check (pre-design)
8
-
9
- Read `openspec/memory/constitution.md` and extract every active numbered
10
- principle heading. Build one ordered name set and reuse it unchanged in both
11
- Constitution Checks: do not add, remove, abbreviate, or rename a heading between
12
- the pre-design and post-design lists.
13
-
14
- Each entry must use the canonical form
15
- `- **<exact principle heading>**: <PASS | JUSTIFIED EXCEPTION | FAIL> — <concrete evidence>`.
16
- Placeholders are invalid, and any `FAIL` blocks task generation. Replace the
17
- anchor below; do not append entries beside an example list.
18
-
19
- <!-- PRE-DESIGN-CONSTITUTION-ENTRIES -->
20
-
21
- ## Design
22
-
23
- ### Requirement mapping
24
-
25
- | Requirement | Technical decision | Files/interfaces | Verification seam |
26
- | --- | --- | --- | --- |
27
- | FR-001 | [Decision] | `[exact/path]` | [Public seam] |
28
-
29
- ## Optional support artifacts
30
-
31
- - `research.md`: [reason or not needed]
32
- - `data-model.md`: [reason or not needed]
33
- - `contracts/`: [reason or not needed]
34
- - `quickstart.md`: [reason or not needed]
35
-
36
- ## Risks and migrations
37
-
38
- - [Risk, mitigation, rollback or migration.]
39
-
40
- ## Constitution Check (post-design)
41
-
42
- Reuse the exact ordered principle names from the pre-design check and provide
43
- fresh evidence about the completed design. Replace the anchor below; the two
44
- checks must differ only in status/evidence, never in principle coverage.
45
-
46
- <!-- POST-DESIGN-CONSTITUTION-ENTRIES -->
@@ -1,62 +0,0 @@
1
- # Feature Specification: [Feature name]
2
-
3
- **Change ID**: `[feature]`<br>
4
- **Route**: Accelerated | Full<br>
5
- **Status**: Draft
6
-
7
- ## Intent and scope
8
-
9
- **Why**: [User or operator value.]<br>
10
- **Impact**: [Observable behavior and compatibility impact.]<br>
11
- **Affected capabilities**: `[capability-slug]` | None
12
-
13
- ## User stories
14
-
15
- ### US1 - [Outcome] (Priority: P1)
16
-
17
- As a [actor], I can [capability] so that [value].
18
-
19
- **Independent test**: [How this story is demonstrated in isolation.]
20
-
21
- **Covers**: FR-001, SC-001
22
-
23
- **Acceptance scenarios**:
24
-
25
- 1. **Given** [context], **When** [action], **Then** [observable result].
26
-
27
- ## Edge cases
28
-
29
- - [Boundary or failure scenario.]
30
-
31
- ## Functional requirements
32
-
33
- - **FR-001 — [Requirement name]**: `[DELTA capability-slug]` The system MUST [observable behavior].
34
-
35
- Replace `DELTA` after inspecting `openspec/specs/<capability>/spec.md`. Use
36
- `ADDED` only for behavior not expressed by a canonical requirement, `MODIFIED`
37
- or `REMOVED` only with the exact existing requirement title, and
38
- `RENAMED capability-slug FROM Exact previous title` when the title changes. Only
39
- `ADDED` is valid when the canonical capability is absent. An addition to an
40
- existing nonempty capability requires semantic-overlap review even when its
41
- exact title is new.
42
-
43
- Use exactly one delta marker per FR: `[INTERNAL]`, `[ADDED capability-slug]`,
44
- `[MODIFIED capability-slug]`, `[REMOVED capability-slug]`, or
45
- `[RENAMED capability-slug FROM Previous requirement name]`.
46
-
47
- ## Success criteria
48
-
49
- - **SC-001** `[buildable]`: [Measurable criterion implemented by this change.]
50
- - **SC-002** `[outcome]`: [Measurable product or operational outcome observed later.]
51
-
52
- ## Assumptions
53
-
54
- - [Documented safe assumption.]
55
-
56
- ## Dependencies
57
-
58
- - [External or internal dependency, or None.]
59
-
60
- ## Out of scope
61
-
62
- - [Explicit non-goal.]
@@ -1,58 +0,0 @@
1
- # Tasks: [Feature name]
2
-
3
- ## Authoring contract
4
-
5
- Replace every HTML anchor below with real content; do not append new tasks next
6
- to retained examples. Across the entire file, task identifiers start at `T001`
7
- and increase by exactly one without resetting for a new story or section.
8
-
9
- The canonical task form is:
10
- ``- [ ] T001 [P] [US1] Description with FR-###/SC-### coverage in `path/to/file` | Verify: observable outcome``
11
-
12
- `[P]` is optional and must precede the optional `[US#]` tag. Before
13
- `| Verify:`, each task must contain exactly one backtick span, reserved for one
14
- literal repository-relative path. Do not use placeholders, globs, absolute or
15
- home-relative paths, repository escapes, URIs, or extra backticks. Every task
16
- must end with a concrete `Verify` outcome.
17
-
18
- ## MVP scope
19
-
20
- [Name the first independently testable story and its completion evidence.]
21
-
22
- ## Dependencies
23
-
24
- `T001 -> T002`; [cross-story dependency notes, or None.]
25
-
26
- ## Story US1
27
-
28
- <!-- STORY-US1-TASKS -->
29
-
30
- Outcome SCs remain verification targets; do not manufacture implementation tasks
31
- for them.
32
-
33
- ## Parallel execution
34
-
35
- Use this exact grammar when safe parallel work exists:
36
-
37
- ### Group P1
38
-
39
- - Lane L1: T001 -> T002 | Owner: deep
40
- - Lane L2: T003 -> T004 | Owner: quick
41
- - Prerequisites: None
42
- - Barrier: Final verification
43
- - Rationale: Both lane path sets are disjoint and neither lane consumes peer output.
44
-
45
- Groups and lanes are sequential and unique. Every `[P]` task belongs to exactly one lane; non-`[P]` tasks do not. Lane surfaces are the union of exact task
46
- paths, and lanes in a group have disjoint surfaces and no cross-lane dependency.
47
- The `Rationale` must explicitly state path-disjointness and cross-lane dependency
48
- evidence so structural validation can gate the evidence shape and Oracle can
49
- judge whether the claim is true.
50
- Prerequisites name known tasks outside the group; the barrier is a downstream
51
- task or `Final verification` after all lane members. If no group exists, use
52
- only `- None: <evidence-backed reason>` and no task may use `[P]`.
53
-
54
- <!-- PARALLEL-EXECUTION-EVIDENCE -->
55
-
56
- ## Final verification
57
-
58
- <!-- FINAL-VERIFICATION-TASKS -->
@@ -1,28 +0,0 @@
1
- # Verification Report: [Feature name]
2
-
3
- **Reviewer**: oracle<br>
4
- **Independent from implementer**: Yes<br>
5
- **Verdict**: PASS | FAIL
6
-
7
- ## Review dimensions
8
-
9
- - **Completeness**: [All accepted scope represented or finding IDs.]
10
- - **Correctness**: [Behavior matches each contract or finding IDs.]
11
- - **Coherence**: [Spec, plan, tasks, implementation, and docs agree or finding IDs.]
12
-
13
- ## Compliance matrix
14
-
15
- | Requirement | Implementation evidence | Executed check | Result |
16
- | --- | --- | --- | --- |
17
- | FR-001 | `[path:line]` | `[command]` | PASS | FAIL |
18
- | SC-001 `[buildable]` | `[path:line]` | `[command]` | PASS | FAIL |
19
- | SC-002 `[outcome]` | [Observed evidence or residual-risk note] | `[check or N/A]` | PASS | RISK |
20
-
21
- ## Findings
22
-
23
- | ID | Severity | Dimension | Evidence | Remediation anchor |
24
- | --- | --- | --- | --- | --- |
25
-
26
- ## Residual risks
27
-
28
- - SC-###: [Explicit outcome risk and observation plan, or None.]