@kafka0102/onespec 0.2.2 → 0.2.3

package/README.md

@@ -8,7 +8,7 @@ OneSpec is a CLI and agent skill bundle for running an OpenSpec + Superpowers wo
 
 ### `onespec`
 
-`onespec` turns OpenSpec from a set of manual commands into an agent-operated workflow. It prepares the design, spec, and task artifacts, asks the human to confirm the design before implementation, recommends the implementation method and path based on complexity, then carries the change through execution, review, and archive.
+`onespec` turns OpenSpec from a set of manual commands into an agent-operated workflow. It prepares the design, spec, and tasks, asks the human to confirm the design before implementation, recommends the implementation method and path based on complexity, then carries the change through execution, review, and archive.
 
 Use it when a change needs normal design confirmation and acceptance review. You invoke the workflow in natural language instead of manually chaining multiple OpenSpec commands.
 
@@ -20,16 +20,42 @@ Use it when a change needs normal design confirmation and acceptance review. You
 
 `onespec`
 
-```mermaid
-flowchart LR
-  A[User request] --> B[Draft design, spec, and tasks] --> C{Human confirms design} --> D[Recommend method and path by complexity] --> E[Execute approved change] --> F{Human reviews acceptance} --> G[Archive]
+```
+┌──────────┐    ┌──────────┐
+│User      │───▶│Complexity│
+│request   │    │ analysis │
+└──────────┘    └────┬─────┘
+                     │
+                  ┌──┴──┐
+                  │     │
+                  Low  High
+                  │     │
+                  ▼     ▼
+┌──────────┐    ┌──────────┐
+│Draft     │◀───│Brainstorm│
+│design,   │    └──────────┘
+│spec, &   │
+│ tasks    │
+└────┬─────┘
+     │
+     ▼
+┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+│Human     │───▶│Recommend │───▶│Execute   │───▶│Human     │───▶│ Archive  │
+│confirms  │    │method &  │    │approved  │    │reviews   │    │          │
+│ design   │    │path by   │    │ change   │    │acceptance│    │          │
+└──────────┘    │complexity│    └──────────┘    └──────────┘    └──────────┘
+                └──────────┘
 ```
 
 `onespec-fast`
 
-```mermaid
-flowchart LR
-  A[Fast-path request] --> B[Create compact OpenSpec context] --> C[Native OpenSpec apply] --> D[Test and validate] --> E[Archive]
+```
+┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+│Fast-path │───▶│Create    │───▶│Native    │───▶│Test &    │───▶│ Archive  │
+│request   │    │compact   │    │OpenSpec  │    │validate  │    │          │
+└──────────┘    │OpenSpec  │    │ apply    │    └──────────┘    └──────────┘
+                │ context  │    └──────────┘
+                └──────────┘
 ```
 
 ## Install

package/assets/skills/onespec/scripts/onespec-closeout.sh

@@ -78,10 +78,19 @@ script_dir() {
 
 canonicalize_path() {
   local input="$1"
-  if [ -z "$input" ] || [ "$input" = "unknown" ] || [ ! -d "$input" ]; then
+  local label="${2:-path}"
+  if [ -z "$input" ] || [ "$input" = "unknown" ]; then
     printf '%s\n' "$input"
     return 0
   fi
+  if [ ! -e "$input" ]; then
+    echo "ERROR: $label does not exist: $input" >&2
+    return 1
+  fi
+  if [ ! -d "$input" ]; then
+    echo "ERROR: $label is not a directory: $input" >&2
+    return 1
+  fi
   (
     cd "$input"
     pwd -P
@@ -102,7 +111,7 @@ selected_actions_csv() {
 }
 
 origin_workspace_path_for_change() {
-  canonicalize_path "$(get_state_value "$1" origin_workspace_path)"
+  canonicalize_path "$(get_state_value "$1" origin_workspace_path)" "origin workspace path"
 }
 
 normalize_action() {
@@ -132,7 +141,7 @@ temporary_worktree_status() {
   origin_branch="$(get_state_value "$change" origin_branch)"
   origin_path="$(get_state_value "$change" origin_workspace_path)"
   origin_mode="$(get_state_value "$change" origin_workspace_mode)"
-  origin_path="$(canonicalize_path "$origin_path")"
+  origin_path="$(canonicalize_path "$origin_path" "origin workspace path")"
   current_path="$(state_workspace_path "$change")"
   current_head="$(git -C "$current_path" branch --show-current 2>/dev/null || true)"
   current_head="${current_head:-detached}"
@@ -221,7 +230,7 @@ cmd_validate_actions() {
   ensure_git_repo
 
   local -a selected=()
-  local action normalized
+  local action selected_action normalized
   local already_selected
   local has_archive_then_merge="false"
   local has_archive_only="false"
@@ -232,8 +241,8 @@ cmd_validate_actions() {
     normalized="$(normalize_action "$action")"
     [ -n "$normalized" ] || continue
     already_selected="false"
-    for action in "${selected[@]:-}"; do
-      if [ "$action" = "$normalized" ]; then
+    for selected_action in "${selected[@]:-}"; do
+      if [ "$selected_action" = "$normalized" ]; then
         already_selected="true"
         break
       fi
@@ -243,8 +252,8 @@ cmd_validate_actions() {
     fi
   done
 
-  for action in "${selected[@]}"; do
-    case "$action" in
+  for selected_action in "${selected[@]}"; do
+    case "$selected_action" in
       archive-then-merge-worktree) has_archive_then_merge="true" ;;
       archive-only) has_archive_only="true" ;;
       discard-worktree) has_discard_worktree="true" ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kafka0102/onespec",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "OpenSpec + Superpowers workflow skill installer for mainstream SKILL.md agents",
   "repository": {
     "type": "git",