guardlink 1.0.0

package/dist/init/detect.d.ts

@@ -0,0 +1,42 @@
+/**
+ * GuardLink init — Project detection utilities.
+ * Detects language, project name, and existing agent instruction files.
+ */
+export type ProjectLanguage = 'typescript' | 'javascript' | 'python' | 'go' | 'rust' | 'java' | 'csharp' | 'ruby' | 'swift' | 'kotlin' | 'terraform' | 'unknown';
+export interface AgentFile {
+    /** Relative path from project root */
+    path: string;
+    /** Agent platform: claude, cursor, codex, copilot, windsurf, cline, gemini, generic */
+    platform: string;
+    /** Whether the file already exists */
+    exists: boolean;
+    /** Whether it already contains GuardLink instructions */
+    hasGuardLink: boolean;
+    /** Whether the agent's directory exists (e.g. .cursor/, .claude/) even if instruction file doesn't */
+    dirDetected: boolean;
+    /** The directory hint that was detected, if any */
+    dirHint?: string;
+}
+export interface ProjectInfo {
+    /** Project root directory */
+    root: string;
+    /** Detected project name */
+    name: string;
+    /** Primary language */
+    language: ProjectLanguage;
+    /** Comment prefix for the primary language */
+    commentPrefix: string;
+    /** File extension for definitions file */
+    definitionsExt: string;
+    /** Detected agent instruction files */
+    agentFiles: AgentFile[];
+    /** Whether .guardlink/ already exists */
+    alreadyInitialized: boolean;
+}
+export declare function detectProject(root: string): ProjectInfo;
+/**
+ * Get unique platforms that have been auto-detected via directory presence or existing files.
+ * Used by the picker to separate "detected" from "optional" agents.
+ */
+export declare function getDetectedPlatforms(agentFiles: AgentFile[]): Map<string, string>;
+//# sourceMappingURL=detect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/init/detect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,MAAM,eAAe,GACvB,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GACtD,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAC/C,WAAW,GAAG,SAAS,CAAC;AAE5B,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,sGAAsG;IACtG,WAAW,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,yCAAyC;IACzC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAiDD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAUvD;AA6GD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWjF"}

package/dist/init/detect.js

