@haposoft/cafekit 0.8.14 → 0.8.15

package/README.md

@@ -80,7 +80,7 @@ CafeKit ships many skills, but the main release surface is:
 - `/hapo:develop <feature-name>`: implement from approved spec artifacts
 - `/hapo:debug <issue>`: diagnose bugs, incidents, CI failures, flaky tests, UI regressions, and performance issues before fixing
 - `/hapo:hotfix <issue>`: fix diagnosed bugs with root-cause, verification, prevention, and side-effect gates
-- `/hapo:docs [init|update|summarize|reconstruct]`: create project docs or reconstruct as-is system documentation from source code
+- `/hapo:docs [--init|--update|--summarize|--reconstruct]`: create project docs or reconstruct as-is system documentation from source code
 - `/hapo:test [scope|--full]`: run verification and return a structured verdict
 - `/hapo:code-review [scope|--pending]`: adversarial review focused on correctness, regressions, and security
 - `/hapo:generate-graph <diagram request>`: generate technical SVG/PNG diagrams
@@ -129,7 +129,7 @@ Generate a diagram:
 Reconstruct current-state docs for an existing or legacy system:
 
 ```bash
-/hapo:docs reconstruct apps/legacy-admin
+/hapo:docs --reconstruct apps/legacy-admin
 ```
 
 The reconstruct bundle includes as-is markdown/JSON evidence and a self-contained `overview.html` review dashboard before the approved docs are handed to `/hapo:specs`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haposoft/cafekit",
-  "version": "0.8.14",
+  "version": "0.8.15",
   "description": "Claude Code-first spec-driven workflow for AI coding assistants. Bundles CafeKit hapo: skills, runtime hooks, agents, and installer scaffolding.",
   "author": "Haposoft <nghialt@haposoft.com>",
   "license": "MIT",

package/src/claude/skills/docs/SKILL.md

@@ -2,7 +2,7 @@
 name: hapo:docs
 description: "Create, update, summarize, or reconstruct project/system documentation from source code. Use reconstruct mode for as-is documentation of existing or legacy systems with evidence and uncertainty tracking."
 version: 1.0.0
-argument-hint: "[init|update|summarize|reconstruct] [scope]"
+argument-hint: "[--init|--update|--summarize|--reconstruct] [scope]"
 ---
 
 # Docs
@@ -18,12 +18,14 @@ Project documentation workflow for CafeKit.
 
 ```text
 /hapo:docs
-/hapo:docs init
-/hapo:docs update
-/hapo:docs summarize
-/hapo:docs reconstruct <scope>
+/hapo:docs --init
+/hapo:docs --update
+/hapo:docs --summarize
+/hapo:docs --reconstruct <scope>
 ```
 
+Mode flags are exclusive. When one is present, use it as the selected mode before interpreting any natural-language scope or instructions.
+
 ## Default Behavior
 
 Parse the user intent before selecting a mode.
@@ -90,9 +92,9 @@ docs/as-is/<scope-slug>/
 └── unknowns-and-assumptions.md
 ```
 
-## Subcommands
+## Mode Flags
 
-### `init`
+### `--init`
 
 Create the standard project docs set from the current source code.
 
@@ -105,7 +107,7 @@ Load:
 - `references/standard-docs-workflow.md`
 - `references/init-workflow.md`
 
-### `update`
+### `--update`
 
 Refresh existing docs after code changes.
 
@@ -118,7 +120,7 @@ Load:
 - `references/standard-docs-workflow.md`
 - `references/update-workflow.md`
 
-### `summarize`
+### `--summarize`
 
 Create or update only `codebase-summary.md`.
 
@@ -130,7 +132,7 @@ Load:
 - `references/standard-docs-workflow.md`
 - `references/summarize-workflow.md`
 
-### `reconstruct`
+### `--reconstruct`
 
 Rebuild current-state, as-is system documentation from source code.
 
@@ -153,7 +155,7 @@ Load:
 
 ## Reconstruction Is Not Specs
 
-`hapo:docs reconstruct` MUST NOT:
+`hapo:docs --reconstruct` MUST NOT:
 
 - design future behavior
 - add new requirements
@@ -165,7 +167,7 @@ Load:
 Correct handoff:
 
 ```text
-/hapo:docs reconstruct <scope>
+/hapo:docs --reconstruct <scope>
 -> human review of as-is docs
 -> /hapo:specs <modernization or change request>
 -> /hapo:develop <feature>
@@ -202,9 +204,9 @@ For broad inputs such as `.`, `/`, `whole repo`, or `entire system`:
 Prefer:
 
 ```text
-/hapo:docs reconstruct apps/admin
-/hapo:docs reconstruct modules/expense-approval
-/hapo:docs reconstruct src/features/order
+/hapo:docs --reconstruct apps/admin
+/hapo:docs --reconstruct modules/expense-approval
+/hapo:docs --reconstruct src/features/order
 ```
 
 Avoid reconstructing a large monolith in one pass unless the user explicitly accepts lower precision.

package/src/claude/skills/docs/references/init-workflow.md

@@ -1,6 +1,6 @@
 # Init Workflow
 
-Use with `/hapo:docs init`.
+Use with `/hapo:docs --init`.
 
 ## Goal
 
@@ -45,7 +45,7 @@ Do not create a large document solely to fill the table. If a core file cannot b
 
 1. Read repo instructions and runtime docs root.
 2. Detect whether docs already exist.
-3. If user specifically asked `init` and docs exist, preserve existing content:
+3. If user specifically asked `--init` and docs exist, preserve existing content:
    - read it first
    - merge or add missing baseline sections
    - do not overwrite human-written docs blind
@@ -126,7 +126,7 @@ Report:
 Recommended next command:
 
 ```text
-/hapo:docs update
+/hapo:docs --update
 ```
 
 after meaningful source changes.

package/src/claude/skills/docs/references/reconstruct-workflow.md

@@ -1,6 +1,6 @@
 # Reconstruct Workflow
 
-Use this reference for `/hapo:docs reconstruct <scope>`.
+Use this reference for `/hapo:docs --reconstruct <scope>`.
 
 ## Goal
 

package/src/claude/skills/docs/references/standard-docs-workflow.md

@@ -1,6 +1,6 @@
 # Standard Docs Workflow
 
-Use this shared contract for `/hapo:docs init`, `/hapo:docs update`, and `/hapo:docs summarize`.
+Use this shared contract for `/hapo:docs --init`, `/hapo:docs --update`, and `/hapo:docs --summarize`.
 
 Then load the mode-specific reference:
 

package/src/claude/skills/docs/references/summarize-workflow.md

@@ -1,6 +1,6 @@
 # Summarize Workflow
 
-Use with `/hapo:docs summarize`.
+Use with `/hapo:docs --summarize`.
 
 ## Goal
 

package/src/claude/skills/docs/references/update-workflow.md

@@ -1,6 +1,6 @@
 # Update Workflow
 
-Use with `/hapo:docs update`.
+Use with `/hapo:docs --update`.
 
 ## Goal