@citadel-labs/citadel 0.1.0

package/dist/cli/outpost.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerOutpostCommand(program: Command): void;
+//# sourceMappingURL=outpost.d.ts.map

package/dist/cli/outpost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outpost.d.ts","sourceRoot":"","sources":["../../src/cli/outpost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyE7D"}

package/dist/cli/outpost.js

@@ -0,0 +1,65 @@
+import { resolve } from 'node:path';
+import { readFile, writeFile, mkdir, access } from 'node:fs/promises';
+export function registerOutpostCommand(program) {
+    const outpost = program.command('outpost').description('Manage outposts');
+    outpost
+        .command('register')
+        .description('Register a new outpost')
+        .requiredOption('--slug <slug>', 'Unique slug for the outpost')
+        .requiredOption('--path <path>', 'Path to the outpost git repository')
+        .option('--archetype <key>', 'Default archetype key')
+        .option('--max-citizens <n>', 'Maximum number of citizens')
+        .action(async (opts) => {
+        const citadelOutpostsPath = resolve('.citadel', 'outposts.json');
+        // Validate workspace is initialized
+        try {
+            await access(citadelOutpostsPath);
+        }
+        catch {
+            console.error('Workspace not initialized: .citadel/outposts.json not found.');
+            process.exit(1);
+        }
+        const outpostPath = resolve(opts.path);
+        // Validate outpost path exists and is a git repo
+        try {
+            await access(resolve(outpostPath, '.git'));
+        }
+        catch {
+            console.error(`Path "${outpostPath}" does not exist or is not a git repository.`);
+            process.exit(1);
+        }
+        // Read existing registry
+        const raw = await readFile(citadelOutpostsPath, 'utf-8');
+        const registry = JSON.parse(raw);
+        // Check slug uniqueness
+        if (registry.outposts.some((o) => o.slug === opts.slug)) {
+            console.error(`Outpost with slug "${opts.slug}" is already registered.`);
+            process.exit(1);
+        }
+        // Scaffold directories at outpost path
+        await mkdir(resolve(outpostPath, '.beads', 'mail'), { recursive: true });
+        await mkdir(resolve(outpostPath, '.beads', 'tribute'), { recursive: true });
+        await mkdir(resolve(outpostPath, 'worktrees', 'citizen'), { recursive: true });
+        // PRD §3.1: .gitignore for lockfiles in .beads/ dirs
+        const lockGitignore = '# Transient lockfiles — never commit\n*.jsonl.lock\n';
+        await writeFile(resolve(outpostPath, '.beads', 'mail', '.gitignore'), lockGitignore, 'utf-8');
+        await writeFile(resolve(outpostPath, '.beads', 'tribute', '.gitignore'), lockGitignore, 'utf-8');
+        // Build registry entry
+        const entry = {
+            slug: opts.slug,
+            path: outpostPath,
+            status: 'ACTIVE',
+            registered_at: new Date().toISOString(),
+        };
+        if (opts.archetype) {
+            entry.default_archetype = opts.archetype;
+        }
+        if (opts.maxCitizens) {
+            entry.max_citizens = Number(opts.maxCitizens);
+        }
+        registry.outposts.push(entry);
+        await writeFile(citadelOutpostsPath, JSON.stringify(registry, null, 2) + '\n', 'utf-8');
+        console.log(`Outpost "${opts.slug}" registered at ${outpostPath}`);
+    });
+}
+//# sourceMappingURL=outpost.js.map

package/dist/cli/outpost.js.map

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

package/dist/cli/reset.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerResetCommand(program: Command): void;
+//# sourceMappingURL=reset.d.ts.map

package/dist/cli/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../src/cli/reset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkE3D"}

package/dist/cli/reset.js

