instar 0.1.0

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "instar",
+  "version": "0.1.0",
+  "description": "Persistent autonomy infrastructure for AI agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "instar": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:all": "vitest run && vitest run --config vitest.integration.config.ts && vitest run --config vitest.e2e.config.ts",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "instar",
+    "autonomous",
+    "agent",
+    "molt",
+    "lobster",
+    "claude",
+    "cli",
+    "automation",
+    "claude-code"
+  ],
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.1",
+    "commander": "^12.0.0",
+    "croner": "^8.0.0",
+    "express": "^4.18.0",
+    "picocolors": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.11.0",
+    "@types/supertest": "^6.0.3",
+    "supertest": "^7.2.2",
+    "typescript": "^5.3.0",
+    "vitest": "^2.0.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+
+/**
+ * instar CLI — Persistent autonomy infrastructure for AI agents.
+ *
+ * Usage:
+ *   instar init my-project         # Create a new agent project from scratch
+ *   instar init                    # Add agent infrastructure to existing project
+ *   instar setup                   # Interactive setup wizard
+ *   instar server start            # Start the persistent agent server
+ *   instar server stop             # Stop the server
+ *   instar status                  # Show agent infrastructure status
+ *   instar user add                # Add a user profile
+ *   instar job add                 # Add a job definition
+ *   instar job list                # List all jobs
+ *   instar add telegram            # Add Telegram messaging adapter
+ */
+
+import { Command } from 'commander';
+import { initProject } from './commands/init.js';
+import { runSetup } from './commands/setup.js';
+import { startServer, stopServer } from './commands/server.js';
+import { showStatus } from './commands/status.js';
+import { addUser, listUsers } from './commands/user.js';
+import { addJob, listJobs } from './commands/job.js';
+
+const program = new Command();
+
+program
+  .name('instar')
+  .description('Persistent autonomy infrastructure for AI agents')
+  .version('0.1.0')
+  .option('--classic', 'Use the classic inquirer-based setup wizard instead of Claude')
+  .action((opts) => runSetup(opts)); // Default: run interactive setup when no subcommand given
+
+// ── Setup (explicit alias) ────────────────────────────────────────
+
+program
+  .command('setup')
+  .description('Interactive setup wizard (same as running `instar` with no args)')
+  .option('--classic', 'Use the classic inquirer-based setup wizard instead of Claude')
+  .action((opts) => runSetup(opts));
+
+// ── Init ─────────────────────────────────────────────────────────
+
+program
+  .command('init [project-name]')
+  .description('Initialize agent infrastructure (fresh project or existing)')
+  .option('-d, --dir <path>', 'Project directory (default: current directory)')
+  .option('--port <port>', 'Server port (default: 4040)', parseInt)
+  .action((projectName, opts) => {
+    // If a project name is given, it's a fresh install
+    // Otherwise, augment the current directory
+    initProject({ ...opts, name: projectName });
+  });
+
+// ── Add ───────────────────────────────────────────────────────────
+
+const addCmd = program
+  .command('add')
+  .description('Add capabilities to the agent');
+
+addCmd
+  .command('telegram')
+  .description('Add Telegram messaging adapter')
+  .option('--token <token>', 'Telegram bot token')
+  .option('--chat-id <id>', 'Telegram forum chat ID')
+  .action((_opts) => {
+    console.log('TODO: Add Telegram adapter (scaffolding only — use programmatic API for now)');
+  });
+
+addCmd
+  .command('email')
+  .description('Add email integration (Gmail)')
+  .action((_opts) => {
+    console.log('TODO: Add email integration');
+  });
+
+addCmd
+  .command('sentry')
+  .description('Add Sentry error monitoring')
+  .option('--dsn <dsn>', 'Sentry DSN')
+  .action((_opts) => {
+    console.log('TODO: Add Sentry integration');
+  });
+
+addCmd
+  .command('quota')
+  .description('Add Claude API quota tracking')
+  .action((_opts) => {
+    console.log('TODO: Add quota tracking');
+  });
+
+// ── Server ────────────────────────────────────────────────────────
+
+const serverCmd = program
+  .command('server')
+  .description('Manage the persistent agent server');
+
+serverCmd
+  .command('start')
+  .description('Start the agent server')
+  .option('--foreground', 'Run in foreground (default: background via tmux)')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(startServer);
+
+serverCmd
+  .command('stop')
+  .description('Stop the agent server')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(stopServer);
+
+// ── Status ────────────────────────────────────────────────────────
+
+program
+  .command('status')
+  .description('Show agent infrastructure status')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(showStatus);
+
+// ── User ──────────────────────────────────────────────────────────
+
+const userCmd = program
+  .command('user')
+  .description('Manage users');
+
+userCmd
+  .command('add')
+  .description('Add a user profile')
+  .requiredOption('--id <id>', 'User ID')
+  .requiredOption('--name <name>', 'User display name')
+  .option('--telegram <topicId>', 'Telegram topic ID')
+  .option('--email <email>', 'Email address')
+  .option('--slack <userId>', 'Slack user ID')
+  .option('--permissions <perms>', 'Comma-separated permissions', (v: string) => v.split(','))
+  .action(addUser);
+
+userCmd
+  .command('list')
+  .description('List all users')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(listUsers);
+
+// ── Job ───────────────────────────────────────────────────────────
+
+const jobCmd = program
+  .command('job')
+  .description('Manage scheduled jobs');
+
+jobCmd
+  .command('add')
+  .description('Add a job definition')
+  .requiredOption('--slug <slug>', 'Job identifier')
+  .requiredOption('--name <name>', 'Job display name')
+  .requiredOption('--schedule <cron>', 'Cron expression')
+  .option('--description <desc>', 'Job description')
+  .option('--priority <priority>', 'Priority (critical|high|medium|low)', 'medium')
+  .option('--model <model>', 'Model tier (opus|sonnet|haiku)', 'sonnet')
+  .option('--type <type>', 'Execution type (skill|prompt|script)', 'prompt')
+  .option('--execute <value>', 'Execution value (skill name, prompt text, or script path)')
+  .action(addJob);
+
+jobCmd
+  .command('list')
+  .description('List all jobs')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(listJobs);
+
+program.parse();