@izkac/forgekit 0.1.6 → 0.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 (23) hide show
  1. package/bin/forge.mjs +2 -0
  2. package/package.json +1 -1
  3. package/src/e2e.mjs +172 -0
  4. package/src/init.mjs +13 -6
  5. package/src/init.test.mjs +32 -1
  6. package/src/integrity-check.mjs +5 -3
  7. package/src/integrity.mjs +310 -20
  8. package/src/integrity.test.mjs +169 -17
  9. package/src/set-phase.test.mjs +9 -1
  10. package/vendor/skills/forge/SKILL.md +1 -1
  11. package/vendor/skills/forge/docs/forge.md +53 -31
  12. package/vendor/skills/forge/phases/finish.md +1 -1
  13. package/vendor/skills/forge/phases/implement.md +1 -0
  14. package/vendor/skills/forge/phases/plan-openspec.md +8 -2
  15. package/vendor/skills/forge/phases/plan-specs.md +8 -2
  16. package/vendor/skills/forge/phases/verify.md +7 -3
  17. package/vendor/skills/forge/references/runtime-integrity.md +28 -10
  18. package/vendor/skills/forge/subagents/final-reviewer-prompt.md +9 -6
  19. package/vendor/skills/forge/subagents/task-reviewer-prompt.md +1 -0
  20. package/vendor/templates/project/claude/commands/forge.md +1 -1
  21. package/vendor/templates/project/claude/rules/forge.md +20 -16
  22. package/vendor/templates/project/codex/rules/forge.md +12 -10
  23. package/vendor/templates/project/cursor/rules/forge.mdc +25 -21
package/vendor/skills/forge/subagents/task-reviewer-prompt.md CHANGED
@@ -43,6 +43,7 @@ Diff range: {DIFF_RANGE} <!-- e.g. `git diff` (uncommitted) or BASE..HEAD -->
43
43
  - Brief authorized a stub / “wire later” for a path this change claims
44
44
  - Wiring is deferred **without a registered open deferral** — the packet must show `forge defer list` output naming this task's deferral; "wiring in §9" with no registry entry is a REJECT
45
45
  - The task claims a capability whose `spine.json` row is missing or library-only (empty runtimeOwner / writes / evidence)
46
+ - The task authored or touched `e2e.json` steps that would pass against a stubbed handler (no domain side-effect assertions), or set `notApplicable` without a real reason
46
47
 
47
48
  **Code quality:**
48
49
 
package/vendor/templates/project/claude/commands/forge.md CHANGED
@@ -2,7 +2,7 @@
2
2
  name: /forge
3
3
  description: Forge — start or resume disciplined development (brainstorm → plan → build → review)
4
4
  category: Workflow
5
- tags: [workflow, forge, openspec]
5
+ tags: [workflow, forge, planning]
6
6
  ---
7
7
 
8
8
  Run the **Forge** workflow for substantial work.
