@aperant/framework 0.6.2

package/dist/cli/commands/team.mjs

@@ -0,0 +1,113 @@
+/**
+ * commands/team.mjs — team subcommand (C29).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { getGitIdentity } from '../git/identity.mjs';
+import { teamSync } from '../team/team.mjs';
+import { withFileLock } from '../util/fs-lock.mjs';
+import { atomicWriteJson } from '../util/io.mjs';
+import { err, ok } from '../util/result.mjs';
+/**
+ * team subcommand: init | status | list | disable | sync
+ */
+export function cmdTeam(subcommand, projectDir, extraArgs) {
+    if (!subcommand)
+        return err('Usage: apt-tools team <init|status|list|disable|sync> <project-dir>');
+    if (!projectDir)
+        return err('Usage: apt-tools team ' + subcommand + ' <project-dir>');
+    const targetDir = resolve(projectDir);
+    const teamPath = join(targetDir, '.aperant', 'team.json');
+    switch (subcommand) {
+        case 'init': {
+            mkdirSync(join(targetDir, '.aperant'), { recursive: true });
+            const identity = getGitIdentity(targetDir);
+            const now = new Date().toISOString();
+            let team = { version: 1, enabled: true, members: {} };
+            if (existsSync(teamPath)) {
+                try {
+                    team = JSON.parse(readFileSync(teamPath, 'utf-8'));
+                }
+                catch {
+                    /* reset on corruption */
+                }
+                team.enabled = true;
+                if (!team.members)
+                    team.members = {};
+            }
+            if (identity) {
+                team.members[identity.email] = team.members[identity.email] || {
+                    name: identity.name,
+                    email: identity.email,
+                    joined_at: now,
+                };
+                team.members[identity.email].name = identity.name;
+            }
+            writeFileSync(teamPath, JSON.stringify(team, null, 2) + '\n', 'utf-8');
+            // C34: the legacy active.json seed was removed. The per-agent
+            // team-status/ directory is lazily created by the coordination
+            // store on first upsert.
+            return ok({
+                status: 'ok',
+                command: 'team-init',
+                team,
+                current_user: identity,
+            });
+        }
+        case 'status': {
+            if (!existsSync(teamPath)) {
+                return ok({ status: 'ok', command: 'team-status', enabled: false });
+            }
+            const team = JSON.parse(readFileSync(teamPath, 'utf-8'));
+            const identity = getGitIdentity(targetDir);
+            return ok({
+                status: 'ok',
+                command: 'team-status',
+                enabled: team.enabled === true,
+                member_count: Object.keys(team.members || {}).length,
+                current_user: identity,
+                is_registered: identity ? !!team.members?.[identity.email] : false,
+            });
+        }
+        case 'list': {
+            if (!existsSync(teamPath)) {
+                return ok({ status: 'ok', command: 'team-list', members: [] });
+            }
+            const team = JSON.parse(readFileSync(teamPath, 'utf-8'));
+            return ok({
+                status: 'ok',
+                command: 'team-list',
+                members: Object.values(team.members || {}),
+            });
+        }
+        case 'disable': {
+            if (!existsSync(teamPath))
+                return err('No team.json found');
+            withFileLock(teamPath, () => {
+                const team = JSON.parse(readFileSync(teamPath, 'utf-8'));
+                team.enabled = false;
+                atomicWriteJson(teamPath, team);
+            });
+            return ok({ status: 'ok', command: 'team-disable' });
+        }
+        case 'sync': {
+            // Parse flags: --push (bool), --message <msg>
+            let push = false;
+            let message = null;
+            for (let i = 0; i < extraArgs.length; i++) {
+                if (extraArgs[i] === '--push') {
+                    push = true;
+                }
+                else if (extraArgs[i] === '--message' && i + 1 < extraArgs.length) {
+                    message = extraArgs[i + 1];
+                    i++;
+                }
+            }
+            const result = teamSync(targetDir, { push, message });
+            return ok({ command: 'team-sync', ...result });
+        }
+        default:
+            return err(`Unknown team subcommand: ${subcommand}. Expected: init, status, list, disable, sync`);
+    }
+}
+//# sourceMappingURL=team.mjs.map

package/dist/cli/commands/team.mjs.map

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

package/dist/cli/commands/template.d.mts

@@ -0,0 +1,2 @@
+export function cmdTemplate(name: any): import("../util/result.mjs").RawCommandResult;
+//# sourceMappingURL=template.d.mts.map

package/dist/cli/commands/template.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/template.mjs"],"names":[],"mappings":"AAoBA,sFAuBC"}

