wolverine-kit 0.0.1__tar.gz → 0.0.2__tar.gz

{wolverine_kit-0.0.1 → wolverine_kit-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wolverine-kit
-Version: 0.0.1
+Version: 0.0.2
 Summary: Spec-driven agent framework for AI coding assistants
 License-Expression: MIT
 License-File: LICENSE

wolverine_kit-0.0.2/docs/brief-format.md

@@ -0,0 +1,70 @@
+# Brief Format
+
+A brief is the output of the spec-synthesizer. It's what gets handed off for implementation.
+
+## Statuses
+
+| Status | Meaning |
+|--------|---------|
+| READY | Every signature is complete, test expectations cover 3+ behaviors, no spec gaps |
+| DRAFT | Incomplete. Lists specific blockers that must be resolved before re-running |
+
+## Structure
+
+A READY brief:
+
+```
+UNIT: <name>
+PHASE: <roadmap phase number>
+STATUS: READY
+
+---
+
+LOCATION: <path where the code will live>
+
+PUBLIC INTERFACE:
+<typed signatures for everything the consumer imports or calls>
+
+INTERNAL STRUCTURE:
+  <filename>: <purpose, 1 line>
+
+TEST EXPECTATIONS:
+  - Given <setup>, when <action>, then <assertion>  (minimum 3)
+
+DEPENDENCIES ON OTHER MODULES:
+  - <other module this one imports from>
+
+---
+HANDOFF NOTE:
+<2-3 sentences: non-obvious constraints, gotchas, or design decisions>
+```
+
+## DRAFT Blockers
+
+When the synthesizer can't produce a READY brief:
+
+```
+UNIT: <name>
+PHASE: <roadmap phase number>
+STATUS: DRAFT
+
+DRAFT BLOCKERS:
+  - <specific question the spec doesn't answer>
+  - <missing interface definition>
+```
+
+Resolve each blocker (fill the spec gap or record a decision), then re-run.
+
+## Quality Bar for READY
+
+- Every typed signature is complete (no `...` placeholders)
+- Test expectations cover at least 3 behaviors
+- HANDOFF NOTE is present and non-trivial
+- No spec section referenced by the brief is missing or ambiguous
+
+## Usage
+
+```
+/wk-impl-brief <module>    # produces the brief only
+/wk-impl <module>          # produces brief + tests + hands off
+```

{wolverine_kit-0.0.1 → wolverine_kit-0.0.2}/spec/WK-INIT.md

@@ -133,6 +133,7 @@ Project ready.
 │  /my-review-spec         Architect review of spec quality    │
 │  /my-impl-brief <unit>   Guardian gate + implementation brief│
 │  /my-impl <unit>         Full gate chain + test spec + handoff│
+│  /my-test <unit>         Generate test specifications        │
 │  /my-drift               Scan for spec↔code drift           │
 │  /my-decision <topic>    Draft ADR + propagate through docs  │
 │  /my-propagate <doc>     Fan change across all downstream docs│

wolverine_kit-0.0.2/src/wolverine_kit/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.0.2"

{wolverine_kit-0.0.1 → wolverine_kit-0.0.2}/src/wolverine_kit/init/ui.py

@@ -66,9 +66,14 @@ def show_commands_panel(prefix: str) -> None:
         (f"{prefix}check", "Full hygiene sweep"),
         (f"{prefix}status", "Roadmap burn-down"),
         (f"{prefix}review-spec", "Architect review of spec quality"),
-        (f"{prefix}spec <unit>", "Guardian gate + implementation brief"),
+        (f"{prefix}impl-brief <unit>", "Guardian gate + implementation brief"),
         (f"{prefix}impl <unit>", "Full gate chain + test spec + handoff"),
+        (f"{prefix}test <unit>", "Generate test specifications"),
         (f"{prefix}drift", "Scan for spec↔code drift"),
+        (f"{prefix}decision <topic>", "Draft ADR + propagate through docs"),
+        (f"{prefix}propagate <doc>", "Fan change across all downstream docs"),
+        (f"{prefix}deps", "Audit dependencies for upgrades"),
+        (f"{prefix}help", "List all commands"),
     ]
     for cmd, desc in commands:
         tbl.add_row(cmd, desc)

wolverine_kit-0.0.1/docs/brief-format.md

@@ -1,62 +0,0 @@
-# Brief Format
-
-A brief is the output of the spec-synthesizer. It's what gets handed off for implementation.
-
-## Statuses
-
-| Status | Meaning |
-|--------|---------|
-| READY | A senior dev could implement from this alone, without asking questions |
-| DRAFT | Incomplete. Lists blockers that must be resolved before re-running |
-
-## Structure
-
-A READY brief contains:
-
-```
-MODULE: <name>
-STATUS: READY
-
-## Context
-<Why this module exists, what problem it solves>
-
-## Scope
-<Exactly what is in scope, what is explicitly out>
-
-## Interface
-<Public API, function signatures, CLI surface, or protocol>
-
-## Behaviour
-<Step-by-step logic, edge cases, error handling>
-
-## Dependencies
-<What this module imports/calls, what calls it>
-
-## Constraints
-<Invariants and ADRs that apply to this module>
-
-## Test Expectations
-<What the test-author should cover — happy path, error cases, boundaries>
-```
-
-## DRAFT Blockers
-
-When the synthesizer can't produce a READY brief, it outputs:
-
-```
-MODULE: <name>
-STATUS: DRAFT
-
-BLOCKERS:
-- <What is missing or ambiguous in the spec>
-- <What decision is needed before implementation>
-```
-
-Resolve each blocker (fill the spec gap or record a decision), then re-run.
-
-## Usage
-
-```
-/wk-impl-brief <module>    # produces the brief
-/wk-impl <module>          # produces brief + tests + hands off
-```

wolverine_kit-0.0.1/src/wolverine_kit/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.0.1"