@codeyam/codeyam-cli 0.1.0-staging.f777668 → 0.1.0-staging.fff1b4e

package/codeyam-cli/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,0BAA0B;AAC1B,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,cAAc,MAAM,oBAAoB,CAAC;AAChD,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,eAAe,MAAM,qBAAqB,CAAC;AAClD,OAAO,cAAc,MAAM,oBAAoB,CAAC;AAChD,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AACzD,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAC5C,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,cAAc,MAAM,oBAAoB,CAAC;AAChD,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAC3D,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,oBAAoB,MAAM,oCAAoC,CAAC;AACtE,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAC5C,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAC3D,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAC5C,OAAO,gBAAgB,MAAM,sBAAsB,CAAC;AACpD,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAC3D,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,eAAe,MAAM,qBAAqB,CAAC;AAClD,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,uBAAuB,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,gBAAgB,MAAM,sBAAsB,CAAC;AAEpD,+DAA+D;AAC/D,gFAAgF;AAChF,oBAAoB;AACpB,YAAY;AACZ,wBAAwB;AACxB,iCAAiC;AACjC,wBAAwB;AACxB,qBAAqB,EAAE,CAAC;AAExB,gEAAgE;AAChE,8DAA8D;AAC9D,SAAS,eAAe,CAAC,GAAQ;IAC/B,OAAO,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,4BAA4B;AAC5B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACzB,UAAU,CAAC,SAAS,CAAC;KACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC;KAC5B,KAAK,CAAC,+BAA+B,CAAC;KACtC,UAAU,CAAC,GAAG,EAAE;IACf,4DAA4D;IAC5D,sEAAsE;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC,CAAC;KACD,UAAU,CAAC,wBAAwB,CAAC;KACpC,UAAU,CAAC,mBAAmB,CAAC;KAC/B,UAAU,CAAC,mBAAmB,CAAC;IAChC,yCAAyC;KACxC,OAAO,CAAC,cAAc,CAAC;KACvB,OAAO,CAAC,YAAY,CAAC;KACrB,OAAO,CAAC,WAAW,CAAC;KACpB,OAAO,CAAC,aAAa,CAAC;KACtB,OAAO,CAAC,gBAAgB,CAAC;IAC1B,mEAAmE;KAClE,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;KACrC,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;KAC7C,OAAO,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;KACjD,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;KACxC,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;KACvC,OAAO,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;KAC5C,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;KAC7C,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;KAC1C,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;KACzC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;KACtC,OAAO,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC;KAC9C,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;KACxC,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;KACvC,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;KACzC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;KACtC,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;KAC7C,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;KACvC,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;KACrC,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;KACvC,QAAQ,CAAC,uBAAuB,EAAE,CAAC;KACnC,aAAa,CAAC,CAAC,CAAC;KAChB,IAAI,EAAE;KACN,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC;KAClB,MAAM,EAAE;KACR,UAAU,EAAE;KACZ,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACf,YAAY,CAAC,WAAW,EAAE;QACxB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS;QACrC,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,IAAI,OAAO;KAChD,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/codeyam-cli/src/commands/__tests__/editor.analyzeImportsArgs.test.js

@@ -0,0 +1,47 @@
+/**
+ * Tests that `codeyam editor analyze-imports` correctly parses optional
+ * file path arguments to scope analysis to specific files.
+ *
+ * Without file paths, analyze-imports analyzes all glossary entities.
+ * With file paths, it scopes analysis to only those files.
+ */
+import { parseAnalyzeImportsArgs } from "../editorAnalyzeImportsArgs.js";
+describe('parseAnalyzeImportsArgs', () => {
+    it('should return empty array when no args provided', () => {
+        expect(parseAnalyzeImportsArgs(undefined, [])).toEqual([]);
+        expect(parseAnalyzeImportsArgs('', [])).toEqual([]);
+    });
+    it('should parse a single file path from json arg', () => {
+        // codeyam editor analyze-imports app/components/Foo.tsx
+        expect(parseAnalyzeImportsArgs('app/components/Foo.tsx', [])).toEqual([
+            'app/components/Foo.tsx',
+        ]);
+    });
+    it('should collect extra positional args from argv._', () => {
+        // codeyam editor analyze-imports app/components/Foo.tsx app/components/Bar.tsx
+        // yargs: json="app/components/Foo.tsx", argv._=["editor", "app/components/Bar.tsx"]
+        expect(parseAnalyzeImportsArgs('app/components/Foo.tsx', [
+            'editor',
+            'app/components/Bar.tsx',
+        ])).toEqual(['app/components/Foo.tsx', 'app/components/Bar.tsx']);
+    });
+    it('should filter out "editor" from argv._', () => {
+        expect(parseAnalyzeImportsArgs(undefined, [
+            'editor',
+            'app/components/Foo.tsx',
+            'app/lib/utils.ts',
+        ])).toEqual(['app/components/Foo.tsx', 'app/lib/utils.ts']);
+    });
+    it('should deduplicate file paths', () => {
+        expect(parseAnalyzeImportsArgs('app/components/Foo.tsx', [
+            'editor',
+            'app/components/Foo.tsx',
+            'app/components/Bar.tsx',
+        ])).toEqual(['app/components/Foo.tsx', 'app/components/Bar.tsx']);
+    });
+    it('should handle numeric extras gracefully', () => {
+        // yargs can put numbers in argv._
+        expect(parseAnalyzeImportsArgs('app/components/Foo.tsx', [42, 'editor'])).toEqual(['app/components/Foo.tsx']);
+    });
+});
+//# sourceMappingURL=editor.analyzeImportsArgs.test.js.map