package/dist/cli/commands/template.mjs

@@ -0,0 +1,41 @@
+/**
+ * commands/template.mjs — template dump command (C29).
+ *
+ * Layer 1 (post-CLI-layering refactor). Special-case: this cmd writes RAW
+ * template text to stdout (not JSON) — the consumer pipes it directly into
+ * a file or another tool. After subtask 20, returns the {rawText, exitCode}
+ * tuple so wrap() routes it through process.stdout.write without wrapping
+ * a JSON envelope on top.
+ *
+ * Errors throw a plain Error which wrap() catches and converts to fail().
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { rawText } from '../util/result.mjs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export function cmdTemplate(name) {
+    if (!name)
+        throw new Error('Usage: apt-tools template <name>\nAvailable: agents-greenfield, agents-brownfield, config, state, gitignore');
+    const templateDir = resolve(__dirname, '..', '..', '..', 'templates');
+    const nameMap = {
+        'agents-greenfield': 'agents-greenfield.md',
+        'agents-brownfield': 'agents-brownfield.md',
+        config: 'config.json',
+        state: 'state.json',
+        gitignore: 'gitignore-aperant',
+    };
+    const filename = nameMap[name];
+    if (!filename)
+        throw new Error(`Unknown template: ${name}. Available: ${Object.keys(nameMap).join(', ')}`);
+    const templatePath = join(templateDir, filename);
+    if (!existsSync(templatePath))
+        throw new Error(`Template file not found: ${templatePath}`);
+    // Output raw content (not JSON) so it can be used directly. The rawText
+    // shape (subtask 15) routes through wrap()'s process.stdout.write path
+    // without a JSON envelope wrapper. (subtask 20: replaces the legacy
+    // `return undefined + side-effect-write` pattern.)
+    return rawText(readFileSync(templatePath, 'utf-8'), 0);
+}
+//# sourceMappingURL=template.mjs.map

package/dist/cli/commands/template.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.mjs","sourceRoot":"","sources":["../../../src/cli/commands/template.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAErC,MAAM,UAAU,WAAW,CAAC,IAAI;IAC/B,IAAI,CAAC,IAAI;QACR,MAAM,IAAI,KAAK,CACd,6GAA6G,CAC7G,CAAA;IACF,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAA;IACrE,MAAM,OAAO,GAAG;QACf,mBAAmB,EAAE,sBAAsB;QAC3C,mBAAmB,EAAE,sBAAsB;QAC3C,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,mBAAmB;KAC9B,CAAA;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,QAAQ;QACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,gBAAgB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC5F,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IAChD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAA;IAC1F,wEAAwE;IACxE,uEAAuE;IACvE,oEAAoE;IACpE,mDAAmD;IACnD,OAAO,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;AACvD,CAAC"}

package/dist/cli/commands/terminal.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Public entry point — dispatched from packages/framework/bin/apt-tools.mjs.
+ *
+ * @param {string} subcommand
+ * @param {string[]} extraArgs
+ */
+export function cmdTerminal(subcommand: string, extraArgs?: string[]): Promise<import("../util/result.mjs").CommandResult>;
+//# sourceMappingURL=terminal.d.mts.map

package/dist/cli/commands/terminal.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/terminal.mjs"],"names":[],"mappings":"AAmCA;;;;;GAKG;AACH,wCAHW,MAAM,cACN,MAAM,EAAE,uDAoGlB"}

package/dist/cli/commands/terminal.mjs