@@ -0,0 +1,185 @@
+/**
+ * GuardLink init — Project detection utilities.
+ * Detects language, project name, and existing agent instruction files.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, basename } from 'node:path';
+// ─── Agent file locations ────────────────────────────────────────────
+const AGENT_FILE_SPECS = [
+    { path: 'CLAUDE.md', platform: 'claude', dirHint: '.claude' },
+    { path: '.cursorrules', platform: 'cursor', dirHint: '.cursor' },
+    { path: '.cursor/rules/guardlink.mdc', platform: 'cursor', dirHint: '.cursor' },
+    { path: 'AGENTS.md', platform: 'codex', dirHint: '.codex' },
+    { path: 'codex.md', platform: 'codex', dirHint: '.codex' },
+    { path: '.github/copilot-instructions.md', platform: 'copilot', dirHint: '.github' },
+    { path: '.windsurfrules', platform: 'windsurf' },
+    { path: '.clinerules', platform: 'cline' },
+    { path: '.gemini/settings.json', platform: 'gemini', dirHint: '.gemini' },
+];
+// ─── Language detection ──────────────────────────────────────────────
+const LANG_SIGNALS = [
+    { files: ['tsconfig.json', 'tsconfig.build.json'], language: 'typescript' },
+    { files: ['package.json'], language: 'javascript' },
+    { files: ['pyproject.toml', 'setup.py', 'requirements.txt'], language: 'python' },
+    { files: ['go.mod', 'go.sum'], language: 'go' },
+    { files: ['Cargo.toml', 'Cargo.lock'], language: 'rust' },
+    { files: ['pom.xml', 'build.gradle', 'build.gradle.kts'], language: 'java' },
+    { files: ['*.csproj', '*.sln'], language: 'csharp' },
+    { files: ['Gemfile', 'Rakefile'], language: 'ruby' },
+    { files: ['Package.swift'], language: 'swift' },
+    { files: ['build.gradle.kts'], language: 'kotlin' },
+    { files: ['main.tf', 'variables.tf'], language: 'terraform' },
+];
+const LANG_CONFIG = {
+    typescript: { commentPrefix: '//', ext: '.ts' },
+    javascript: { commentPrefix: '//', ext: '.js' },
+    python: { commentPrefix: '#', ext: '.py' },
+    go: { commentPrefix: '//', ext: '.go' },
+    rust: { commentPrefix: '//', ext: '.rs' },
+    java: { commentPrefix: '//', ext: '.java' },
+    csharp: { commentPrefix: '//', ext: '.cs' },
+    ruby: { commentPrefix: '#', ext: '.rb' },
+    swift: { commentPrefix: '//', ext: '.swift' },
+    kotlin: { commentPrefix: '//', ext: '.kt' },
+    terraform: { commentPrefix: '#', ext: '.tf' },
+    unknown: { commentPrefix: '//', ext: '.ts' },
+};
+// ─── Detection functions ─────────────────────────────────────────────
+export function detectProject(root) {
+    return {
+        root,
+        name: detectProjectName(root),
+        language: detectLanguage(root),
+        commentPrefix: LANG_CONFIG[detectLanguage(root)].commentPrefix,
+        definitionsExt: LANG_CONFIG[detectLanguage(root)].ext,
+        agentFiles: detectAgentFiles(root),
+        alreadyInitialized: existsSync(join(root, '.guardlink')),
+    };
+}
+function detectProjectName(root) {
+    // Try package.json
+    const pkgPath = join(root, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (pkg.name)
+                return pkg.name;
+        }
+        catch { /* ignore */ }
+    }
+    // Try Cargo.toml
+    const cargoPath = join(root, 'Cargo.toml');
+    if (existsSync(cargoPath)) {
+        try {
+            const cargo = readFileSync(cargoPath, 'utf-8');
+            const m = cargo.match(/^name\s*=\s*"([^"]+)"/m);
+            if (m)
+                return m[1];
+        }
+        catch { /* ignore */ }
+    }
+    // Try go.mod
+    const goModPath = join(root, 'go.mod');
+    if (existsSync(goModPath)) {
+        try {
+            const goMod = readFileSync(goModPath, 'utf-8');
+            const m = goMod.match(/^module\s+(\S+)/m);
+            if (m)
+                return m[1].split('/').pop() || m[1];
+        }
+        catch { /* ignore */ }
+    }
+    // Try pyproject.toml
+    const pyprojectPath = join(root, 'pyproject.toml');
+    if (existsSync(pyprojectPath)) {
+        try {
+            const pyp = readFileSync(pyprojectPath, 'utf-8');
+            const m = pyp.match(/^name\s*=\s*"([^"]+)"/m);
+            if (m)
+                return m[1];
+        }
+        catch { /* ignore */ }
+    }
+    // Fallback: directory name
+    return basename(root);
+}
+function detectLanguage(root) {
+    let entries;
+    try {
+        entries = readdirSync(root);
+    }
+    catch {
+        return 'unknown';
+    }
+    for (const signal of LANG_SIGNALS) {
+        for (const pattern of signal.files) {
+            if (pattern.includes('*')) {
+                const ext = pattern.replace('*', '');
+                if (entries.some(e => e.endsWith(ext)))
+                    return signal.language;
+            }
+            else {
+                if (entries.includes(pattern))
+                    return signal.language;
+            }
+        }
+    }
+    // tsconfig.json takes priority over plain package.json for TS vs JS
+    if (entries.includes('tsconfig.json'))
+        return 'typescript';
+    if (entries.includes('package.json'))
+        return 'javascript';
+    return 'unknown';
+}
+function detectAgentFiles(root) {
+    const results = [];
+    for (const spec of AGENT_FILE_SPECS) {
+        const fullPath = join(root, spec.path);
+        const exists = existsSync(fullPath);
+        let hasGuardLink = false;
+        if (exists) {
+            try {
+                const content = readFileSync(fullPath, 'utf-8');
+                hasGuardLink = content.includes('GuardLink') || content.includes('guardlink');
+            }
+            catch { /* ignore */ }
+        }
+        // Check if agent directory exists even when instruction file doesn't
+        let dirDetected = false;
+        if (spec.dirHint) {
+            const dirPath = join(root, spec.dirHint);
+            try {
+                dirDetected = existsSync(dirPath) && statSync(dirPath).isDirectory();
+            }
+            catch { /* ignore */ }
+        }
+        results.push({
+            path: spec.path,
+            platform: spec.platform,
+            exists,
+            hasGuardLink,
+            dirDetected,
+            dirHint: spec.dirHint,
+        });
+    }
+    return results;
+}
+/**
+ * Get unique platforms that have been auto-detected via directory presence or existing files.
+ * Used by the picker to separate "detected" from "optional" agents.
+ */
+export function getDetectedPlatforms(agentFiles) {
+    const detected = new Map(); // platform → reason
+    for (const af of agentFiles) {
+        if (detected.has(af.platform))
+            continue;
+        if (af.exists) {
+            detected.set(af.platform, `found ${af.path}`);
+        }
+        else if (af.dirDetected && af.dirHint) {
+            detected.set(af.platform, `found ${af.dirHint}/`);
+        }
+    }
+    return detected;
+}
+//# sourceMappingURL=detect.js.map

