@overshift/sfs 1.1.0 → 1.1.2

package/README.md

@@ -31,6 +31,7 @@ npx sfs init
 This creates:
 - `sfs.config.md` - Base configuration
 - `example.sfs` - Example login flow
+- `.sfsignore` - Coverage scan exclusions
 
 ## CLI Commands
 
@@ -55,11 +56,15 @@ npx sfs validate "stories/**/*.sfs"
 ### Coverage Report
 
 ```bash
-npx sfs coverage                      # Table format
-npx sfs coverage --format json        # JSON output
-npx sfs coverage --format summary     # Summary only
+npx sfs coverage                              # Scan entire project, table output
+npx sfs coverage -f json                      # JSON output for CI pipelines
+npx sfs coverage -f summary                   # One-line summary
+npx sfs coverage -s docs/stories              # Scan only docs/stories directory
+npx sfs coverage --story-pattern "JIRA-\d+"   # Custom story ID pattern
 ```
 
+By default, coverage scans the entire project (respecting `.sfsignore` exclusions). Use `--stories <dir>` to restrict scope.
+
 ## SFS File Syntax
 
 ```sfs
@@ -141,6 +146,32 @@ CLICK login button >> selector:text:Log In         # Text selector
 | guest | | | Unauthenticated |
 ```
 
+### .sfsignore
+
+Control which directories are excluded from coverage scanning:
+
+```
+# Comments start with #
+node_modules
+dist
+build
+vendor
+*.log
+docs/archive
+```
+
+Bare names auto-expand to glob patterns (e.g., `vendor` becomes `**/vendor/**`). Built-in defaults (`node_modules`, `.git`, `dist`, `build`, `coverage`) always apply.
+
+### Story ID Pattern
+
+Configure custom story ID patterns in `sfs.config.md`:
+
+```markdown
+| STORY_ID_PATTERN | JIRA-\d+ |
+```
+
+Or via CLI: `--story-pattern "JIRA-\d+"`
+
 ### Environment Layering
 
 Configuration files are merged in order:

package/dist/cli/coverage-types.d.ts

