ai-dev-analytics 1.0.3 → 1.1.0

package/dist/utils/ai-build.js

@@ -0,0 +1,278 @@
+import { dirname, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { buildRuleViews } from './rules.js';
+import { bootstrapSkillRegistry, buildSkillViews, getSkillContent } from './skills.js';
+import { ensureGuide, updateGuide, updateGuideReferences } from './guide.js';
+import { configPath } from './paths.js';
+import { ensureDir, fileExists, readJson, readText, writeJson, writeText } from './fs.js';
+export const QUICK_COMMANDS = [
+    { name: 'workflow', skill: 'workflow-orchestrator' },
+    { name: 'audit', skill: 'audit' },
+    { name: 'deviation', skill: 'deviation-recorder' },
+    { name: 'self-reviewer', skill: 'self-reviewer' },
+    { name: 'bug-fixer', skill: 'bug-fixer' },
+    { name: 'rules-evolver', skill: 'rules-evolver' },
+];
+const MCP_SERVER_ENTRY = {
+    command: 'npx',
+    args: ['-y', 'ai-dev-analytics', 'mcp'],
+};
+const MCP_CONFIG_JSON = JSON.stringify({
+    mcpServers: {
+        aida: MCP_SERVER_ENTRY,
+    },
+}, null, 2);
+const CODEX_CONFIG_TOML = `[mcp_servers.aida]
+command = "npx"
+args = ["-y", "ai-dev-analytics", "mcp"]
+`;
+export function readConfiguredTools(projectRoot) {
+    if (!fileExists(configPath(projectRoot)))
+        return [];
+    const config = readJson(configPath(projectRoot));
+    if (Array.isArray(config.aiTools) && config.aiTools.length > 0) {
+        return [...new Set(config.aiTools)];
+    }
+    return config.aiTool ? [config.aiTool] : [];
+}
+export function normalizeRequestedTools(projectRoot, requested = []) {
+    const configured = readConfiguredTools(projectRoot);
+    if (requested.length === 0 || requested.includes('all'))
+        return configured;
+    const valid = new Set(['claude-code', 'cursor', 'vscode-copilot', 'windsurf', 'lingma', 'codex']);
+    return requested.filter((tool) => valid.has(tool));
+}
+function writeJsonMerge(filePath) {
+    if (fileExists(filePath)) {
+        try {
+            const existing = JSON.parse(readText(filePath));
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers.aida = MCP_SERVER_ENTRY;
+            writeText(filePath, JSON.stringify(existing, null, 2) + '\n');
+            return;
+        }
+        catch {
+            // Fall through to overwrite invalid JSON.
+        }
+    }
+    writeText(filePath, MCP_CONFIG_JSON + '\n');
+}
+function mergeCodexToml(raw) {
+    const trimmed = raw.trim();
+    const block = CODEX_CONFIG_TOML.trim();
+    const pattern = /\[mcp_servers\.aida\][\s\S]*?(?=\n\[|$)/m;
+    if (!trimmed)
+        return `${block}\n`;
+    if (pattern.test(trimmed)) {
+        return `${trimmed.replace(pattern, block).trim()}\n`;
+    }
+    return `${trimmed}\n\n${block}\n`;
+}
+function syncCodexGlobalConfig() {
+    const home = process.env.HOME || homedir();
+    const codexDir = resolve(home, '.codex');
+    const codexConfigPath = resolve(codexDir, 'config.toml');
+    ensureDir(dirname(codexConfigPath));
+    const existing = fileExists(codexConfigPath) ? readText(codexConfigPath) : '';
+    writeText(codexConfigPath, mergeCodexToml(existing));
+    return codexConfigPath;
+}
+function toolConfigSnapshotPath(projectRoot) {
+    return resolve(projectRoot, '.aida', 'tool-configs.json');
+}
+function readJsonIfExists(filePath) {
+    if (!fileExists(filePath))
+        return null;
+    try {
+        return JSON.parse(readText(filePath));
+    }
+    catch {
+        return readText(filePath);
+    }
+}
+function writeToolConfigSnapshot(projectRoot, tools, codexGlobalPath) {
+    const snapshots = [];
+    if (tools.includes('claude-code')) {
+        snapshots.push({
+            tool: 'claude-code',
+            path: '.mcp.json',
+            format: 'json',
+            content: readJsonIfExists(resolve(projectRoot, '.mcp.json')),
+        });
+    }
+    if (tools.includes('cursor')) {
+        snapshots.push({
+            tool: 'cursor',
+            path: '.cursor/mcp.json',
+            format: 'json',
+            content: readJsonIfExists(resolve(projectRoot, '.cursor', 'mcp.json')),
+        });
+    }
+    if (tools.includes('vscode-copilot')) {
+        snapshots.push({
+            tool: 'vscode-copilot',
+            path: '.vscode/mcp.json',
+            format: 'json',
+            content: readJsonIfExists(resolve(projectRoot, '.vscode', 'mcp.json')),
+        });
+    }
+    if (tools.includes('lingma')) {
+        snapshots.push({
+            tool: 'lingma',
+            path: '.lingma/mcp.json',
+            format: 'json',
+            content: readJsonIfExists(resolve(projectRoot, '.lingma', 'mcp.json')),
+        });
+    }
+    if (tools.includes('codex')) {
+        snapshots.push({
+            tool: 'codex',
+            path: '.aida/codex/config.toml',
+            format: 'toml',
+            content: fileExists(resolve(projectRoot, '.aida', 'codex', 'config.toml'))
+                ? readText(resolve(projectRoot, '.aida', 'codex', 'config.toml'))
+                : '',
+        });
+        if (codexGlobalPath) {
+            snapshots.push({
+                tool: 'codex',
+                path: codexGlobalPath,
+                format: 'toml',
+                content: readText(codexGlobalPath),
+            });
+        }
+    }
+    writeJson(toolConfigSnapshotPath(projectRoot), {
+        generatedAt: new Date().toISOString(),
+        tools,
+        snapshots,
+    });
+    return toolConfigSnapshotPath(projectRoot);
+}
+export function writeMcpConfig(projectRoot, tools) {
+    const written = [];
+    for (const tool of tools) {
+        switch (tool) {
+            case 'claude-code':
+                writeJsonMerge(resolve(projectRoot, '.mcp.json'));
+                written.push('.mcp.json');
+                break;
+            case 'cursor': {
+                const dir = resolve(projectRoot, '.cursor');
+                ensureDir(dir);
+                writeJsonMerge(resolve(dir, 'mcp.json'));
+                written.push('.cursor/mcp.json');
+                break;
+            }
+            case 'vscode-copilot': {
+                const dir = resolve(projectRoot, '.vscode');
+                ensureDir(dir);
+                writeJsonMerge(resolve(dir, 'mcp.json'));
+                written.push('.vscode/mcp.json');
+                break;
+            }
+            case 'lingma': {
+                const dir = resolve(projectRoot, '.lingma');
+                ensureDir(dir);
+                writeJsonMerge(resolve(dir, 'mcp.json'));
+                written.push('.lingma/mcp.json');
+                break;
+            }
+            case 'codex': {
+                const dir = resolve(projectRoot, '.aida', 'codex');
+                ensureDir(dir);
+                writeText(resolve(dir, 'config.toml'), CODEX_CONFIG_TOML);
+                const globalPath = syncCodexGlobalConfig();
+                written.push(`.aida/codex/config.toml (synced to ${globalPath})`);
+                break;
+            }
+            case 'windsurf':
+                written.push('(windsurf: manual config needed)');
+                break;
+        }
+    }
+    return written;
+}
+function buildClaudeCommands(projectRoot) {
+    const dir = resolve(projectRoot, '.claude', 'commands');
+    ensureDir(dir);
+    let written = 0;
+    for (const cmd of QUICK_COMMANDS) {
+        const content = getSkillContent(projectRoot, cmd.skill);
+        if (!content)
+            continue;
+        writeText(resolve(dir, `${cmd.name}.md`), content);
+        written++;
+    }
+    return written;
+}
+function buildCursorCommands(projectRoot) {
+    let written = 0;
+    for (const cmd of QUICK_COMMANDS) {
+        const content = getSkillContent(projectRoot, cmd.skill);
+        if (!content)
+            continue;
+        const dir = resolve(projectRoot, '.cursor', 'skills', cmd.name);
+        ensureDir(dir);
+        writeText(resolve(dir, 'SKILL.md'), content);
+        written++;
+    }
+    return written;
+}
+export function ensureBuildGitignore(projectRoot, tools) {
+    const gitignorePath = resolve(projectRoot, '.gitignore');
+    const existing = fileExists(gitignorePath) ? readText(gitignorePath) : '';
+    const entries = [
+        '.aida/rules/*.md',
+        '.aida/skills/*/SKILL.md',
+        '.aida/index.json',
+        '.aida/tool-configs.json',
+    ];
+    if (tools.includes('claude-code')) {
+        entries.push('.mcp.json', '.claude/commands/*.md');
+    }
+    if (tools.includes('cursor')) {
+        entries.push('.cursor/mcp.json', '.cursor/skills/', '.cursor/rules/aidevos/');
+    }
+    if (tools.includes('vscode-copilot')) {
+        entries.push('.vscode/mcp.json');
+    }
+    if (tools.includes('lingma')) {
+        entries.push('.lingma/mcp.json', '.lingma/rules/');
+    }
+    if (tools.includes('codex')) {
+        entries.push('.aida/codex/config.toml');
+    }
+    const toAdd = entries.filter((entry) => !existing.includes(entry));
+    if (toAdd.length > 0) {
+        writeText(gitignorePath, existing.trimEnd() + '\n\n# AIDA - generated local AI tool artifacts\n' + toAdd.join('\n') + '\n');
+    }
+    return toAdd;
+}
+export function buildProjectArtifacts(projectRoot, requestedTools = []) {
+    const tools = normalizeRequestedTools(projectRoot, requestedTools);
+    bootstrapSkillRegistry(projectRoot);
+    const ruleViews = buildRuleViews(projectRoot);
+    const skillViews = buildSkillViews(projectRoot);
+    const mcpFiles = writeMcpConfig(projectRoot, tools);
+    let commandFiles = 0;
+    if (tools.includes('claude-code'))
+        commandFiles += buildClaudeCommands(projectRoot);
+    if (tools.includes('cursor'))
+        commandFiles += buildCursorCommands(projectRoot);
+    ensureGuide(projectRoot);
+    updateGuide(projectRoot);
+    updateGuideReferences(projectRoot, tools);
+    const toolConfigSnapshot = writeToolConfigSnapshot(projectRoot, tools);
+    const gitignoreAdded = ensureBuildGitignore(projectRoot, tools);
+    return {
+        tools,
+        ruleViews,
+        skillViews,
+        mcpFiles,
+        commandFiles,
+        gitignoreAdded,
+        toolConfigSnapshot,
+    };
+}
+//# sourceMappingURL=ai-build.js.map

package/dist/utils/ai-build.js.map

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

package/dist/utils/fs.d.ts

@@ -6,4 +6,22 @@ export declare function readText(filePath: string): string;
 export declare function writeText(filePath: string, content: string): void;
 export declare function getProjectName(): string;
 export declare function listDirs(dir: string): string[];
+/**
+ * Extract ours/theirs sections from a file with git conflict markers.
+ * Handles standard format and diff3 format (with ||||||| base section).
+ * Returns null if no conflict markers found.
+ */
+export declare function extractConflictSections(raw: string): {
+    ours: string;
+    theirs: string;
+} | null;
+/**
+ * Parse one side of a JSON merge-conflict section into a normalized array payload.
+ * Supports:
+ * - full arrays: `[{}, {}]`
+ * - single objects: `{}`
+ * - empty object / null / empty string => `[]`
+ * - array fragments extracted from inside a larger array: `{...}, {...}`
+ */
+export declare function parseConflictJsonArray<T = Record<string, unknown>>(raw: string): T[];
 //# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAUA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAGzD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAE/D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAUvC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9C"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAUA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAGzD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAE/D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAUvC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,GACV;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6BzC;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,CAoBpF"}

package/dist/utils/fs.js

@@ -40,4 +40,74 @@ export function listDirs(dir) {
         return statSync(full).isDirectory();
     });
 }
