thoth-agents 0.4.1 → 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.
- package/LICENSE +30 -0
- package/README.md +86 -58
- package/dist/agents/prompt-sections.d.ts +5 -3
- package/dist/agents/prompt-utils.d.ts +1 -1
- package/dist/agents/worker.d.ts +2 -0
- package/dist/{chunk-STCURXAQ.js → chunk-MRFCA3U2.js} +33 -67
- package/dist/{chunk-EFGSGPYM.js → chunk-OW6I7ZUU.js} +391 -416
- package/dist/chunk-V7HSGRMB.js +1016 -0
- package/dist/{chunk-2D7E7GMP.js → chunk-VUNYH263.js} +1650 -380
- package/dist/cli/claude-code-paths.d.ts +2 -2
- package/dist/cli/codex-install.d.ts +5 -2
- package/dist/cli/codex-paths.d.ts +2 -2
- package/dist/cli/index.js +47 -11
- package/dist/cli/model-defaults.d.ts +4 -0
- package/dist/cli/operations/pi.d.ts +1 -0
- package/dist/cli/pi-effort.d.ts +1 -1
- package/dist/cli/pi-external-package.d.ts +24 -0
- package/dist/cli/pi-git-source.d.ts +1 -0
- package/dist/cli/pi-install.d.ts +92 -15
- package/dist/cli/pi-managed-write.d.ts +3 -0
- package/dist/cli/pi-model-config.d.ts +17 -0
- package/dist/cli/pi-native-probe.d.ts +2 -0
- package/dist/cli/pi-paths.d.ts +2 -0
- package/dist/cli/pi-resources.d.ts +3 -1
- package/dist/cli/pi-tool-config.d.ts +32 -0
- package/dist/cli/tui/index.js +32 -7
- package/dist/cli/tui/operations.d.ts +3 -1
- package/dist/cli/types.d.ts +2 -0
- package/dist/config/constants.d.ts +4 -8
- package/dist/config/schema.d.ts +7 -36
- package/dist/harness/adapters/claude-code.d.ts +2 -4
- package/dist/harness/core/agent-pack.d.ts +52 -42
- package/dist/harness/core/memory-governance.d.ts +2 -2
- package/dist/harness/core/sdd.d.ts +159 -319
- package/dist/harness/writers/pi-agent.d.ts +3 -1
- package/dist/index.js +12 -6
- package/dist/pi/tools-panel.d.ts +51 -0
- package/dist/pi.d.ts +44 -2
- package/dist/pi.js +471 -9
- package/dist/utils/subprocess.d.ts +1 -0
- package/package.json +18 -4
- package/pi/.thoth-agents-assets.json +5 -6
- package/pi/agents/thoth-designer.md +23 -8
- package/pi/agents/thoth-explorer.md +29 -9
- package/pi/agents/thoth-librarian.md +30 -8
- package/pi/agents/thoth-oracle.md +18 -10
- package/pi/agents/thoth-worker.md +96 -0
- package/plugin/.claude-plugin/.thoth-agents-plugin-assets.json +7 -12
- package/plugin/.claude-plugin/plugin.json +2 -2
- package/plugin/.codex-plugin/plugin.json +2 -2
- package/plugin/agents/designer.md +13 -5
- package/plugin/agents/explorer.md +16 -5
- package/plugin/agents/librarian.md +15 -4
- package/plugin/agents/oracle.md +13 -7
- package/plugin/agents/orchestrator.md +82 -91
- package/plugin/agents/worker.md +76 -0
- package/plugin/skills/plan-reviewer/SKILL.md +39 -141
- package/plugin/skills/thoth-archive/SKILL.md +50 -47
- package/plugin/skills/thoth-archive/scripts/archive.mjs +287 -654
- package/plugin/skills/thoth-constitution/SKILL.md +23 -42
- package/plugin/skills/thoth-constitution/templates/constitution.md +54 -44
- package/plugin/skills/thoth-init/SKILL.md +19 -29
- package/plugin/skills/thoth-init/scripts/init.mjs +73 -66
- package/plugin/skills/thoth-sdd/SKILL.md +164 -117
- package/plugin/skills/thoth-sdd/references/phases/checklist.md +2 -22
- package/plugin/skills/thoth-sdd/references/phases/clarify.md +14 -12
- package/plugin/skills/thoth-sdd/references/phases/converge.md +2 -13
- package/plugin/skills/thoth-sdd/references/phases/explore.md +3 -8
- package/plugin/skills/thoth-sdd/references/phases/implement.md +58 -57
- package/plugin/skills/thoth-sdd/references/phases/plan.md +2 -18
- package/plugin/skills/thoth-sdd/references/phases/specify.md +2 -33
- package/plugin/skills/thoth-sdd/references/phases/tasks.md +4 -45
- package/plugin/skills/thoth-sdd/references/phases/verify.md +4 -22
- package/plugin/skills/thoth-sdd/scripts/validate.mjs +610 -1232
- package/plugin/skills/thoth-sdd/templates/change.md +94 -0
- package/skills/README.md +11 -13
- package/skills/plan-reviewer/SKILL.md +39 -141
- package/skills/thoth-archive/SKILL.md +50 -47
- package/skills/thoth-archive/scripts/archive.mjs +287 -654
- package/skills/thoth-constitution/SKILL.md +23 -42
- package/skills/thoth-constitution/templates/constitution.md +54 -44
- package/skills/thoth-init/SKILL.md +19 -29
- package/skills/thoth-init/scripts/init.mjs +73 -66
- package/skills/thoth-sdd/SKILL.md +164 -117
- package/skills/thoth-sdd/references/phases/checklist.md +2 -22
- package/skills/thoth-sdd/references/phases/clarify.md +14 -12
- package/skills/thoth-sdd/references/phases/converge.md +2 -13
- package/skills/thoth-sdd/references/phases/explore.md +3 -8
- package/skills/thoth-sdd/references/phases/implement.md +58 -57
- package/skills/thoth-sdd/references/phases/plan.md +2 -18
- package/skills/thoth-sdd/references/phases/specify.md +2 -33
- package/skills/thoth-sdd/references/phases/tasks.md +4 -45
- package/skills/thoth-sdd/references/phases/verify.md +4 -22
- package/skills/thoth-sdd/scripts/validate.mjs +610 -1232
- package/skills/thoth-sdd/templates/change.md +94 -0
- package/thoth-agents.schema.json +9 -77
- package/dist/agents/deep.d.ts +0 -2
- package/dist/agents/quick.d.ts +0 -2
- package/dist/chunk-2U5MBLLV.js +0 -312
- package/pi/agents/thoth-deep.md +0 -81
- package/pi/agents/thoth-quick.md +0 -81
- package/plugin/agents/deep.md +0 -68
- package/plugin/agents/quick.md +0 -68
- package/plugin/skills/plan-reviewer/templates/plan-review.md +0 -65
- package/plugin/skills/thoth-sdd/templates/archive-report.md +0 -25
- package/plugin/skills/thoth-sdd/templates/checklist.md +0 -27
- package/plugin/skills/thoth-sdd/templates/plan.md +0 -46
- package/plugin/skills/thoth-sdd/templates/spec.md +0 -62
- package/plugin/skills/thoth-sdd/templates/tasks.md +0 -58
- package/plugin/skills/thoth-sdd/templates/verify-report.md +0 -28
- package/skills/plan-reviewer/templates/plan-review.md +0 -65
- package/skills/thoth-sdd/templates/archive-report.md +0 -25
- package/skills/thoth-sdd/templates/checklist.md +0 -27
- package/skills/thoth-sdd/templates/plan.md +0 -46
- package/skills/thoth-sdd/templates/spec.md +0 -62
- package/skills/thoth-sdd/templates/tasks.md +0 -58
- 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.]
|