@bradygaster/squad-sdk 0.9.1 → 0.9.2-insider.1

package/dist/config/init.js

@@ -7,10 +7,9 @@
  *
  * @module config/init
  */
-import { mkdir, writeFile, appendFile, unlink } from 'fs/promises';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { existsSync, cpSync, statSync, mkdirSync, readFileSync, readdirSync } from 'fs';
+import { FSStorageProvider } from '../storage/index.js';
 import { execFileSync } from 'node:child_process';
 import { MODELS } from '../runtime/constants.js';
 import { getRoleById } from '../roles/index.js';
@@ -20,17 +19,17 @@ import { getRoleById } from '../roles/index.js';
 /**
  * Get the SDK templates directory path.
  */
-export function getSDKTemplatesDir() {
+export function getSDKTemplatesDir(storage = new FSStorageProvider()) {
     // Use fileURLToPath for cross-platform compatibility (handles Windows drive letters, URL encoding)
     const currentDir = dirname(fileURLToPath(import.meta.url));
     // Try relative to this file (in dist/)
     const distPath = join(currentDir, '../../templates');
-    if (existsSync(distPath)) {
+    if (storage.existsSync(distPath)) {
         return distPath;
     }
     // Try relative to package root (for dev)
     const pkgPath = join(currentDir, '../../../templates');
-    if (existsSync(pkgPath)) {
+    if (storage.existsSync(pkgPath)) {
         return pkgPath;
     }
     return null;
@@ -38,18 +37,18 @@ export function getSDKTemplatesDir() {
 /**
  * Copy a directory recursively.
  */
-function copyRecursiveSync(src, dest) {
-    if (!existsSync(dest)) {
-        mkdirSync(dest, { recursive: true });
+function copyRecursiveSync(src, dest, storage = new FSStorageProvider()) {
+    if (!storage.existsSync(dest)) {
+        storage.mkdirSync(dest, { recursive: true });
     }
-    for (const entry of statSync(src).isDirectory() ? readdirSync(src) : []) {
+    for (const entry of storage.isDirectorySync(src) ? storage.listSync(src) : []) {
         const srcPath = join(src, entry);
         const destPath = join(dest, entry);
-        if (statSync(srcPath).isDirectory()) {
-            copyRecursiveSync(srcPath, destPath);
+        if (storage.isDirectorySync(srcPath)) {
+            copyRecursiveSync(srcPath, destPath, storage);
         }
         else {
-            cpSync(srcPath, destPath);
+            storage.copySync(srcPath, destPath);
         }
     }
 }
@@ -95,82 +94,82 @@ function formatModelArray(chain) {
  */
 function generateTypeScriptConfig(options) {
     const { projectName, projectDescription, agents } = options;
-    return `import type { SquadConfig } from '@bradygaster/squad';
-
-/**
- * Squad Configuration for ${projectName}
- * ${projectDescription ? `\n * ${projectDescription}` : ''}
- */
-const config: SquadConfig = {
-  version: '1.0.0',
-  
-  models: {
-    defaultModel: '${MODELS.DEFAULT}',
-    defaultTier: 'standard',
-    fallbackChains: {
-      premium: ${formatModelArray(MODELS.FALLBACK_CHAINS.premium)},
-      standard: ${formatModelArray(MODELS.FALLBACK_CHAINS.standard)},
-      fast: ${formatModelArray(MODELS.FALLBACK_CHAINS.fast)}
-    },
-    preferSameProvider: true,
-    respectTierCeiling: true,
-    nuclearFallback: {
-      enabled: false,
-      model: '${MODELS.NUCLEAR_FALLBACK}',
-      maxRetriesBeforeNuclear: ${MODELS.NUCLEAR_MAX_RETRIES}
-    }
-  },
-  
-  routing: {
-    rules: [
-      {
-        workType: 'feature-dev',
-        agents: ['@${agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'bug-fix',
-        agents: ['@${agents.find(a => a.role === 'developer')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'testing',
-        agents: ['@${agents.find(a => a.role === 'tester')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'documentation',
-        agents: ['@${agents.find(a => a.role === 'scribe')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      }
-    ],
-    governance: {
-      eagerByDefault: true,
-      scribeAutoRuns: false,
-      allowRecursiveSpawn: false
-    }
-  },
-  
-  casting: {
-    allowlistUniverses: [
-      'The Usual Suspects',
-      'Breaking Bad',
-      'The Wire',
-      'Firefly'
-    ],
-    overflowStrategy: 'generic',
-    universeCapacity: {}
-  },
-  
-  platforms: {
-    vscode: {
-      disableModelSelection: false,
-      scribeMode: 'sync'
-    }
-  }
-};
-
-export default config;
+    return `import type { SquadConfig } from '@bradygaster/squad';
+
+/**
+ * Squad Configuration for ${projectName}
+ * ${projectDescription ? `\n * ${projectDescription}` : ''}
+ */
+const config: SquadConfig = {
+  version: '1.0.0',
+  
+  models: {
+    defaultModel: '${MODELS.DEFAULT}',
+    defaultTier: 'standard',
+    fallbackChains: {
+      premium: ${formatModelArray(MODELS.FALLBACK_CHAINS.premium)},
+      standard: ${formatModelArray(MODELS.FALLBACK_CHAINS.standard)},
+      fast: ${formatModelArray(MODELS.FALLBACK_CHAINS.fast)}
+    },
+    preferSameProvider: true,
+    respectTierCeiling: true,
+    nuclearFallback: {
+      enabled: false,
+      model: '${MODELS.NUCLEAR_FALLBACK}',
+      maxRetriesBeforeNuclear: ${MODELS.NUCLEAR_MAX_RETRIES}
+    }
+  },
+  
+  routing: {
+    rules: [
+      {
+        workType: 'feature-dev',
+        agents: ['@${agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'bug-fix',
+        agents: ['@${agents.find(a => a.role === 'developer')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'testing',
+        agents: ['@${agents.find(a => a.role === 'tester')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'documentation',
+        agents: ['@${agents.find(a => a.role === 'scribe')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      }
+    ],
+    governance: {
+      eagerByDefault: true,
+      scribeAutoRuns: false,
+      allowRecursiveSpawn: false
+    }
+  },
+  
+  casting: {
+    allowlistUniverses: [
+      'The Usual Suspects',
+      'Breaking Bad',
+      'The Wire',
+      'Firefly'
+    ],
+    overflowStrategy: 'generic',
+    universeCapacity: {}
+  },
+  
+  platforms: {
+    vscode: {
+      disableModelSelection: false,
+      scribeMode: 'sync'
+    }
+  }
+};
+
+export default config;
 `;
 }
 /**
@@ -367,26 +366,26 @@ function generateCharter(agent, projectName, projectDescription) {
     const template = AGENT_TEMPLATES[agent.role];
     const displayName = agent.displayName || template?.displayName || titleCase(agent.name);
     const description = template?.description || 'Team member focused on their assigned responsibilities.';
-    return `# ${displayName} — ${titleCase(agent.role)}
-
-${description}
-
-## Project Context
-
-**Project:** ${projectName}
-${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
-
-## Responsibilities
-
-- Collaborate with team members on assigned work
-- Maintain code quality and project standards
-- Document decisions and progress in history
-
-## Work Style
-
-- Read project context and team decisions before starting work
-- Communicate clearly with team members
-- Follow established patterns and conventions
+    return `# ${displayName} — ${titleCase(agent.role)}
+
+${description}
+
+## Project Context
+
+**Project:** ${projectName}
+${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
+
+## Responsibilities
+
+- Collaborate with team members on assigned work
+- Maintain code quality and project standards
+- Document decisions and progress in history
+
+## Work Style
+
+- Read project context and team decisions before starting work
+- Communicate clearly with team members
+- Follow established patterns and conventions
 `;
 }
 /**
@@ -395,22 +394,22 @@ ${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
 function generateInitialHistory(agent, projectName, projectDescription, userName) {
     const displayName = agent.displayName || AGENT_TEMPLATES[agent.role]?.displayName || titleCase(agent.name);
     const now = new Date().toISOString().split('T')[0];
-    return `# Project Context
-
-${userName ? `- **Owner:** ${userName}\n` : ''}- **Project:** ${projectName}
-${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${now}
-
-## Core Context
-
-Agent ${displayName} initialized and ready for work.
-
-## Recent Updates
-
-📌 Team initialized on ${now}
-
-## Learnings
-
-Initial setup complete.
+    return `# Project Context
+
+${userName ? `- **Owner:** ${userName}\n` : ''}- **Project:** ${projectName}
+${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${now}
+
+## Core Context
+
+Agent ${displayName} initialized and ready for work.
+
+## Recent Updates
+
+📌 Team initialized on ${now}
+
+## Learnings
+
+Initial setup complete.
 `;
 }
 /**
@@ -467,7 +466,7 @@ const FRAMEWORK_WORKFLOWS = [
     'squad-triage.yml',
     'sync-squad-labels.yml',
 ];
-export async function initSquad(options) {
+export async function initSquad(options, storage = new FSStorageProvider()) {
     const { teamRoot, projectName, projectDescription, agents, configFormat = 'typescript', userName, skipExisting = true, includeWorkflows = true, includeTemplates = true, includeMcpConfig = true, projectType = 'unknown', version = '0.0.0', } = options;
     const createdFiles = [];
     const skippedFiles = [];
@@ -498,23 +497,22 @@ export async function initSquad(options) {
     };
     // Helper to write file (respects skipExisting)
     const writeIfNotExists = async (filePath, content) => {
-        if (existsSync(filePath) && skipExisting) {
+        if (storage.existsSync(filePath) && skipExisting) {
             skippedFiles.push(toRelativePath(filePath));
             return false;
         }
-        await mkdir(dirname(filePath), { recursive: true });
-        await writeFile(filePath, content, 'utf-8');
+        await storage.write(filePath, content);
         createdFiles.push(toRelativePath(filePath));
         return true;
     };
     // Helper to copy file (respects skipExisting)
     const copyIfNotExists = async (src, dest) => {
-        if (existsSync(dest) && skipExisting) {
+        if (storage.existsSync(dest) && skipExisting) {
             skippedFiles.push(toRelativePath(dest));
             return false;
         }
-        await mkdir(dirname(dest), { recursive: true });
-        cpSync(src, dest);
+        await storage.mkdir(dirname(dest), { recursive: true });
+        storage.copySync(src, dest);
         createdFiles.push(toRelativePath(dest));
         return true;
     };
@@ -534,19 +532,45 @@ export async function initSquad(options) {
         join(squadDir, 'log'),
     ];
     for (const dir of directories) {
-        if (!existsSync(dir)) {
-            await mkdir(dir, { recursive: true });
+        if (!storage.existsSync(dir)) {
+            await storage.mkdir(dir, { recursive: true });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Scaffold .squad/casting/ files (policy, registry, history)
+    // -------------------------------------------------------------------------
+    const castingDir = join(squadDir, 'casting');
+    const castingFiles = [
+        { name: 'policy.json', templateName: 'casting-policy.json', fallback: JSON.stringify({ casting_policy_version: '1.1', allowlist_universes: [], universe_capacity: {} }, null, 2) + '\n' },
+        { name: 'registry.json', templateName: 'casting-registry.json', fallback: JSON.stringify({ agents: {} }, null, 2) + '\n' },
+        { name: 'history.json', templateName: 'casting-history.json', fallback: JSON.stringify({ universe_usage_history: [], assignment_cast_snapshots: {} }, null, 2) + '\n' },
+    ];
+    for (const cf of castingFiles) {
+        const dest = join(castingDir, cf.name);
+        if (!storage.existsSync(dest)) {
+            // Try to copy from SDK templates first, fall back to inline defaults
+            const templateSrc = templatesDir ? join(templatesDir, cf.templateName) : null;
+            if (templateSrc && storage.existsSync(templateSrc)) {
+                storage.copySync(templateSrc, dest);
+            }
+            else {
+                await storage.write(dest, cf.fallback);
+            }
+            createdFiles.push(toRelativePath(dest));
+        }
+        else {
+            skippedFiles.push(toRelativePath(dest));
         }
     }
     // -------------------------------------------------------------------------
     // Create .squad/config.json for squad settings
     // -------------------------------------------------------------------------
     const squadConfigPath = join(squadDir, 'config.json');
-    if (!existsSync(squadConfigPath)) {
+    if (!storage.existsSync(squadConfigPath)) {
         // Detect platform from git remote for config
         let detectedPlatform;
         try {
-            const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], { cwd: teamRoot, encoding: 'utf-8' }).trim();
+            const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], { cwd: teamRoot, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
             const remoteUrlLower = remoteUrl.toLowerCase();
             if (remoteUrlLower.includes('dev.azure.com') || remoteUrlLower.includes('visualstudio.com') || remoteUrlLower.includes('ssh.dev.azure.com')) {
                 detectedPlatform = 'azure-devops';
@@ -566,7 +590,7 @@ export async function initSquad(options) {
             // to discover available work item types for the project.
             let introspectedTypes;
             try {
-                const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], { cwd: teamRoot, encoding: 'utf-8' }).trim();
+                const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], { cwd: teamRoot, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
                 // Parse org/project from remote URL for introspection
                 const httpsMatch = remoteUrl.match(/dev\.azure\.com\/([^/]+)\/([^/]+)\/_git/i);
                 const sshMatch = remoteUrl.match(/ssh\.dev\.azure\.com:v3\/([^/]+)\/([^/]+)\//i);
@@ -605,7 +629,7 @@ export async function initSquad(options) {
         if (options.extractionDisabled) {
             squadConfig.extractionDisabled = true;
         }
-        await writeFile(squadConfigPath, JSON.stringify(squadConfig, null, 2), 'utf-8');
+        await storage.write(squadConfigPath, JSON.stringify(squadConfig, null, 2));
         createdFiles.push(toRelativePath(squadConfigPath));
     }
     // -------------------------------------------------------------------------
@@ -633,7 +657,6 @@ export async function initSquad(options) {
     const agentsDir = join(squadDir, 'agents');
     for (const agent of agents) {
         const agentDir = join(agentsDir, agent.name);
-        await mkdir(agentDir, { recursive: true });
         agentDirs.push(agentDir);
         // Create charter.md
         const charterPath = join(agentDir, 'charter.md');
@@ -650,27 +673,27 @@ export async function initSquad(options) {
     const identityDir = join(squadDir, 'identity');
     const nowMdPath = join(identityDir, 'now.md');
     const wisdomMdPath = join(identityDir, 'wisdom.md');
-    const nowContent = `---
-updated_at: ${new Date().toISOString()}
-focus_area: Initial setup
-active_issues: []
----
-
-# What We're Focused On
-
-Getting started. Updated by coordinator at session start.
+    const nowContent = `---
+updated_at: ${new Date().toISOString()}
+focus_area: Initial setup
+active_issues: []
+---
+
+# What We're Focused On
+
+Getting started. Updated by coordinator at session start.
 `;
-    const wisdomContent = `---
-last_updated: ${new Date().toISOString()}
----
-
-# Team Wisdom
-
-Reusable patterns and heuristics learned through work. NOT transcripts — each entry is a distilled, actionable insight.
-
-## Patterns
-
-<!-- Append entries below. Format: **Pattern:** description. **Context:** when it applies. -->
+    const wisdomContent = `---
+last_updated: ${new Date().toISOString()}
+---
+
+# Team Wisdom
+
+Reusable patterns and heuristics learned through work. NOT transcripts — each entry is a distilled, actionable insight.
+
+## Patterns
+
+<!-- Append entries below. Format: **Pattern:** description. **Context:** when it applies. -->
 `;
     await writeIfNotExists(nowMdPath, nowContent);
     await writeIfNotExists(wisdomMdPath, wisdomContent);
@@ -678,70 +701,70 @@ Reusable patterns and heuristics learned through work. NOT transcripts — each
     // Create ceremonies.md
     // -------------------------------------------------------------------------
     const ceremoniesDest = join(squadDir, 'ceremonies.md');
-    if (templatesDir && existsSync(join(templatesDir, 'ceremonies.md'))) {
+    if (templatesDir && storage.existsSync(join(templatesDir, 'ceremonies.md'))) {
         await copyIfNotExists(join(templatesDir, 'ceremonies.md'), ceremoniesDest);
     }
     // -------------------------------------------------------------------------
     // Create decisions.md (canonical location at squad root)
     // -------------------------------------------------------------------------
     const decisionsPath = join(squadDir, 'decisions.md');
-    const decisionsContent = `# Squad Decisions
-
-## Active Decisions
-
-No decisions recorded yet.
-
-## Governance
-
-- All meaningful changes require team consensus
-- Document architectural decisions here
-- Keep history focused on work, decisions focused on direction
+    const decisionsContent = `# Squad Decisions
+
+## Active Decisions
+
+No decisions recorded yet.
+
+## Governance
+
+- All meaningful changes require team consensus
+- Document architectural decisions here
+- Keep history focused on work, decisions focused on direction
 `;
     await writeIfNotExists(decisionsPath, decisionsContent);
     // -------------------------------------------------------------------------
     // Create team.md (required by shell lifecycle)
     // -------------------------------------------------------------------------
     const teamPath = join(squadDir, 'team.md');
-    const teamContent = `# Squad Team
-
-> ${projectDescription || projectName}
-
-## Coordinator
-
-| Name | Role | Notes |
-|------|------|-------|
-| Squad | Coordinator | Routes work, enforces handoffs and reviewer gates. |
-
-## Members
-
-| Name | Role | Charter | Status |
-|------|------|---------|--------|
-
-## Project Context
-
-- **Project:** ${projectName}
-${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${new Date().toISOString().split('T')[0]}
+    const teamContent = `# Squad Team
+
+> ${projectDescription || projectName}
+
+## Coordinator
+
+| Name | Role | Notes |
+|------|------|-------|
+| Squad | Coordinator | Routes work, enforces handoffs and reviewer gates. |
+
+## Members
+
+| Name | Role | Charter | Status |
+|------|------|---------|--------|
+
+## Project Context
+
+- **Project:** ${projectName}
+${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${new Date().toISOString().split('T')[0]}
 `;
     await writeIfNotExists(teamPath, teamContent);
     // -------------------------------------------------------------------------
     // Create routing.md
     // -------------------------------------------------------------------------
     const routingPath = join(squadDir, 'routing.md');
-    if (templatesDir && existsSync(join(templatesDir, 'routing.md'))) {
+    if (templatesDir && storage.existsSync(join(templatesDir, 'routing.md'))) {
         await copyIfNotExists(join(templatesDir, 'routing.md'), routingPath);
     }
     else {
-        const routingContent = `# Squad Routing
-
-## Work Type Rules
-
-| Work Type | Primary Agent | Fallback |
-|-----------|---------------|----------|
-
-## Governance
-
-- Route based on work type and agent expertise
-- Update this file as team capabilities evolve
+        const routingContent = `# Squad Routing
+
+## Work Type Rules
+
+| Work Type | Primary Agent | Fallback |
+|-----------|---------------|----------|
+
+## Governance
+
+- Route based on work type and agent expertise
+- Update this file as team capabilities evolve
 `;
         await writeIfNotExists(routingPath, routingContent);
     }
@@ -749,11 +772,11 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     // Copy starter skills
     // -------------------------------------------------------------------------
     const skillsDir = join(teamRoot, '.copilot', 'skills');
-    if (templatesDir && existsSync(join(templatesDir, 'skills'))) {
+    if (templatesDir && storage.existsSync(join(templatesDir, 'skills'))) {
         const skillsSrc = join(templatesDir, 'skills');
-        const existingSkills = existsSync(skillsDir) ? readdirSync(skillsDir) : [];
+        const existingSkills = storage.existsSync(skillsDir) ? storage.listSync(skillsDir) : [];
         if (existingSkills.length === 0) {
-            cpSync(skillsSrc, skillsDir, { recursive: true });
+            copyRecursiveSync(skillsSrc, skillsDir, storage);
             createdFiles.push('.copilot/skills');
         }
     }
@@ -768,15 +791,15 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
         '.squad/orchestration-log/** merge=union',
     ];
     let existingAttrs = '';
-    if (existsSync(gitattributesPath)) {
-        existingAttrs = readFileSync(gitattributesPath, 'utf-8');
+    if (storage.existsSync(gitattributesPath)) {
+        existingAttrs = storage.readSync(gitattributesPath) ?? '';
     }
     const missingRules = unionRules.filter(rule => !existingAttrs.includes(rule));
     if (missingRules.length > 0) {
         const block = (existingAttrs && !existingAttrs.endsWith('\n') ? '\n' : '')
             + '# Squad: union merge for append-only team state files\n'
             + missingRules.join('\n') + '\n';
-        await appendFile(gitattributesPath, block);
+        await storage.append(gitattributesPath, block);
         createdFiles.push(toRelativePath(gitattributesPath));
     }
     // -------------------------------------------------------------------------
@@ -792,27 +815,26 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
         '.squad/sessions/',
     ];
     let existingIgnore = '';
-    if (existsSync(gitignorePath)) {
-        existingIgnore = readFileSync(gitignorePath, 'utf-8');
+    if (storage.existsSync(gitignorePath)) {
+        existingIgnore = storage.readSync(gitignorePath) ?? '';
     }
     const missingIgnore = ignoreEntries.filter(entry => !existingIgnore.includes(entry));
     if (missingIgnore.length > 0) {
         const block = (existingIgnore && !existingIgnore.endsWith('\n') ? '\n' : '')
             + '# Squad: ignore runtime state (logs, inbox, sessions)\n'
             + missingIgnore.join('\n') + '\n';
-        await appendFile(gitignorePath, block);
+        await storage.append(gitignorePath, block);
         createdFiles.push(toRelativePath(gitignorePath));
     }
     // -------------------------------------------------------------------------
     // Create .github/agents/squad.agent.md
     // -------------------------------------------------------------------------
     const agentFile = join(teamRoot, '.github', 'agents', 'squad.agent.md');
-    if (!existsSync(agentFile) || !skipExisting) {
-        if (templatesDir && existsSync(join(templatesDir, 'squad.agent.md'))) {
-            let agentContent = readFileSync(join(templatesDir, 'squad.agent.md'), 'utf-8');
+    if (!storage.existsSync(agentFile) || !skipExisting) {
+        if (templatesDir && storage.existsSync(join(templatesDir, 'squad.agent.md.template'))) {
+            let agentContent = storage.readSync(join(templatesDir, 'squad.agent.md.template')) ?? '';
             agentContent = stampVersionInContent(agentContent, version);
-            await mkdir(dirname(agentFile), { recursive: true });
-            await writeFile(agentFile, agentContent, 'utf-8');
+            await storage.write(agentFile, agentContent);
             createdFiles.push(toRelativePath(agentFile));
         }
     }
@@ -824,8 +846,8 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     // -------------------------------------------------------------------------
     if (includeTemplates && templatesDir) {
         const templatesDest = join(teamRoot, '.squad', 'templates');
-        if (!existsSync(templatesDest)) {
-            cpSync(templatesDir, templatesDest, { recursive: true });
+        if (!storage.existsSync(templatesDest)) {
+            copyRecursiveSync(templatesDir, templatesDest, storage);
             createdFiles.push(toRelativePath(templatesDest));
         }
         else {
@@ -837,7 +859,7 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     // -------------------------------------------------------------------------
     let isGitHub = true;
     try {
-        const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], { cwd: teamRoot, encoding: 'utf-8' }).trim();
+        const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], { cwd: teamRoot, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
         const remoteUrlLower = remoteUrl.toLowerCase();
         if (remoteUrlLower.includes('dev.azure.com') || remoteUrlLower.includes('visualstudio.com') || remoteUrlLower.includes('ssh.dev.azure.com')) {
             isGitHub = false;
@@ -849,17 +871,17 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     // -------------------------------------------------------------------------
     // Copy workflows (optional) — skip for ADO repos
     // -------------------------------------------------------------------------
-    if (includeWorkflows && isGitHub && templatesDir && existsSync(join(templatesDir, 'workflows'))) {
+    if (includeWorkflows && isGitHub && templatesDir && storage.existsSync(join(templatesDir, 'workflows'))) {
         const workflowsSrc = join(templatesDir, 'workflows');
         const workflowsDest = join(teamRoot, '.github', 'workflows');
-        if (statSync(workflowsSrc).isDirectory()) {
-            const allWorkflowFiles = readdirSync(workflowsSrc).filter(f => f.endsWith('.yml'));
+        if (storage.isDirectorySync(workflowsSrc)) {
+            const allWorkflowFiles = storage.listSync(workflowsSrc).filter(f => f.endsWith('.yml'));
             const workflowFiles = allWorkflowFiles.filter(f => FRAMEWORK_WORKFLOWS.includes(f));
-            await mkdir(workflowsDest, { recursive: true });
+            await storage.mkdir(workflowsDest, { recursive: true });
             for (const file of workflowFiles) {
                 const destFile = join(workflowsDest, file);
-                if (!existsSync(destFile) || !skipExisting) {
-                    cpSync(join(workflowsSrc, file), destFile);
+                if (!storage.existsSync(destFile) || !skipExisting) {
+                    storage.copySync(join(workflowsSrc, file), destFile);
                     createdFiles.push(toRelativePath(destFile));
                 }
                 else {
@@ -873,7 +895,7 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     // -------------------------------------------------------------------------
     if (includeMcpConfig) {
         const mcpConfigPath = join(teamRoot, '.copilot', 'mcp-config.json');
-        if (!existsSync(mcpConfigPath)) {
+        if (!storage.existsSync(mcpConfigPath)) {
             const mcpSample = isGitHub
                 ? {
                     mcpServers: {
@@ -898,8 +920,7 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
                         }
                     }
                 };
-            await mkdir(dirname(mcpConfigPath), { recursive: true });
-            await writeFile(mcpConfigPath, JSON.stringify(mcpSample, null, 2) + '\n', 'utf-8');
+            await storage.write(mcpConfigPath, JSON.stringify(mcpSample, null, 2) + '\n');
             createdFiles.push(toRelativePath(mcpConfigPath));
         }
         else {
@@ -923,14 +944,14 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     {
         const workstreamIgnoreEntry = '.squad-workstream';
         let currentIgnore = '';
-        if (existsSync(gitignorePath)) {
-            currentIgnore = readFileSync(gitignorePath, 'utf-8');
+        if (storage.existsSync(gitignorePath)) {
+            currentIgnore = storage.readSync(gitignorePath) ?? '';
         }
         if (!currentIgnore.includes(workstreamIgnoreEntry)) {
             const block = (currentIgnore && !currentIgnore.endsWith('\n') ? '\n' : '')
                 + '# Squad: SubSquad activation file (local to this machine)\n'
                 + workstreamIgnoreEntry + '\n';
-            await appendFile(gitignorePath, block);
+            await storage.append(gitignorePath, block);
             createdFiles.push(toRelativePath(gitignorePath));
         }
     }
@@ -938,8 +959,8 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     // Create .first-run marker
     // -------------------------------------------------------------------------
     const firstRunMarker = join(squadDir, '.first-run');
-    if (!existsSync(firstRunMarker)) {
-        await writeFile(firstRunMarker, new Date().toISOString() + '\n', 'utf-8');
+    if (!storage.existsSync(firstRunMarker)) {
+        await storage.write(firstRunMarker, new Date().toISOString() + '\n');
         createdFiles.push(toRelativePath(firstRunMarker));
     }
     // -------------------------------------------------------------------------
@@ -947,7 +968,7 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     // -------------------------------------------------------------------------
     if (options.prompt) {
         const promptFile = join(squadDir, '.init-prompt');
-        await writeFile(promptFile, options.prompt, 'utf-8');
+        await storage.write(promptFile, options.prompt);
         createdFiles.push(toRelativePath(promptFile));
     }
     return {
@@ -965,10 +986,10 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
  *
  * @param squadDir - Path to the .squad directory
  */
-export async function cleanupOrphanInitPrompt(squadDir) {
+export async function cleanupOrphanInitPrompt(squadDir, storage = new FSStorageProvider()) {
     const promptFile = join(squadDir, '.init-prompt');
-    if (existsSync(promptFile)) {
-        await unlink(promptFile);
+    if (storage.existsSync(promptFile)) {
+        await storage.delete(promptFile);
     }
 }
 //# sourceMappingURL=init.js.map