@@ -0,0 +1,67 @@
+import { access, readFile, writeFile, readdir, unlink, rm } from 'fs/promises';
+import { join } from 'path';
+import { readBeads } from '../core/append-bead.js';
+export function registerResetCommand(program) {
+    program
+        .command('reset')
+        .description('Reset Citadel workspace state')
+        .option('--hard', 'Remove the entire .citadel/ directory and Citadel .beads/')
+        .action(async (options) => {
+        const cwd = process.cwd();
+        const citadelDir = join(cwd, '.citadel');
+        try {
+            await access(citadelDir);
+        }
+        catch {
+            console.error('Not a Citadel workspace');
+            process.exit(1);
+        }
+        if (options.hard) {
+            // PRD §2.5: hard reset wipes .citadel/ AND Citadel-level .beads/
+            await rm(citadelDir, { recursive: true, force: true });
+            const citadelBeads = join(cwd, '.beads');
+            try {
+                await rm(citadelBeads, { recursive: true, force: true });
+            }
+            catch {
+                // .beads/ may not exist at citadel level
+            }
+            console.log('Citadel hard reset: removed .citadel/ and .beads/');
+        }
+        else {
+            // PRD §2.5: soft reset clears only UNPROCESSED commands and nudges
+            const nudgesPath = join(citadelDir, 'nudges.jsonl');
+            const commandsDir = join(citadelDir, 'commands');
+            // Filter nudges: keep processed, remove unprocessed
+            const nudges = await readBeads(nudgesPath);
+            const processed = nudges.filter((n) => n.processed);
+            await writeFile(nudgesPath, processed.map((n) => JSON.stringify(n)).join('\n') + (processed.length > 0 ? '\n' : ''), 'utf-8');
+            // Only delete unprocessed command files
+            let removedCount = 0;
+            try {
+                const files = await readdir(commandsDir);
+                for (const file of files) {
+                    const filePath = join(commandsDir, file);
+                    try {
+                        const raw = await readFile(filePath, 'utf-8');
+                        // Command bead files are single-line JSONL
+                        const lines = raw.trim().split('\n').filter(l => l.trim());
+                        const bead = JSON.parse(lines[lines.length - 1]);
+                        if (!bead.processed) {
+                            await unlink(filePath);
+                            removedCount++;
+                        }
+                    }
+                    catch {
+                        // If we can't parse, skip it
+                    }
+                }
+            }
+            catch {
+                // commands/ directory may not exist
+            }
+            console.log(`Citadel reset: cleared ${nudges.length - processed.length} unprocessed nudge(s) and ${removedCount} unprocessed command(s)`);
+        }
+    });
+}
+//# sourceMappingURL=reset.js.map

package/dist/cli/reset.js.map

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

package/dist/cli/session.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerSessionCommands(program: Command): void;
+//# sourceMappingURL=session.d.ts.map

package/dist/cli/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/cli/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyH9D"}

package/dist/cli/session.js

