@codeyam/codeyam-cli 0.1.0-staging.30dc541 → 0.1.0-staging.39719f5

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. Delete ALL existing tasks: run TaskList, then run TaskUpdate with status "deleted" for every task returned
+2. Run TaskCreate with the EXACT title from the `EXACT_TASK_TITLE:` line — copy it character-for-character, do NOT paraphrase
+
+This ensures only one task is ever visible. 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.30dc541",
+  "version": "0.1.0-staging.39719f5",
   "description": "Local development CLI for CodeYam analysis",
   "type": "module",
   "bin": {

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

@@ -182,6 +182,7 @@ const SILENTLY_IGNORED_EQUIVALENCY_REASONS = new Set([
     'transformed non-object function equivalency - Array.from() equivalency',
     'Spread operator equivalency key update: Explicit array deconstruction equivalency value',
     // 'transformed non-object function equivalency - Explicit array deconstruction equivalency value',
+    'useState setter call equivalency (direct)',
 ]);
 export class ScopeDataStructure {
     // Getter for backward compatibility - returns the tree structure
@@ -648,9 +649,29 @@ export class ScopeDataStructure {
         delete schema[path];
     }
     addEquivalency(path, equivalentPath, equivalentScopeName, scopeNode, equivalencyReason, equivalencyValueChain, traceId) {
+        // Fast early exits that don't count toward the limit.
+        // These are "no-op" calls that would be caught further below anyway,
+        // but checking them first prevents counter inflation from redundant calls
+        // generated by managers and followEquivalencies during scope processing.
         var _a;
+        // Skip silently-ignored reasons before counting
+        if (SILENTLY_IGNORED_EQUIVALENCY_REASONS.has(equivalencyReason)) {
+            return;
+        }
+        // Skip exact duplicates before counting (Phase 1 only — Phase 2 needs
+        // to process duplicates for database chain tracking)
+        if (this.onlyEquivalencies) {
+            const existing = scopeNode.equivalencies[path];
+            if (existing?.some((v) => v.schemaPath === equivalentPath &&
+                v.scopeNodeName === equivalentScopeName)) {
+                return;
+            }
+        }
         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,
@@ -663,15 +684,11 @@ export class ScopeDataStructure {
         }
         // Filter equivalency reasons - use pre-computed Sets for O(1) lookup
         if (!ALLOWED_EQUIVALENCY_REASONS.has(equivalencyReason)) {
-            if (SILENTLY_IGNORED_EQUIVALENCY_REASONS.has(equivalencyReason)) {
-                return;
-            }
-            else {
-                // Log and skip - if an equivalency reason isn't in ALLOWED or SILENTLY_IGNORED,
-                // it shouldn't be stored (was previously missing the return)
-                console.info('Not tracked equivalency reason', { equivalencyReason });
-                return;
-            }
+            // Silently-ignored reasons already handled above
+            // Log and skip - if an equivalency reason isn't in ALLOWED or SILENTLY_IGNORED,
+            // it shouldn't be stored (was previously missing the return)
+            console.info('Not tracked equivalency reason', { equivalencyReason });
+            return;
         }
         // Skip self-referential equivalencies that would create infinite loops.
         // Case 1: Direct self-reference (path === equivalentPath)