package/codeyam-cli/src/commands/__tests__/editor.analyzeImportsArgs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.analyzeImportsArgs.test.js","sourceRoot":"","sources":["../../../../../src/commands/__tests__/editor.analyzeImportsArgs.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,uBAAuB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,uBAAuB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,wDAAwD;QACxD,MAAM,CAAC,uBAAuB,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACpE,wBAAwB;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,+EAA+E;QAC/E,oFAAoF;QACpF,MAAM,CACJ,uBAAuB,CAAC,wBAAwB,EAAE;YAChD,QAAQ;YACR,wBAAwB;SACzB,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CACJ,uBAAuB,CAAC,SAAS,EAAE;YACjC,QAAQ;YACR,wBAAwB;YACxB,kBAAkB;SACnB,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CACJ,uBAAuB,CAAC,wBAAwB,EAAE;YAChD,QAAQ;YACR,wBAAwB;YACxB,wBAAwB;SACzB,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,kCAAkC;QAClC,MAAM,CACJ,uBAAuB,CAAC,wBAAwB,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAClE,CAAC,OAAO,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/codeyam-cli/src/commands/__tests__/editor.auditNoAutoAnalysis.test.js

@@ -0,0 +1,71 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Structural test: handleAudit must NOT call runAnalysisForEntities.
+ *
+ * Previously, handleAudit auto-ran full analysis for incomplete entities,
+ * which was slow (analyzer startup + AST scan for all glossary entries).
+ *
+ * Targeted analysis (with filePaths for 1-3 specific files) is acceptable,
+ * but a full scan (without filePaths) must never be used here.
+ * This test ensures the full auto-analysis doesn't creep back in.
+ */
+describe('handleAudit - no auto-analysis', () => {
+    it('should not call runAnalysisForEntities inside handleAudit', () => {
+        const editorTsPath = path.join(__dirname, '..', 'editor.ts');
+        const source = fs.readFileSync(editorTsPath, 'utf8');
+        // Extract the handleAudit function body.
+        // It starts with "async function handleAudit" and ends at the next
+        // top-level "async function" or "function" declaration (unindented).
+        const handleAuditStart = source.indexOf('async function handleAudit');
+        expect(handleAuditStart).toBeGreaterThan(-1);
+        // Find the next top-level function declaration after handleAudit starts.
+        // Top-level functions start at the beginning of a line (no indentation).
+        const afterStart = source.slice(handleAuditStart + 1);
+        const nextFnMatch = afterStart.match(/\n(?:async )?function [a-zA-Z]/);
+        const handleAuditEnd = nextFnMatch
+            ? handleAuditStart + 1 + nextFnMatch.index
+            : source.length;
+        const handleAuditBody = source.slice(handleAuditStart, handleAuditEnd);
+        // The function body must NOT contain runAnalysisForEntities
+        expect(handleAuditBody).not.toContain('runAnalysisForEntities');
+    });
+    it('should report incomplete entities with guidance instead of auto-fixing', () => {
+        const editorTsPath = path.join(__dirname, '..', 'editor.ts');
+        const source = fs.readFileSync(editorTsPath, 'utf8');
+        const handleAuditStart = source.indexOf('async function handleAudit');
+        const afterStart = source.slice(handleAuditStart + 1);
+        const nextFnMatch = afterStart.match(/\n(?:async )?function [a-zA-Z]/);
+        const handleAuditEnd = nextFnMatch
+            ? handleAuditStart + 1 + nextFnMatch.index
+            : source.length;
+        const handleAuditBody = source.slice(handleAuditStart, handleAuditEnd);
+        // Should still report incomplete entities
+        expect(handleAuditBody).toContain('incompleteEntities');
+        expect(handleAuditBody).toContain('formatIncompleteEntityGuidance');
+    });
+    it('should only call handleAnalyzeImports with filePaths (targeted, not full scan)', () => {
+        const editorTsPath = path.join(__dirname, '..', 'editor.ts');
+        const source = fs.readFileSync(editorTsPath, 'utf8');
+        const handleAuditStart = source.indexOf('async function handleAudit');
+        expect(handleAuditStart).toBeGreaterThan(-1);
+        const afterStart = source.slice(handleAuditStart + 1);
+        const nextFnMatch = afterStart.match(/\n(?:async )?function [a-zA-Z]/);
+        const handleAuditEnd = nextFnMatch
+            ? handleAuditStart + 1 + nextFnMatch.index
+            : source.length;
+        const handleAuditBody = source.slice(handleAuditStart, handleAuditEnd);
+        // Targeted handleAnalyzeImports (with filePaths) is OK — it only
+        // analyzes 1-3 specific files. A full scan (without filePaths) takes
+        // minutes on large projects and must never be used here.
+        const calls = [...handleAuditBody.matchAll(/handleAnalyzeImports\s*\(/g)];
+        for (const call of calls) {
+            const afterCall = handleAuditBody.slice(call.index + call[0].length);
+            // Each call must include filePaths in its arguments
+            const closingParen = afterCall.indexOf(')');
+            const callArgs = afterCall.slice(0, closingParen);
+            expect(callArgs).toContain('filePaths');
+        }
+    });
+});
+//# sourceMappingURL=editor.auditNoAutoAnalysis.test.js.map

package/codeyam-cli/src/commands/__tests__/editor.auditNoAutoAnalysis.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.auditNoAutoAnalysis.test.js","sourceRoot":"","sources":["../../../../../src/commands/__tests__/editor.auditNoAutoAnalysis.test.ts"],"names":[],"mappings":"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"}

package/codeyam-cli/src/commands/__tests__/editor.designSystem.test.js

@@ -0,0 +1,30 @@
+import fs from 'fs';
+import path from 'path';
+import { DESIGN_SYSTEMS } from "../../data/designSystems.js";
+/**
+ * Structural tests for built-in design system selection in the editor.
+ * Ensures template files exist, editor.ts references each design system,
+ * and the subcommand dispatch is wired up.
+ */
+describe('editor design system selection', () => {
+    const editorSource = fs.readFileSync(path.join(__dirname, '..', 'editor.ts'), 'utf8');
+    const templatesDir = path.join(__dirname, '..', // commands
+    '..', // src
+    '..', // codeyam-cli
+    'templates', 'design-systems');
+    it('should have a template file for each design system', () => {
+        for (const ds of DESIGN_SYSTEMS) {
+            const filePath = path.join(templatesDir, ds.fileName);
+            expect(fs.existsSync(filePath)).toBe(true);
+        }
+    });
+    it('should iterate over DESIGN_SYSTEMS in printSetup to output design-system commands', () => {
+        // printSetup dynamically iterates DESIGN_SYSTEMS and outputs
+        // `codeyam editor design-system ${ds.id}` for each — verify the template literal is present
+        expect(editorSource).toContain('codeyam editor design-system ${ds.id}');
+    });
+    it('should have a design-system subcommand dispatch', () => {
+        expect(editorSource).toMatch(/argv\.step === ['"]design-system['"]/);
+    });
+});
+//# sourceMappingURL=editor.designSystem.test.js.map

package/codeyam-cli/src/commands/__tests__/editor.designSystem.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.designSystem.test.js","sourceRoot":"","sources":["../../../../../src/commands/__tests__/editor.designSystem.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;GAIG;AACH,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,EACvC,MAAM,CACP,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,SAAS,EACT,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,cAAc;IACpB,WAAW,EACX,gBAAgB,CACjB,CAAC;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;YACtD,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,6DAA6D;QAC7D,4FAA4F;QAC5F,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/codeyam-cli/src/commands/__tests__/editor.isolateArgs.test.js

@@ -0,0 +1,51 @@
+/**
+ * Tests that `codeyam editor isolate` correctly parses multiple component
+ * names whether passed as separate args or a single quoted string.
+ *
+ * Bug: `codeyam editor isolate A B C` failed because yargs .strict()
+ * rejected extra positionals beyond the two declared (step, json).
+ * Claude would then try one at a time, wasting time and tokens.
+ */
+import { parseIsolateArgs } from "../editorIsolateArgs.js";
+describe('parseIsolateArgs', () => {
+    it('should parse a single component name from json arg', () => {
+        expect(parseIsolateArgs('LogoMark', [])).toEqual(['LogoMark']);
+    });
+    it('should parse space-separated names from a single quoted json arg', () => {
+        // codeyam editor isolate "LogoMark AppHeader Button"
+        expect(parseIsolateArgs('LogoMark AppHeader Button', [])).toEqual([
+            'LogoMark',
+            'AppHeader',
+            'Button',
+        ]);
+    });
+    it('should parse comma-separated names from json arg', () => {
+        expect(parseIsolateArgs('LogoMark,AppHeader,Button', [])).toEqual([
+            'LogoMark',
+            'AppHeader',
+            'Button',
+        ]);
+    });
+    it('should collect extra positional args from argv._', () => {
+        // codeyam editor isolate LogoMark AppHeader Button
+        // yargs: json="LogoMark", argv._=["editor", "AppHeader", "Button"]
+        expect(parseIsolateArgs('LogoMark', ['editor', 'AppHeader', 'Button'])).toEqual(['LogoMark', 'AppHeader', 'Button']);
+    });
+    it('should deduplicate names from json and extras', () => {
+        expect(parseIsolateArgs('LogoMark', ['editor', 'LogoMark', 'AppHeader'])).toEqual(['LogoMark', 'AppHeader']);
+    });
+    it('should filter out empty strings', () => {
+        expect(parseIsolateArgs('LogoMark  AppHeader', [])).toEqual([
+            'LogoMark',
+            'AppHeader',
+        ]);
+    });
+    it('should return empty array when no names provided', () => {
+        expect(parseIsolateArgs(undefined, [])).toEqual([]);
+        expect(parseIsolateArgs('', [])).toEqual([]);
+    });
+    it('should filter out "editor" from argv._', () => {
+        expect(parseIsolateArgs(undefined, ['editor', 'LogoMark', 'AppHeader'])).toEqual(['LogoMark', 'AppHeader']);
+    });
+});
+//# sourceMappingURL=editor.isolateArgs.test.js.map

package/codeyam-cli/src/commands/__tests__/editor.isolateArgs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.isolateArgs.test.js","sourceRoot":"","sources":["../../../../../src/commands/__tests__/editor.isolateArgs.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,qDAAqD;QACrD,MAAM,CAAC,gBAAgB,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAChE,UAAU;YACV,WAAW;YACX,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,gBAAgB,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAChE,UAAU;YACV,WAAW;YACX,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,mDAAmD;QACnD,mEAAmE;QACnE,MAAM,CACJ,gBAAgB,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAChE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CACJ,gBAAgB,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAClE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,gBAAgB,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1D,UAAU;YACV,WAAW;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CACJ,gBAAgB,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CACjE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/codeyam-cli/src/commands/__tests__/editor.statePersistence.test.js

@@ -0,0 +1,55 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Structural test: every writeState() call in editor.ts must preserve
+ * `techStackId` and `appFormats` from the previous state.
+ *
+ * Bug: Steps 4-18 dropped techStackId from writeState calls, causing
+ * getTechStackContext() to fall back to Next.js defaults. This broke
+ * `codeyam editor isolate` for Expo projects — it created Next.js-style
+ * subdirectories instead of Expo flat files.
+ */
+describe('editor state persistence', () => {
+    const editorSource = fs.readFileSync(path.join(__dirname, '..', 'editor.ts'), 'utf8');
+    // Find all writeState blocks in the source.
+    // Each writeState call spans multiple lines like:
+    //   writeState(root, {
+    //     feature,
+    //     step: N,
+    //     ...
+    //   });
+    const writeStateBlocks = [];
+    const lines = editorSource.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes('writeState(root,')) {
+            // Collect lines until we find the closing `});`
+            let block = '';
+            for (let j = i; j < lines.length; j++) {
+                block += lines[j] + '\n';
+                if (lines[j].match(/^\s*\}\);/))
+                    break;
+            }
+            writeStateBlocks.push({ lineNumber: i + 1, block });
+        }
+    }
+    it('should find writeState calls in editor.ts', () => {
+        expect(writeStateBlocks.length).toBeGreaterThan(10);
+    });
+    // Filter to only writeState blocks that set a step number (printStep functions).
+    // Exclude the handleTemplate/migration-survey writeState that sets step: 0.
+    const stepWriteStates = writeStateBlocks.filter(({ block }) => block.match(/step:\s*\d+/) && !block.match(/step:\s*0/));
+    it('should find step writeState calls', () => {
+        expect(stepWriteStates.length).toBeGreaterThanOrEqual(18);
+    });
+    for (const { lineNumber, block } of stepWriteStates) {
+        const stepMatch = block.match(/step:\s*(\d+)/);
+        const stepNum = stepMatch ? stepMatch[1] : '?';
+        it(`step ${stepNum} writeState (line ${lineNumber}) should preserve techStackId`, () => {
+            expect(block).toContain('techStackId');
+        });
+        it(`step ${stepNum} writeState (line ${lineNumber}) should preserve appFormats`, () => {
+            expect(block).toContain('appFormats');
+        });
+    }
+});
+//# sourceMappingURL=editor.statePersistence.test.js.map