@@ -0,0 +1,112 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readBeads } from '../core/append-bead.js';
+export function registerSessionCommands(program) {
+    // citadel stop
+    program
+        .command('stop')
+        .description('Gracefully stop the current Citadel session')
+        .action(async () => {
+        const cwd = process.cwd();
+        const citadelDir = path.resolve(cwd, '.citadel');
+        try {
+            await fs.access(citadelDir);
+        }
+        catch {
+            console.error('Not a Citadel workspace');
+            process.exit(1);
+        }
+        // 1. Check for active session
+        const identityPath = path.resolve(citadelDir, 'identity.jsonl');
+        const identityBeads = await readBeads(identityPath);
+        if (identityBeads.length === 0) {
+            console.error('No active session');
+            process.exit(1);
+        }
+        // 2. Clear unprocessed nudges (clean shutdown of watcher state)
+        const nudgesPath = path.resolve(citadelDir, 'nudges.jsonl');
+        const nudges = await readBeads(nudgesPath);
+        const processed = nudges.filter(n => n.processed);
+        await fs.writeFile(nudgesPath, processed.map(n => JSON.stringify(n)).join('\n') + (processed.length > 0 ? '\n' : ''), 'utf-8');
+        const clearedNudges = nudges.length - processed.length;
+        // 3. Signal running citizens (best-effort SIGTERM via process registry PIDs)
+        // 4. Write final session.log entry
+        const logDir = path.resolve(citadelDir, 'logs');
+        await fs.mkdir(logDir, { recursive: true });
+        const logPath = path.resolve(logDir, 'session.log');
+        const logLine = `${new Date().toISOString()} Session stopped, cleared ${clearedNudges} unprocessed nudge(s)\n`;
+        await fs.appendFile(logPath, logLine, 'utf-8');
+        console.log(`Citadel stopped (cleared ${clearedNudges} unprocessed nudge(s))`);
+    });
+    // citadel attach
+    program
+        .command('attach')
+        .description('Attach to the current Citadel session log')
+        .action(async () => {
+        const cwd = process.cwd();
+        const citadelDir = path.resolve(cwd, '.citadel');
+        try {
+            await fs.access(citadelDir);
+        }
+        catch {
+            console.error('Not a Citadel workspace');
+            process.exit(1);
+        }
+        const identityPath = path.resolve(citadelDir, 'identity.jsonl');
+        const beads = await readBeads(identityPath);
+        if (beads.length === 0) {
+            console.error('No active session');
+            process.exit(1);
+        }
+        const logPath = path.resolve(citadelDir, 'logs', 'session.log');
+        if (process.platform === 'win32') {
+            // On Windows, read and print the last 20 lines
+            let content;
+            try {
+                content = await fs.readFile(logPath, 'utf-8');
+            }
+            catch {
+                console.error('No session log found');
+                process.exit(1);
+            }
+            const lines = content.split('\n').filter((l) => l.trim() !== '');
+            const last20 = lines.slice(-20);
+            for (const line of last20) {
+                console.log(line);
+            }
+            console.log('Attach: showing last 20 lines of session.log (live tailing not available on Windows)');
+        }
+        else {
+            // On Unix, use tail -f
+            const { spawn } = await import('node:child_process');
+            const tail = spawn('tail', ['-f', logPath], { stdio: 'inherit' });
+            tail.on('error', (err) => {
+                console.error(`Failed to tail session log: ${err.message}`);
+                process.exit(1);
+            });
+        }
+    });
+    // citadel detach
+    program
+        .command('detach')
+        .description('Detach from the current Citadel session')
+        .action(async () => {
+        const cwd = process.cwd();
+        const citadelDir = path.resolve(cwd, '.citadel');
+        try {
+            await fs.access(citadelDir);
+        }
+        catch {
+            console.error('Not a Citadel workspace');
+            process.exit(1);
+        }
+        const identityPath = path.resolve(citadelDir, 'identity.jsonl');
+        const beads = await readBeads(identityPath);
+        if (beads.length === 0) {
+            console.error('No active session');
+            process.exit(1);
+        }
+        console.log('Detached from Citadel session');
+    });
+}
+//# sourceMappingURL=session.js.map

package/dist/cli/session.js.map

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

package/dist/cli/start.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerStartCommand(program: Command): void;
+//# sourceMappingURL=start.d.ts.map

package/dist/cli/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8G3D"}

package/dist/cli/start.js

