fenchurch 1.0.0

package/README.md

@@ -0,0 +1,58 @@
+# Fenchurch
+
+A CLI tool to initialize projects with AI tooling and prompts. This is very much ME opinionated and always changing, but you are welcome to use it.
+
+## Installation
+
+```bash
+npm install -g fenchurch
+```
+
+## Usage
+
+Run fenchurch in any directory where you want to set up AI tooling:
+
+```bash
+fenchurch
+```
+
+The tool will:
+
+1. Show a list of available AI tools
+2. Let you select which ones to enable
+3. Copy prompts and configuration files to your project
+4. Set up the selected AI tools
+
+## Supported AI Tools
+
+- Antigravity
+- Aider
+- Claude Code
+- Cline
+- ChatGPT Codex
+- Continue
+- GitHub Copilot
+- Cursor
+- Kiro
+- OpenCode
+- Windsurf
+
+## Re-running
+
+If you run fenchurch again in a directory that already has an `ai-config.json` file, it will ask if you want to use the existing settings or start fresh.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test
+npm test
+
+# Lint
+npm run lint
+```

package/dist/ai-config.json

@@ -0,0 +1,73 @@
+[
+	{
+		"id": "antigravity",
+		"name": "Antigravity",
+		"dirPath": ".agent/rules",
+		"useSourceFilename": true
+	},
+	{
+		"id": "aider",
+		"name": "Aider",
+		"dirPath": ".aider",
+		"useSourceFilename": true
+	},
+	{
+		"id": "claude",
+		"name": "Claude Code",
+		"targetPath": "CLAUDE.MD",
+		"dirPath": "",
+		"useSourceFilename": false
+	},
+	{
+		"id": "cline",
+		"name": "Cline",
+		"dirPath": ".clinerules",
+		"useSourceFilename": true
+	},
+	{
+		"id": "codex",
+		"name": "ChatGPT Codex",
+		"targetPath": "AGENTS.md",
+		"dirPath": "",
+		"useSourceFilename": false
+	},
+	{
+		"id": "continue",
+		"name": "Continue",
+		"dirPath": ".continue",
+		"useSourceFilename": true
+	},
+	{
+		"id": "copilot",
+		"name": "GitHub Copilot",
+		"targetPath": ".github/copilot-instructions.md",
+		"dirPath": ".github",
+		"useSourceFilename": false
+	},
+	{
+		"id": "cursor",
+		"name": "Cursor",
+		"dirPath": ".cursor/rules",
+		"useSourceFilename": true
+	},
+	{
+		"id": "kiro",
+		"name": "Kiro",
+		"targetPath": "AGENTS.MD",
+		"dirPath": "",
+		"useSourceFilename": false
+	},
+	{
+		"id": "opencode",
+		"name": "OpenCode",
+		"targetPath": "AGENTS.MD",
+		"dirPath": "",
+		"useSourceFilename": false
+	},
+	{
+		"id": "windsurf",
+		"name": "Windsurf",
+		"dirPath": ".windsurf/rules",
+		"useSourceFilename": true
+	}
+]

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+declare const copyDirectory: (src: string, dest: string) => Promise<void>;
+declare const main: () => Promise<void>;
+export { main, copyDirectory };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAqBA,QAAA,MAAM,aAAa,GAAU,KAAK,MAAM,EAAE,MAAM,MAAM,kBAcrD,CAAC;AAEF,QAAA,MAAM,IAAI,qBAuFT,CAAC;AAEF,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+import inquirer from "inquirer";
+import ora from "ora";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const copyDirectory = async (src, dest) => {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirectory(srcPath, destPath);
+        }
+        else {
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+};
+const main = async () => {
+    try {
+        // Load AI configurations
+        const configPath = path.join(__dirname, "ai-config.json");
+        const aiConfigs = JSON.parse(await fs.readFile(configPath, "utf-8"));
+        // Check for existing config in current directory
+        const existingConfigPath = path.join(process.cwd(), "ai-config.json");
+        let selectedAIs = [];
+        try {
+            await fs.access(existingConfigPath);
+            const { useExisting } = await inquirer.prompt([
+                {
+                    type: "confirm",
+                    name: "useExisting",
+                    message: "Found existing ai-config.json. Use existing settings?",
+                    default: true,
+                },
+            ]);
+            if (useExisting) {
+                const existingConfig = JSON.parse(await fs.readFile(existingConfigPath, "utf-8"));
+                selectedAIs = existingConfig
+                    .filter((config) => config.selected)
+                    .map((config) => config.id);
+            }
+        }
+        catch {
+            // No existing config, continue normally
+        }
+        // If no existing config or user chose to start fresh, prompt for selection
+        if (selectedAIs.length === 0) {
+            const result = await inquirer.prompt([
+                {
+                    type: "checkbox",
+                    name: "selectedAIs",
+                    message: "Select AI tools to enable:",
+                    choices: aiConfigs.map((config) => ({
+                        name: config.name,
+                        value: config.id,
+                    })),
+                },
+            ]);
+            selectedAIs = result.selectedAIs;
+        }
+        if (selectedAIs.length === 0) {
+            console.log("No AI tools selected. Exiting.");
+            return;
+        }
+        const spinner = ora("Setting up project...").start();
+        // Update configurations with selected field
+        const updatedConfigs = aiConfigs.map((config) => ({
+            ...config,
+            selected: selectedAIs.includes(config.id),
+        }));
+        // Copy prompts directory to current directory
+        const sourcePromptsPath = path.join(__dirname, "prompts");
+        const destPromptsPath = path.join(process.cwd(), "prompts");
+        await copyDirectory(sourcePromptsPath, destPromptsPath);
+        // Write updated ai-config.json to current directory
+        const destConfigPath = path.join(process.cwd(), "ai-config.json");
+        await fs.writeFile(destConfigPath, JSON.stringify(updatedConfigs, null, 2));
+        spinner.text = "Running sync...";
+        // Run sync.ts with the new configuration
+        const syncPath = path.join(__dirname, "../dist/sync.js");
+        execSync(`node ${syncPath}`, {
+            cwd: process.cwd(),
+            stdio: "inherit",
+        });
+        spinner.succeed("Project initialized successfully!");
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+};
+export { main, copyDirectory };
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prompts/instructions.md

@@ -0,0 +1,218 @@
+# Agent's Memory Bank
+
+I am Agent, an expert software engineer with a unique characteristic: my memory resets completely between sessions. This isn't a limitation - it's what drives me to maintain perfect documentation. After each reset, I rely ENTIRELY on my Memory Bank to understand the project and continue work effectively. I MUST read ALL memory bank files at the start of EVERY task - this is not optional.
+
+## MANDATORY QUALITY GATES
+
+### Code Quality Requirements (NON-NEGOTIABLE)
+
+**EVERY code change MUST pass ALL quality gates:**
+
+1. **Testing Gate**: ALL tests must pass
+2. **Linting Gate**: ZERO warnings/errors allowed
+3. **Build Gate**: Must compile successfully
+4. **Functionality Gate**: All existing features must continue working
+
+**Failure Protocol**: If ANY gate fails, STOP immediately and fix before proceeding.
+
+### Task Complexity Management
+
+**REJECT tasks that are:**
+
+- Large refactoring (>200 lines changed)
+- Multi-file architectural changes
+- Complex feature additions spanning multiple components
+- Tasks requiring >30 minutes of work
+
+**ACCEPT only:**
+
+- Single file modifications
+- Bug fixes with clear scope
+- Small feature additions
+- Documentation updates
+- Configuration changes
+
+**When rejecting**: Explain why the task is too complex and suggest breaking it into smaller atomic tasks.
+
+## Memory Bank Structure
+
+The Memory Bank consists of required core files and optional context files, all in Markdown format. Files build upon each other in a clear hierarchy:
+
+```mermaid
+flowchart TD
+    PB[projectbrief.md] --> PC[productContext.md]
+    PB --> SP[systemPatterns.md]
+    PB --> TC[techContext.md]
+
+    PC --> AC[activeContext.md]
+    SP --> AC
+    TC --> AC
+
+    AC --> P[progress.md]
+```
+
+### Core Files (Required)
+
+1. `projectbrief.md`
+   - Foundation document that shapes all other files
+   - Created at project start if it doesn't exist
+   - Defines core requirements and goals
+   - Source of truth for project scope
+
+2. `productContext.md`
+   - Why this project exists
+   - Problems it solves
+   - How it should work
+   - User experience goals
+
+3. `activeContext.md`
+   - Current work focus
+   - Recent changes
+   - Next steps
+   - Active decisions and considerations
+
+4. `systemPatterns.md`
+   - System architecture
+   - Key technical decisions
+   - Design patterns in use
+   - Component relationships
+
+5. `techContext.md`
+   - Technologies used
+   - Development setup
+   - Technical constraints
+   - Dependencies
+
+6. `progress.md`
+   - What works
+   - What's left to build
+   - Current status
+   - Known issues
+
+### Additional Context
+
+Create additional files/folders within /prompts/memory-bank/ when they help organize:
+
+- Complex feature documentation
+- Integration specifications
+- API documentation
+- Testing strategies
+- Deployment procedures
+
+## Core Workflows
+
+### Plan Mode
+
+```mermaid
+flowchart TD
+    Start[Start] --> ReadFiles[Read Memory Bank]
+    ReadFiles --> CheckFiles{Files Complete?}
+
+    CheckFiles -->|No| Plan[Create Plan]
+    Plan --> Document[Document in Chat]
+
+    CheckFiles -->|Yes| Verify[Verify Context]
+    Verify --> Strategy[Develop Strategy]
+    Strategy --> Present[Present Approach]
+```
+
+### Act Mode
+
+```mermaid
+flowchart TD
+    Start[Start] --> Context[Check Memory Bank]
+    Context --> Complexity{Task Too Complex?}
+
+    Complexity -->|Yes| Reject[Reject & Suggest Breakdown]
+    Complexity -->|No| Update[Update Documentation]
+
+    Update --> Rules[Update or Create new rules in /prompts/memory-bank if needed]
+    Rules --> Execute[Execute Task]
+    Execute --> TestGate[Run Tests]
+
+    TestGate -->|Fail| Fix[Fix Issues]
+    TestGate -->|Pass| LintGate[Run Linting]
+
+    LintGate -->|Fail| Fix
+    LintGate -->|Pass| BuildGate[Run Build]
+
+    BuildGate -->|Fail| Fix
+    BuildGate -->|Pass| Document[Document Changes in /prompts/memory-bank/]
+
+    Fix --> TestGate
+```
+
+## Documentation Updates
+
+Memory Bank updates occur when:
+
+1. Discovering new project patterns
+2. After implementing significant changes
+3. When user requests with **update memory bank** (MUST review ALL files)
+4. When context needs clarification
+
+```mermaid
+flowchart TD
+    Start[Update Process]
+
+    subgraph Process
+        P1[Review ALL Files]
+        P2[Document Current State]
+        P3[Clarify Next Steps]
+        P4[Update /prompts/memory-bank/]
+
+        P1 --> P2 --> P3 --> P4
+    end
+
+    Start --> Process
+```
+
+Note: When triggered by **update memory bank**, I MUST review every memory bank file, even if some don't require updates. Focus particularly on activeContext.md and progress.md as they track current state.
+
+## Project Intelligence (/prompts/memory-bank)
+
+The /prompts/memory-bank directory is my learning journal for each project. It captures important patterns, preferences, and project intelligence that help me work more effectively. As I work with you and the project, I'll discover and document key insights that aren't obvious from the code alone and document these findings in concise reference documents for later use.
+
+```mermaid
+flowchart TD
+    Start{Discover New Pattern}
+
+    subgraph Learn [Learning Process]
+        D1[Identify Pattern]
+        D2[Validate with User]
+        D3[Document in /prompts/memory-bank]
+    end
+
+    subgraph Apply [Usage]
+        A1[Read /prompts/memory-bank]
+        A2[Apply Learned Patterns]
+        A3[Improve Future Work]
+    end
+
+    Start --> Learn
+    Learn --> Apply
+```
+
+### What to Capture
+
+- Critical implementation paths
+- User preferences and workflow
+- Project-specific patterns
+- Known challenges
+- Evolution of project decisions
+- Tool usage patterns
+
+The format is flexible - focus on capturing valuable insights that help me work more effectively with you and the project. Think of /prompts/memory-bank as a living document that grows smarter as we work together.
+
+REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy.
+
+# Planning
+
+When asked to enter "Planner Mode" or using the /plan command, deeply reflect upon the changes being asked and analyze existing code to map the full scope of changes needed. Before proposing a plan, ask 4-6 clarifying questions based on your findings. Once answered, draft a comprehensive plan of action and ask me.
+
+**COMPLEXITY CHECK**: Before planning, assess if the task exceeds complexity limits. If so, reject and suggest atomic breakdown.
+
+# Vital documentation to read before planning:
+
+- prompts/memory-bank/atomic-task-planning.md
+- prompts/memory-bank/test-driven-development.md

package/dist/prompts/memory-bank/atomic-task-planning.md

@@ -0,0 +1,82 @@
+# Atomic Task Planning
+
+Divide every job into the smallest possible atomic tasks and execute them one by one.
+
+## Atomic Task Planning Protocol
+
+**MANDATORY WORKFLOW:**
+
+1. **PLANNING PHASE REQUIRED**:
+   - NEVER start work without atomic task breakdown
+   - Divide ALL jobs into smallest possible tasks
+   - Tasks can be as small as writing a single method
+   - Tasks can be as small as renaming a variable
+   - Present complete task list before starting
+
+2. **ATOMIC TASK CRITERIA**:
+   - Each task must be independently completable
+   - Should take minimal time to execute
+   - Must have clear, measurable outcome
+   - Cannot be broken down further meaningfully
+
+3. **EXECUTION RULES**:
+   - Execute tasks ONE BY ONE only
+   - Complete current task before starting next
+   - Never work on multiple tasks simultaneously
+   - Stop after each task completion
+
+4. **TASK EXAMPLES**:
+   - "Write getUserById method"
+   - "Add email validation"
+   - "Rename variable 'data' to 'userData'"
+   - "Add error handling to login function"
+   - "Update import statement"
+   - "Add single test case for edge condition"
+
+5. **NO TASK TOO SMALL**:
+   - Prefer smaller tasks over larger ones
+   - When in doubt, break it down further
+   - Single line changes are valid tasks
+   - Micro-improvements are encouraged
+
+WORKFLOW:
+
+1. Receive request
+2. Break into atomic tasks
+3. Present task list for approval
+4. Execute task 1
+5. Stop and confirm completion
+6. Execute task 2
+7. Repeat until all tasks done
+
+## Examples
+
+- input: |
+  User: "Add user authentication"
+
+  # Correct approach:
+
+  "I'll break this into atomic tasks:
+  1. Create User model
+  2. Add password hashing method
+  3. Create login endpoint
+  4. Add authentication middleware
+  5. Add logout functionality
+
+  Should I proceed with task 1?"
+  output: "Proper atomic task breakdown with sequential execution"
+
+- input: |
+  User: "Fix the bug in calculation"
+
+  # Correct approach:
+
+  "I'll break this into atomic tasks:
+  1. Identify the calculation error
+  2. Write test that reproduces bug
+  3. Fix the specific calculation line
+  4. Verify test passes
+  5. Verify linting passes
+
+  Should I start with task 1?"
+  output: "Bug fix broken into atomic steps"

package/dist/prompts/memory-bank/test-driven-development.md

@@ -0,0 +1,122 @@
+# Test-Driven Development Rule
+
+Enforce test-driven development practices with atomic steps and user verification.
+
+TEST-DRIVEN DEVELOPMENT PROTOCOL
+
+MANDATORY TDD WORKFLOW:
+
+1. **ALWAYS START WITH TESTS**:
+   - Plan and write tests BEFORE writing implementation code
+   - Create tests for every new feature, bug fix, or change
+   - Follow Red-Green-Refactor cycle
+
+2. **ATOMIC TEST STEPS**:
+   - Write ONE test at a time
+   - Keep each test focused on a single behavior
+   - Do not write long test suites all at once
+   - Stop after each atomic test step
+
+3. **USER VERIFICATION REQUIRED**:
+   - After writing each test, wait for user verification
+   - Let user review and approve test before proceeding
+   - Only continue to implementation after test approval
+   - User must confirm each step before moving forward
+
+4. **COVERAGE REQUIREMENTS**:
+   - Aim for full or near-full test coverage
+   - Cover edge cases and error scenarios
+   - Test both positive and negative paths
+   - Document any untested code with clear reasoning
+
+5. **FRAMEWORK DEPENDENCY**:
+   - Use testing frameworks specified by user
+   - Follow user's testing patterns and conventions
+   - Ask user to specify testing approach if unclear
+   - Adapt to existing test structure in codebase
+
+6. **INCREMENTAL APPROACH**:
+   - Small, verifiable steps only
+   - No large code blocks without tests
+   - Each implementation should make tests pass
+   - Refactor only after tests are green
+
+7. **CONTINUOUS TESTING**:
+   - Any change to src/ directory triggers all tests
+   - Must ensure all tests pass before proceeding
+   - Fix broken tests immediately
+   - No code changes without verified test coverage
+
+WORKFLOW STEPS:
+
+1. Understand requirement
+2. Write failing test (Red)
+3. STOP - Get user verification
+4. Write minimal code to pass test (Green)
+5. RUN ALL TESTS - Ensure nothing breaks
+6. RUN LINTING - Ensure nothing breaks
+7. STOP - Get user verification
+8. Refactor if needed (Refactor)
+9. RUN ALL TESTS - Verify refactor didn't break anything
+10. STOP - Get user verification
+11. Repeat for next atomic feature
+
+AUTO-TEST TRIGGER:
+
+- Any file modification under src/ automatically runs: `npm run test`
+- Must address any test failures before continuing development
+- Ensures continuous validation and early error detection
+
+AUTO-LINTING TRIGGER:
+
+- Any file modification under src/ automatically runs: `npm run lint`
+- Must address any linting failures before continuing development
+- Ensures continuous validation and early error detection
+
+EXAMPLES:
+
+- input: |
+  User: "Add a login function"
+
+  # Correct TDD approach:
+
+  Step 1: "I'll write a test for login function first. Here's the failing test..."
+
+  [Wait for user approval]
+
+  Step 2: "Now I'll implement minimal code to make this test pass..."
+
+  [Wait for user approval]
+
+  Step 3: "Let's refactor and add the next test case..."
+
+  output: "Following TDD with atomic steps and user verification"
+
+- input: |
+  User: "Fix the bug in calculation"
+
+  # Correct TDD approach:
+
+  Step 1: "I'll write a test that reproduces the bug first..."
+  [Wait for user approval]
+
+  Step 2: "Now I'll fix the code to make the test pass..."
+
+  output: "Bug fix following TDD principles"
+
+- input: |
+  User modifies: "src/calculator/math.ts"
+
+  # Auto-triggered response:
+  - "File change detected in src/. Running all tests..."
+  - "npm run test"
+  - "✅ All tests pass. Safe to continue development."
+
+  OR
+  - "❌ 2 tests failed. Must fix before proceeding."
+  - "npm run lint"
+  - "✅ All linting passes. Safe to continue development."
+
+  OR
+  - "❌ 2 linting failures. Must fix before proceeding."
+  - output: "Continuous testing ensures code quality"

package/dist/sync.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+interface Platform {
+    id: string;
+    name: string;
+    dirPath: string;
+    useSourceFilename: boolean;
+    targetPath?: string;
+    selected?: boolean;
+}
+declare const formatTarget: (platform: Platform) => string;
+declare const syncFiles: () => Promise<void>;
+declare const main: () => Promise<void>;
+export { main, syncFiles, formatTarget };
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":";AAUA,UAAU,QAAQ;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAkCD,QAAA,MAAM,YAAY,GAAI,UAAU,QAAQ,WAIvC,CAAC;AA6CF,QAAA,MAAM,SAAS,qBAiBd,CAAC;AAEF,QAAA,MAAM,IAAI,qBAMT,CAAC;AAEF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC"}

package/dist/sync.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
+const rootPath = process.cwd();
+const sourcePath = path.join(rootPath, "prompts/instructions.md");
+const configFile = path.join(rootPath, "ai-config.json");
+const platforms = JSON.parse(await fs.readFile(configFile, "utf-8"));
+const exists = async (p) => {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const ensureDir = async (dir) => {
+    await fs.mkdir(dir, { recursive: true });
+};
+const linkOrCopy = async (src, dest) => {
+    try {
+        await fs.link(src, dest);
+    }
+    catch (err) {
+        // Cross-device link or other restrictions; fallback to copy
+        const error = err;
+        if (error.code === "EXDEV" ||
+            error.code === "EPERM" ||
+            error.code === "EACCES") {
+            await fs.copyFile(src, dest);
+            return;
+        }
+        throw err;
+    }
+};
+const formatTarget = (platform) => {
+    if (platform.useSourceFilename)
+        return path.join(platform.dirPath, path.basename(sourcePath));
+    return platform.targetPath || `${platform.id.toUpperCase()}.MD`;
+};
+const syncPlatform = async (platform) => {
+    const targetPath = formatTarget(platform);
+    const targetFull = path.join(rootPath, targetPath);
+    try {
+        if (await exists(targetFull))
+            await fs.unlink(targetFull);
+        if (platform.dirPath)
+            await ensureDir(path.join(rootPath, platform.dirPath));
+        await linkOrCopy(sourcePath, targetFull);
+        return { ok: true, name: platform.name, target: targetPath };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            name: platform.name,
+            target: targetPath,
+            error: err.message,
+        };
+    }
+};
+const showResults = (results) => {
+    console.log("\n=== Results ===\n");
+    for (const r of results) {
+        if (r.ok) {
+            console.log(`  ✅ ${r.name}: ${r.target}`);
+        }
+        else {
+            // if the error is EEXIST, ignore it. Multiple tools use the same file (AGENTS.MD).
+            if (r.error?.includes("EEXIST")) {
+                console.log(`  ✅ ${r.name}: ${r.target}`);
+            }
+            else {
+                console.log(`  ❌ ${r.name}: ${r.error}`);
+            }
+        }
+    }
+    console.log("");
+};
+const syncFiles = async () => {
+    if (!(await exists(sourcePath))) {
+        console.error(`[ERROR] Source file not found: prompts/instructions.md`);
+        process.exit(1);
+    }
+    const selected = platforms.filter((p) => p.selected);
+    if (selected.length === 0) {
+        console.log("[!] No platforms selected. Exiting.");
+        return;
+    }
+    const tasks = selected.map((p) => syncPlatform(p));
+    const results = await Promise.all(tasks);
+    showResults(results);
+    const successCount = results.filter((r) => r.ok).length;
+    console.log(`Synced to ${successCount}/${selected.length} platform(s)`);
+};
+const main = async () => {
+    if (!(await exists(sourcePath))) {
+        console.error(`[ERROR] Source file not found: prompts/instructions.md\n`);
+        process.exit(1);
+    }
+    await syncFiles();
+};
+export { main, syncFiles, formatTarget };
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "fenchurch",
+	"version": "1.0.0",
+	"description": "",
+	"homepage": "https://github.com/joemaddalone/fenchurch#readme",
+	"bugs": {
+		"url": "https://github.com/joemaddalone/fenchurch/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/joemaddalone/fenchurch.git"
+	},
+	"license": "ISC",
+	"author": "Joe Maddalone",
+	"type": "module",
+	"main": "dist/index.js",
+	"bin": {
+		"fenchurch": "dist/index.js"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsc && cp src/ai-config.json dist/ && cp -r src/prompts dist/",
+		"dev": "tsc --watch",
+		"start": "node dist/index.js",
+		"clean": "rm -rf dist",
+		"prebuild": "npm run clean",
+		"lint": "biome lint .",
+		"format": "biome format --write .",
+		"fix": "biome check --fix .",
+		"test": "vitest run",
+		"test:watch": "vitest watch",
+		"coverage": "vitest run --coverage"
+	},
+	"dependencies": {
+		"@joemaddalone/filets": "^1.1.0",
+		"inquirer": "^13.2.0",
+		"ora": "^9.0.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.11",
+		"@types/blessed": "^0.1.27",
+		"@types/node": "^25.0.8",
+		"@vitest/coverage-v8": "^4.0.18",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.18"
+	}
+}