package/codeyam-cli/src/commands/__tests__/editor.statePersistence.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.statePersistence.test.js","sourceRoot":"","sources":["../../../../../src/commands/__tests__/editor.statePersistence.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;;GAQG;AACH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,EACvC,MAAM,CACP,CAAC;IAEF,4CAA4C;IAC5C,kDAAkD;IAClD,uBAAuB;IACvB,eAAe;IACf,eAAe;IACf,UAAU;IACV,QAAQ;IACR,MAAM,gBAAgB,GAA4C,EAAE,CAAC;IACrE,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC1C,gDAAgD;YAChD,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;gBACzB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;oBAAE,MAAM;YACzC,CAAC;YACD,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,iFAAiF;IACjF,4EAA4E;IAC5E,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,CAC7C,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CACvE,CAAC;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,eAAe,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAE/C,EAAE,CAAC,QAAQ,OAAO,qBAAqB,UAAU,+BAA+B,EAAE,GAAG,EAAE;YACrF,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,QAAQ,OAAO,qBAAqB,UAAU,8BAA8B,EAAE,GAAG,EAAE;YACpF,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}

package/codeyam-cli/src/commands/__tests__/editor.stepDispatch.test.js

@@ -0,0 +1,56 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Structural test: the CLI dispatch switch in editor.ts must have case labels
+ * for every step 1–18. Without this test, it's easy to add new steps
+ * (e.g. 16, 17, 18) to the printStep functions and STEP_LABELS but forget
+ * to add matching case labels to the switch statement — causing `codeyam editor N`
+ * to silently do nothing for the missing steps.
+ *
+ * This test reads the source file and parses the switch block that dispatches
+ * step numbers to their handlers.
+ */
+describe('editor CLI step dispatch', () => {
+    const editorSource = fs.readFileSync(path.join(__dirname, '..', 'editor.ts'), 'utf8');
+    it('should have switch case labels for all steps 1–18', () => {
+        // Find the switch(step) block in the CLI dispatch section.
+        // There are two stepFns definitions in editor.ts:
+        //   1. Test/debug scenario generator (~line 4658) — uses a for-loop, not a switch
+        //   2. CLI dispatch (~line 5263) — uses switch(step) { case N: ... }
+        //
+        // We need to verify the second one (CLI dispatch) has cases for all 18 steps.
+        // Find all `case N:` labels in the file. The CLI dispatch switch is the
+        // only switch on `step` that uses numbered cases.
+        const switchMatch = editorSource.match(/switch\s*\(step\)\s*\{([\s\S]*?)\n\s{4}\}/);
+        expect(switchMatch).not.toBeNull();
+        const switchBody = switchMatch[1];
+        for (let step = 1; step <= 18; step++) {
+            const casePattern = new RegExp(`case\\s+${step}\\s*[:{]`);
+            expect(switchBody).toMatch(casePattern);
+        }
+    });
+    it('should have STEP_LABELS entries for all steps 1–18', () => {
+        for (let step = 1; step <= 18; step++) {
+            const labelPattern = new RegExp(`${step}:\\s*'[^']+'`);
+            expect(editorSource).toMatch(labelPattern);
+        }
+    });
+    it('should have printStep functions defined for all steps 1–18', () => {
+        for (let step = 1; step <= 18; step++) {
+            const fnPattern = new RegExp(`function\\s+printStep${step}\\s*\\(`);
+            expect(editorSource).toMatch(fnPattern);
+        }
+    });
+    it('should include dimension in all preview commands that contain scenarioId', () => {
+        // Find all lines that contain a preview command with scenarioId.
+        // Every such line must also include "dimension" to avoid Claude getting
+        // an error when copying the example command verbatim.
+        const lines = editorSource.split('\n');
+        const previewWithScenarioId = lines.filter((line) => line.includes('scenarioId') && line.includes('preview'));
+        expect(previewWithScenarioId.length).toBeGreaterThan(0);
+        for (const line of previewWithScenarioId) {
+            expect(line).toContain('dimension');
+        }
+    });
+});
+//# sourceMappingURL=editor.stepDispatch.test.js.map