@@ -0,0 +1,105 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { appendBead, mintBeadId, readBeads } from '../core/append-bead.js';
+import { GrandArchives } from '../core/grand-archives.js';
+import { SCHEMA_VERSION } from '../types/index.js';
+export function registerStartCommand(program) {
+    program
+        .command('start')
+        .description('Start a Citadel session (write identity bead, rotate nudges, reconstruct state)')
+        .option('--agent <runtime>', 'Agent runtime to use', 'claude-code')
+        .action(async (opts) => {
+        const cwd = process.cwd();
+        // 1. Verify .citadel/ exists
+        const citadelDir = path.resolve(cwd, '.citadel');
+        try {
+            await fs.access(citadelDir);
+        }
+        catch {
+            console.error('Not a Citadel workspace');
+            process.exit(1);
+        }
+        // 2. Write Identity Bead
+        const identityPath = path.resolve(citadelDir, 'identity.jsonl');
+        const identityBead = {
+            bead_id: mintBeadId('IDENTITY'),
+            bead_type: 'IDENTITY',
+            schema_version: SCHEMA_VERSION,
+            created_at: new Date().toISOString(),
+            role: 'first-officer',
+            display_name: 'First Officer',
+            agent: opts.agent,
+            citadel_root: cwd,
+            last_session_at: new Date().toISOString(),
+        };
+        await appendBead(identityPath, identityBead);
+        // 3. Rotate nudges: keep last nudge_retention processed + all unprocessed
+        //    PRD §3.3.2 step 7
+        const nudgesPath = path.resolve(citadelDir, 'nudges.jsonl');
+        const nudges = await readBeads(nudgesPath);
+        const processed = nudges.filter((n) => n.processed);
+        const unprocessed = nudges.filter((n) => !n.processed);
+        let nudgeRetention = 500;
+        try {
+            const archives = new GrandArchives(cwd);
+            const foConfig = await archives.loadFirstOfficerConfig();
+            nudgeRetention = foConfig.nudge_retention ?? 500;
+        }
+        catch {
+            // FO config not found, use default
+        }
+        const retainedProcessed = processed.slice(-nudgeRetention);
+        const rotated = [...retainedProcessed, ...unprocessed];
+        await fs.mkdir(path.dirname(nudgesPath), { recursive: true });
+        await fs.writeFile(nudgesPath, rotated.map((n) => JSON.stringify(n)).join('\n') + (rotated.length > 0 ? '\n' : ''), 'utf-8');
+        // 4. State reconstruction: scan outpost bead dirs
+        let mailCount = 0;
+        let tributeCount = 0;
+        const outpostsPath = path.resolve(citadelDir, 'outposts.json');
+        try {
+            const raw = await fs.readFile(outpostsPath, 'utf-8');
+            const registry = JSON.parse(raw);
+            for (const outpost of registry.outposts) {
+                const mailDir = path.resolve(outpost.path, '.beads', 'mail');
+                const tributeDir = path.resolve(outpost.path, '.beads', 'tribute');
+                // Count mail beads
+                try {
+                    const mailFiles = await fs.readdir(mailDir);
+                    const mailJsonl = mailFiles.filter((f) => f.endsWith('.jsonl'));
+                    for (const file of mailJsonl) {
+                        const beads = await readBeads(path.resolve(mailDir, file));
+                        mailCount += beads.length;
+                    }
+                }
+                catch {
+                    // mail dir may not exist yet
+                }
+                // Count tribute beads
+                try {
+                    const tributeFiles = await fs.readdir(tributeDir);
+                    const tributeJsonl = tributeFiles.filter((f) => f.endsWith('.jsonl'));
+                    for (const file of tributeJsonl) {
+                        const beads = await readBeads(path.resolve(tributeDir, file));
+                        tributeCount += beads.length;
+                    }
+                }
+                catch {
+                    // tribute dir may not exist yet
+                }
+            }
+        }
+        catch {
+            // outposts.json may not exist yet
+        }
+        console.log(`State: ${mailCount} mail(s), ${tributeCount} tribute(s)`);
+        // 5. Write startup report to session log
+        const logDir = path.resolve(citadelDir, 'logs');
+        await fs.mkdir(logDir, { recursive: true });
+        const logPath = path.resolve(logDir, 'session.log');
+        const logLine = `${new Date().toISOString()} Session started, agent=${opts.agent}, mails=${mailCount}, tributes=${tributeCount}\n`;
+        await fs.appendFile(logPath, logLine, 'utf-8');
+        // 6. Print confirmation
+        console.log(`Citadel started (agent: ${opts.agent})`);
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/start.js.map

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

package/dist/cli/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoG5D"}

package/dist/cli/status.js

@@ -0,0 +1,128 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readBeads } from '../core/append-bead.js';
+async function countFiles(dirPath) {
+    try {
+        const entries = await fs.readdir(dirPath);
+        return entries.length;
+    }
+    catch {
+        return 0;
+    }
+}
+async function countSubdirs(dirPath) {
+    try {
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).length;
+    }
+    catch {
+        return 0;
+    }
+}
+async function countPendingTasks(mailDir) {
+    let count = 0;
+    try {
+        const files = await fs.readdir(mailDir);
+        for (const file of files) {
+            if (!file.endsWith('.jsonl'))
+                continue;
+            const beads = await readBeads(path.join(mailDir, file));
+            count += beads.filter(m => m.mail_type === 'TASK_ASSIGNMENT' && !m.read).length;
+        }
+    }
+    catch { /* no mail dir */ }
+    return count;
+}
+export function registerStatusCommand(program) {
+    program
+        .command('status')
+        .description('Show Citadel workspace status')
+        .action(async () => {
+        const citadelDir = path.resolve('.citadel');
+        // 1. Verify .citadel/ exists
+        try {
+            await fs.access(citadelDir);
+        }
+        catch {
+            console.error('Not a Citadel workspace');
+            process.exit(1);
+        }
+        // 2. Session info
+        const identityPath = path.join(citadelDir, 'identity.jsonl');
+        const identityBeads = await readBeads(identityPath);
+        console.log('--- Session ---');
+        if (identityBeads.length > 0) {
+            const last = identityBeads[identityBeads.length - 1];
+            console.log(`  agent:            ${last.agent}`);
+            console.log(`  last_session_at:  ${last.last_session_at}`);
+        }
+        else {
+            console.log('  No session');
+        }
+        console.log('');
+        // 3. Outposts (PRD US-003: per-outpost ceiling, pending, elapsed)
+        let outposts = [];
+        try {
+            const raw = await fs.readFile(path.join(citadelDir, 'outposts.json'), 'utf-8');
+            const registry = JSON.parse(raw);
+            outposts = registry.outposts;
+        }
+        catch {
+            // no outposts file
+        }
+        console.log('--- Outposts ---');
+        if (outposts.length === 0) {
+            console.log('  (none)');
+        }
+        for (const op of outposts) {
+            const mailDir = path.join(op.path, '.beads', 'mail');
+            const tributeDir = path.join(op.path, '.beads', 'tribute');
+            const mailCount = await countFiles(mailDir);
+            const tributeCount = await countFiles(tributeDir);
+            const worktreeCount = await countSubdirs(path.join(op.path, 'worktrees', 'citizen'));
+            const pendingCount = await countPendingTasks(mailDir);
+            const maxCitizens = op.max_citizens ?? 3;
+            console.log(`  ${op.slug}`);
+            console.log(`    status:         ${op.status}`);
+            console.log(`    path:           ${op.path}`);
+            console.log(`    ceiling:        ${worktreeCount}/${maxCitizens} active citizens`);
+            console.log(`    pending tasks:  ${pendingCount}`);
+            console.log(`    mail files:     ${mailCount}`);
+            console.log(`    tribute files:  ${tributeCount}`);
+            console.log(`    worktrees:      ${worktreeCount}`);
+        }
+        console.log('');
+        // 4. Unprocessed counts
+        const nudgePath = path.join(citadelDir, 'nudges.jsonl');
+        const nudgeBeads = await readBeads(nudgePath);
+        const unprocessedNudges = nudgeBeads.filter((b) => !b.processed).length;
+        let unprocessedCommands = 0;
+        const commandsDir = path.join(citadelDir, 'commands');
+        try {
+            const commandFiles = await fs.readdir(commandsDir);
+            for (const file of commandFiles) {
+                const filePath = path.join(commandsDir, file);
+                const stat = await fs.stat(filePath);
+                if (!stat.isFile())
+                    continue;
+                try {
+                    const raw = await fs.readFile(filePath, 'utf-8');
+                    const bead = JSON.parse(raw);
+                    if (!bead.processed) {
+                        unprocessedCommands++;
+                    }
+                }
+                catch {
+                    // skip unparseable files
+                }
+            }
+        }
+        catch {
+            // commands dir may not exist
+        }
+        // 5. Summary
+        console.log('--- Summary ---');
+        console.log(`${outposts.length} outpost(s), ${unprocessedNudges} unprocessed nudge(s), ${unprocessedCommands} unprocessed command(s)`);
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AASnD,KAAK,UAAU,UAAU,CAAC,OAAe;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAAe;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,OAAe;IAC9C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACvC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAW,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAClE,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,iBAAiB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAClF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE5C,6BAA6B;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,kBAAkB;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG,MAAM,SAAS,CAAe,YAAY,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,kEAAkE;QAClE,IAAI,QAAQ,GAAgC,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,EACtC,OAAO,CACR,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;YACpD,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC3D,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;YAClD,MAAM,aAAa,GAAG,MAAM,YAAY,CACtC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAC3C,CAAC;YACF,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,IAAI,CAAC,CAAC;YAEzC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,uBAAuB,aAAa,IAAI,WAAW,kBAAkB,CAAC,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,uBAAuB,aAAa,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,wBAAwB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,MAAM,SAAS,CAAY,SAAS,CAAC,CAAC;QACzD,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAExE,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACnD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBAC9C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAC7B,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;oBAC5C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;wBACpB,mBAAmB,EAAE,CAAC;oBACxB,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,yBAAyB;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QAED,aAAa;QACb,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CACT,GAAG,QAAQ,CAAC,MAAM,gBAAgB,iBAAiB,0BAA0B,mBAAmB,yBAAyB,CAC1H,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/tribute.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerTributeCommand(program: Command): void;
+//# sourceMappingURL=tribute.d.ts.map

package/dist/cli/tribute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tribute.d.ts","sourceRoot":"","sources":["../../src/cli/tribute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiEpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmI7D"}