package/dist/init/detect.js.map

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

package/dist/init/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GuardLink init — Project initialization.
+ *
+ * Detects project language and existing agent files, creates .guardlink/
+ * directory with shared definitions, and injects GuardLink instructions
+ * into agent instruction files (CLAUDE.md, .cursorrules, etc.).
+ *
+ * @exposes #init to #arbitrary-write [high] cwe:CWE-73 -- "Writes config files and agent instructions to user-specified root"
+ * @exposes #init to #path-traversal [high] cwe:CWE-22 -- "Creates directories and files based on user-provided root path"
+ * @mitigates #init against #arbitrary-write using #path-validation -- "Files written only to .guardlink/ subdirectory and known agent file locations"
+ * @mitigates #init against #path-traversal using #path-validation -- "join() used with fixed relative paths within root"
+ * @flows #cli -> #init via initProject -- "CLI passes user-specified root directory"
+ * @flows #init -> Filesystem via writeFileSync -- "Creates config.json, definitions.ts, agent instruction files"
+ */
+import { type ProjectInfo } from './detect.js';
+export { detectProject, type ProjectInfo, type AgentFile } from './detect.js';
+export { promptAgentSelection, resolveAgentFiles, AGENT_CHOICES } from './picker.js';
+export interface InitOptions {
+    /** Project root directory */
+    root: string;
+    /** Override project name */
+    project?: string;
+    /** Skip agent file updates (only create .guardlink/) */
+    skipAgentFiles?: boolean;
+    /** Force overwrite even if already initialized */
+    force?: boolean;
+    /** Dry run — show what would be created without writing */
+    dryRun?: boolean;
+    /** Explicit agent IDs to create files for (when no existing agent files found) */
+    agentIds?: string[];
+}
+export interface InitResult {
+    project: ProjectInfo;
+    created: string[];
+    updated: string[];
+    skipped: string[];
+}
+export declare function initProject(options: InitOptions): InitResult;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/init/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAiB,KAAK,WAAW,EAAkB,MAAM,aAAa,CAAC;AAa9E,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIrF,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AASD,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAoF5D"}

package/dist/init/index.js

