@brainervirus/workit-cli 0.10.0 → 1.0.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@brainervirus/workit-cli",
3
- "version": "0.10.0",
3
+ "version": "1.0.0",
4
4
  "private": false,
5
5
  "description": "Workit interactive setup wizard (Ink TUI)",
6
6
  "keywords": [
@@ -34,14 +34,14 @@
34
34
  "typecheck": "tsc --noEmit"
35
35
  },
36
36
  "dependencies": {
37
- "@brainervirus/workit-core": "^0.10.0",
38
- "@brainervirus/workit-cursor": "^0.10.0",
39
- "@brainervirus/workit-opencode": "^0.10.0",
37
+ "@brainervirus/workit-core": "^1.0.0",
38
+ "@brainervirus/workit-cursor": "^1.0.0",
39
+ "@brainervirus/workit-opencode": "^1.0.0",
40
40
  "@inkjs/ui": "2.0.0",
41
41
  "ink": "7.1.1",
42
42
  "react": "19.2.8"
43
43
  },
44
44
  "engines": {
45
- "node": ">=22"
45
+ "node": ">=24"
46
46
  }
47
47
  }
@@ -1,75 +0,0 @@
1
- # Superpowers document contract
2
-
3
- Use OpenCode's native `question` for every bounded user choice. Give concise choices and allow a custom answer; if the tool is unavailable, ask one concise plain-text question. Use `skill` to load workflow and Superpowers skills, `todowrite` for task state, and `task` for delegated work.
4
-
5
- ## Tracked document layout
6
-
7
- | Document | Path |
8
- | --- | --- |
9
- | Spec | `docs/<slug>/spec.md` |
10
- | Plan | `docs/<slug>/plan.md` |
11
- | SDD state | `docs/<slug>/sdd/` |
12
-
13
- An optional human mirror may live at `docs/specs/<same-basename>.md`; when present, keep its branch identical.
14
-
15
- Specs require:
16
-
17
- ```markdown
18
- **Branch:** `feature/<slug>`
19
- ```
20
-
21
- Plans require:
22
-
23
- ```markdown
24
- **Spec:** `docs/<slug>/spec.md`
25
- **Branch:** `feature/<slug>`
26
- ```
27
-
28
- `bugfix/<slug>` is also valid. Never use `main`, `develop`, `master`, or `prod`. Use plain backtick paths. Top-level headings are exactly `### Task N: Title`; steps use `- [ ] **Step N:** ...`; task headings never appear inside fences.
29
-
30
- Before writing **Branch:** into a new spec or plan, call `workit_docs_branch` and write the returned `branch` verbatim. When `action` is `keep`, use the current feature/bugfix branch. When `action` is `create_from_develop` or `create_from_base`, create the branch only through `workit_branch_setup`; it uses the configured workspace/global target branch.
31
-
32
- ## Execution and handoff
33
-
34
- - Implementation uses `wk-implement` and subagent-driven development, with native `todowrite` and `task`.
35
- - Commits use `wk-commit` after its native `question` confirmation.
36
- - Continuation uses `wk-handoff`, whose `workit_handoff_session` creates and seeds the OpenCode session automatically.
37
- - Never use worktrees. Resolve the declared branch with `workit_resolve_branch`, preview dirty-tree stash choices with `question`, and apply an approved in-place checkout through `workit_branch_setup` with `confirmed: true` (grounded in the recorded NativeChoiceEvidence).
38
- - Flow-tool confirmations are never agent-typed booleans and never caller-supplied evidence objects: on OpenCode the plugin records the user's native-`question` answer as a host-observed one-use receipt (`attested: true`, `callID`, `selectedLabel`, `recordedAt`) consumed by `workit_spec_approve` / `workit_plan_approve` / `workit_plan_menu` — no evidence argument exists, and delegated worker status comes from host session parentage (`parentID`), never a caller `role` field. On Cursor, confirmations are policy-only (`attested: false`) and subagent-driven execution is rejected as unsupported.
39
- - Keep all SDD state under the gitignored `docs/<slug>/sdd/`; use `workit_sdd_context` and the registered `workit_sdd_*` tools.
40
- - After implementation, use `question` before an approved stash reapply through `workit_branch_setup` with `confirmed: true`.
41
-
42
- ## YouTrack content
43
-
44
- Chat follows the user's language. YouTrack task comments are Spanish (`es-CL`) and use `workit_youtrack_draft` followed by reviewed `workit_youtrack_post` with `confirmed: true`. Preserve the user's paragraph voice; do not inject commits, file paths, or robotic bullet reports.
45
-
46
- ## Final self-check
47
-
48
- Before handoff, call `workit_docs_validate` on the linked spec/plan pair. Hard-fail on any error; never offer execution when validation fails.
49
-
50
- Before handoff, verify the saved spec path, plan path, declared branch, top-level task numbering, and workflow-managed SDD directory through the registered read-only workflow tools. Report structured failures; never infer success.
51
-
52
- ## Post-plan execution choice
53
-
54
- After saving a plan, call `workit_docs_validate` on the spec/plan pair. On failure, stop and fix docs — do not offer execution.
55
-
56
- On success, use native `question` / Cursor `AskQuestion` with exactly these options (no stay, no A/B/C prose duplicate):
57
-
58
- 1. Subagent-driven → load `wk-implement`
59
- 2. Inline → execute in this session
60
- 3. Handoff → load `wk-handoff` (new session only)
61
- 4. Review spec first
62
- 5. Review plan first
63
- 6. Change model first
64
-
65
- `Change model first` is display-only deferral: it ends the turn without calling `workit_plan_menu` and re-presents the menu on the next turn. Every other choice must call `workit_plan_menu` immediately after the answer and before any skill, branch question, mutation, or handoff.
66
-
67
- Never emit Superpowers text beginning “Two execution options”.
68
-
69
- A handoff destination session (the seeded contract carries `<workflow-handoff-destination>true</workflow-handoff-destination>`) presents exactly five choices — Subagent-driven, Inline, Review spec first, Review plan first, Change model first — and never re-offers the originating handoff option.
70
-
71
- - Specs/plans must follow `templates/spec-template.md` / `templates/plan-template.md` (mandated diagrams, tables, CA-XX).
72
-
73
- ## Doc delivery
74
-
75
- When delivering a spec or plan, use a clickable markdown link (\`[spec.md](docs/<slug>/spec.md)\`) and a 3-5 bullet summary of the content (Context, Goals, key decisions, status). Never reference docs with backtick-only paths.