package/vendor/templates/project/claude/rules/forge.md CHANGED
@@ -1,16 +1,20 @@
1
- # Forge (thin rule)
2
-
3
- Full workflow: `~/.claude/skills/forge/docs/forge.md` · Skill: user-installed **Forge** (`~/.claude/skills/forge/SKILL.md` after `forge install`).
4
-
5
- **Default:** triage before implementation. Substantial work → **Forge**
6
- (brainstorm → OpenSpec → subagent TDD implement → review).
7
-
8
- **Forge = OpenSpec:** after brainstorm, proceed directly to `/opsx:propose` — do not ask for a plan mode. Work too small for OpenSpec should skip Forge (`/forge:skip` or direct execution).
9
-
10
- **Skip Forge** only when work is trivial OR user sends **`/forge:skip`**.
11
-
12
- Scratch sessions: `.forge/sessions/` (14-day retention). Active pointer: `.forge/active.json`.
13
-
14
- CLI: `forge new`, `forge status`, `forge prefs`, `forge models`, `forge phase`, `forge doctor`.
15
-
16
- Do not edit vendor OpenSpec skills — Forge orchestrates them. Workflow skills are bundled under the Forge skill’s `skills/` folder.
1
+ # Forge (thin rule)
2
+
3
+ Full workflow: `~/.claude/skills/forge/docs/forge.md` · Skill: user-installed **Forge** (`~/.claude/skills/forge/SKILL.md` after `forge install`).
4
+
5
+ **Default:** triage before implementation. Substantial work → **Forge**
6
+ (brainstorm → plan → subagent TDD implement → review).
7
+
8
+ **Planning engine:** this project's engine is recorded in `.forge/config.json` (`plan.engine`). After brainstorm, create the change spec directly — do not ask for a plan mode:
9
+ - OpenSpec → `/opsx:propose`
10
+ - built-in specs → `forge change new <slug>`
11
+
12
+ Work too small to spec should skip Forge (`/forge:skip` or direct execution).
13
+
14
+ **Skip Forge** only when work is trivial OR user sends **`/forge:skip`**.
15
+
16
+ Scratch sessions: `.forge/sessions/` (14-day retention). Active pointer: `.forge/active.json`.
17
+
18
+ CLI: `forge new`, `forge status`, `forge prefs`, `forge models`, `forge phase`, `forge doctor`.
19
+
20
+ Do not edit vendor planning-engine skills — Forge orchestrates them. Workflow skills are bundled under the Forge skill's `skills/` folder.
package/vendor/templates/project/codex/rules/forge.md CHANGED
@@ -1,10 +1,12 @@
1
- # Forge (thin rule)
2
-
3
- Full workflow: `~/.codex/skills/forge/docs/forge.md` · Skill: user-installed **Forge** (`~/.codex/skills/forge/SKILL.md` after `forge install`).
4
-
5
- **Default:** triage before implementation. Substantial work → **Forge**
6
- (brainstorm → OpenSpec → subagent TDD implement → review).
7
-
8
- **Forge = OpenSpec:** after brainstorm, proceed directly to OpenSpec propose. Skip with `/forge:skip` or when work is trivial.
9
-
10
- Scratch: `.forge/` · CLI: `forge new|status|prefs|models|phase|doctor`
1
+ # Forge (thin rule)
2
+
3
+ Full workflow: `~/.codex/skills/forge/docs/forge.md` · Skill: user-installed **Forge** (`~/.codex/skills/forge/SKILL.md` after `forge install`).
4
+
5
+ **Default:** triage before implementation. Substantial work → **Forge**
6
+ (brainstorm → plan → subagent TDD implement → review).
7
+
8
+ **Planning engine:** recorded in `.forge/config.json` (`plan.engine`). After brainstorm, create the change directly — OpenSpec → `/opsx:propose`, built-in specs → `forge change new <slug>`. Skip with `/forge:skip` or when work is trivial.
9
+
10
+ Scratch: `.forge/` · CLI: `forge new|status|prefs|models|phase|doctor`
11
+
12
+ Do not edit vendor planning-engine skills — Forge orchestrates them.
package/vendor/templates/project/cursor/rules/forge.mdc CHANGED
@@ -1,21 +1,25 @@
1
- ---
2
- description: Forge triage and workflow (thin rule)
3
- alwaysApply: true
4
- ---
5
-
6
- # Forge (thin rule)
7
-
8
- Full workflow: `~/.cursor/skills/forge/docs/forge.md` · Skill: user-installed **Forge** (`~/.cursor/skills/forge/SKILL.md` after `forge install`).
9
-
10
- **Default:** triage before implementation. Substantial work → **Forge**
11
- (brainstorm → OpenSpec → subagent TDD implement → review).
12
-
13
- **Forge = OpenSpec:** after brainstorm, proceed directly to `/opsx:propose` — do not ask for a plan mode. Work too small for OpenSpec should skip Forge (`/forge:skip` or direct execution).
14
-
15
- **Skip Forge** only when work is trivial OR user sends **`/forge:skip`**.
16
-
17
- Scratch sessions: `.forge/sessions/` (14-day retention). Active pointer: `.forge/active.json`.
18
-
19
- CLI: `forge new`, `forge status`, `forge prefs`, `forge models`, `forge phase`, `forge doctor`.
20
-
21
- Do not edit vendor OpenSpec skills — Forge orchestrates them. Workflow skills are bundled under the Forge skill’s `skills/` folder.
1
+ ---
2
+ description: Forge triage and workflow (thin rule)
3
+ alwaysApply: true
4
+ ---
5
+
6
+ # Forge (thin rule)
7
+
8
+ Full workflow: `~/.cursor/skills/forge/docs/forge.md` · Skill: user-installed **Forge** (`~/.cursor/skills/forge/SKILL.md` after `forge install`).
9
+
10
+ **Default:** triage before implementation. Substantial work → **Forge**
11
+ (brainstorm → plan → subagent TDD implement → review).
12
+
13
+ **Planning engine:** this project's engine is recorded in `.forge/config.json` (`plan.engine`). After brainstorm, create the change spec directly — do not ask for a plan mode:
14
+ - OpenSpec → `/opsx:propose`
15
+ - built-in specs → `forge change new <slug>`
16
+
17
+ Work too small to spec should skip Forge (`/forge:skip` or direct execution).
18
+
19
+ **Skip Forge** only when work is trivial OR user sends **`/forge:skip`**.
20
+
21
+ Scratch sessions: `.forge/sessions/` (14-day retention). Active pointer: `.forge/active.json`.
22
+
23
+ CLI: `forge new`, `forge status`, `forge prefs`, `forge models`, `forge phase`, `forge doctor`.
24
+
25
+ Do not edit vendor planning-engine skills — Forge orchestrates them. Workflow skills are bundled under the Forge skill's `skills/` folder.