package/codeyam-cli/src/commands/__tests__/editor.stepDispatch.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.stepDispatch.test.js","sourceRoot":"","sources":["../../../../../src/commands/__tests__/editor.stepDispatch.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;;;GASG;AACH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,EACvC,MAAM,CACP,CAAC;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,2DAA2D;QAC3D,kDAAkD;QAClD,kFAAkF;QAClF,qEAAqE;QACrE,EAAE;QACF,8EAA8E;QAE9E,wEAAwE;QACxE,kDAAkD;QAClD,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CACpC,2CAA2C,CAC5C,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAEnC,MAAM,UAAU,GAAG,WAAY,CAAC,CAAC,CAAC,CAAC;QAEnC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,WAAW,IAAI,UAAU,CAAC,CAAC;YAC1D,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC;YACvD,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,wBAAwB,IAAI,SAAS,CAAC,CAAC;YACpE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,iEAAiE;QACjE,wEAAwE;QACxE,sDAAsD;QACtD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,qBAAqB,GAAG,KAAK,CAAC,MAAM,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAClE,CAAC;QAEF,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACxD,KAAK,MAAM,IAAI,IAAI,qBAAqB,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/codeyam-cli/src/commands/__tests__/init.gitignore.test.js

@@ -2,39 +2,88 @@ import * as fs from 'fs/promises';
 import * as path from 'path';
 import * as os from 'os';
 /**
- * Extract the ensureGitignoreEntry function for testing
- * This is the same implementation as in init.ts
+ * Granular .codeyam ignore patterns — machine-local files only.
+ * Shared files (config.json, editor-scenarios/, etc.) are NOT ignored
+ * so they can be committed and shared via git.
  */
