vibe-fabric 0.1.0

package/dist/core/repo/templates/vibe-readme.js

@@ -0,0 +1,204 @@
+/**
+ * vibe/ folder README templates
+ */
+export const vibeReadmes = [
+    // incoming-scopes/README.md
+    {
+        path: 'vibe/incoming-scopes/README.md',
+        content: `# Incoming Scopes
+
+This folder receives scope briefs from the planning hub.
+
+## Workflow
+
+1. Planning hub sends scope via \`vibe send\`
+2. Scope lands here as \`SCOPE-XXX.md\`
+3. Create implementation plan: \`/plan-from-scope SCOPE-XXX\`
+4. Move scope to \`processed/\` once plan is created
+
+## Folder Structure
+
+\`\`\`
+incoming-scopes/
+├── SCOPE-XXX.md       # New scopes land here
+└── processed/         # Scopes with plans created
+    └── SCOPE-YYY.md
+\`\`\`
+
+## Scope Format
+
+Each scope contains:
+- Summary of what to implement
+- Requirements and acceptance criteria
+- Technical constraints
+- Implementation notes
+`,
+    },
+    // implementation-plans/README.md
+    {
+        path: 'vibe/implementation-plans/README.md',
+        content: `# Implementation Plans
+
+Plans for implementing scopes from the planning hub.
+
+## Workflow
+
+1. Read scope from \`../incoming-scopes/\`
+2. Create plan using template: \`/plan-from-scope SCOPE-XXX\`
+3. Work on plan (track progress in log)
+4. Move to \`completed/\` when done
+
+## Folder Structure
+
+\`\`\`
+implementation-plans/
+├── active/            # Plans in progress
+├── completed/         # Finished plans
+├── archived/          # Cancelled plans
+└── templates/
+    └── PLAN_TEMPLATE.md
+\`\`\`
+
+## Plan Requirements
+
+Every plan MUST include:
+- \`Source Scope: SCOPE-XXX\` in metadata (links to planning hub)
+- Progress log section
+- Acceptance criteria checklist
+`,
+    },
+    // implementation-plans/templates/PLAN_TEMPLATE.md
+    {
+        path: 'vibe/implementation-plans/templates/PLAN_TEMPLATE.md',
+        content: `# Implementation Plan: [Title]
+
+## Metadata
+
+| Field | Value |
+|-------|-------|
+| **Plan ID** | \`PLAN-XXX\` |
+| **Source Scope** | \`SCOPE-XXX\` |
+| **Status** | \`active\` |
+| **Created** | YYYY-MM-DD |
+| **Part** | 1 of 1 |
+
+## Objective
+
+[Brief description of what this plan implements]
+
+## Acceptance Criteria
+
+From scope:
+- [ ] Criteria 1
+- [ ] Criteria 2
+- [ ] Criteria 3
+
+## Implementation Steps
+
+1. Step 1
+2. Step 2
+3. Step 3
+
+## Progress Log
+
+### YYYY-MM-DD
+- Started implementation
+- [Notes]
+
+## Notes
+
+[Additional context]
+`,
+    },
+    // knowledge-base/_index.md
+    {
+        path: 'vibe/knowledge-base/_index.md',
+        content: `# Knowledge Base
+
+Documentation and learnings from this repository.
+
+## Structure
+
+Add entries by category:
+
+\`\`\`markdown
+## Category Name
+- [Entry Title](path/to/entry.md)
+\`\`\`
+
+## Categories
+
+<!-- Add categories and entries as you learn -->
+`,
+    },
+    // knowledge-base/_TEMPLATE.md
+    {
+        path: 'vibe/knowledge-base/_TEMPLATE.md',
+        content: `# [Title]
+
+## Context
+
+[What situation led to this knowledge?]
+
+## Learning
+
+[What did you learn?]
+
+## Example
+
+\`\`\`
+[Code or configuration example]
+\`\`\`
+
+## Related
+
+- [Related entry](./related.md)
+`,
+    },
+    // knowledge-base/README.md
+    {
+        path: 'vibe/knowledge-base/README.md',
+        content: `# Knowledge Base
+
+Store learnings, decisions, and documentation discovered during implementation.
+
+## When to Add Entries
+
+- Discovered gotcha or edge case
+- Made architectural decision
+- Found useful pattern
+- Debugged tricky issue
+- Learned something about the codebase
+
+## How to Add
+
+Use the \`/kb-add\` command or create a file manually:
+
+\`\`\`bash
+/kb-add "Authentication uses JWT with refresh tokens"
+\`\`\`
+
+## Entry Format
+
+Use the template in \`_TEMPLATE.md\`:
+
+\`\`\`markdown
+# Title
+
+## Context
+What situation led to this knowledge?
+
+## Learning
+What did you learn?
+
+## Example
+Code or configuration example.
+\`\`\`
+
+## Syncing
+
+The planning hub syncs KB entries via \`vibe sync\`. Keep \`_index.md\` updated with links to all entries.
+`,
+    },
+];
+//# sourceMappingURL=vibe-readme.js.map

