@codeyam/codeyam-cli 0.1.0-staging.25a2014 → 0.1.0-staging.26dc674

package/codeyam-cli/templates/editor-step-hook.py

@@ -15,40 +15,44 @@ from datetime import datetime, timezone
 
 STEP_LABELS = {
     1: "Plan",
-    2: "Prototype",
-    3: "Confirm",
-    4: "Deconstruct",
-    5: "Extract",
-    6: "Glossary",
-    7: "Analyze",
-    8: "App Scenarios",
-    9: "User Scenarios",
-    10: "Verify",
-    11: "Journal",
-    12: "Review",
-    13: "Present",
-    14: "Commit",
-    15: "Finalize",
-    16: "Push",
+    2: "Prepare",
+    3: "Prototype",
+    4: "Verify Prototype",
+    5: "Confirm",
+    6: "Deconstruct",
+    7: "Extract",
+    8: "Glossary",
+    9: "Analyze",
+    10: "App Scenarios",
+    11: "User Scenarios",
+    12: "Verify",
+    13: "Journal",
+    14: "Review",
+    15: "Present",
+    16: "Commit",
+    17: "Finalize",
+    18: "Push",
 }
 
 STEP_RESTRICTIONS = {
     1: "Do NOT write any code. Plan and describe only. Wait for user confirmation.",
-    2: "Do NOT create scenarios or run codeyam analyze. Build fast — working prototype with real data.",
-    3: "Present a selection menu (AskUserQuestion) for confirmation. Do NOT refactor or create scenarios until approved.",
-    4: "Do NOT write any code. Read every file, identify all extractable pieces, write a numbered plan. Planning only.",
-    5: "Execute the extraction plan from step 4. Components first (no tests), then library functions via TDD. Page files must contain ZERO direct JSX.",
-    6: "Do NOT write application code or scenarios. Update the glossary only.",
-    7: "Create isolation routes for visual components, run tests for library functions. Register component scenarios via codeyam editor register.",
-    8: "Do NOT modify application code. Create and register app-level scenarios only.",
-    9: "Do NOT modify application code. Create user-persona scenarios only (or skip if no users).",
-    10: "Verify component isolation screenshots AND editor scenarios. After ANY code fix, re-register affected components. Fix only — do NOT add features.",
-    11: "Create or update the journal entry for this feature. Do NOT create a duplicate — check if one exists first.",
-    12: "Verify ALL screenshots exist and NO client-side errors (/api/editor-client-errors). Run codeyam editor audit. Do not proceed until all checks pass.",
-    13: "Show the results panel, present summary, then selection menu (AskUserQuestion): Save or make changes.",
-    14: "Hide the results panel and commit all changes. Do NOT push — that happens in step 16.",
-    15: "Update the journal entry with the commit SHA and amend the commit to include the journal update.",
-    16: "Check for a git remote and offer to push. WAIT for the user's answer before starting the next feature.",
+    2: "Do NOT write any code or build features. Set up the project and prepare the database only.",
+    3: "Do NOT create scenarios or run codeyam analyze. Build fast — working prototype with real data.",
+    4: "Verify the prototype works. Do NOT add features — only fix broken functionality.",
+    5: "Present a selection menu (AskUserQuestion) for confirmation. Do NOT refactor or create scenarios until approved.",
+    6: "Do NOT write any code. Read every file, identify all extractable pieces, write a numbered plan. Planning only.",
+    7: "Execute the extraction plan from step 6. Components first (no tests), then library functions via TDD. Page files must contain ZERO direct JSX.",
+    8: "Do NOT write application code or scenarios. Update the glossary only.",
+    9: "Create isolation routes for visual components, run tests for library functions. Register component scenarios via codeyam editor register.",
+    10: "Do NOT modify application code. Create and register app-level scenarios only.",
+    11: "Do NOT modify application code. Create user-persona scenarios only (or skip if no users).",
+    12: "Verify component isolation screenshots AND editor scenarios. After ANY code fix, re-register affected components. Fix only — do NOT add features.",
+    13: "Create or update the journal entry for this feature. Do NOT create a duplicate — check if one exists first.",
+    14: "Verify ALL screenshots exist and NO client-side errors (/api/editor-client-errors). Run codeyam editor audit. Do not proceed until all checks pass.",
+    15: "Show the results panel, present summary, then selection menu (AskUserQuestion): Save or make changes.",
+    16: "Hide the results panel and commit all changes. Do NOT push — that happens in step 18.",
+    17: "Update the journal entry with the commit SHA and amend the commit to include the journal update.",
+    18: "Check for a git remote and offer to push. WAIT for the user's answer before starting the next feature.",
 }
 
 MIGRATION_STEP_LABELS = {
@@ -127,18 +131,34 @@ def main():
     # Detect event early so we can capture the user prompt even before state exists
     event_type, event_data = detect_event()
 
-    # Capture the very first real user prompt (before state file may exist).
-    # Save to a separate file so it persists across state transitions.
+    # Capture the user's feature request prompt.
+    # Write when: (a) no prompt file yet, (b) no state file (between features),
+    # or (c) previous feature is done (step >= 18). This ensures the prompt
+    # is refreshed for each new feature instead of persisting stale text.
     # Skip slash commands (e.g. /codeyam-editor) — they aren't user prompts.
-    if event_type == "user_prompt" and not os.path.exists(prompt_path):
+    if event_type == "user_prompt":
         prompt_text = event_data.get("prompt", "").strip()
         if prompt_text and not prompt_text.startswith("/"):
-            try:
-                os.makedirs(os.path.dirname(prompt_path), exist_ok=True)
-                with open(prompt_path, "w") as f:
-                    f.write(prompt_text)
-            except Exception:
-                pass  # Best-effort
+            should_capture = not os.path.exists(prompt_path)
+            if not should_capture:
+                # Overwrite stale prompt when between features
+                if not os.path.exists(state_path):
+                    should_capture = True
+                else:
+                    try:
+                        with open(state_path, "r") as f:
+                            prev = json.load(f)
+                        if prev.get("step", 0) >= 18:
+                            should_capture = True
+                    except Exception:
+                        pass
+            if should_capture:
+                try:
+                    os.makedirs(os.path.dirname(prompt_path), exist_ok=True)
+                    with open(prompt_path, "w") as f:
+                        f.write(prompt_text)
+                except Exception:
+                    pass  # Best-effort
 
     if not os.path.exists(state_path):
         return
@@ -157,6 +177,27 @@ def main():
     if not step:
         return
 
+    # ── Task tracking ──────────────────────────────────────────────────
+    # Track whether TaskCreate was called between step transitions.
+    # If Claude advances to the next step without creating a task, block it.
+    task_tracking_path = os.path.join(project_dir, ".codeyam", "editor-task-tracking.json")
+
+    if event_type == "post_tool_use":
+        tool_name = event_data.get("tool_name", "")
+
+        # Record when TaskCreate is called
+        if tool_name == "TaskCreate":
+            try:
+                tracking = {}
+                if os.path.exists(task_tracking_path):
+                    with open(task_tracking_path, "r") as f:
+                        tracking = json.load(f)
+                tracking["taskCreated"] = True
+                with open(task_tracking_path, "w") as f:
+                    json.dump(tracking, f)
+            except Exception:
+                pass
+
     # Log the hook firing
     log_data = {"step": step, "label": label, "feature": feature, "hook": event_type}
     if migration:
@@ -171,7 +212,7 @@ def main():
         next_cmd = f"codeyam editor migrate {step + 1}" if step < 10 else "codeyam editor migrate next"
     else:
         restriction = STEP_RESTRICTIONS.get(step, "")
-        next_cmd = f"codeyam editor {step + 1}" if step < 16 else "codeyam editor 1"
+        next_cmd = f"codeyam editor {step + 1}" if step < 18 else "codeyam editor 1"
 
     # UserPromptSubmit: concise workflow reminder injected before Claude processes the user's message
     if event_type == "user_prompt":
@@ -212,14 +253,14 @@ def main():
                 "The change workflow ensures Working Session Results are shown to the user. "
                 "If the user chose to commit, run `codeyam editor migrate next` to advance to the next page."
             )