-async function ensureGitignoreEntry(projectRoot, entry) {
+const CODEYAM_GITIGNORE_ENTRIES = [
+    '.codeyam/db.sqlite3',
+    '.codeyam/db.sqlite3-wal',
+    '.codeyam/db.sqlite3-shm',
+    '.codeyam/secrets.json',
+    '.codeyam/server.json',
+    '.codeyam/server-state.json',
+    '.codeyam/queue.json',
+    '.codeyam/active-scenario.json',
+    '.codeyam/editor-step.json',
+    '.codeyam/editor-user-prompt.txt',
+    '.codeyam/claude-session-id.txt',
+    '.codeyam/editor-mode-context.md',
+    '.codeyam/dev-mode-context.md',
+    '.codeyam/handoff-context.md',
+    '.codeyam/logs/',
+    '.codeyam/llm-calls/',
+    '.codeyam/captures/',
+    '.codeyam/results/',
+    '.codeyam/tmp/',
+    '.codeyam/rules/',
+    '.codeyam/bin/',
+    '.codeyam/docs/',
+];
+/**
+ * Extract the ensureGitignoreEntry function for testing.
+ * Uses granular patterns instead of blanket .codeyam.
+ */
+async function ensureGitignoreEntry(projectRoot) {
     const gitignorePath = path.join(projectRoot, '.gitignore');
     let gitignoreContent = '';
-    // Read existing .gitignore if it exists
     try {
         gitignoreContent = await fs.readFile(gitignorePath, 'utf8');
     }
     catch (error) {
         // File doesn't exist, will create it
     }
-    // Check if entry already exists
     const lines = gitignoreContent.split('\n');
-    const entryExists = lines.some((line) => line.trim() === entry || line.trim() === `/${entry}`);
-    if (!entryExists) {
-        // Add entry with a comment
+    // If there's already a blanket .codeyam ignore, replace it with granular patterns
+    const blanketIndex = lines.findIndex((line) => line.trim() === '.codeyam' || line.trim() === '/.codeyam');
+    if (blanketIndex !== -1) {
+        // Remove the blanket entry (and preceding comment if it's ours)
+        const removeStart = blanketIndex > 0 &&
+            lines[blanketIndex - 1].trim().startsWith('# CodeYam local files')
+            ? blanketIndex - 1
+            : blanketIndex;
+        lines.splice(removeStart, blanketIndex - removeStart + 1);
+        gitignoreContent = lines.join('\n');
+    }
+    // Check if granular patterns already exist
+    const hasGranularPatterns = CODEYAM_GITIGNORE_ENTRIES.some((entry) => lines.some((line) => line.trim() === entry));
+    if (!hasGranularPatterns) {
+        const block = '\n# CodeYam - local only (not shared)\n' +
+            CODEYAM_GITIGNORE_ENTRIES.join('\n') +
+            '\n';
         const newContent = gitignoreContent +
             (gitignoreContent && !gitignoreContent.endsWith('\n') ? '\n' : '') +
-            '\n# CodeYam local files (contains secrets and local database)\n' +
-            `.codeyam\n`;
+            block;
         await fs.writeFile(gitignorePath, newContent, 'utf8');
     }
+    else {
+        // Add any missing entries from the current list
+        const missingEntries = CODEYAM_GITIGNORE_ENTRIES.filter((entry) => !lines.some((line) => line.trim() === entry));
+        if (missingEntries.length > 0) {
+            const updatedContent = gitignoreContent +
+                (gitignoreContent && !gitignoreContent.endsWith('\n') ? '\n' : '') +
+                missingEntries.join('\n') +
+                '\n';
+            await fs.writeFile(gitignorePath, updatedContent, 'utf8');
+        }
+    }
 }
 describe('init command - gitignore management', () => {
     let testDir;
     beforeEach(async () => {
-        // Create a unique temp directory for each test
         testDir = await fs.mkdtemp(path.join(os.tmpdir(), 'codeyam-test-'));
     });
     afterEach(async () => {
-        // Clean up test directory
         try {
             await fs.rm(testDir, { recursive: true, force: true });
         }
@@ -43,62 +92,77 @@ describe('init command - gitignore management', () => {
         }
     });
     describe('ensureGitignoreEntry', () => {
-        test('creates new .gitignore with .codeyam entry when file does not exist', async () => {
-            await ensureGitignoreEntry(testDir, '.codeyam');
+        test('creates new .gitignore with granular .codeyam patterns when file does not exist', async () => {
+            await ensureGitignoreEntry(testDir);
             const gitignorePath = path.join(testDir, '.gitignore');
             const content = await fs.readFile(gitignorePath, 'utf8');
-            expect(content).toContain('.codeyam');
-            expect(content).toContain('# CodeYam local files (contains secrets and local database)');
+            expect(content).toContain('.codeyam/db.sqlite3');
+            expect(content).toContain('.codeyam/secrets.json');
+            expect(content).toContain('.codeyam/server.json');
+            expect(content).toContain('.codeyam/logs/');
+            expect(content).toContain('# CodeYam - local only (not shared)');
+            // Should NOT have blanket .codeyam
+            expect(content).not.toMatch(/^\.codeyam$/m);
         });
-        test('adds .codeyam to existing .gitignore that does not have it', async () => {
+        test('adds granular patterns to existing .gitignore', async () => {
             const gitignorePath = path.join(testDir, '.gitignore');
-            const existingContent = 'node_modules\n.env\n';
-            await fs.writeFile(gitignorePath, existingContent, 'utf8');
-            await ensureGitignoreEntry(testDir, '.codeyam');
+            await fs.writeFile(gitignorePath, 'node_modules\n.env\n', 'utf8');
+            await ensureGitignoreEntry(testDir);
             const content = await fs.readFile(gitignorePath, 'utf8');
             expect(content).toContain('node_modules');
             expect(content).toContain('.env');
-            expect(content).toContain('.codeyam');
-            expect(content).toContain('# CodeYam local files (contains secrets and local database)');
+            expect(content).toContain('.codeyam/db.sqlite3');
+            expect(content).toContain('.codeyam/secrets.json');
         });
-        test('does not duplicate .codeyam entry when it already exists', async () => {
+        test('does not duplicate when all granular patterns already exist', async () => {
             const gitignorePath = path.join(testDir, '.gitignore');
-            const existingContent = 'node_modules\n.codeyam\n.env\n';
-            await fs.writeFile(gitignorePath, existingContent, 'utf8');
-            await ensureGitignoreEntry(testDir, '.codeyam');
+            await fs.writeFile(gitignorePath, 'node_modules\n\n# CodeYam - local only (not shared)\n' +
+                CODEYAM_GITIGNORE_ENTRIES.join('\n') +
+                '\n', 'utf8');
+            await ensureGitignoreEntry(testDir);
             const content = await fs.readFile(gitignorePath, 'utf8');
-            const matches = content.match(/\.codeyam/g);
-            // Should only appear once
+            // Exact match on the line — no duplicates
+            const matches = content.match(/^\.codeyam\/db\.sqlite3$/gm);
             expect(matches).toHaveLength(1);
         });
-        test('handles .codeyam with leading slash in existing .gitignore', async () => {
+        test('replaces blanket .codeyam with granular patterns', async () => {
             const gitignorePath = path.join(testDir, '.gitignore');
-            const existingContent = 'node_modules\n/.codeyam\n.env\n';
-            await fs.writeFile(gitignorePath, existingContent, 'utf8');
-            await ensureGitignoreEntry(testDir, '.codeyam');
+            await fs.writeFile(gitignorePath, 'node_modules\n\n# CodeYam local files (contains secrets and local database)\n.codeyam\n', 'utf8');
+            await ensureGitignoreEntry(testDir);
             const content = await fs.readFile(gitignorePath, 'utf8');
-            const matches = content.match(/\.codeyam/g);
-            // Should not add another entry since /.codeyam already exists
-            expect(matches).toHaveLength(1);
+            // Blanket entry should be removed
+            expect(content).not.toMatch(/^\.codeyam$/m);
+            // Granular patterns should be added
+            expect(content).toContain('.codeyam/db.sqlite3');
+            expect(content).toContain('.codeyam/secrets.json');
+            // Existing content preserved
+            expect(content).toContain('node_modules');
+        });
+        test('replaces blanket /.codeyam with granular patterns', async () => {
+            const gitignorePath = path.join(testDir, '.gitignore');
+            await fs.writeFile(gitignorePath, 'node_modules\n/.codeyam\n.env\n', 'utf8');
+            await ensureGitignoreEntry(testDir);
+            const content = await fs.readFile(gitignorePath, 'utf8');
+            expect(content).not.toMatch(/^\/\.codeyam$/m);
+            expect(content).toContain('.codeyam/db.sqlite3');
+            expect(content).toContain('.env');
         });
         test('properly handles .gitignore without trailing newline', async () => {
             const gitignorePath = path.join(testDir, '.gitignore');
-            const existingContent = 'node_modules';
-            await fs.writeFile(gitignorePath, existingContent, 'utf8');
-            await ensureGitignoreEntry(testDir, '.codeyam');
+            await fs.writeFile(gitignorePath, 'node_modules', 'utf8');
+            await ensureGitignoreEntry(testDir);
             const content = await fs.readFile(gitignorePath, 'utf8');
             expect(content).toContain('node_modules');
-            expect(content).toContain('.codeyam');
-            // Should have proper newlines
+            expect(content).toContain('.codeyam/db.sqlite3');
             expect(content).toMatch(/node_modules\n/);
         });
         test('handles empty .gitignore file', async () => {
             const gitignorePath = path.join(testDir, '.gitignore');
             await fs.writeFile(gitignorePath, '', 'utf8');
-            await ensureGitignoreEntry(testDir, '.codeyam');
+            await ensureGitignoreEntry(testDir);
             const content = await fs.readFile(gitignorePath, 'utf8');
-            expect(content).toContain('.codeyam');
-            expect(content).toContain('# CodeYam local files (contains secrets and local database)');
+            expect(content).toContain('.codeyam/db.sqlite3');
+            expect(content).toContain('# CodeYam - local only (not shared)');
         });
         test('preserves existing content formatting', async () => {
             const gitignorePath = path.join(testDir, '.gitignore');
@@ -115,17 +179,43 @@ dist
 build
 `;
             await fs.writeFile(gitignorePath, existingContent, 'utf8');
-            await ensureGitignoreEntry(testDir, '.codeyam');
+            await ensureGitignoreEntry(testDir);
             const content = await fs.readFile(gitignorePath, 'utf8');
-            // Check that existing content is preserved
             expect(content).toContain('# Dependencies');
             expect(content).toContain('node_modules');
             expect(content).toContain('# Environment');
             expect(content).toContain('.env');
             expect(content).toContain('# Build');
             expect(content).toContain('dist');
-            // And our new entry is added
-            expect(content).toContain('.codeyam');
+            expect(content).toContain('.codeyam/db.sqlite3');
+        });
+        test('adds missing entries to existing granular block', async () => {
+            const gitignorePath = path.join(testDir, '.gitignore');
+            // Simulate an older gitignore that has most entries but is missing claude-session-id.txt and docs/
+            const oldEntries = CODEYAM_GITIGNORE_ENTRIES.filter((e) => e !== '.codeyam/claude-session-id.txt' && e !== '.codeyam/docs/');
+            await fs.writeFile(gitignorePath, 'node_modules\n\n# CodeYam - local only (not shared)\n' +
+                oldEntries.join('\n') +
+                '\n', 'utf8');
+            await ensureGitignoreEntry(testDir);
+            const content = await fs.readFile(gitignorePath, 'utf8');
+            // New entries should be added
+            expect(content).toContain('.codeyam/claude-session-id.txt');
+            expect(content).toContain('.codeyam/docs/');
+            // Existing entries should still be there
+            expect(content).toContain('.codeyam/db.sqlite3');
+            expect(content).toContain('.codeyam/secrets.json');
+            // No duplicates
+            const dbMatches = content.match(/\.codeyam\/db\.sqlite3$/gm);
+            expect(dbMatches).toHaveLength(1);
+        });
+        test('config.json is NOT ignored (allows sharing via git)', async () => {
+            await ensureGitignoreEntry(testDir);
+            const gitignorePath = path.join(testDir, '.gitignore');
+            const content = await fs.readFile(gitignorePath, 'utf8');
+            // config.json should not appear in gitignore
+            expect(content).not.toContain('config.json');
+            // editor-scenarios/ should not appear in gitignore
+            expect(content).not.toContain('editor-scenarios/');
         });
     });
 });