archrip 0.1.2

package/dist/commands/build.d.ts

@@ -0,0 +1,2 @@
+export declare function build(): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAqDA,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAsD3C"}

package/dist/commands/build.js

@@ -0,0 +1,88 @@
+import { existsSync, writeFileSync, mkdirSync, cpSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { loadAndValidate, validateViewerDir } from '../utils/validate.js';
+import { computeLayout } from '../utils/layout.js';
+import { installViewer } from '../install/viewer.js';
+import { updateGitignore } from '../utils/gitignore.js';
+function writeProcessedArchitecture(viewerDir, data, layoutMap) {
+    const viewerPublic = join(viewerDir, 'public');
+    mkdirSync(viewerPublic, { recursive: true });
+    const processedData = {
+        ...data,
+        _layout: layoutMap,
+    };
+    writeFileSync(join(viewerPublic, 'architecture.json'), JSON.stringify(processedData, null, 2));
+    console.log('  Wrote public/architecture.json (with layout data)');
+}
+function execSyncWithOutput(command, cwd) {
+    try {
+        execSync(command, { cwd, stdio: 'pipe' });
+    }
+    catch (err) {
+        if (err instanceof Error && 'stderr' in err) {
+            const stderr = String(err.stderr).trim();
+            if (stderr) {
+                throw new Error(`Command "${command}" failed:\n${stderr}`);
+            }
+        }
+        throw new Error(`Command "${command}" failed.`);
+    }
+}
+function runViewerBuild(viewerDir, distDir) {
+    console.log('Installing viewer dependencies...');
+    execSyncWithOutput('npm ci', viewerDir);
+    console.log('Building viewer...');
+    execSyncWithOutput('npm run build', viewerDir);
+    mkdirSync(distDir, { recursive: true });
+    const viewerDist = join(viewerDir, 'dist');
+    if (existsSync(viewerDist)) {
+        cpSync(viewerDist, distDir, { recursive: true });
+    }
+}
+export async function build() {
+    const projectDir = process.cwd();
+    const archripDir = join(projectDir, '.archrip');
+    const archJsonPath = join(archripDir, 'architecture.json');
+    const viewerDir = join(archripDir, 'viewer');
+    const distDir = join(archripDir, 'dist');
+    console.log('\narchrip build\n');
+    // 1. Check architecture.json exists
+    if (!existsSync(archJsonPath)) {
+        throw new Error('.archrip/architecture.json not found.\n'
+            + 'Run /archrip-scan to generate it.');
+    }
+    // 2. Always overwrite viewer to prevent supply-chain attacks
+    console.log('Setting up viewer...');
+    mkdirSync(archripDir, { recursive: true });
+    installViewer(archripDir);
+    updateGitignore(projectDir);
+    validateViewerDir(viewerDir);
+    // 3. Validate architecture.json
+    console.log('Validating architecture.json...');
+    const { data, errors, warnings } = loadAndValidate(archJsonPath);
+    if (errors.length > 0) {
+        const details = errors.map((err) => `  - ${err.path}: ${err.message}`).join('\n');
+        throw new Error(`Validation errors:\n${details}`);
+    }
+    if (warnings.length > 0) {
+        for (const w of warnings) {
+            console.warn(`  Warning: ${w.path}: ${w.message}`);
+        }
+    }
+    console.log(`  ${data.nodes.length} nodes, ${data.edges.length} edges, ${data.useCases?.length ?? 0} use cases`);
+    // 4. Compute dagre layout
+    console.log('Computing layout...');
+    const layout = computeLayout(data);
+    const layoutMap = {};
+    for (const node of layout.nodes) {
+        layoutMap[node.id] = { x: node.x, y: node.y };
+    }
+    // 5. Write processed data to viewer's public/
+    writeProcessedArchitecture(viewerDir, data, layoutMap);
+    // 6. Build viewer and copy dist
+    runViewerBuild(viewerDir, distDir);
+    console.log(`\nBuild complete! Output: .archrip/dist/`);
+    console.log('Run `npx archrip serve` to preview.');
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function init(targetPath: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AASA,wBAAsB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD5D"}

package/dist/commands/init.js

@@ -0,0 +1,58 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { detectAgents, getAllAgentTypes } from '../utils/detect-agents.js';
+import { detectProjectInfo } from '../utils/project-info.js';
+import { getTemplatesDir } from '../utils/paths.js';
+import { installViewer } from '../install/viewer.js';
+import { installSlashCommands } from '../install/slash-commands.js';
+import { updateGitignore } from '../utils/gitignore.js';
+export async function init(targetPath) {
+    const projectDir = resolve(targetPath);
+    console.log(`\narchrip init — ${projectDir}\n`);
+    // 1. Detect project info
+    const projectInfo = detectProjectInfo(projectDir);
+    console.log(`Detected: ${projectInfo.language}${projectInfo.framework ? ` / ${projectInfo.framework}` : ''}`);
+    // 2. Create .archrip/ directory
+    const archripDir = join(projectDir, '.archrip');
+    mkdirSync(archripDir, { recursive: true });
+    // 3. Write architecture.json skeleton
+    const archJsonPath = join(archripDir, 'architecture.json');
+    if (!existsSync(archJsonPath)) {
+        const templatesDir = getTemplatesDir();
+        const skeleton = JSON.parse(readFileSync(join(templatesDir, 'skeleton.json'), 'utf-8'));
+        const project = skeleton.project;
+        project.name = projectInfo.name;
+        project.language = projectInfo.language;
+        project.framework = projectInfo.framework;
+        writeFileSync(archJsonPath, JSON.stringify(skeleton, null, 2) + '\n');
+        console.log('  + .archrip/architecture.json (skeleton)');
+    }
+    else {
+        console.log('  ~ .archrip/architecture.json (already exists, skipped)');
+    }
+    // 4. Copy viewer template
+    installViewer(archripDir);
+    // 5. Detect agents and install slash commands
+    const detected = detectAgents(projectDir);
+    if (detected.length > 0) {
+        console.log(`\nDetected AI agents: ${detected.map((a) => a.type).join(', ')}`);
+        for (const agent of detected) {
+            installSlashCommands(projectDir, agent.type);
+        }
+    }
+    else {
+        console.log('\nNo AI agent config detected. Installing commands for all agents...');
+        for (const agentType of getAllAgentTypes()) {
+            installSlashCommands(projectDir, agentType);
+        }
+    }
+    // 6. Update .gitignore
+    updateGitignore(projectDir);
+    console.log(`
+Done! Next steps:
+  1. Run /archrip-scan in your AI agent to analyze the codebase
+  2. Run: npx archrip build
+  3. Run: npx archrip serve
+`);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/serve.d.ts

@@ -0,0 +1,2 @@
+export declare function serve(): Promise<void>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAKA,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAwB3C"}

package/dist/commands/serve.js

@@ -0,0 +1,27 @@
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { build } from './build.js';
+import { validateViewerDir } from '../utils/validate.js';
+export async function serve() {
+    const projectDir = process.cwd();
+    const viewerDir = join(projectDir, '.archrip', 'viewer');
+    // Always rebuild to ensure layout reflects latest architecture.json
+    await build();
+    // Verify viewer origin before executing anything in that directory
+    validateViewerDir(viewerDir);
+    console.log('\narchrip serve — Starting preview server...\n');
+    // Use vite preview to serve the built files
+    try {
+        execSync('npm run preview -- --port 4173 --open', {
+            cwd: viewerDir,
+            stdio: 'inherit',
+        });
+    }
+    catch (err) {
+        // Ctrl+C (SIGINT) → status is null, exit silently
+        if (err instanceof Error && 'status' in err && err.status !== null) {
+            throw new Error('Failed to start preview server.');
+        }
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEzD,oEAAoE;IACpE,MAAM,KAAK,EAAE,CAAC;IAEd,mEAAmE;IACnE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAE7B,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAE9D,4CAA4C;IAC5C,IAAI,CAAC;QACH,QAAQ,CAAC,uCAAuC,EAAE;YAChD,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,kDAAkD;QAClD,IAAI,GAAG,YAAY,KAAK,IAAI,QAAQ,IAAI,GAAG,IAAK,GAAyD,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1H,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { init } from './commands/init.js';
+import { build } from './commands/build.js';
+import { serve } from './commands/serve.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const args = process.argv.slice(2);
+const command = args[0];
+async function main() {
+    switch (command) {
+        case 'init':
+            await init(args[1] ?? '.');
+            break;
+        case 'build':
+            await build();
+            break;
+        case 'serve':
+            await serve();
+            break;
+        case '--version':
+        case '-v':
+            console.log(`archrip v${pkg.version}`);
+            break;
+        case '--help':
+        case '-h':
+        case undefined:
+            printUsage();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            printUsage();
+            process.exit(1);
+    }
+}
+function printUsage() {
+    console.log(`
+archrip - Generate interactive architecture diagrams from your codebase
+
+Usage:
+  archrip init [path]    Initialize archrip in a project directory
+  archrip build          Build the architecture viewer (static HTML)
+  archrip serve          Preview the built viewer in browser
+
+Options:
+  -v, --version           Show version
+  -h, --help              Show this help
+
+Workflow:
+  1. /archrip-scan               # AI scans codebase → architecture.json
+  2. npx archrip build           # Build static HTML viewer (auto-installs viewer)
+  3. npx archrip serve           # Preview in browser
+`);
+}
+main().catch((err) => {
+    if (err instanceof Error) {
+        console.error(`Error: ${err.message}`);
+    }
+    else {
+        console.error(err);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,KAAK,UAAU,IAAI;IACjB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAC3B,MAAM;QACR,KAAK,OAAO;YACV,MAAM,KAAK,EAAE,CAAC;YACd,MAAM;QACR,KAAK,OAAO;YACV,MAAM,KAAK,EAAE,CAAC;YACd,MAAM;QACR,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACvC,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,UAAU,EAAE,CAAC;YACb,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,UAAU,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;CAgBb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/install/slash-commands.d.ts

@@ -0,0 +1,6 @@
+import type { AgentType } from '../utils/detect-agents.js';
+/**
+ * Copy slash command templates for a specific agent type.
+ */
+export declare function installSlashCommands(projectDir: string, agentType: AgentType): void;
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/install/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/install/slash-commands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAwBnF"}

package/dist/install/slash-commands.js

@@ -0,0 +1,31 @@
+import { existsSync, mkdirSync, readdirSync, copyFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getTemplatesDir } from '../utils/paths.js';
+/**
+ * Copy slash command templates for a specific agent type.
+ */
+export function installSlashCommands(projectDir, agentType) {
+    const templatesDir = getTemplatesDir();
+    const srcDir = join(templatesDir, 'slash-commands', agentType);
+    if (!existsSync(srcDir))
+        return;
+    const commandDirMap = {
+        claude: '.claude/commands',
+        gemini: '.gemini/commands',
+        codex: '.codex/commands',
+    };
+    const destDir = join(projectDir, commandDirMap[agentType]);
+    mkdirSync(destDir, { recursive: true });
+    const files = readdirSync(srcDir);
+    for (const file of files) {
+        const dest = join(destDir, file);
+        if (!existsSync(dest)) {
+            copyFileSync(join(srcDir, file), dest);
+            console.log(`  + ${commandDirMap[agentType]}/${file}`);
+        }
+        else {
+            console.log(`  ~ ${commandDirMap[agentType]}/${file} (already exists, skipped)`);
+        }
+    }
+}
+//# sourceMappingURL=slash-commands.js.map

package/dist/install/slash-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.js","sourceRoot":"","sources":["../../src/install/slash-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,SAAoB;IAC3E,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO;IAEhC,MAAM,aAAa,GAA8B;QAC/C,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,kBAAkB;QAC1B,KAAK,EAAE,iBAAiB;KACzB,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3D,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,IAAI,4BAA4B,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/install/viewer.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Copy the viewer template to .archrip/viewer/
+ */
+export declare function installViewer(archripDir: string): void;
+//# sourceMappingURL=viewer.d.ts.map

package/dist/install/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/install/viewer.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAiBtD"}

package/dist/install/viewer.js

@@ -0,0 +1,40 @@
+import { existsSync, mkdirSync, writeFileSync, copyFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { getViewerDir } from '../utils/paths.js';
+/**
+ * Copy the viewer template to .archrip/viewer/
+ */
+export function installViewer(archripDir) {
+    const viewerSrc = getViewerDir();
+    const viewerDest = join(archripDir, 'viewer');
+    if (!existsSync(viewerSrc)) {
+        console.log('  ! Viewer template not found (expected in monorepo). Skipping viewer copy.');
+        return;
+    }
+    mkdirSync(viewerDest, { recursive: true });
+    // Copy viewer files recursively, skipping node_modules and dist
+    copyDirRecursive(viewerSrc, viewerDest, ['node_modules', 'dist', '.tsbuildinfo']);
+    // Write marker file to verify viewer origin in build/serve
+    writeFileSync(join(viewerDest, '.archrip-viewer'), 'archrip-official-viewer\n');
+    console.log('  + .archrip/viewer/ (viewer template)');
+}
+function copyDirRecursive(src, dest, skipDirs) {
+    mkdirSync(dest, { recursive: true });
+    const entries = readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (skipDirs.includes(entry.name))
+            continue;
+        // Skip symlinks to prevent path traversal via symlink injection
+        if (entry.isSymbolicLink())
+            continue;
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath, skipDirs);
+        }
+        else {
+            copyFileSync(srcPath, destPath);
+        }
+    }
+}
+//# sourceMappingURL=viewer.js.map

package/dist/install/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.js","sourceRoot":"","sources":["../../src/install/viewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE9C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO;IACT,CAAC;IAED,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,gEAAgE;IAChE,gBAAgB,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAElF,2DAA2D;IAC3D,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,IAAY,EAAE,QAAkB;IACrE,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAC5C,gEAAgE;QAChE,IAAI,KAAK,CAAC,cAAc,EAAE;YAAE,SAAS;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/schema/architecture.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/yida29/archrip/main/packages/cli/src/schema/architecture.schema.json",
+  "title": "archrip Architecture Schema",
+  "description": "Schema for architecture.json used by archrip to generate interactive architecture diagrams",
+  "type": "object",
+  "required": ["version", "project", "nodes", "edges"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": {
+      "type": "string",
+      "const": "1.0"
+    },
+    "project": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string", "description": "Project display name" },
+        "description": { "type": "string" },
+        "language": { "type": "string" },
+        "framework": { "type": "string" },
+        "sourceUrl": {
+          "type": "string",
+          "description": "URL template for source links. Use {filePath} as placeholder. Example: https://github.com/org/repo/blob/main/{filePath}"
+        },
+        "layout": {
+          "type": "string",
+          "enum": ["dagre", "concentric"],
+          "default": "dagre",
+          "description": "Layout algorithm: 'dagre' (top-to-bottom) or 'concentric' (onion/DDD ring layout)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "nodes": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/node" }
+    },
+    "edges": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/edge" }
+    },
+    "useCases": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/useCase" }
+    },
+    "schemas": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/tableSchema" }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "node": {
+      "type": "object",
+      "required": ["id", "category", "label", "layer"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+        "category": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string", "default": "" },
+        "filePath": { "type": "string", "default": "" },
+        "layer": { "type": "integer", "minimum": 0 },
+        "methods": { "type": "array", "items": { "type": "string" } },
+        "routes": { "type": "array", "items": { "type": "string" } },
+        "useCases": { "type": "array", "items": { "type": "string" } },
+        "schema": { "type": "string", "description": "Key into top-level schemas object" },
+        "implements": { "type": "string" },
+        "externalService": { "type": "string" },
+        "sqlExamples": { "type": "array", "items": { "type": "string" } },
+        "depth": { "type": "integer", "minimum": 0, "maximum": 2, "description": "Abstraction depth: 0=overview (boundary), 1=structure (internal), 2=detail (implementation). Auto-inferred from category if omitted." }
+      },
+      "additionalProperties": false
+    },
+    "edge": {
+      "type": "object",
+      "required": ["source", "target"],
+      "properties": {
+        "source": { "type": "string" },
+        "target": { "type": "string" },
+        "label": { "type": ["string", "null"] },
+        "type": {
+          "type": "string",
+          "enum": ["dependency", "implements", "relation"],
+          "default": "dependency"
+        }
+      },
+      "additionalProperties": false
+    },
+    "useCase": {
+      "type": "object",
+      "required": ["id", "name", "nodeIds"],
+      "properties": {
+        "id": { "type": "string" },
+        "name": { "type": "string" },
+        "description": { "type": "string", "default": "" },
+        "nodeIds": { "type": "array", "items": { "type": "string" } },
+        "flow": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "tableSchema": {
+      "type": "object",
+      "required": ["tableName", "columns"],
+      "properties": {
+        "tableName": { "type": "string" },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name", "type"],
+            "properties": {
+              "name": { "type": "string" },
+              "type": { "type": "string" },
+              "nullable": { "type": "boolean", "default": false },
+              "default": { "type": "string" },
+              "index": { "type": "string" },
+              "foreignKey": {
+                "type": "object",
+                "required": ["table", "column"],
+                "properties": {
+                  "table": { "type": "string" },
+                  "column": { "type": "string" },
+                  "onDelete": { "type": "string" }
+                },
+                "additionalProperties": false
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "indexes": { "type": "array", "items": { "type": "string" } },
+        "enumValues": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/dist/templates/skeleton.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://raw.githubusercontent.com/yida29/archrip/main/packages/cli/src/schema/architecture.schema.json",
+  "version": "1.0",
+  "project": {
+    "name": "",
+    "description": "",
+    "language": "",
+    "framework": "",
+    "sourceUrl": ""
+  },
+  "nodes": [],
+  "edges": [],
+  "useCases": [],
+  "schemas": {}
+}

package/dist/templates/slash-commands/claude/archrip-refine.md

@@ -0,0 +1,17 @@
+---
+description: Interactively refine the architecture diagram
+---
+
+# archrip refine — Refine architecture diagram
+
+Read `.archrip/architecture.json` and apply the user's requested changes:
+- Add/remove/modify nodes
+- Fix relationships
+- Add/modify use cases
+- Adjust layer assignments
+- Add database schemas
+- Improve descriptions
+
+Write the updated `.archrip/architecture.json`.
+
+$ARGUMENTS