package/dist/core/repo/templates/vibe-readme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibe-readme.js","sourceRoot":"","sources":["../../../../src/core/repo/templates/vibe-readme.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,4BAA4B;IAC5B;QACE,IAAI,EAAE,gCAAgC;QACtC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BZ;KACE;IAED,iCAAiC;IACjC;QACE,IAAI,EAAE,qCAAqC;QAC3C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BZ;KACE;IAED,kDAAkD;IAClD;QACE,IAAI,EAAE,sDAAsD;QAC5D,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCZ;KACE;IAED,2BAA2B;IAC3B;QACE,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE;;;;;;;;;;;;;;;;CAgBZ;KACE;IAED,8BAA8B;IAC9B;QACE,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBZ;KACE;IAED,2BAA2B;IAC3B;QACE,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCZ;KACE;CACF,CAAC"}

package/dist/core/repo/templates/vibe-scripts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * vibe/scripts/ templates
+ */
+import type { TemplateFile } from './index.js';
+export declare const vibeScripts: TemplateFile[];
+//# sourceMappingURL=vibe-scripts.d.ts.map

package/dist/core/repo/templates/vibe-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibe-scripts.d.ts","sourceRoot":"","sources":["../../../../src/core/repo/templates/vibe-scripts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,YAAY,EAiTrC,CAAC"}

package/dist/core/repo/templates/vibe-scripts.js