@@ -0,0 +1,228 @@
+/**
+ * GuardLink init — Project initialization.
+ *
+ * Detects project language and existing agent files, creates .guardlink/
+ * directory with shared definitions, and injects GuardLink instructions
+ * into agent instruction files (CLAUDE.md, .cursorrules, etc.).
+ *
+ * @exposes #init to #arbitrary-write [high] cwe:CWE-73 -- "Writes config files and agent instructions to user-specified root"
+ * @exposes #init to #path-traversal [high] cwe:CWE-22 -- "Creates directories and files based on user-provided root path"
+ * @mitigates #init against #arbitrary-write using #path-validation -- "Files written only to .guardlink/ subdirectory and known agent file locations"
+ * @mitigates #init against #path-traversal using #path-validation -- "join() used with fixed relative paths within root"
+ * @flows #cli -> #init via initProject -- "CLI passes user-specified root directory"
+ * @flows #init -> Filesystem via writeFileSync -- "Creates config.json, definitions.ts, agent instruction files"
+ */
+import { existsSync, readFileSync, mkdirSync, writeFileSync, appendFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { detectProject } from './detect.js';
+import { agentInstructions, cursorRulesContent, cursorMdcContent, definitionsContent, configContent, mcpConfig, referenceDocContent, GITIGNORE_ENTRY, } from './templates.js';
+import { AGENT_CHOICES } from './picker.js';
+export { detectProject } from './detect.js';
+export { promptAgentSelection, resolveAgentFiles, AGENT_CHOICES } from './picker.js';
+// ─── Marker for detecting our content ────────────────────────────────
+const GUARDLINK_MARKER = '<!-- guardlink:begin -->';
+const GUARDLINK_MARKER_END = '<!-- guardlink:end -->';
+// ─── Main init function ──────────────────────────────────────────────
+export function initProject(options) {
+    const { root, force = false, dryRun = false, skipAgentFiles = false } = options;
+    const project = detectProject(root);
+    if (options.project)
+        project.name = options.project;
+    const created = [];
+    const updated = [];
+    const skipped = [];
+    // ── 1. Create .guardlink/ directory ──
+    const tsDir = join(root, '.guardlink');
+    if (!existsSync(tsDir)) {
+        if (!dryRun)
+            mkdirSync(tsDir, { recursive: true });
+        created.push('.guardlink/');
+    }
+    // ── 2. Create config.json ──
+    const configPath = join(tsDir, 'config.json');
+    if (!existsSync(configPath) || force) {
+        if (!dryRun)
+            writeFileSync(configPath, configContent(project));
+        created.push('.guardlink/config.json');
+    }
+    else {
+        skipped.push('.guardlink/config.json (exists)');
+    }
+    // ── 3. Create definitions file ──
+    const defsFile = `definitions${project.definitionsExt}`;
+    const defsPath = join(tsDir, defsFile);
+    if (!existsSync(defsPath) || force) {
+        if (!dryRun)
+            writeFileSync(defsPath, definitionsContent(project));
+        created.push(`.guardlink/${defsFile}`);
+    }
+    else {
+        skipped.push(`.guardlink/${defsFile} (exists)`);
+    }
+    // ── 4. Create docs/GUARDLINK_REFERENCE.md ──
+    const docsDir = join(root, 'docs');
+    const refDocPath = join(docsDir, 'GUARDLINK_REFERENCE.md');
+    if (!existsSync(refDocPath) || force) {
+        if (!dryRun) {
+            ensureDir(docsDir);
+            writeFileSync(refDocPath, referenceDocContent(project));
+        }
+        created.push('docs/GUARDLINK_REFERENCE.md');
+    }
+    else {
+        skipped.push('docs/GUARDLINK_REFERENCE.md (exists)');
+    }
+    // ── 5. Update .gitignore ──
+    const gitignorePath = join(root, '.gitignore');
+    if (existsSync(gitignorePath)) {
+        const content = readFileSync(gitignorePath, 'utf-8');
+        if (!content.includes('GuardLink') && !content.includes('.guardlink')) {
+            if (!dryRun)
+                appendFileSync(gitignorePath, GITIGNORE_ENTRY);
+            updated.push('.gitignore');
+        }
+    }
+    // ── 6. Update/create agent instruction files ──
+    if (!skipAgentFiles) {
+        const agentResults = updateAgentFiles(root, project, force, dryRun, options.agentIds);
+        created.push(...agentResults.created);
+        updated.push(...agentResults.updated);
+        skipped.push(...agentResults.skipped);
+    }
+    // ── 7. Create .mcp.json for Claude Code MCP integration ──
+    const mcpPath = join(root, '.mcp.json');
+    if (!existsSync(mcpPath) || force) {
+        if (!dryRun)
+            writeFileSync(mcpPath, mcpConfig());
+        created.push('.mcp.json');
+    }
+    else {
+        skipped.push('.mcp.json (exists)');
+    }
+    return { project, created, updated, skipped };
+}
+// ─── Agent file update logic ─────────────────────────────────────────
+function updateAgentFiles(root, project, force, dryRun, agentIds) {
+    const created = [];
+    const updated = [];
+    const skipped = [];
+    const ids = agentIds ?? ['claude'];
+    for (const id of ids) {
+        const choice = AGENT_CHOICES.find(c => c.id === id);
+        if (!choice)
+            continue;
+        const filePath = join(root, choice.file);
+        const exists = existsSync(filePath);
+        if (exists) {
+            // File exists — inject/update GuardLink block
+            const af = project.agentFiles.find(f => f.path === choice.file);
+            if (af?.hasGuardLink && !force) {
+                skipped.push(`${choice.file} (already has GuardLink)`);
+                continue;
+            }
+            const result = injectIntoAgentFile(root, choice.file, project, force, dryRun);
+            if (result === 'updated')
+                updated.push(choice.file);
+            else if (result === 'skipped')
+                skipped.push(choice.file);
+        }
+        else {
+            // File doesn't exist — create fresh
+            if (choice.file.endsWith('.mdc')) {
+                if (!dryRun) {
+                    ensureDir(dirname(filePath));
+                    writeFileSync(filePath, cursorMdcContent(project));
+                }
+                created.push(choice.file);
+            }
+            else if (choice.file === '.cursorrules' || choice.file === '.windsurfrules' || choice.file === '.clinerules') {
+                if (!dryRun) {
+                    writeFileSync(filePath, wrapMarkers(cursorRulesContent(project)));
+                }
+                created.push(choice.file);
+            }
+            else {
+                // Markdown-based (CLAUDE.md, AGENTS.md, copilot-instructions.md, .gemini/GEMINI.md)
+                if (!dryRun) {
+                    ensureDir(dirname(filePath));
+                    writeFileSync(filePath, buildClaudeMdFromScratch(project));
+                }
+                created.push(choice.file);
+            }
+        }
+    }
+    return { created, updated, skipped };
+}
+function injectIntoAgentFile(root, relPath, project, force, dryRun) {
+    const fullPath = join(root, relPath);
+    // Special handling for Cursor .mdc files
+    if (relPath.endsWith('.mdc')) {
+        if (!dryRun) {
+            ensureDir(dirname(fullPath));
+            writeFileSync(fullPath, cursorMdcContent(project));
+        }
+        return 'updated';
+    }
+    // Special handling for .cursorrules / .windsurfrules / .clinerules (no markdown headers)
+    if (relPath === '.cursorrules' || relPath === '.windsurfrules' || relPath === '.clinerules') {
+        const existing = readFileSync(fullPath, 'utf-8');
+        if (existing.includes('GuardLink') && !force)
+            return 'skipped';
+        if (!dryRun) {
+            const block = wrapMarkers(cursorRulesContent(project));
+            const newContent = replaceOrAppend(existing, block);
+            writeFileSync(fullPath, newContent);
+        }
+        return 'updated';
+    }
+    // Special handling for Gemini settings.json
+    if (relPath.endsWith('settings.json')) {
+        return 'skipped';
+    }
+    // All other markdown-based files
+    const existing = readFileSync(fullPath, 'utf-8');
+    if (existing.includes('GuardLink') && !force)
+        return 'skipped';
+    if (!dryRun) {
+        const block = wrapMarkers(agentInstructions(project));
+        const newContent = replaceOrAppend(existing, block);
+        writeFileSync(fullPath, newContent);
+    }
+    return 'updated';
+}
+function buildClaudeMdFromScratch(project) {
+    return `# ${toPascalCase(project.name)} — Project Instructions
+
+${wrapMarkers(agentInstructions(project))}`;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+function wrapMarkers(content) {
+    return `${GUARDLINK_MARKER}\n${content}\n${GUARDLINK_MARKER_END}\n`;
+}
+/**
+ * If markers exist, replace the content between them.
+ * Otherwise append to end of file.
+ */
+function replaceOrAppend(existing, block) {
+    const beginIdx = existing.indexOf(GUARDLINK_MARKER);
+    const endIdx = existing.indexOf(GUARDLINK_MARKER_END);
+    if (beginIdx !== -1 && endIdx !== -1) {
+        // Replace existing block
+        return existing.slice(0, beginIdx) + block + existing.slice(endIdx + GUARDLINK_MARKER_END.length);
+    }
+    // Append with separator
+    const separator = existing.endsWith('\n') ? '\n' : '\n\n';
+    return existing + separator + block;
+}
+function ensureDir(dir) {
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function toPascalCase(s) {
+    return s
+        .replace(/[-_./]/g, ' ')
+        .split(/\s+/)
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+        .join('');
+}
+//# sourceMappingURL=index.js.map

package/dist/init/index.js.map

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

package/dist/init/picker.d.ts

@@ -0,0 +1,32 @@
+/**
+ * GuardLink init — Interactive agent picker.
+ *
+ * Shows a detection-aware prompt:
+ *   - Always-created files (reference doc, AGENTS.md, .mcp.json)
+ *   - Auto-detected agents (directories found on disk)
+ *   - Optional agents the user can additionally select
+ */
+import type { AgentFile } from './detect.js';
+export interface AgentChoice {
+    id: string;
+    label: string;
+    file: string;
+    platform: string;
+}
+export declare const AGENT_CHOICES: AgentChoice[];
+/** Files that are always created regardless of agent selection. */
+export declare const ALWAYS_FILES: string[];
+/**
+ * Show detection-aware prompt. Displays:
+ *   1. Always-created files
+ *   2. Auto-detected agents (from directory presence)
+ *   3. Optional agents user can add
+ *
+ * Returns combined list of agent IDs (detected + user-selected).
+ */
+export declare function promptAgentSelection(agentFiles: AgentFile[]): Promise<string[]>;
+/**
+ * Resolve agent IDs (from picker or flags) to file paths.
+ */
+export declare function resolveAgentFiles(agentIds: string[]): AgentChoice[];
+//# sourceMappingURL=picker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../src/init/picker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAQtC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,YAAY,UAGxB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8ErF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAInE"}