compact-agent 1.1.0

package/dist/users.js

@@ -0,0 +1,193 @@
+/**
+ * Users table — persistent user management.
+ * Stores user data in ~/.crowcoder/users.json
+ *
+ * Each user has a unique ID, display name, and metadata.
+ * Users can be activated/deactivated, and the active user's context
+ * is injected into the system prompt so the LLM knows who it's working with.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { getConfigDir } from './config.js';
+import { createEmptyUsersTable } from './schema.js';
+const USERS_FILE = join(getConfigDir(), 'users.json');
+function defaultUsersData() {
+    return createEmptyUsersTable();
+}
+function loadUsers() {
+    if (!existsSync(USERS_FILE)) {
+        return defaultUsersData();
+    }
+    try {
+        const raw = readFileSync(USERS_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return defaultUsersData();
+    }
+}
+function saveUsers(data) {
+    mkdirSync(getConfigDir(), { recursive: true });
+    writeFileSync(USERS_FILE, JSON.stringify(data, null, 2), 'utf-8');
+}
+/**
+ * Create a new user. Returns the created User.
+ */
+export function createUser(name, email, role) {
+    const data = loadUsers();
+    const user = {
+        id: randomUUID(),
+        name,
+        email,
+        role,
+        active: false,
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        metadata: {},
+    };
+    data.users.push(user);
+    saveUsers(data);
+    return user;
+}
+/**
+ * List all users.
+ */
+export function listUsers() {
+    return loadUsers().users;
+}
+/**
+ * Get a user by ID.
+ */
+export function getUser(id) {
+    const data = loadUsers();
+    return data.users.find((u) => u.id === id) || null;
+}
+/**
+ * Get a user by email address.
+ */
+export function getUserByEmail(email) {
+    const data = loadUsers();
+    return data.users.find((u) => u.email?.toLowerCase() === email.toLowerCase()) || null;
+}
+/**
+ * Get the currently active user.
+ */
+export function getActiveUser() {
+    const data = loadUsers();
+    if (!data.activeUserId)
+        return null;
+    return getUser(data.activeUserId);
+}
+/**
+ * Update a user's fields. Returns the updated User or null if not found.
+ */
+export function updateUser(id, updates) {
+    const data = loadUsers();
+    const idx = data.users.findIndex((u) => u.id === id);
+    if (idx === -1)
+        return null;
+    const user = data.users[idx];
+    if (updates.name !== undefined)
+        user.name = updates.name;
+    if (updates.email !== undefined)
+        user.email = updates.email;
+    if (updates.role !== undefined)
+        user.role = updates.role;
+    if (updates.active !== undefined)
+        user.active = updates.active;
+    if (updates.metadata !== undefined)
+        user.metadata = { ...user.metadata, ...updates.metadata };
+    user.updatedAt = new Date().toISOString();
+    // If activating this user, deactivate all others
+    if (updates.active === true) {
+        data.activeUserId = id;
+        for (let i = 0; i < data.users.length; i++) {
+            if (i !== idx) {
+                data.users[i].active = false;
+            }
+        }
+    }
+    else if (updates.active === false && data.activeUserId === id) {
+        data.activeUserId = null;
+    }
+    data.users[idx] = user;
+    saveUsers(data);
+    return user;
+}
+/**
+ * Delete a user by ID. Returns true if deleted, false if not found.
+ */
+export function deleteUser(id) {
+    const data = loadUsers();
+    const idx = data.users.findIndex((u) => u.id === id);
+    if (idx === -1)
+        return false;
+    if (data.activeUserId === id) {
+        data.activeUserId = null;
+    }
+    data.users.splice(idx, 1);
+    saveUsers(data);
+    return true;
+}
+/**
+ * Set the active user by ID. Returns the activated User or null if not found.
+ */
+export function setActiveUser(id) {
+    const user = getUser(id);
+    if (!user)
+        return null;
+    return updateUser(id, { active: true });
+}
+/**
+ * Set user metadata key/value pair.
+ */
+export function setUserMetadata(id, key, value) {
+    const user = getUser(id);
+    if (!user)
+        return null;
+    return updateUser(id, { metadata: { ...user.metadata, [key]: value } });
+}
+/**
+ * Get a metadata value for a user.
+ */
+export function getUserMetadata(id, key) {
+    const user = getUser(id);
+    return user?.metadata[key];
+}
+/**
+ * Print a formatted user list to stdout.
+ */
+export function printUserList() {
+    const { users, activeUserId } = loadUsers();
+    if (users.length === 0) {
+        console.log('  No users defined yet.');
+        return;
+    }
+    for (const u of users) {
+        const marker = u.id === activeUserId ? ' ◀ active' : '';
+        const status = u.active ? '' : ' (inactive)';
+        const email = u.email ? ` <${u.email}>` : '';
+        const role = u.role ? ` [${u.role}]` : '';
+        console.log(`  ${u.id.slice(0, 8)}  ${u.name}${email}${role}${status}${marker}`);
+    }
+}
+/**
+ * Build a context string about the active user for the system prompt.
+ */
+export function buildUserContext() {
+    const user = getActiveUser();
+    if (!user)
+        return '';
+    const lines = [`# Active User: ${user.name}`];
+    if (user.email)
+        lines.push(`# Email: ${user.email}`);
+    if (user.role)
+        lines.push(`# Role: ${user.role}`);
+    const customKeys = Object.keys(user.metadata).filter((k) => !['name', 'email', 'role'].includes(k));
+    for (const k of customKeys) {
+        lines.push(`# ${k}: ${user.metadata[k]}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=users.js.map

package/dist/users.js.map

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

package/dist/verification.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Verification loop engine and checkpoint system
+ * - Verification loop (/verify): Runs tests, analyzes failures, fixes code, repeats
+ * - Checkpoint system (/checkpoint): Saves/restores git state
+ */
+export interface Checkpoint {
+    id: string;
+    sessionId: string;
+    label?: string;
+    headSha: string;
+    isDirty: boolean;
+    dirtyFiles: string[];
+    timestamp: string;
+    cwd: string;
+}
+export interface VerificationConfig {
+    maxIterations: number;
+    timeoutMs: number;
+    verbose: boolean;
+}
+declare function ensureCheckpointsDir(): void;
+declare function checkpointPath(sessionId: string, checkpointId: string): string;
+declare function generateCheckpointId(): string;
+declare function getGitHeadSha(cwd: string): string;
+declare function getGitDirtyFiles(cwd: string): string[];
+declare function isGitDirty(cwd: string): boolean;
+/**
+ * Save current git state as a checkpoint
+ * @param sessionId - Unique session identifier
+ * @param cwd - Working directory to checkpoint
+ * @param label - Optional label for the checkpoint
+ * @returns Checkpoint metadata
+ */
+export declare function saveCheckpoint(sessionId: string, cwd: string, label?: string): Checkpoint;
+/**
+ * List all checkpoints for a session
+ * @param sessionId - Session identifier
+ * @returns Array of checkpoint metadata
+ */
+export declare function listCheckpoints(sessionId: string): Checkpoint[];
+/**
+ * Restore a checkpoint (returns instructions for restoration)
+ * @param sessionId - Session identifier
+ * @param checkpointId - Checkpoint identifier
+ * @returns Instructions string for restoring the checkpoint
+ */
+export declare function restoreCheckpoint(sessionId: string, checkpointId: string): string;
+/**
+ * Auto-detect the test command for the current project
+ * @param cwd - Working directory
+ * @returns Test command string
+ */
+export declare function autoDetectTestCommand(cwd: string): string;
+/**
+ * Build a detailed verification loop prompt
+ * @param cwd - Working directory
+ * @param command - Optional test command (auto-detected if not provided)
+ * @returns Detailed prompt string
+ */
+export declare function buildVerifyPrompt(cwd: string, command?: string): string;
+/**
+ * Run a verification loop (for CLI reference/testing)
+ * @param cwd - Working directory
+ * @param command - Test command
+ * @param config - Verification configuration
+ * @returns Verification result
+ */
+export declare function runVerificationLoop(cwd: string, command: string, config?: VerificationConfig): Promise<{
+    success: boolean;
+    iterations: number;
+    errors: string[];
+}>;
+export { getGitHeadSha, getGitDirtyFiles, isGitDirty, generateCheckpointId, checkpointPath, ensureCheckpointsDir, };

package/dist/verification.js

@@ -0,0 +1,269 @@
+/**
+ * Verification loop engine and checkpoint system
+ * - Verification loop (/verify): Runs tests, analyzes failures, fixes code, repeats
+ * - Checkpoint system (/checkpoint): Saves/restores git state
+ */
+import { execSync } from 'node:child_process';
+import { readFileSync, writeFileSync, readdirSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import chalk from 'chalk';
+import { getConfigDir } from './config.js';
+// ── Checkpoint System ──────────────────────────────────
+const CHECKPOINTS_DIR = join(getConfigDir(), 'checkpoints');
+function ensureCheckpointsDir() {
+    mkdirSync(CHECKPOINTS_DIR, { recursive: true });
+}
+function checkpointPath(sessionId, checkpointId) {
+    return join(CHECKPOINTS_DIR, `${sessionId}__${checkpointId}.json`);
+}
+function generateCheckpointId() {
+    const ts = Date.now().toString(36);
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `${ts}-${rand}`;
+}
+function getGitHeadSha(cwd) {
+    try {
+        return execSync('git rev-parse HEAD', { cwd, encoding: 'utf-8' }).trim();
+    }
+    catch {
+        throw new Error('Not a git repository');
+    }
+}
+function getGitDirtyFiles(cwd) {
+    try {
+        const output = execSync('git status --porcelain', { cwd, encoding: 'utf-8' }).trim();
+        return output ? output.split('\n').map((line) => line.slice(3)) : [];
+    }
+    catch {
+        return [];
+    }
+}
+function isGitDirty(cwd) {
+    try {
+        const output = execSync('git status --porcelain', { cwd, encoding: 'utf-8' }).trim();
+        return output.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Save current git state as a checkpoint
+ * @param sessionId - Unique session identifier
+ * @param cwd - Working directory to checkpoint
+ * @param label - Optional label for the checkpoint
+ * @returns Checkpoint metadata
+ */
+export function saveCheckpoint(sessionId, cwd, label) {
+    ensureCheckpointsDir();
+    const checkpointId = generateCheckpointId();
+    const headSha = getGitHeadSha(cwd);
+    const isDirty = isGitDirty(cwd);
+    const dirtyFiles = getGitDirtyFiles(cwd);
+    const checkpoint = {
+        id: checkpointId,
+        sessionId,
+        label,
+        headSha,
+        isDirty,
+        dirtyFiles,
+        timestamp: new Date().toISOString(),
+        cwd,
+    };
+    const path = checkpointPath(sessionId, checkpointId);
+    writeFileSync(path, JSON.stringify(checkpoint, null, 2), 'utf-8');
+    return checkpoint;
+}
+/**
+ * List all checkpoints for a session
+ * @param sessionId - Session identifier
+ * @returns Array of checkpoint metadata
+ */
+export function listCheckpoints(sessionId) {
+    ensureCheckpointsDir();
+    const files = readdirSync(CHECKPOINTS_DIR).filter((f) => f.startsWith(`${sessionId}__`) && f.endsWith('.json'));
+    const checkpoints = [];
+    for (const file of files) {
+        try {
+            const raw = readFileSync(join(CHECKPOINTS_DIR, file), 'utf-8');
+            checkpoints.push(JSON.parse(raw));
+        }
+        catch {
+            // skip corrupt files
+        }
+    }
+    return checkpoints.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+}
+/**
+ * Restore a checkpoint (returns instructions for restoration)
+ * @param sessionId - Session identifier
+ * @param checkpointId - Checkpoint identifier
+ * @returns Instructions string for restoring the checkpoint
+ */
+export function restoreCheckpoint(sessionId, checkpointId) {
+    ensureCheckpointsDir();
+    const path = checkpointPath(sessionId, checkpointId);
+    if (!existsSync(path)) {
+        throw new Error(`Checkpoint not found: ${checkpointId}`);
+    }
+    const checkpoint = JSON.parse(readFileSync(path, 'utf-8'));
+    // Build restoration instructions
+    const instructions = [];
+    instructions.push(`${chalk.bold('Checkpoint Restoration Instructions')}:`);
+    instructions.push('');
+    instructions.push(`Label: ${checkpoint.label || '(unlabeled)'}`);
+    instructions.push(`Timestamp: ${checkpoint.timestamp}`);
+    instructions.push(`HEAD SHA: ${checkpoint.headSha}`);
+    instructions.push('');
+    instructions.push('To restore this checkpoint, run:');
+    instructions.push('');
+    instructions.push(`  cd "${checkpoint.cwd}"`);
+    instructions.push(`  git checkout ${checkpoint.headSha}`);
+    if (checkpoint.isDirty) {
+        instructions.push('');
+        instructions.push('Note: This checkpoint had uncommitted changes:');
+        for (const file of checkpoint.dirtyFiles) {
+            instructions.push(`  - ${file}`);
+        }
+        instructions.push('');
+        instructions.push('You may want to preserve them:');
+        instructions.push('  git stash');
+        instructions.push('  git checkout <your-branch>');
+        instructions.push('  git stash pop');
+    }
+    return instructions.join('\n');
+}
+// ── Verification Loop ──────────────────────────────────
+/**
+ * Auto-detect the test command for the current project
+ * @param cwd - Working directory
+ * @returns Test command string
+ */
+export function autoDetectTestCommand(cwd) {
+    const checks = [
+        { file: 'package.json', cmd: 'npm test' },
+        { file: 'pyproject.toml', cmd: 'pytest' },
+        { file: 'setup.py', cmd: 'pytest' },
+        { file: 'Cargo.toml', cmd: 'cargo test' },
+        { file: 'go.mod', cmd: 'go test ./...' },
+        { file: 'Gemfile', cmd: 'bundle exec rake test' },
+        { file: 'pom.xml', cmd: 'mvn test' },
+        { file: 'build.gradle', cmd: 'gradle test' },
+    ];
+    for (const { file, cmd } of checks) {
+        if (existsSync(join(cwd, file))) {
+            return cmd;
+        }
+    }
+    return 'npm test'; // default fallback
+}
+/**
+ * Build a detailed verification loop prompt
+ * @param cwd - Working directory
+ * @param command - Optional test command (auto-detected if not provided)
+ * @returns Detailed prompt string
+ */
+export function buildVerifyPrompt(cwd, command) {
+    const testCmd = command || autoDetectTestCommand(cwd);
+    const prompt = `You are now in verification mode. Your goal is to run tests, analyze failures, fix the code, and repeat until all tests pass.
+
+${chalk.bold('Verification Loop Process:')}
+
+1. ${chalk.cyan('Run the test command')}
+   Execute: ${chalk.yellow(testCmd)}
+   Capture all output, stderr, and exit codes
+
+2. ${chalk.cyan('Analyze the output')}
+   Look for:
+   - Failed test names and error messages
+   - Stack traces and assertion failures
+   - Missing imports or undefined references
+   - Type errors (if applicable)
+   - Any other compilation/runtime errors
+
+3. ${chalk.cyan('Fix the failing code')}
+   Based on the errors:
+   - Identify the root cause
+   - Modify the minimal necessary code to fix the issue
+   - Do NOT refactor unrelated code
+   - Ensure fixes are targeted and precise
+
+4. ${chalk.cyan('Re-run the test command')}
+   Execute: ${chalk.yellow(testCmd)}
+   Verify the fix resolved the issue
+
+5. ${chalk.cyan('Repeat until success')}
+   Continue the loop until either:
+   - All tests pass (SUCCESS)
+   - You've made 5 iterations (STOP - escalate)
+
+${chalk.bold('Important Guidelines:')}
+- ${chalk.dim('Work in:')} ${cwd}
+- ${chalk.dim('Run tests with:')} ${testCmd}
+- ${chalk.dim('Max iterations:')} 5 (safety limit)
+- ${chalk.dim('Be systematic:')} Fix one issue at a time
+- ${chalk.dim('Show progress:')} Report iteration count and current status
+- ${chalk.dim('Be explicit:')} Show the exact commands you run and their output
+- ${chalk.dim('Stop if stuck:')} If you can't make progress after 5 iterations, explain what you've tried and ask for help
+
+${chalk.bold('Output Format:')}
+For each iteration, clearly indicate:
+- Iteration number (e.g., "Iteration 1/5")
+- Test command being run
+- Output/errors found
+- Root cause analysis
+- Fix applied
+- Result of re-run
+
+When complete, provide a summary of:
+- Total iterations taken
+- Issues fixed
+- Final test status (PASS/FAIL)
+- Any remaining concerns
+`;
+    return prompt;
+}
+/**
+ * Run a verification loop (for CLI reference/testing)
+ * @param cwd - Working directory
+ * @param command - Test command
+ * @param config - Verification configuration
+ * @returns Verification result
+ */
+export async function runVerificationLoop(cwd, command, config = { maxIterations: 5, timeoutMs: 30000, verbose: false }) {
+    const errors = [];
+    let iterations = 0;
+    for (iterations = 1; iterations <= config.maxIterations; iterations++) {
+        if (config.verbose) {
+            console.log(`\n${chalk.blue(`Iteration ${iterations}/${config.maxIterations}`)}`);
+        }
+        try {
+            const output = execSync(command, {
+                cwd,
+                encoding: 'utf-8',
+                stdio: 'pipe',
+                timeout: config.timeoutMs,
+            });
+            if (config.verbose) {
+                console.log(chalk.green('All tests passed!'));
+            }
+            return { success: true, iterations, errors: [] };
+        }
+        catch (err) {
+            const errorOutput = err instanceof Error ? err.message : String(err);
+            errors.push(errorOutput);
+            if (config.verbose) {
+                console.log(chalk.red('Test failed'));
+                console.log(chalk.dim(errorOutput.slice(0, 200) + '...'));
+            }
+        }
+    }
+    return {
+        success: false,
+        iterations: config.maxIterations,
+        errors,
+    };
+}
+// ── Exports ────────────────────────────────────────────
+export { getGitHeadSha, getGitDirtyFiles, isGitDirty, generateCheckpointId, checkpointPath, ensureCheckpointsDir, };
+//# sourceMappingURL=verification.js.map

package/dist/verification.js.map

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

package/dist/walkthrough.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Walkthrough prompt — agent-led tour of Crowcoder.
+ *
+ * Invoked via `/walkthrough` (or `/tour` / `/guide`). Returns a prompt that
+ * puts the assistant into Onboarding Guide mode for the rest of the session
+ * (until the user runs `/clear` or switches modes). The guide leads the user
+ * through the canonical command surface — no duplicates, no ECC-vs-built-in
+ * choices to make.
+ */
+export declare function buildWalkthroughPrompt(): string;