@@ -0,0 +1,308 @@
+/**
+ * vibe/scripts/ templates
+ */
+export const vibeScripts = [
+    // sync-self.ts - Map generation script
+    {
+        path: 'vibe/scripts/sync-self.ts',
+        content: `#!/usr/bin/env npx tsx
+/**
+ * Codebase map generation script
+ *
+ * Generates a JSON map of the codebase structure including:
+ * - File tree
+ * - Export analysis
+ * - Dependency graph
+ *
+ * Usage: npx tsx vibe/scripts/sync-self.ts [--output maps/codebase-map.json]
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+interface FileNode {
+  name: string;
+  path: string;
+  type: 'file' | 'directory';
+  children?: FileNode[];
+  exports?: string[];
+}
+
+const IGNORE_PATTERNS = [
+  'node_modules',
+  '.git',
+  'dist',
+  'build',
+  '.next',
+  'coverage',
+  '.cache',
+  'vibe',
+];
+
+function shouldIgnore(name: string): boolean {
+  return IGNORE_PATTERNS.some((pattern) => name === pattern || name.startsWith('.'));
+}
+
+function scanDirectory(dirPath: string, relativePath = ''): FileNode[] {
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  const nodes: FileNode[] = [];
+
+  for (const entry of entries) {
+    if (shouldIgnore(entry.name)) continue;
+
+    const fullPath = path.join(dirPath, entry.name);
+    const relPath = path.join(relativePath, entry.name);
+
+    if (entry.isDirectory()) {
+      nodes.push({
+        name: entry.name,
+        path: relPath,
+        type: 'directory',
+        children: scanDirectory(fullPath, relPath),
+      });
+    } else if (entry.isFile()) {
+      nodes.push({
+        name: entry.name,
+        path: relPath,
+        type: 'file',
+      });
+    }
+  }
+
+  return nodes;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const outputIndex = args.indexOf('--output');
+  const outputPath = outputIndex >= 0 ? args[outputIndex + 1] : 'vibe/maps/codebase-map.json';
+
+  console.log('Scanning codebase...');
+  const tree = scanDirectory(process.cwd());
+
+  const map = {
+    generated: new Date().toISOString(),
+    root: process.cwd(),
+    tree,
+  };
+
+  // Ensure output directory exists
+  const outputDir = path.dirname(outputPath);
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  fs.writeFileSync(outputPath, JSON.stringify(map, null, 2));
+  console.log(\`Map written to \${outputPath}\`);
+}
+
+main();
+`,
+    },
+    // dependency-graph.ts - Dependency analysis script
+    {
+        path: 'vibe/scripts/dependency-graph.ts',
+        content: `#!/usr/bin/env npx tsx
+/**
+ * Dependency graph generation script
+ *
+ * Analyzes import statements to build a dependency graph.
+ *
+ * Usage: npx tsx vibe/scripts/dependency-graph.ts [--output graphs/deps.json]
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+interface DependencyNode {
+  file: string;
+  imports: string[];
+  importedBy: string[];
+}
+
+interface DependencyGraph {
+  generated: string;
+  nodes: Record<string, DependencyNode>;
+}
+
+const SOURCE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs'];
+const IGNORE_DIRS = ['node_modules', 'dist', 'build', '.git', 'vibe'];
+
+function findSourceFiles(dir: string, files: string[] = []): string[] {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+
+    if (entry.isDirectory() && !IGNORE_DIRS.includes(entry.name)) {
+      findSourceFiles(fullPath, files);
+    } else if (entry.isFile() && SOURCE_EXTENSIONS.includes(path.extname(entry.name))) {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}
+
+function extractImports(filePath: string): string[] {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const imports: string[] = [];
+
+  // Match import statements
+  const importRegex = /import\\s+(?:[^'"]*from\\s+)?['"]([^'"]+)['"]/g;
+  let match;
+
+  while ((match = importRegex.exec(content)) !== null) {
+    const importPath = match[1];
+    // Only include relative imports
+    if (importPath.startsWith('.')) {
+      imports.push(importPath);
+    }
+  }
+
+  return imports;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const outputIndex = args.indexOf('--output');
+  const outputPath = outputIndex >= 0 ? args[outputIndex + 1] : 'vibe/graphs/deps.json';
+
+  console.log('Analyzing dependencies...');
+
+  const sourceFiles = findSourceFiles(process.cwd());
+  const graph: DependencyGraph = {
+    generated: new Date().toISOString(),
+    nodes: {},
+  };
+
+  // Build initial nodes
+  for (const file of sourceFiles) {
+    const relativePath = path.relative(process.cwd(), file);
+    graph.nodes[relativePath] = {
+      file: relativePath,
+      imports: extractImports(file),
+      importedBy: [],
+    };
+  }
+
+  // Build importedBy relationships
+  for (const [file, node] of Object.entries(graph.nodes)) {
+    for (const imp of node.imports) {
+      const resolved = path.normalize(path.join(path.dirname(file), imp));
+      // Try to find matching file
+      for (const ext of ['', ...SOURCE_EXTENSIONS]) {
+        const target = resolved + ext;
+        if (graph.nodes[target]) {
+          graph.nodes[target].importedBy.push(file);
+          break;
+        }
+      }
+    }
+  }
+
+  // Ensure output directory exists
+  const outputDir = path.dirname(outputPath);
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  fs.writeFileSync(outputPath, JSON.stringify(graph, null, 2));
+  console.log(\`Graph written to \${outputPath}\`);
+  console.log(\`Analyzed \${sourceFiles.length} files\`);
+}
+
+main();
+`,
+    },
+    // slack-notify.py - Notification script
+    {
+        path: 'vibe/scripts/slack-notify.py',
+        content: `#!/usr/bin/env -S uv run --quiet --script
+# /// script
+# requires-python = ">=3.11"
+# dependencies = ["requests", "python-dotenv"]
+# ///
+"""
+Slack notification script for Ralph completions and other events.
+
+Usage:
+    uv run slack-notify.py --plan-id ILS-2026-001 --status success
+    uv run slack-notify.py --message "Custom message" --title "Title"
+"""
+
+import argparse
+import os
+import sys
+try:
+    import requests
+    from dotenv import load_dotenv
+except ImportError:
+    print("Dependencies not available. Run with: uv run slack-notify.py")
+    sys.exit(1)
+
+
+def send_notification(webhook_url: str, title: str, message: str, status: str = "info") -> bool:
+    """Send a Slack notification."""
+    color = {
+        "success": "#36a64f",
+        "error": "#ff0000",
+        "info": "#0066cc"
+    }.get(status, "#0066cc")
+
+    payload = {
+        "attachments": [{
+            "color": color,
+            "title": title,
+            "text": message,
+            "footer": "Vibe-Fabric"
+        }]
+    }
+
+    try:
+        response = requests.post(webhook_url, json=payload, timeout=10)
+        return response.status_code == 200
+    except Exception as e:
+        print(f"Failed to send notification: {e}")
+        return False
+
+
+def main():
+    load_dotenv(".env.local")
+    load_dotenv(".env")
+
+    webhook_url = os.getenv("SLACK_WEBHOOK_URL")
+
+    if not webhook_url:
+        print("SLACK_WEBHOOK_URL not configured. Skipping notification.")
+        return
+
+    parser = argparse.ArgumentParser(description="Send Slack notifications")
+    parser.add_argument("--plan-id", help="Plan ID for completion notification")
+    parser.add_argument("--status", choices=["success", "error", "info"], default="info")
+    parser.add_argument("--message", help="Custom message")
+    parser.add_argument("--title", help="Custom title")
+    parser.add_argument("--summary", help="Additional summary text")
+    args = parser.parse_args()
+
+    if args.plan_id:
+        emoji = {"success": "✅", "error": "❌", "info": "ℹ️"}.get(args.status, "ℹ️")
+        title = f"{emoji} Ralph Complete: {args.plan_id}"
+        message = args.summary or f"Plan {args.plan_id} has completed."
+    else:
+        title = args.title or "Vibe-Fabric Notification"
+        message = args.message or "No message provided."
+
+    if send_notification(webhook_url, title, message, args.status):
+        print(f"Notification sent: {title}")
+    else:
+        print("Failed to send notification")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()
+`,
+    },
+];
+//# sourceMappingURL=vibe-scripts.js.map