@@ -0,0 +1,128 @@
+/**
+ * cli/commands/terminal.mjs — apt-tools terminal {spawn|list|status|health}
+ *
+ * Talks to the Electron-main AperantIpcServer over the per-user, per-pid
+ * Unix-domain socket whose absolute path is in process.env.APERANT_IPC_SOCKET.
+ *
+ * All output is JSON to stdout. Exit codes:
+ *   0 — success (request returned ok:true OR ok:false with structured error)
+ *   1 — internal error / unexpected exception
+ *   2 — preflight failure (not_in_aperant_terminal, electron_compute_unavailable)
+ *
+ * Custom error envelope shape `{error, message}` (not the standard
+ * `{status:'error', error}`) preserved verbatim via the local terminalErr()
+ * helper that returns { envelope, exitCode } tuples wrap() can consume.
+ * The dispatch.mjs `terminal` handler keeps its `.catch` wrapper for
+ * unhandled rejections — same byte-identical D-04 backward-compat as
+ * taste-infer.
+ */
+import { connectSocket } from '../terminal/socket-client.mjs';
+import { parseFlags } from '../util/args.mjs';
+import { exitWith, ok } from '../util/result.mjs';
+/**
+ * Build the terminal custom error envelope. Returns the {envelope, exitCode}
+ * tuple wrap() consumes.
+ *
+ * @param {string} code
+ * @param {string} message
+ * @param {number} exitCode
+ */
+function terminalErr(code, message, exitCode) {
+    return exitWith({ error: code, message }, exitCode);
+}
+/**
+ * Public entry point — dispatched from packages/framework/bin/apt-tools.mjs.
+ *
+ * @param {string} subcommand
+ * @param {string[]} extraArgs
+ */
+export async function cmdTerminal(subcommand, extraArgs = []) {
+    if (!subcommand || subcommand === '--help' || subcommand === '-h') {
+        return terminalErr('usage', 'apt-tools terminal {spawn|list|status|health} [flags]', 1);
+    }
+    // Preflight: must be running inside an Aperant terminal.
+    const socketPath = process.env.APERANT_IPC_SOCKET;
+    if (!socketPath || socketPath.length === 0) {
+        return terminalErr('not_in_aperant_terminal', 'APERANT_IPC_SOCKET is not set. apt-tools terminal commands only work inside an Aperant-spawned PTY (TERM_PROGRAM=Aperant).', 2);
+    }
+    const callerDepth = Number(process.env.APERANT_SPAWN_DEPTH ?? '0') || 0;
+    const flags = parseFlags(extraArgs);
+    let client;
+    try {
+        client = await connectSocket(socketPath);
+    }
+    catch (err) {
+        const code = err && err.code === 'ENOENT' ? 'electron_compute_unavailable' : 'connect_failed';
+        return terminalErr(code, code === 'electron_compute_unavailable'
+            ? `Electron main is not running — socket file ${socketPath} does not exist.`
+            : err instanceof Error
+                ? err.message
+                : String(err), 2);
+    }
+    try {
+        switch (subcommand) {
+            case 'spawn': {
+                const worktreePath = flags.get('worktree');
+                const taskId = flags.get('task');
+                if (!worktreePath || worktreePath === true) {
+                    return terminalErr('usage', '--worktree <path> is required', 1);
+                }
+                if (!taskId || taskId === true) {
+                    return terminalErr('usage', '--task <id> is required', 1);
+                }
+                const payload = {
+                    worktreePath: String(worktreePath),
+                    taskId: String(taskId),
+                    _callerDepth: callerDepth,
+                };
+                const instructions = flags.get('instructions');
+                if (typeof instructions === 'string')
+                    payload.instructions = instructions;
+                const cli = flags.get('cli');
+                if (typeof cli === 'string')
+                    payload.cliType = cli;
+                if (flags.get('yolo') === true)
+                    payload.yoloMode = true;
+                const res = await client.request('spawn', payload);
+                return ok(res);
+            }
+            case 'list': {
+                const res = await client.request('list', {});
+                return ok(res);
+            }
+            case 'status': {
+                const sessionId = flags.get('session');
+                if (!sessionId || sessionId === true) {
+                    return terminalErr('usage', '--session <id> is required', 1);
+                }
+                const res = await client.request('status', { sessionId: String(sessionId) });
+                return ok(res);
+            }
+            case 'health': {
+                const res = await client.request('health', {});
+                return ok(res);
+            }
+            default:
+                return terminalErr('usage', `Unknown subcommand: ${subcommand}. Use spawn|list|status|health.`, 1);
+        }
+    }
+    catch (err) {
+        // Errors from connectSocket().request — typed as { code, message }
+        const code = err && typeof err === 'object' && 'code' in err ? err.code : 'request_failed';
+        const message = err && typeof err === 'object' && 'message' in err
+            ? err.message
+            : err instanceof Error
+                ? err.message
+                : String(err);
+        return terminalErr(code, message, 1);
+    }
+    finally {
+        try {
+            client?.close();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+//# sourceMappingURL=terminal.mjs.map

package/dist/cli/commands/terminal.mjs.map

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

package/dist/cli/commands/token-budget.d.mts

@@ -0,0 +1,2 @@
+export function cmdTokenBudget(args: any, targetDir: any): import("../util/result.mjs").CommandResult;
+//# sourceMappingURL=token-budget.d.mts.map

package/dist/cli/commands/token-budget.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/token-budget.mjs"],"names":[],"mappings":"AAiBA,sGAmHC"}

package/dist/cli/commands/token-budget.mjs

@@ -0,0 +1,122 @@
+/**
+ * commands/token-budget.mjs — token-budget init/record/check command (C29).
+ */
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { budgetStatusFromTotal, DEFAULT_BUDGET_LIMIT, estimateTokens, readBudget, taskBudgetPath, } from '../budget/budget.mjs';
+import { withFileLock } from '../util/fs-lock.mjs';
+import { atomicWriteJson } from '../util/io.mjs';
+import { err, ok } from '../util/result.mjs';
+export function cmdTokenBudget(args, targetDir) {
+    const action = args[0];
+    if (!action) {
+        return err('Usage: apt-tools token-budget <init|record|check> [flags]');
+    }
+    const flag = (name) => {
+        const i = args.indexOf(name);
+        return i >= 0 ? args[i + 1] : null;
+    };
+    const taskId = flag('--task-id');
+    if (!taskId)
+        return err('--task-id is required');
+    const budgetPath = taskBudgetPath(targetDir, taskId);
+    mkdirSync(dirname(budgetPath), { recursive: true });
+    if (action === 'init') {
+        const limit = parseInt(flag('--limit') || String(DEFAULT_BUDGET_LIMIT), 10);
+        withFileLock(budgetPath, () => {
+            atomicWriteJson(budgetPath, {
+                task_id: taskId,
+                limit_tokens: limit,
+                consumed: {},
+                total: 0,
+                warnings: [],
+                status: 'ok',
+                created_at: new Date().toISOString(),
+            });
+        });
+        return ok({
+            status: 'ok',
+            command: 'token-budget',
+            action: 'init',
+            task_id: taskId,
+            limit_tokens: limit,
+        });
+    }
+    if (action === 'record') {
+        const phase = flag('--phase') || 'unknown';
+        const tokensFlag = flag('--tokens');
+        const textFlag = flag('--text-file');
+        let tokens = 0;
+        if (tokensFlag) {
+            tokens = parseInt(tokensFlag, 10) || 0;
+        }
+        else if (textFlag && existsSync(textFlag)) {
+            tokens = estimateTokens(readFileSync(textFlag, 'utf-8'));
+        }
+        if (tokens <= 0)
+            return err('Provide --tokens N or --text-file <path>');
+        let result;
+        withFileLock(budgetPath, () => {
+            const current = readBudget(budgetPath) || {
+                task_id: taskId,
+                limit_tokens: DEFAULT_BUDGET_LIMIT,
+                consumed: {},
+                total: 0,
+                warnings: [],
+                status: 'ok',
+            };
+            current.consumed[phase] = (current.consumed[phase] || 0) + tokens;
+            current.total = (current.total || 0) + tokens;
+            const previousStatus = current.status;
+            current.status = budgetStatusFromTotal(current.total, current.limit_tokens);
+            if (current.status !== previousStatus && current.status !== 'ok') {
+                current.warnings.push({
+                    phase,
+                    at: current.total,
+                    status: current.status,
+                    ts: new Date().toISOString(),
+                });
+            }
+            atomicWriteJson(budgetPath, current);
+            result = current;
+        });
+        return ok({
+            status: 'ok',
+            command: 'token-budget',
+            action: 'record',
+            task_id: taskId,
+            phase,
+            added_tokens: tokens,
+            total: result.total,
+            limit_tokens: result.limit_tokens,
+            budget_status: result.status,
+        });
+    }
+    if (action === 'check') {
+        const current = readBudget(budgetPath);
+        if (!current) {
+            return ok({
+                status: 'ok',
+                command: 'token-budget',
+                action: 'check',
+                task_id: taskId,
+                exists: false,
+            });
+        }
+        return ok({
+            status: 'ok',
+            command: 'token-budget',
+            action: 'check',
+            task_id: taskId,
+            exists: true,
+            total: current.total,
+            limit_tokens: current.limit_tokens,
+            consumed: current.consumed,
+            warnings: current.warnings,
+            budget_status: current.status,
+            exceeded: current.status === 'exceeded',
+        });
+    }
+    return err(`Unknown token-budget action: ${action}`);
+}
+//# sourceMappingURL=token-budget.mjs.map

package/dist/cli/commands/token-budget.mjs.map

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

package/dist/cli/commands/tokens.d.mts

@@ -0,0 +1,5 @@
+/**
+ * Top-level dispatcher.
+ */
+export function cmdTokens(subcommand: any, projectDir: any, extraArgs?: any[]): import("../util/result.mjs").CommandResult;
+//# sourceMappingURL=tokens.d.mts.map

package/dist/cli/commands/tokens.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/tokens.mjs"],"names":[],"mappings":"AAqaA;;GAEG;AACH,2HA+BC"}