@dsalazardev/ai-hub-cli 0.2.0 → 0.3.1
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/README.md +64 -4
- package/dist/backup/snapshots.js +12 -0
- package/dist/catalog.d.ts +8 -1
- package/dist/catalog.js +38 -9
- package/dist/cli/args.js +1 -0
- package/dist/cli/doctor.js +20 -11
- package/dist/cli/maintenance.js +21 -39
- package/dist/cli/memory.js +4 -0
- package/dist/cli/onboarding.d.ts +13 -0
- package/dist/cli/onboarding.js +152 -14
- package/dist/cli/run.d.ts +3 -1
- package/dist/cli/run.js +5 -4
- package/dist/cli/types.d.ts +3 -0
- package/dist/engine/engine.d.ts +19 -1
- package/dist/engine/engine.js +52 -0
- package/dist/engine/gates.d.ts +16 -0
- package/dist/engine/gates.js +102 -1
- package/dist/harness/memory/ledger.d.ts +6 -0
- package/dist/harness/memory/ledger.js +44 -2
- package/dist/manifest/manifest.d.ts +3 -1
- package/dist/manifest/manifest.js +16 -10
- package/dist/presets/materialize.d.ts +5 -0
- package/dist/presets/materialize.js +30 -0
- package/dist/speckit/binding.d.ts +15 -0
- package/dist/speckit/binding.js +66 -0
- package/dist/speckit/commands.d.ts +64 -0
- package/dist/speckit/commands.js +171 -0
- package/dist/speckit/doctor.d.ts +17 -0
- package/dist/speckit/doctor.js +119 -0
- package/dist/speckit/runner.d.ts +19 -0
- package/dist/speckit/runner.js +22 -0
- package/dist/speckit/seal.d.ts +12 -0
- package/dist/speckit/seal.js +47 -0
- package/dist/speckit/settings.d.ts +36 -0
- package/dist/speckit/settings.js +75 -0
- package/dist/speckit/state.d.ts +59 -0
- package/dist/speckit/state.js +279 -0
- package/dist/speckit/version.d.ts +8 -0
- package/dist/speckit/version.js +53 -0
- package/dist/sync/config.js +3 -2
- package/dist/sync/render.js +30 -0
- package/dist/sync/sync.d.ts +4 -0
- package/dist/sync/sync.js +48 -5
- package/dist/sync/targets.d.ts +13 -0
- package/dist/sync/targets.js +5 -0
- package/engine/engine.yaml +65 -31
- package/manifest.json +20 -48
- package/package.json +1 -1
- package/schema/engine.schema.json +22 -3
- package/schema/manifest.schema.json +10 -0
- package/skills/shared/analyze/SKILL.md +2 -1
- package/skills/shared/clarify/SKILL.md +2 -1
- package/skills/shared/implement/SKILL.md +2 -1
- package/skills/shared/plan/SKILL.md +2 -1
- package/skills/shared/review/SKILL.md +2 -1
- package/skills/shared/sdd/SKILL.md +2 -1
- package/skills/shared/sdd-init/SKILL.md +2 -1
- package/skills/shared/ship/SKILL.md +2 -1
- package/skills/shared/specify/SKILL.md +2 -1
- package/skills/shared/tasks/SKILL.md +2 -1
- package/skills/shared/verify/SKILL.md +2 -1
- package/skills/shared/speckit-analyze/SKILL.md +0 -35
- package/skills/shared/speckit-assess-decide/SKILL.md +0 -36
- package/skills/shared/speckit-assess-define/SKILL.md +0 -36
- package/skills/shared/speckit-assess-intake/SKILL.md +0 -38
- package/skills/shared/speckit-assess-research/SKILL.md +0 -36
- package/skills/shared/speckit-assess-shape/SKILL.md +0 -36
- package/skills/shared/speckit-bug-assess/SKILL.md +0 -38
- package/skills/shared/speckit-bug-fix/SKILL.md +0 -37
- package/skills/shared/speckit-bug-test/SKILL.md +0 -37
- package/skills/shared/speckit-checklist/SKILL.md +0 -35
- package/skills/shared/speckit-clarify/SKILL.md +0 -32
- package/skills/shared/speckit-constitution/SKILL.md +0 -35
- package/skills/shared/speckit-converge/SKILL.md +0 -36
- package/skills/shared/speckit-implement/SKILL.md +0 -32
- package/skills/shared/speckit-plan/SKILL.md +0 -37
- package/skills/shared/speckit-specify/SKILL.md +0 -36
- package/skills/shared/speckit-tasks/SKILL.md +0 -34
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: speckit-converge
|
|
3
|
-
description: Verify that the implemented codebase satisfies every requirement before archiving the change. Use after speckit-implement reports DONE.
|
|
4
|
-
license: MIT
|
|
5
|
-
compatibility: Requires the Spec Kit layout under .specify/, specs/ and the project test commands.
|
|
6
|
-
metadata:
|
|
7
|
-
author: onna
|
|
8
|
-
version: "1.0"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Close the loop between what was specified and what exists.
|
|
12
|
-
|
|
13
|
-
**Input**: `spec.md`, `plan.md`, `tasks.md`, `analysis.md` and the implemented code.
|
|
14
|
-
|
|
15
|
-
**Steps**
|
|
16
|
-
|
|
17
|
-
1. Read every requirement and locate its implementation and test.
|
|
18
|
-
2. Run the full verification commands from the plan and record the result.
|
|
19
|
-
3. Write `convergence.md`:
|
|
20
|
-
- `## Requisito → evidencia` — table with requirement, code path, test.
|
|
21
|
-
- `## Tareas` — every task checked; list any unchecked.
|
|
22
|
-
- `## Deriva` — behavior implemented but not specified.
|
|
23
|
-
- `## Veredicto` — `CONVERGED` or `NEEDS_WORK` with the exact gap.
|
|
24
|
-
4. If `NEEDS_WORK`, return to `implement` or `specify`; do not patch here.
|
|
25
|
-
5. On `CONVERGED`, hand off to the human approval gate and then archive.
|
|
26
|
-
|
|
27
|
-
**Artifacts**: `specs/<feature>/convergence.md`
|
|
28
|
-
|
|
29
|
-
**Exit states**
|
|
30
|
-
- `CONVERGED` — every requirement proven and every task complete.
|
|
31
|
-
- `NEEDS_WORK` — a requirement lacks evidence or unspecced behavior exists.
|
|
32
|
-
|
|
33
|
-
**Guardrails**
|
|
34
|
-
- Never mark `CONVERGED` from a summary; cite code and test output.
|
|
35
|
-
- Never delete or archive the feature while a task is open.
|
|
36
|
-
- Do not rewrite the spec to match the implementation.
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: speckit-implement
|
|
3
|
-
description: Execute the approved task list in an isolated worktree and produce verified code. Use only after analysis passes and a human approved the spec hash.
|
|
4
|
-
license: MIT
|
|
5
|
-
compatibility: Requires the Spec Kit layout under .specify/, specs/ and a Git repository.
|
|
6
|
-
metadata:
|
|
7
|
-
author: onna
|
|
8
|
-
version: "1.0"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Implement the tasks exactly as approved, with evidence.
|
|
12
|
-
|
|
13
|
-
**Input**: `specs/<feature>/tasks.md`, `plan.md` and the approved SHA-256 of `spec.md + plan.md + tasks.md`.
|
|
14
|
-
|
|
15
|
-
**Steps**
|
|
16
|
-
|
|
17
|
-
1. Verify the approval hash still matches the three artifacts. If not, stop: the approval is invalid.
|
|
18
|
-
2. Work in the assigned worktree or feature branch. Never implement on the trunk.
|
|
19
|
-
3. For each task in order: make the smallest change, run its verification, and only then mark it `[x]`.
|
|
20
|
-
4. Keep a trace in `.planning/impl_<feature>.md`: task, files, command, result.
|
|
21
|
-
5. If a task needs scope beyond the spec, stop and return to `specify` or `plan`.
|
|
22
|
-
|
|
23
|
-
**Artifacts**: source code, tests, `.planning/impl_<feature>.md` and updated `tasks.md`.
|
|
24
|
-
|
|
25
|
-
**Exit states**
|
|
26
|
-
- `DONE` — every task verified and the full suite is green.
|
|
27
|
-
- `BLOCKED` — a task needs a design or scope decision; record why and stop.
|
|
28
|
-
|
|
29
|
-
**Guardrails**
|
|
30
|
-
- Never weaken a test to pass.
|
|
31
|
-
- Never edit `spec.md`, `plan.md` or `tasks.md` to match what was built.
|
|
32
|
-
- No `TODO`, placeholder or commented-out code.
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: speckit-plan
|
|
3
|
-
description: Produce the technical plan that implements an approved specification. Use after the spec is READY and before writing tasks.
|
|
4
|
-
license: MIT
|
|
5
|
-
compatibility: Requires the Spec Kit layout under .specify/ and specs/.
|
|
6
|
-
metadata:
|
|
7
|
-
author: onna
|
|
8
|
-
version: "1.0"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Translate requirements into a design without changing them.
|
|
12
|
-
|
|
13
|
-
**Input**: `specs/<feature>/spec.md` in state `READY` and the project constitution.
|
|
14
|
-
|
|
15
|
-
**Steps**
|
|
16
|
-
|
|
17
|
-
1. Read every requirement and scenario. Map each to a design element.
|
|
18
|
-
2. Write `plan.md`:
|
|
19
|
-
- `## Contexto` — current behavior and constraints.
|
|
20
|
-
- `## Decisiones` — numbered, each with rationale and rejected alternatives.
|
|
21
|
-
- `## Componentes` — modules, responsibilities and data flow.
|
|
22
|
-
- `## Contratos` — APIs, schemas, events and error cases.
|
|
23
|
-
- `## Trazabilidad` — requirement id → component → test.
|
|
24
|
-
- `## Riesgos` — mitigation per risk.
|
|
25
|
-
- `## Migración` — rollout, rollback and compatibility.
|
|
26
|
-
3. Verify every requirement has at least one component and one test.
|
|
27
|
-
4. Keep the plan implementable in one change; split otherwise.
|
|
28
|
-
|
|
29
|
-
**Artifacts**: `specs/<feature>/plan.md`
|
|
30
|
-
|
|
31
|
-
**Exit states**
|
|
32
|
-
- `READY` — every requirement is covered and no design decision is open.
|
|
33
|
-
|
|
34
|
-
**Guardrails**
|
|
35
|
-
- Never add a requirement that the spec does not contain.
|
|
36
|
-
- Do not write task lists here; `tasks.md` owns sequencing.
|
|
37
|
-
- Name the trade-off of every significant decision.
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: speckit-specify
|
|
3
|
-
description: Write the behavioral specification of a feature with EARS requirements and testable scenarios. Use after the constitution and before planning.
|
|
4
|
-
license: MIT
|
|
5
|
-
compatibility: Requires the Spec Kit layout under .specify/ and specs/.
|
|
6
|
-
metadata:
|
|
7
|
-
author: onna
|
|
8
|
-
version: "1.0"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Describe what the system must do, not how it will do it.
|
|
12
|
-
|
|
13
|
-
**Input**: the approved assessment or feature request and the project constitution.
|
|
14
|
-
|
|
15
|
-
**Steps**
|
|
16
|
-
|
|
17
|
-
1. Choose a kebab-case feature id and create `specs/<feature>/`.
|
|
18
|
-
2. Write `spec.md`:
|
|
19
|
-
- `## Purpose` — one paragraph, user-visible outcome.
|
|
20
|
-
- `## Requisitos` — EARS statements using `MUST`, `MUST NOT`, `WHEN`, `IF`.
|
|
21
|
-
- `## Escenarios` — one block per requirement with exactly `#### Scenario:` and WHEN/THEN.
|
|
22
|
-
- `## Fuera de alcance` — what this feature deliberately excludes.
|
|
23
|
-
- `## Preguntas abiertas` — numbered; none may remain before approval.
|
|
24
|
-
3. Give every requirement at least one scenario and a stable identifier (`R1`, `R2`, ...).
|
|
25
|
-
4. Keep each requirement to one behavior; split compound requirements.
|
|
26
|
-
|
|
27
|
-
**Artifacts**: `specs/<feature>/spec.md`
|
|
28
|
-
|
|
29
|
-
**Exit states**
|
|
30
|
-
- `DRAFT` — requirements exist but open questions remain.
|
|
31
|
-
- `READY` — no open questions and every requirement has a scenario.
|
|
32
|
-
|
|
33
|
-
**Guardrails**
|
|
34
|
-
- No architecture, library choices or file paths in `spec.md`.
|
|
35
|
-
- Never mark `READY` with an untestable requirement.
|
|
36
|
-
- Do not modify the constitution from this skill.
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: speckit-tasks
|
|
3
|
-
description: Break an approved plan into atomic, ordered, verifiable implementation tasks. Use after the checklist passes.
|
|
4
|
-
license: MIT
|
|
5
|
-
compatibility: Requires the Spec Kit layout under .specify/ and specs/.
|
|
6
|
-
metadata:
|
|
7
|
-
author: onna
|
|
8
|
-
version: "1.0"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Produce the executable sequence the implementers will follow.
|
|
12
|
-
|
|
13
|
-
**Input**: `spec.md`, `plan.md` and `checklist.md` in state `PASS`.
|
|
14
|
-
|
|
15
|
-
**Steps**
|
|
16
|
-
|
|
17
|
-
1. Create `tasks.md` grouped by phase (foundation, core, integration, release).
|
|
18
|
-
2. Each task MUST be one checkbox with:
|
|
19
|
-
- a concrete action,
|
|
20
|
-
- the files or modules it touches,
|
|
21
|
-
- an explicit verification criterion.
|
|
22
|
-
3. Order tasks by dependency; a task may only depend on earlier tasks.
|
|
23
|
-
4. Map every requirement to at least one task; add a traceability table.
|
|
24
|
-
5. Estimate nothing; split any task that cannot be verified in one run.
|
|
25
|
-
|
|
26
|
-
**Artifacts**: `specs/<feature>/tasks.md`
|
|
27
|
-
|
|
28
|
-
**Exit states**
|
|
29
|
-
- `READY` — every task has a verification criterion and every requirement is covered.
|
|
30
|
-
|
|
31
|
-
**Guardrails**
|
|
32
|
-
- No `TODO`, "investigar" or unverifiable tasks.
|
|
33
|
-
- Do not include implementation code in the task list.
|
|
34
|
-
- Do not mark a task complete from this skill.
|