package/dist/core/repo/templates/vibe-scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibe-scripts.js","sourceRoot":"","sources":["../../../../src/core/repo/templates/vibe-scripts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,uCAAuC;IACvC;QACE,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FZ;KACE;IAED,mDAAmD;IACnD;QACE,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GZ;KACE;IAED,wCAAwC;IACxC;QACE,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFZ;KACE;CACF,CAAC"}

package/dist/core/repo/validation.d.ts

@@ -0,0 +1,46 @@
+import { Octokit } from 'octokit';
+/**
+ * Parsed GitHub URL information
+ */
+export interface ParsedGitHubUrl {
+    owner: string;
+    repo: string;
+    fullUrl: string;
+}
+/**
+ * Repository access validation result
+ */
+export interface RepoAccessResult {
+    valid: boolean;
+    canRead: boolean;
+    canWrite: boolean;
+    isPrivate: boolean;
+    defaultBranch: string;
+    error?: string;
+}
+/**
+ * Parse a GitHub URL and extract owner/repo
+ * Supports formats:
+ * - github.com/owner/repo
+ * - https://github.com/owner/repo
+ * - https://github.com/owner/repo.git
+ * - git@github.com:owner/repo.git
+ */
+export declare function parseGitHubUrl(url: string): ParsedGitHubUrl | null;
+/**
+ * Validate repository access with a GitHub token
+ */
+export declare function validateRepoAccess(octokit: Octokit, owner: string, repo: string): Promise<RepoAccessResult>;
+/**
+ * Validate alias format
+ */
+export declare function isValidAlias(alias: string): boolean;
+/**
+ * Get validation error for alias
+ */
+export declare function getAliasError(alias: string): string | null;
+/**
+ * Generate a default alias from repository name
+ */
+export declare function generateDefaultAlias(repoName: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/repo/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/core/repo/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAqClE;AAYD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CA2E3B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAInD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7D"}