+/**
+ * Extract ours/theirs sections from a file with git conflict markers.
+ * Handles standard format and diff3 format (with ||||||| base section).
+ * Returns null if no conflict markers found.
+ */
+export function extractConflictSections(raw) {
+    const lines = raw.split('\n');
+    let state = 'before';
+    let hasConflict = false;
+    const oursLines = [];
+    const theirsLines = [];
+    for (const line of lines) {
+        if (line.startsWith('<<<<<<<')) {
+            hasConflict = true;
+            state = 'ours';
+        }
+        else if (line.startsWith('|||||||')) {
+            state = 'base'; // diff3 base section — skip
+        }
+        else if (line.startsWith('=======')) {
+            state = 'theirs';
+        }
+        else if (line.startsWith('>>>>>>>')) {
+            state = 'before'; // reset after conflict block
+        }
+        else {
+            if (state === 'ours')
+                oursLines.push(line);
+            else if (state === 'theirs')
+                theirsLines.push(line);
+        }
+    }
+    if (!hasConflict)
+        return null;
+    return {
+        ours: oursLines.join('\n').trim(),
+        theirs: theirsLines.join('\n').trim(),
+    };
+}
+/**
+ * Parse one side of a JSON merge-conflict section into a normalized array payload.
+ * Supports:
+ * - full arrays: `[{}, {}]`
+ * - single objects: `{}`
+ * - empty object / null / empty string => `[]`
+ * - array fragments extracted from inside a larger array: `{...}, {...}`
+ */
+export function parseConflictJsonArray(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed || trimmed === 'null' || trimmed === '{}')
+        return [];
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed))
+            return parsed;
+        if (parsed && typeof parsed === 'object') {
+            return Object.keys(parsed).length === 0 ? [] : [parsed];
+        }
+    }
+    catch {
+        // Fall through to fragment parsing.
+    }
+    try {
+        const parsed = JSON.parse(`[${trimmed}]`);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
 //# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAc,QAAgB;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAa;IACvD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IACzD,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAClB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CACvC,CAAC;QACF,IAAI,GAAG,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"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"}

package/dist/utils/git.d.ts

@@ -1,4 +1,13 @@
+export declare function isGitRepo(): boolean;
+export declare function isSvnRepo(): boolean;
+/**
+ * Get the current branch / working copy name.
+ * Priority: git → svn → AIDA_BRANCH env → "main"
+ */
 export declare function getBranchName(): string;
+/**
+ * Get the current developer name.
+ * Priority: git config user.name → svn Last Changed Author → AIDA_DEV env → OS username
+ */
 export declare function getDevName(): string;
-export declare function isGitRepo(): boolean;
 //# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,SAAS,IAAI,OAAO,CAOnC"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,IAAI,OAAO,CAOnC;AAID,wBAAgB,SAAS,IAAI,OAAO,CAOnC;AAsBD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAWtC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAiBnC"}

package/dist/utils/git.js

@@ -1,18 +1,86 @@
 import { execSync } from 'node:child_process';
-export function getBranchName() {
-    return execSync('git branch --show-current', { encoding: 'utf-8' }).trim();
-}
-export function getDevName() {
-    const name = execSync('git config user.name', { encoding: 'utf-8' }).trim();
-    return name.toLowerCase().replace(/\s+/g, '-');
-}
+import { userInfo } from 'node:os';
+// ─── Git ─────────────────────────────────────────────────
 export function isGitRepo() {
     try {
-        execSync('git rev-parse --is-inside-work-tree', { encoding: 'utf-8' });
+        execSync('git rev-parse --is-inside-work-tree', { encoding: 'utf-8', stdio: 'pipe' });
         return true;
     }
     catch {
         return false;
     }
 }
+// ─── SVN ─────────────────────────────────────────────────
+export function isSvnRepo() {
+    try {
+        execSync('svn info', { encoding: 'utf-8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getSvnBranchName() {
+    try {
+        const info = execSync('svn info', { encoding: 'utf-8', stdio: 'pipe' });
+        const urlMatch = info.match(/^URL:\s*(.+)$/m);
+        if (urlMatch) {
+            const url = urlMatch[1].trim();
+            // branches/feature-x → feature-x
+            const branchMatch = url.match(/\/branches\/([^/]+)/);
+            if (branchMatch)
+                return branchMatch[1];
+            // trunk → trunk
+            if (/\/trunk(\/|$)/.test(url))
+                return 'trunk';
+            // fall back to last path segment
+            return url.split('/').filter(Boolean).pop() || 'main';
+        }
+    }
+    catch { /* ignore */ }
+    return 'main';
+}
+// ─── VCS-agnostic ────────────────────────────────────────
+/**
+ * Get the current branch / working copy name.
+ * Priority: git → svn → AIDA_BRANCH env → "main"
+ */
+export function getBranchName() {
+    try {
+        const name = execSync('git branch --show-current', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+        if (name)
+            return name;
+    }
+    catch { /* fall through */ }
+    try {
+        if (isSvnRepo())
+            return getSvnBranchName();
+    }
+    catch { /* fall through */ }
+    return process.env.AIDA_BRANCH || 'main';
+}
+/**
+ * Get the current developer name.
+ * Priority: git config user.name → svn Last Changed Author → AIDA_DEV env → OS username
+ */
+export function getDevName() {
+    try {
+        const name = execSync('git config user.name', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+        if (name)
+            return name.toLowerCase().replace(/\s+/g, '-');
+    }
+    catch { /* fall through */ }
+    try {
+        const info = execSync('svn info', { encoding: 'utf-8', stdio: 'pipe' });
+        const authorMatch = info.match(/^Last Changed Author:\s*(.+)$/m);
+        if (authorMatch) {
+            const name = authorMatch[1].trim();
+            if (name)
+                return name.toLowerCase().replace(/\s+/g, '-');
+        }
+    }
+    catch { /* fall through */ }
+    const osUser = process.env.AIDA_DEV || userInfo().username;
+    return osUser.toLowerCase().replace(/\s+/g, '-');
+}
 //# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,aAAa;IAC3B,OAAO,QAAQ,CAAC,2BAA2B,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC;QACH,QAAQ,CAAC,qCAAqC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}

package/dist/utils/guide.d.ts

@@ -2,17 +2,34 @@
  * AIDA Guide — ensures data collection and rule sedimentation guidance
  * is written to AI tool instruction files.
  *
- * Single source of truth: .aidevos/aida-guide.md
- * References: CLAUDE.md (Claude Code) / .cursor/rules/ (Cursor)
+ * Single source of truth: .aida/aida-guide.md
+ * References: CLAUDE.md (Claude Code) / AGENTS.md (Codex) / .cursor/rules/ (Cursor)
  */
 export declare function guidePath(projectRoot: string): string;
 /**
- * Write .aidevos/aida-guide.md if it doesn't exist.
+ * Write .aida/aida-guide.md if it doesn't exist.
  */
 export declare function ensureGuide(projectRoot: string): void;
 /**
- * Add guide reference to AI tool instruction files.
+ * Always overwrite .aida/aida-guide.md with the latest template content.
+ * Called by `aida rules build` to keep the guide in sync with the package version.
+ */
+export declare function updateGuide(projectRoot: string): void;
+/**
+ * Add guide reference to AI tool instruction files (create-if-not-exists).
  * Called by init (with explicit tool list) or ensureRunJson (auto-detect).
  */
 export declare function syncGuideReference(projectRoot: string, tools?: string[]): void;
+/**
+ * Update guide content in all detected AI tool instruction files with latest template.
+ * Called by `aida rules build` — always overwrites so content stays in sync.
+ */
+export declare function updateGuideReferences(projectRoot: string, tools?: string[]): void;
+/**
+ * Ensure the AIDA guide reference sits near the top of CLAUDE.md with up-to-date content.
+ * Moves the section if it's buried lower in the file, and updates stale content.
+ * Called by `aida rules build` so the AI always encounters it first.
+ */
+export declare function ensureGuideAtTop(projectRoot: string): void;
+export declare function ensureCodexGuideAtTop(projectRoot: string): void;
 //# sourceMappingURL=guide.d.ts.map

package/dist/utils/guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/utils/guide.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwIH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAKrD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAe9E"}
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/utils/guide.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0JH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAKrD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAkB9E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAwBjF;AAmCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAqC1D;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAgC/D"}