-        elif step in (13, 14, 15, 16) and not migration:
+        elif step in (15, 16, 17, 18) and not migration:
             lines.append(
                 "If the user is requesting changes (even indirectly), "
                 "run `codeyam editor change` BEFORE making any modifications "
                 "(code, scenarios, data, styles — everything). "
                 "The change command gives you the post-change checklist. "
                 "The change workflow ensures Working Session Results are shown to the user. "
-                "If the user chose to commit, run `codeyam editor 14` to advance to the commit step."
+                "If the user chose to commit, run `codeyam editor 16` to advance to the commit step."
             )
         elif migration:
             lines.append(
@@ -270,9 +311,9 @@ def main():
                     tracker.append(f"{DIM}  \u2502  \u25cb  {cntnt}\u2502{RESET}")
             tracker.append(f"{DIM}  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518{RESET}")
         else:
-            # Standard progress tracker (16 steps)
+            # Standard progress tracker (18 steps)
             tracker = [f"{DIM}  \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510{RESET}"]
-            for i in range(1, 17):
+            for i in range(1, 19):
                 lbl = STEP_LABELS[i].ljust(28)
                 num = f" {i}" if i < 10 else f"{i}"
                 content = f"{num}. {lbl}"
@@ -291,7 +332,7 @@ def main():
             "\u2713 (done) or \u2717 (skipped + reason)."
         )
 