@@ -2,6 +2,7 @@ export interface CoverageOptions {
     stories?: string;
     sfs?: string;
     format?: "table" | "json" | "summary";
+    storyPattern?: string;
 }
 export interface UserStory {
     id: string;

package/dist/cli/coverage-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coverage-types.d.ts","sourceRoot":"","sources":["../../src/cli/coverage-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"coverage-types.d.ts","sourceRoot":"","sources":["../../src/cli/coverage-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/cli/coverage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../src/cli/coverage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,qBAAqB,CAAC;AAU7B,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB7E"}
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../src/cli/coverage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,qBAAqB,CAAC;AAY7B,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC7E"}

package/dist/cli/coverage.js

@@ -3,8 +3,10 @@ import { glob } from "glob";
 import chalk from "chalk";
 import { extractStoryIdFromFilename, extractStoryTitle, extractStoriesFromMultiFile, deduplicateStories, extractSfsStoryId, } from "./story-extractor.js";
 import { outputResults } from "./coverage-output.js";
+import { loadIgnorePatterns } from "./sfsignore.js";
+import { loadStoryIdPattern } from "./story-id-pattern.js";
 export async function coverageCommand(options) {
-    const storiesDir = options.stories ?? "stories";
+    const storiesDir = options.stories ?? ".";
     const sfsPattern = options.sfs ?? "**/*.sfs";
     const format = options.format ?? "table";
     // Only show header for non-JSON formats
@@ -13,7 +15,9 @@ export async function coverageCommand(options) {
         console.log();
     }
     try {
-        const result = await calculateCoverage(storiesDir, sfsPattern);
+        const ignorePatterns = await loadIgnorePatterns();
+        const storyIdPattern = await loadStoryIdPattern(undefined, options.storyPattern);
+        const result = await calculateCoverage(storiesDir, sfsPattern, ignorePatterns, storyIdPattern);
         outputResults(result, format);
     }
     catch (error) {
@@ -21,36 +25,36 @@ export async function coverageCommand(options) {
         process.exit(1);
     }
 }
-async function calculateCoverage(storiesDir, sfsPattern) {
-    const singleStoryFiles = await glob(`${storiesDir}/**/US-*.md`, {
-        ignore: ["**/node_modules/**", "**/*.sfs.md"],
+async function calculateCoverage(storiesDir, sfsPattern, ignorePatterns, storyIdPattern) {
+    const singleStoryFiles = await glob(`${storiesDir}/**/${storyIdPattern.glob}`, {
+        ignore: [...ignorePatterns, "**/*.sfs.md"],
     });
     const multiStoryFiles = await glob([
         `${storiesDir}/**/*user-stories*.md`,
         `${storiesDir}/**/*user.stories*.md`,
         `${storiesDir}/**/*user_stories*.md`,
     ], {
-        ignore: ["**/node_modules/**"],
+        ignore: ignorePatterns,
     });
     const sfsFiles = await glob(sfsPattern, {
-        ignore: ["**/node_modules/**"],
+        ignore: ignorePatterns,
     });
     const stories = [];
     for (const file of singleStoryFiles) {
-        const id = extractStoryIdFromFilename(file);
+        const id = extractStoryIdFromFilename(file, storyIdPattern.regex);
         if (id) {
             const title = await extractStoryTitle(file);
             stories.push({ id, title, path: file, source: "single" });
         }
     }
     for (const file of multiStoryFiles) {
-        const multiStories = await extractStoriesFromMultiFile(file);
+        const multiStories = await extractStoriesFromMultiFile(file, storyIdPattern.regex);
         stories.push(...multiStories);
     }
     const uniqueStories = deduplicateStories(stories);
     const flows = [];
     for (const file of sfsFiles) {
-        const storyId = await extractSfsStoryId(file);
+        const storyId = await extractSfsStoryId(file, storyIdPattern.regex);
         if (storyId) {
             flows.push({
                 storyId,

package/dist/cli/coverage.js.map

@@ -1 +1 @@
-{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/cli/coverage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/cli/coverage.ts"],"names":[],"mappings":"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"}

package/dist/cli/help-text.d.ts

@@ -0,0 +1,6 @@
+export declare const PROGRAM_HELP_AFTER = "\nQuick Start:\n  $ npx sfs init             Set up SFS in your project\n  $ npx sfs run              Run all SFS flow files\n  $ npx sfs coverage         Show user story coverage report\n\n  Run \"npx sfs <command> --help\" for detailed help on each command.\n";
+export declare const COVERAGE_HELP_AFTER = "\nExamples:\n  $ sfs coverage                         Scan entire project (default)\n  $ sfs coverage -f json                 Output as JSON\n  $ sfs coverage -f summary              Output compact summary\n  $ sfs coverage -s stories              Restrict scan to stories/ directory\n  $ sfs coverage --sfs \"src/**/*.sfs\"    Custom SFS file pattern\n  $ sfs coverage --story-pattern \"JIRA-\\d+\"   Use custom story ID pattern\n\nStory Detection:\n  Single-file stories:  Files matching US-*.md (or custom pattern prefix)\n  Multi-file stories:   Files matching *user-stories*.md, *user.stories*.md, *user_stories*.md\n  Story ID formats:     Headings (## US-001: Title), Bold (**US-001**), Lists (- US-001: Title), Tables (| US-001 | Title |)\n";
+export declare const RUN_HELP_AFTER = "\nExamples:\n  $ sfs run                              Run all *.sfs files\n  $ sfs run stories/US-AUTH-001.sfs      Run a specific file\n  $ sfs run \"stories/**/*.sfs\"           Run files matching a glob\n  $ sfs run -e local                     Use local environment config\n  $ sfs run -v                           Show verbose output\n  $ sfs run --headed                     Run browser in headed mode\n";
+export declare const INIT_HELP_AFTER = "\nExamples:\n  $ sfs init                  Create default project files\n  $ sfs init --force          Overwrite existing files\n  $ sfs init --skills-dir .agent/skills   Custom skills directory\n\nCreated Files:\n  sfs.config.md       Configuration (settings, personas, hooks)\n  stories/example.sfs Example flow file\n  .sfsignore          Coverage scan exclusions\n  .gitignore          Updated with SFS entries\n  <skills-dir>/sfs/   SFS skill files for AI assistants\n";
+export declare const VALIDATE_HELP_AFTER = "\nExamples:\n  $ sfs validate stories/US-AUTH-001.sfs        Validate a single file\n  $ sfs validate stories/*.sfs                  Validate all SFS files\n";
+//# sourceMappingURL=help-text.d.ts.map

package/dist/cli/help-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.d.ts","sourceRoot":"","sources":["../../src/cli/help-text.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,0QAO9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,ivBAa/B,CAAC;AAEF,eAAO,MAAM,cAAc,8ZAQ1B,CAAC;AAEF,eAAO,MAAM,eAAe,8dAY3B,CAAC;AAEF,eAAO,MAAM,mBAAmB,kKAI/B,CAAC"}

package/dist/cli/help-text.js

@@ -0,0 +1,50 @@
+export const PROGRAM_HELP_AFTER = `
+Quick Start:
+  $ npx sfs init             Set up SFS in your project
+  $ npx sfs run              Run all SFS flow files
+  $ npx sfs coverage         Show user story coverage report
+
+  Run "npx sfs <command> --help" for detailed help on each command.
+`;
+export const COVERAGE_HELP_AFTER = `
+Examples:
+  $ sfs coverage                         Scan entire project (default)
+  $ sfs coverage -f json                 Output as JSON
+  $ sfs coverage -f summary              Output compact summary
+  $ sfs coverage -s stories              Restrict scan to stories/ directory
+  $ sfs coverage --sfs "src/**/*.sfs"    Custom SFS file pattern
+  $ sfs coverage --story-pattern "JIRA-\\d+"   Use custom story ID pattern
+
+Story Detection:
+  Single-file stories:  Files matching US-*.md (or custom pattern prefix)
+  Multi-file stories:   Files matching *user-stories*.md, *user.stories*.md, *user_stories*.md
+  Story ID formats:     Headings (## US-001: Title), Bold (**US-001**), Lists (- US-001: Title), Tables (| US-001 | Title |)
+`;
+export const RUN_HELP_AFTER = `
+Examples:
+  $ sfs run                              Run all *.sfs files
+  $ sfs run stories/US-AUTH-001.sfs      Run a specific file
+  $ sfs run "stories/**/*.sfs"           Run files matching a glob
+  $ sfs run -e local                     Use local environment config
+  $ sfs run -v                           Show verbose output
+  $ sfs run --headed                     Run browser in headed mode
+`;
+export const INIT_HELP_AFTER = `
+Examples:
+  $ sfs init                  Create default project files
+  $ sfs init --force          Overwrite existing files
+  $ sfs init --skills-dir .agent/skills   Custom skills directory
+
+Created Files:
+  sfs.config.md       Configuration (settings, personas, hooks)
+  stories/example.sfs Example flow file
+  .sfsignore          Coverage scan exclusions
+  .gitignore          Updated with SFS entries
+  <skills-dir>/sfs/   SFS skill files for AI assistants
+`;
+export const VALIDATE_HELP_AFTER = `
+Examples:
+  $ sfs validate stories/US-AUTH-001.sfs        Validate a single file
+  $ sfs validate stories/*.sfs                  Validate all SFS files
+`;
+//# sourceMappingURL=help-text.js.map

package/dist/cli/help-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../../src/cli/help-text.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;CAOjC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;CAalC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;CAQ7B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;CAY9B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;CAIlC,CAAC"}

package/dist/cli/init-templates.d.ts

@@ -1,5 +1,6 @@
 export declare const CONFIG_TEMPLATE = "# SFS Configuration\n\n## Settings\n\n| Setting | Value |\n|---------|-------|\n| ENTRYPOINT | http://localhost:3000 |\n| LOCALE | en-US |\n| TIMEOUT | 30000 |\n| ON FAILURE | capture screenshot |\n| PRESERVE STATE ON FAILURE | true |\n\n## Hints\n\n- Add context about your application here\n- Describe the UI layout, navigation patterns\n- Note any authentication requirements\n- Mention relevant test data or fixtures\n\n## Personas\n\n| Persona | Username | Password | Description |\n|---------|----------|----------|-------------|\n| user | testuser@example.com | {{TEST_USER_PASSWORD}} | Standard user account |\n| admin | admin@example.com | {{ADMIN_PASSWORD}} | Administrator with full access |\n| guest | | | Unauthenticated visitor |\n\n## Before Session\n\n```sfs\n# Validate environment\nASSERT file .env exists\nASSERT env-check\n\n# Start services (uncomment as needed)\n# SHELL docker compose up -d\n# WAIT FOR http://localhost:3000 to respond\n```\n\n## After Session\n\n```sfs\n# Collect logs\nSHELL mkdir -p {{RUN_DIR}}\n# SHELL docker compose logs > {{RUN_DIR}}/docker.log\n```\n\n## Before Each\n\n```sfs\n# Reset browser state\nCLEAR cookies\nCLEAR local storage\n```\n\n## After Each\n\n```sfs\n# Log completion\nSHELL echo \"$(date): Completed {{SFS_NAME}}\" >> {{RUN_DIR}}/execution.log\n```\n";
 export declare const EXAMPLE_SFS = "# example.sfs\n# Example: Basic page load verification\n\nSTORY       EXAMPLE-001\nENTRYPOINT  http://localhost:3000\nLOCALE      en-US\n\nHINT        Replace with your application context\nHINT        Describe the page layout and key elements\n\nON FAILURE  capture screenshot and describe visible state\n\nBEFORE THIS\n  ASSERT port 3000 is open\n\n--- page-load ---\nAS user\nOBSERVE page has loaded\nOBSERVE main content is visible\n\n--- verify-elements ---\n# Add your verification steps here\nOBSERVE expected elements are present\n\nDONE WHEN page loaded successfully with expected content\n";
 export declare const GITIGNORE_ADDITIONS = "\n# SFS local config (may contain sensitive paths/settings)\nsfs.config.local.md\n\n# SFS run outputs\n/runs/\n/stories/runs/\n*.report.md\n\n# Failure screenshots\n/failures/\n";
+export declare const SFSIGNORE_TEMPLATE = "# .sfsignore - Directories and files to exclude from SFS coverage scanning\n# Syntax: one pattern per line\n# Lines starting with # are comments\n# Bare directory names are auto-expanded to **/name/**\n# Patterns with * or / are used as-is\n\n# Package managers\nnode_modules\n\n# Build outputs\ndist\nbuild\ncoverage\n\n# Version control\n.git\n\n# IDE files\n.vscode\n.idea\n\n# OS files\n.DS_Store\nThumbs.db\n";
 export declare const SFS_SKILLS: string[];
 //# sourceMappingURL=init-templates.d.ts.map

package/dist/cli/init-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,0yCA6D3B,CAAC;AAEF,eAAO,MAAM,WAAW,4lBAyBvB,CAAC;AAEF,eAAO,MAAM,mBAAmB,sLAW/B,CAAC;AAEF,eAAO,MAAM,UAAU,UAMtB,CAAC"}
+{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,0yCA6D3B,CAAC;AAEF,eAAO,MAAM,WAAW,4lBAyBvB,CAAC;AAEF,eAAO,MAAM,mBAAmB,sLAW/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,kaAwB9B,CAAC;AAEF,eAAO,MAAM,UAAU,UAMtB,CAAC"}

package/dist/cli/init-templates.js

@@ -98,6 +98,31 @@ sfs.config.local.md
 # Failure screenshots
 /failures/
 `;
+export const SFSIGNORE_TEMPLATE = `# .sfsignore - Directories and files to exclude from SFS coverage scanning
+# Syntax: one pattern per line
+# Lines starting with # are comments
+# Bare directory names are auto-expanded to **/name/**
+# Patterns with * or / are used as-is
+
+# Package managers
+node_modules
+
+# Build outputs
+dist
+build
+coverage
+
+# Version control
+.git
+
+# IDE files
+.vscode
+.idea
+
+# OS files
+.DS_Store
+Thumbs.db
+`;
 export const SFS_SKILLS = [
     "from-user-story-to-sfs.md",
     "write-sfs-session-reports.md",

package/dist/cli/init-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-templates.js","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6D9B,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyB1B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;CAWlC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2BAA2B;IAC3B,8BAA8B;IAC9B,6BAA6B;IAC7B,wBAAwB;IACxB,oBAAoB;CACrB,CAAC"}
+{"version":3,"file":"init-templates.js","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6D9B,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyB1B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;CAWlC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBjC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2BAA2B;IAC3B,8BAA8B;IAC9B,6BAA6B;IAC7B,wBAAwB;IACxB,oBAAoB;CACrB,CAAC"}

package/dist/cli/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAkBA,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqErE"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAoBA,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ErE"}

package/dist/cli/init.js

@@ -1,14 +1,16 @@
 import { writeFile, readFile, access, mkdir, readdir, copyFile, } from "fs/promises";
 import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 import chalk from "chalk";
 import { detectMcpIntegration } from "../utils/mcp-detector.js";
-import { CONFIG_TEMPLATE, EXAMPLE_SFS, GITIGNORE_ADDITIONS, SFS_SKILLS, } from "./init-templates.js";
+import { CONFIG_TEMPLATE, EXAMPLE_SFS, GITIGNORE_ADDITIONS, SFSIGNORE_TEMPLATE, SFS_SKILLS, } from "./init-templates.js";
 export async function initCommand(options) {
     console.log(chalk.blue("SFS - Initialize Project"));
     console.log();
     const filesToCreate = [
         { path: "sfs.config.md", content: CONFIG_TEMPLATE },
         { path: "stories/example.sfs", content: EXAMPLE_SFS },
+        { path: ".sfsignore", content: SFSIGNORE_TEMPLATE },
     ];
     for (const file of filesToCreate) {
         const exists = await fileExists(file.path);
@@ -57,6 +59,7 @@ export async function initCommand(options) {
     console.log(chalk.gray("  2. Define personas with credentials for your environment"));
     console.log(chalk.gray("  3. Create your first flow: stories/US-XXX-001.sfs"));
     console.log(chalk.gray("  4. Run: npx sfs run"));
+    console.log(chalk.gray("  5. Customize .sfsignore to exclude directories from coverage scanning"));
 }
 async function fileExists(path) {
     try {
@@ -93,51 +96,53 @@ async function detectOrCreateSkillsDir(preferred) {
 async function copySkills(destDir, force) {
     console.log();
     console.log(chalk.blue(`Copying SFS skills to ${destDir}...`));
-    // Get the SFS package skills directory
-    // In development: relative to this file
-    // In production: from the package's skills directory
     const packageSkillsDir = await findPackageSkillsDir();
     if (!packageSkillsDir) {
         console.log(chalk.yellow("⚠ Could not locate SFS skills directory"));
         return;
     }
+    // Create sfs/ subdirectory under destination
+    await ensureDir(join(destDir, "sfs"));
     for (const skillFile of SFS_SKILLS) {
-        const srcPath = join(packageSkillsDir, skillFile);
-        const destPath = join(destDir, skillFile);
+        const srcPath = join(packageSkillsDir, "sfs", skillFile);
+        const destPath = join(destDir, "sfs", skillFile);
         try {
             const srcExists = await fileExists(srcPath);
             if (!srcExists) {
-                console.log(chalk.yellow(`⚠ Skill not found: ${skillFile}`));
+                console.log(chalk.yellow(`⚠ Skill not found: sfs/${skillFile}`));
                 continue;
             }
             const destExists = await fileExists(destPath);
             if (destExists && !force) {
-                console.log(chalk.gray(`⊘ ${skillFile} already exists`));
+                console.log(chalk.gray(`⊘ sfs/${skillFile} already exists`));
             }
             else {
                 await copyFile(srcPath, destPath);
-                console.log(chalk.green(`✓ Copied ${skillFile}`));
+                console.log(chalk.green(`✓ Copied sfs/${skillFile}`));
             }
         }
         catch (err) {
-            console.log(chalk.yellow(`⚠ Could not copy ${skillFile}: ${err instanceof Error ? err.message : "Unknown error"}`));
+            console.log(chalk.yellow(`⚠ Could not copy sfs/${skillFile}: ${err instanceof Error ? err.message : "Unknown error"}`));
         }
     }
 }
 async function findPackageSkillsDir() {
-    // Try to find the skills directory relative to the current module
+    // Resolve package root from compiled dist/cli/init.js → package root
+    const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
     const candidates = [
+        // Package-relative: works with npx, global install, local install
+        join(packageRoot, "skills"),
         // Development: when running from source
         join(process.cwd(), ".claude", "skills"),
-        // Production: when installed as package (look in node_modules)
-        join(process.cwd(), "node_modules", "@sfs", "cli", "skills"),
+        // Production: when installed as package in project node_modules
+        join(process.cwd(), "node_modules", "@overshift", "sfs", "skills"),
         join(process.cwd(), "node_modules", "sfs", "skills"),
     ];
     for (const candidate of candidates) {
-        if (await fileExists(candidate)) {
+        const sfsSubdir = join(candidate, "sfs");
+        if (await fileExists(sfsSubdir)) {
             try {
-                const files = await readdir(candidate);
-                // Check if it has at least one of our skill files
+                const files = await readdir(sfsSubdir);
                 if (files.some((f) => SFS_SKILLS.includes(f))) {
                     return candidate;
                 }

package/dist/cli/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/sfsignore.d.ts

@@ -0,0 +1,5 @@
+export declare function getDefaultIgnorePatterns(): string[];
+export declare function parseSfsIgnore(content: string): string[];
+export declare function normalizeIgnorePattern(pattern: string): string;
+export declare function loadIgnorePatterns(cwd?: string): Promise<string[]>;
+//# sourceMappingURL=sfsignore.d.ts.map

package/dist/cli/sfsignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfsignore.d.ts","sourceRoot":"","sources":["../../src/cli/sfsignore.ts"],"names":[],"mappings":"AAGA,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAQnD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa9D;AAED,wBAAsB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYxE"}

package/dist/cli/sfsignore.js

@@ -0,0 +1,45 @@
+import { readFile } from "fs/promises";
+import { join } from "path";
+export function getDefaultIgnorePatterns() {
+    return [
+        "**/node_modules/**",
+        "**/.git/**",
+        "**/dist/**",
+        "**/build/**",
+        "**/coverage/**",
+    ];
+}
+export function parseSfsIgnore(content) {
+    return content
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith("#"));
+}
+export function normalizeIgnorePattern(pattern) {
+    // If it contains glob characters, use as-is
+    if (pattern.includes("*")) {
+        return pattern;
+    }
+    // Strip trailing slash for bare directory name check
+    const stripped = pattern.replace(/\/+$/, "");
+    // If the stripped form contains a path separator, it's a path — use as-is
+    if (stripped.includes("/")) {
+        return pattern;
+    }
+    // Bare directory name — wrap in glob
+    return `**/${stripped}/**`;
+}
+export async function loadIgnorePatterns(cwd) {
+    const defaults = getDefaultIgnorePatterns();
+    const dir = cwd ?? process.cwd();
+    const sfsignorePath = join(dir, ".sfsignore");
+    try {
+        const content = await readFile(sfsignorePath, "utf-8");
+        const userPatterns = parseSfsIgnore(content).map(normalizeIgnorePattern);
+        return [...defaults, ...userPatterns];
+    }
+    catch {
+        return defaults;
+    }
+}
+//# sourceMappingURL=sfsignore.js.map

package/dist/cli/sfsignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfsignore.js","sourceRoot":"","sources":["../../src/cli/sfsignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,oBAAoB;QACpB,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,4CAA4C;IAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,qDAAqD;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,0EAA0E;IAC1E,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,qCAAqC;IACrC,OAAO,MAAM,QAAQ,KAAK,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAY;IACnD,MAAM,QAAQ,GAAG,wBAAwB,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,YAAY,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/story-extractor.d.ts

@@ -1,7 +1,7 @@
 import type { UserStory } from "./coverage-types.js";
-export declare function extractStoryIdFromFilename(filePath: string): string | undefined;
+export declare function extractStoryIdFromFilename(filePath: string, storyIdPattern?: RegExp): string | undefined;
 export declare function extractStoryTitle(filePath: string): Promise<string | undefined>;
-export declare function extractStoriesFromMultiFile(filePath: string): Promise<UserStory[]>;
+export declare function extractStoriesFromMultiFile(filePath: string, storyIdPattern?: RegExp): Promise<UserStory[]>;
 export declare function deduplicateStories(stories: UserStory[]): UserStory[];
-export declare function extractSfsStoryId(filePath: string): Promise<string | undefined>;
+export declare function extractSfsStoryId(filePath: string, storyIdPattern?: RegExp): Promise<string | undefined>;
 //# sourceMappingURL=story-extractor.d.ts.map

package/dist/cli/story-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"story-extractor.d.ts","sourceRoot":"","sources":["../../src/cli/story-extractor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,EAAE,CAAC,CAsFtB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAcpE;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}
+{"version":3,"file":"story-extractor.d.ts","sourceRoot":"","sources":["../../src/cli/story-extractor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AASrD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAuFtB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAcpE;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B"}

package/dist/cli/story-extractor.js

@@ -1,8 +1,14 @@
 import { readFile } from "fs/promises";
 import { basename } from "path";
-export function extractStoryIdFromFilename(filePath) {
+import { DEFAULT_STORY_ID_PATTERN } from "./story-id-pattern.js";
+const DEFAULT_RE = new RegExp(DEFAULT_STORY_ID_PATTERN, "i");
+function idRegex(pattern) {
+    return pattern ?? DEFAULT_RE;
+}
+export function extractStoryIdFromFilename(filePath, storyIdPattern) {
     const name = basename(filePath, ".md");
-    const match = name.match(/^(US-[A-Z0-9-]+)/i);
+    const re = new RegExp(`^(${idRegex(storyIdPattern).source})`, "i");
+    const match = name.match(re);
     if (match?.[1]) {
         return match[1].toUpperCase();
     }
@@ -11,7 +17,7 @@ export function extractStoryIdFromFilename(filePath) {
 export async function extractStoryTitle(filePath) {
     try {
         const content = await readFile(filePath, "utf-8");
-        const lines = content.split("\n");
+        const lines = content.split(/\r?\n/);
         for (const line of lines) {
             const match = line.match(/^#\s+(.+)$/);
             if (match?.[1]) {
@@ -24,16 +30,18 @@ export async function extractStoryTitle(filePath) {
     }
     return undefined;
 }
-export async function extractStoriesFromMultiFile(filePath) {
+export async function extractStoriesFromMultiFile(filePath, storyIdPattern) {
     const stories = [];
+    const idSrc = idRegex(storyIdPattern).source;
     try {
         const content = await readFile(filePath, "utf-8");
-        const lines = content.split("\n");
+        const lines = content.split(/\r?\n/);
         let currentStoryId;
         let currentTitle;
         for (const line of lines) {
-            // Look for story IDs in headings: ## US-XXX-001: Title or ### US-XXX-001 - Title
-            const headingMatch = line.match(/^#{1,4}\s+(US-[A-Z0-9-]+)[\s:|-]+(.*)$/i);
+            // Headings: ## US-XXX-001: Title
+            const headingRe = new RegExp(`^#{1,4}\\s+(${idSrc})[\\s:|-]+(.*)$`, "i");
+            const headingMatch = line.match(headingRe);
             if (headingMatch?.[1]) {
                 if (currentStoryId) {
                     stories.push({
@@ -47,8 +55,9 @@ export async function extractStoriesFromMultiFile(filePath) {
                 currentTitle = headingMatch[2]?.trim() || undefined;
                 continue;
             }
-            // Also look for story IDs in bold: **US-XXX-001** or **US-XXX-001:** or **US-XXX-001**:
-            const boldMatch = line.match(/\*\*(US-[A-Z0-9-]+):?\*\*[\s:|-]*(.*)$/i);
+            // Bold: **US-XXX-001**: Description
+            const boldRe = new RegExp(`\\*\\*(${idSrc}):?\\*\\*[\\s:|-]*(.*)$`, "i");
+            const boldMatch = line.match(boldRe);
             if (boldMatch?.[1]) {
                 if (currentStoryId) {
                     stories.push({
@@ -62,8 +71,9 @@ export async function extractStoriesFromMultiFile(filePath) {
                 currentTitle = boldMatch[2]?.trim() || undefined;
                 continue;
             }
-            // Look for story IDs in list items: - US-XXX-001: Title or * US-XXX-001 - Title
-            const listMatch = line.match(/^[\s]*[-*]\s+(US-[A-Z0-9-]+)[\s:|-]+(.*)$/i);
+            // List items: - US-XXX-001: Title
+            const listRe = new RegExp(`^[\\s]*[-*]\\s+(${idSrc})[\\s:|-]+(.*)$`, "i");
+            const listMatch = line.match(listRe);
             if (listMatch?.[1]) {
                 stories.push({
                     id: listMatch[1].toUpperCase(),
@@ -73,8 +83,9 @@ export async function extractStoriesFromMultiFile(filePath) {
                 });
                 continue;
             }
-            // Look for story IDs in table rows: | US-XXX-001 | Title | ... |
-            const tableMatch = line.match(/\|\s*(US-[A-Z0-9-]+)\s*\|([^|]*)\|/i);
+            // Table rows: | US-XXX-001 | Title | ... |
+            const tableRe = new RegExp(`\\|\\s*(${idSrc})\\s*\\|([^|]*)\\|`, "i");
+            const tableMatch = line.match(tableRe);
             if (tableMatch?.[1]) {
                 stories.push({
                     id: tableMatch[1].toUpperCase(),
@@ -111,12 +122,14 @@ export function deduplicateStories(stories) {
     }
     return [...storyMap.values()];
 }
-export async function extractSfsStoryId(filePath) {
+export async function extractSfsStoryId(filePath, storyIdPattern) {
+    const idSrc = idRegex(storyIdPattern).source;
     try {
         const content = await readFile(filePath, "utf-8");
-        const lines = content.split("\n");
+        const lines = content.split(/\r?\n/);
+        const re = new RegExp(`^STORY\\s+(${idSrc})`, "i");
         for (const line of lines) {
-            const match = line.match(/^STORY\s+(US-[A-Z0-9-]+)/i);
+            const match = line.match(re);
             if (match?.[1]) {
                 return match[1].toUpperCase();
             }