create-agonda 0.1.0

package/index.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+
+import { createInterface } from 'node:readline';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, rmSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { tmpdir } from 'node:os';
+
+const PACKAGE_NAME = '@alavida-ai/agonda-framework';
+const REGISTRY = 'https://npm.pkg.github.com';
+
+// --- Helpers ---
+
+function hashFile(absPath) {
+  return createHash('sha256').update(readFileSync(absPath)).digest('hex');
+}
+
+function fetchFramework() {
+  const tmp = join(tmpdir(), `create-agonda-${Date.now()}`);
+  mkdirSync(tmp, { recursive: true });
+
+  try {
+    execFileSync('npm', [
+      'install', '--prefix', tmp,
+      '--registry', REGISTRY,
+      PACKAGE_NAME,
+    ], { encoding: 'utf-8', timeout: 60000, stdio: ['pipe', 'pipe', 'pipe'] });
+  } catch (err) {
+    rmSync(tmp, { recursive: true, force: true });
+    const stderr = err.stderr || '';
+    if (stderr.includes('404') || stderr.includes('not found')) {
+      console.error('Error: Agonda framework package not found.');
+      console.error('Check your .npmrc has GitHub Packages auth configured.');
+    } else {
+      console.error(`Error fetching framework: ${stderr.trim() || err.message}`);
+    }
+    process.exit(1);
+  }
+
+  const packageDir = join(tmp, 'node_modules', PACKAGE_NAME);
+  if (!existsSync(packageDir)) {
+    rmSync(tmp, { recursive: true, force: true });
+    console.error('Error: Package installed but not found at expected path.');
+    process.exit(1);
+  }
+
+  return { packageDir, tmp };
+}
+
+function generateClaudeMd(templatePath, companyName, description) {
+  let content = readFileSync(templatePath, 'utf-8');
+  content = content.replace('{Instance Name}', companyName);
+  content = content.replace('{description}', description);
+  content = content.replace(
+    /\| \*\{domain\}\* \| \*\{type\}\* \| \*\{owner\}\* \| \*\{routing hint\}\* \|/,
+    '| *(add domains via governance process)* | | | |'
+  );
+  return content;
+}
+
+/**
+ * Collect all lines from stdin, then serve them sequentially.
+ * Works with both piped input and interactive TTY.
+ */
+function createPrompter() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const lines = [];
+  let lineResolve = null;
+  let closed = false;
+
+  rl.on('line', (line) => {
+    if (lineResolve) {
+      const resolve = lineResolve;
+      lineResolve = null;
+      resolve(line);
+    } else {
+      lines.push(line);
+    }
+  });
+
+  rl.on('close', () => {
+    closed = true;
+    if (lineResolve) {
+      lineResolve(null);
+    }
+  });
+
+  return {
+    ask(prompt) {
+      process.stdout.write(prompt);
+      if (lines.length > 0) {
+        const line = lines.shift();
+        process.stdout.write(line + '\n');
+        return Promise.resolve(line);
+      }
+      if (closed) {
+        return Promise.resolve(null);
+      }
+      return new Promise((resolve) => {
+        lineResolve = resolve;
+      });
+    },
+    close() {
+      rl.close();
+    },
+  };
+}
+
+// --- Main ---
+
+async function main() {
+  const dirArg = process.argv[2];
+
+  if (dirArg === '--help' || dirArg === '-h') {
+    console.log('Usage: npx @alavida-ai/create-agonda [directory]\n');
+    console.log('Create a new Agonda instance.\n');
+    console.log('Options:');
+    console.log('  -h, --help    Show this help message');
+    process.exit(0);
+  }
+
+  const prompter = createPrompter();
+
+  let targetDir;
+  if (dirArg) {
+    targetDir = join(process.cwd(), dirArg);
+  } else {
+    const dir = await prompter.ask('Directory name: ');
+    if (!dir || !dir.trim()) {
+      console.error('Directory name is required.');
+      process.exit(1);
+    }
+    targetDir = join(process.cwd(), dir.trim());
+  }
+
+  if (existsSync(targetDir)) {
+    prompter.close();
+    console.error(`Error: ${targetDir} already exists.`);
+    process.exit(1);
+  }
+
+  const companyName = await prompter.ask('Company name: ');
+  if (!companyName || !companyName.trim()) {
+    prompter.close();
+    console.error('Company name is required.');
+    process.exit(1);
+  }
+
+  const description = await prompter.ask(`What does ${companyName.trim()} do? `);
+  prompter.close();
+
+  if (!description || !description.trim()) {
+    console.error('Description is required.');
+    process.exit(1);
+  }
+
+  console.log(`\nCreating Agonda instance for ${companyName.trim()}...\n`);
+
+  // 1. Fetch framework package
+  process.stdout.write('  Fetching framework...');
+  const { packageDir, tmp } = fetchFramework();
+  const manifest = JSON.parse(readFileSync(join(packageDir, 'manifest.json'), 'utf-8'));
+  console.log(` v${manifest.version}`);
+
+  // 2. Create directory structure
+  mkdirSync(targetDir, { recursive: true });
+  const workspaceDirs = [
+    'workspace/inbox',
+    'workspace/active',
+    'workspace/reference',
+    'workspace/archive',
+    'domains',
+    '.agonda',
+  ];
+  for (const dir of workspaceDirs) {
+    mkdirSync(join(targetDir, dir), { recursive: true });
+  }
+  console.log('  Created workspace directories');
+
+  // 3. Copy managed files from framework
+  const contentDir = join(packageDir, 'content');
+  const files = {};
+  for (const [filePath] of Object.entries(manifest.files)) {
+    const src = join(contentDir, filePath);
+    const dest = join(targetDir, filePath);
+    mkdirSync(dirname(dest), { recursive: true });
+    cpSync(src, dest);
+    files[filePath] = { sha256: hashFile(dest) };
+  }
+  console.log(`  Installed ${Object.keys(files).length} framework files`);
+
+  // 4. Generate CLAUDE.md from template
+  const templatePath = join(packageDir, 'templates', 'CLAUDE.md');
+  const claudeMd = generateClaudeMd(templatePath, companyName.trim(), description.trim());
+  writeFileSync(join(targetDir, 'CLAUDE.md'), claudeMd);
+  console.log('  Generated CLAUDE.md');
+
+  // 5. Write .agonda/manifest.json
+  const instanceManifest = {
+    framework: {
+      package: PACKAGE_NAME,
+      version: manifest.version,
+      installed: new Date().toISOString(),
+    },
+    files,
+  };
+  writeFileSync(
+    join(targetDir, '.agonda', 'manifest.json'),
+    JSON.stringify(instanceManifest, null, 2) + '\n'
+  );
+
+  // 6. Write .gitignore
+  writeFileSync(join(targetDir, '.gitignore'), [
+    '.agonda/status.json',
+    'node_modules/',
+    '.DS_Store',
+    '',
+  ].join('\n'));
+
+  // 7. Git init + initial commit
+  try {
+    execFileSync('git', ['init'], { cwd: targetDir, stdio: 'pipe' });
+    execFileSync('git', ['add', '.'], { cwd: targetDir, stdio: 'pipe' });
+    execFileSync('git', ['commit', '-m', `Initialize Agonda instance for ${companyName.trim()}`], {
+      cwd: targetDir,
+      stdio: 'pipe',
+    });
+    console.log('  Initialized git repository');
+  } catch {
+    console.log('  Warning: git init failed — initialize manually');
+  }
+
+  // 8. Clean up
+  rmSync(tmp, { recursive: true, force: true });
+
+  // Done
+  const dirName = dirArg || targetDir.split('/').pop();
+  console.log(`\nDone. Next:\n\n  cd ${dirName} && claude\n`);
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "create-agonda",
+  "version": "0.1.0",
+  "description": "Create a new Agonda instance",
+  "type": "module",
+  "bin": {
+    "create-agonda": "./index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alavida-ai/create-agonda.git"
+  },
+  "keywords": [
+    "agonda",
+    "governance",
+    "ai-agents",
+    "scaffolding"
+  ],
+  "author": "Alavida AI",
+  "license": "MIT",
+  "private": false
+}