-    if event_type == "stop" and ((step in (13, 14) and not migration) or (step == 8 and migration)):
+    if event_type == "stop" and ((step in (15, 16) and not migration) or (step == 8 and migration)):
         import subprocess as _sp
         try:
             _result = _sp.run(
@@ -309,9 +350,15 @@ def main():
             )
             lines.append(
                 f"\033[31mRun `codeyam editor change` if you haven't already, then complete the "
-                f"checklist and run `{'codeyam editor migrate 8' if migration else 'codeyam editor 13'}` to show results to the user.\033[0m"
+                f"checklist and run `{'codeyam editor migrate 8' if migration else 'codeyam editor 15'}` to show results to the user.\033[0m"
             )
 
+    if event_type == "stop":
+        lines.append(
+            f"\n\033[2mReminder: Only use `codeyam editor` subcommands in the Build terminal. "
+            f"Follow `codeyam editor steps` when changing code.\033[0m"
+        )
+
     lines.append(f"When this step is complete, run: {next_cmd}")
 
     print("\n".join(lines))

package/codeyam-cli/templates/skills/codeyam-editor/SKILL.md

@@ -16,6 +16,15 @@ You MUST follow a step-by-step workflow driven by `codeyam editor` commands. Eac
 
 **The rule:** After completing what a command tells you to do, run the NEXT command it specifies. The commands are your instructions — follow them one at a time.
 
+## TASK Directive
+
+Some `codeyam editor N` commands output a `━━━ TASK ━━━` section with an `EXACT_TASK_TITLE:` line. When you see one:
+
+1. Mark your current task as complete (if one exists)
+2. Run TaskCreate with the EXACT title from the `EXACT_TASK_TITLE:` line — copy it character-for-character, do NOT paraphrase
+
+Do NOT create tasks on your own. Only create them when a `━━━ TASK ━━━` directive tells you to.
+
 ## Migration Mode
 
 When `codeyam editor steps` shows **"Project Migration"** instead of "Feature Cycle", the project is being migrated from an existing codebase. Follow the `codeyam editor migrate` commands instead of the normal 13-step cycle.
@@ -117,6 +126,9 @@ This command gives you the post-change checklist (re-register scenarios, re-run
 ## Key Rules
 
 - **Run the commands** — they ARE your instructions, not suggestions
+- **One step at a time** — run each `codeyam editor N` command, read its FULL output, complete every checklist item, then advance. The CLI enforces a minimum time per step.
+- **NEVER batch-run steps** — `for step in 5 6 7 8; do codeyam editor $step; done` or piping to `head` defeats the entire workflow. Each step has unique instructions you must read and follow.
+- **NEVER delegate multiple steps to a subagent** — each step must be run, read, and completed in the main conversation. You MAY use subagents for parallelizable work _within_ a single step (e.g. extracting components + writing tests in step 5).
 - **Every feature gets scenarios** — this is the core value of CodeYam
 - **Always scaffold with a database** (Prisma + SQLite)
 - **Build real API routes** — the proxy handles scenario data transparently
@@ -176,7 +188,13 @@ codeyam editor register '{"name":"Full Catalog","type":"application","url":"/","
 # Register app scenario with localStorage (for apps using client-side storage instead of a database)
 codeyam editor register '{"name":"Full Library","type":"application","url":"/","dimensions":["<name from screenSizes>"],"localStorage":{"articles":[...],"collections":[...]}}'
 
-# For large seed/localStorage data, write JSON to a temp file and use @ prefix:
+# BULK REGISTRATION (preferred — register all scenarios at once):
+# Write an array of scenarios to a temp file, then register with @ prefix.
+# This is faster and avoids repeated screenshot capture overhead.
+# File format: [{"name":"...","type":"...","url":"...","seed":{...}}, ...]
+codeyam editor register @.codeyam/tmp/scenarios.json
+
+# Single scenario from file (for large seed/localStorage data):
 codeyam editor register @/tmp/scenario-data.json
 
 # Journal entry (one per feature, references scenario names)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeyam/codeyam-cli",
-  "version": "0.1.0-staging.25a2014",
+  "version": "0.1.0-staging.26dc674",
   "description": "Local development CLI for CodeYam analysis",
   "type": "module",
   "bin": {

package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js

@@ -650,7 +650,10 @@ export class ScopeDataStructure {
     addEquivalency(path, equivalentPath, equivalentScopeName, scopeNode, equivalencyReason, equivalencyValueChain, traceId) {
         var _a;
         addEquivalencyCallCount++;
-        if (addEquivalencyCallCount > 50000) {
+        const limit = typeof globalThis.__CODEYAM_EQUIVALENCY_LIMIT === 'number'
+            ? globalThis.__CODEYAM_EQUIVALENCY_LIMIT
+            : 50000;
+        if (addEquivalencyCallCount > limit) {
             console.error('INFINITE LOOP DETECTED in addEquivalency', {
                 callCount: addEquivalencyCallCount,
                 path,