@voxslopuli/openagentsy 0.0.0-stage → 0.2.1

package/dist/commands/audit.d.ts

@@ -0,0 +1,74 @@
+import type { ProjectRoots } from '@openagentsy/core';
+import { type Finding, type SloplintDegradation, type SloplintPath } from '@openagentsy/hooks/quality/audit';
+/**
+ * The audit command.
+ *
+ * `openagentsy audit` reports the quality findings of the change under
+ * audit. The scope is the change: the files the working tree differs in
+ * from the base, and the files git does not know yet. `--all` audits the
+ * whole project instead, and `--base <ref>` measures the change against
+ * another ref.
+ *
+ * The command reads the mode of the project and says what it means: in
+ * `after` the hook does nothing and this report is the only one there is,
+ * and in `during` the hook reports on every write and this is a snapshot
+ * of the scope.
+ *
+ * The exit code follows the floor rule of the gate: a change with an open
+ * floor finding does not pass, and the command says so with a non-zero
+ * exit. A change with only reflex findings open passes, because a reflex
+ * finding is a tell that a person may waive.
+ */
+/** What the audit looks at. */
+export type AuditScope = 'changed' | 'all';
+/** What the caller knows about the audit. */
+export interface AuditOptions {
+    /** The scope: the files that changed, or the whole project. */
+    scope?: AuditScope | undefined;
+    /** The ref the change is measured against. */
+    base?: string | undefined;
+}
+/** What the audit found. */
+export interface AuditReport {
+    /** The project root. */
+    root: string;
+    /** The scope that was audited. */
+    scope: AuditScope;
+    /** The ref the change was measured against. */
+    base: string;
+    /** When the check runs in this project. */
+    mode: 'during' | 'after';
+    /** The files in the scope. */
+    files: string[];
+    /** The files the check read. */
+    checked: string[];
+    /** Every finding, the waived ones included. */
+    findings: Finding[];
+    /** The findings no waiver covers, the floor ones first. */
+    open: Finding[];
+    /** The findings a waiver covers. */
+    waived: Finding[];
+    /** Which path ran. */
+    path: SloplintPath;
+    /** Why the linter did not deliver, when it did not. */
+    degraded?: SloplintDegradation | undefined;
+    /** The open findings of the floor. */
+    floor: number;
+    /** The open findings of the reflex tier. */
+    reflex: number;
+    /** The open findings of the taste tier. */
+    finish: number;
+    /** The exit code the command returns. */
+    exitCode: number;
+    /** Why the scope is what it is, when the scope is not what was asked for. */
+    problem?: string | undefined;
+}
+/**
+ * The audit.
+ */
+export declare function runAudit(roots: ProjectRoots, options?: AuditOptions): Promise<AuditReport>;
+/**
+ * The report, as it is read.
+ */
+export declare function formatAuditReport(report: AuditReport): string;
+//# sourceMappingURL=audit.d.ts.map

package/dist/commands/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,kCAAkC,CAAC;AAK1C;;;;;;;;;;;;;;;;;;GAkBG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3C,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gCAAgC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,2DAA2D;IAC3D,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,oCAAoC;IACpC,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,sBAAsB;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC3C,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AA4CD;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CActB;AA0ID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsB7D"}

package/dist/commands/audit.js

@@ -0,0 +1,230 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { runQualityAudit, } from '@openagentsy/hooks/quality/audit';
+import { loadWaiverLookup } from '@openagentsy/hooks/quality/waivers';
+import { gitText } from '@openagentsy/ledger';
+import { parse as parseJsonc } from 'jsonc-parser';
+/**
+ * The directories the walk does not enter.
+ *
+ * They hold no source: the built output, the dependencies, the state of
+ * the board and the files the build generated.
+ */
+const SKIPPED_DIRS = new Set([
+    '.git',
+    '.openagentsy',
+    '.opencode',
+    '.turbo',
+    'build',
+    'coverage',
+    'dist',
+    'node_modules',
+    'out',
+    'target',
+    'vendor',
+]);
+/**
+ * The git options the scope reads the repository with.
+ *
+ * The fsmonitor hook is off: the scope is a list of file names, and a
+ * machine whose fsmonitor daemon is not running must still be able to ask
+ * what changed. The hook answers with an error, and the audit would report
+ * an empty scope instead of the change.
+ */
+const GIT_OPTIONS = ['-c', 'core.fsmonitor=false'];
+/** The order the tiers are read in: the floor first, the taste last. */
+const TIER_ORDER = { floor: 0, reflex: 1, finish: 2 };
+/** What each degradation means, in one line. */
+const DEGRADATION_TEXT = {
+    absent: 'the Hallmark linter is not installed, so the static rules ran alone',
+    'no-files': 'the scope has no page or stylesheet in it, so the linter had nothing to read',
+    crashed: 'the linter failed, so the static findings stand',
+    timeout: 'the linter ran too long, so the static findings stand',
+    unparsable: 'the linter said something the bridge cannot read, so the static findings stand',
+};
+/**
+ * The audit.
+ */
+export async function runAudit(roots, options = {}) {
+    const { workspace, stateRoot } = roots;
+    const scope = options.scope ?? 'changed';
+    const base = options.base ?? 'HEAD';
+    const resolved = scope === 'all' ? { files: await projectFiles(workspace) } : changedFiles(workspace, base);
+    const mode = await readQualityMode(workspace);
+    // The waivers are the state root's: a waiver is a decision about the
+    // project, and a worktree of the project has the same waivers as the
+    // project. The files are the workspace's: they are the files of the
+    // branch under audit.
+    const waivers = await loadWaiverLookup(stateRoot);
+    const result = await runQualityAudit({ root: workspace, files: resolved.files, waivers });
+    return reportOf({ root: workspace, scope, base, mode, result, ...resolved });
+}
+/** The report of a run. */
+function reportOf(input) {
+    const open = [...input.result.open].sort((a, b) => TIER_ORDER[a.tier] - TIER_ORDER[b.tier]);
+    const floor = open.filter((finding) => finding.tier === 'floor').length;
+    const reflex = open.filter((finding) => finding.tier === 'reflex').length;
+    const finish = open.filter((finding) => finding.tier === 'finish').length;
+    return {
+        root: input.root,
+        scope: input.scope,
+        base: input.base,
+        mode: input.mode,
+        files: input.files,
+        checked: input.result.files,
+        findings: input.result.findings,
+        open,
+        waived: input.result.waived,
+        path: input.result.path,
+        ...(input.result.degraded !== undefined ? { degraded: input.result.degraded } : {}),
+        floor,
+        reflex,
+        finish,
+        exitCode: floor > 0 ? 1 : 0,
+        ...(input.problem !== undefined ? { problem: input.problem } : {}),
+    };
+}
+/**
+ * The files that changed.
+ *
+ * The scope is the change: the files the working tree differs in from the
+ * base, and the files git does not know yet. A directory that is not a
+ * repository has no changed files, and the report says so.
+ */
+function changedFiles(root, base) {
+    const inside = gitText(root, ['rev-parse', '--is-inside-work-tree']);
+    if (inside === null || inside.trim() !== 'true') {
+        return { files: [], problem: 'this directory is not a git repository, so the scope is empty' };
+    }
+    const diff = gitText(root, [...GIT_OPTIONS, 'diff', '--name-only', '--relative', base]);
+    if (diff === null) {
+        return { files: [], problem: `the base ${base} could not be read, so the scope is empty` };
+    }
+    const untracked = gitText(root, [...GIT_OPTIONS, 'ls-files', '--others', '--exclude-standard']);
+    return { files: unique([...lines(diff), ...lines(untracked ?? '')]) };
+}
+/**
+ * The files of the whole project.
+ *
+ * The walk skips the directories that hold no source. What it finds is
+ * every file in the project, and the check reads the ones a rule applies
+ * to.
+ */
+async function projectFiles(root) {
+    const files = [];
+    await walk(root, '', files);
+    return files;
+}
+/** The files of a directory, and of the directories under it. */
+async function walk(root, dir, files) {
+    const entries = await entriesOf(join(root, dir));
+    for (const entry of entries) {
+        const path = dir === '' ? entry.name : `${dir}/${entry.name}`;
+        if (entry.isDirectory()) {
+            if (SKIPPED_DIRS.has(entry.name))
+                continue;
+            await walk(root, path, files);
+            continue;
+        }
+        if (entry.isFile())
+            files.push(path);
+    }
+}
+/** The entries of a directory, when it can be read. */
+async function entriesOf(path) {
+    try {
+        return await readdir(path, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+/** The paths of a git answer, one per line. */
+function lines(text) {
+    return text
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line !== '');
+}
+/** The paths, without the ones that came twice. */
+function unique(paths) {
+    return [...new Set(paths)];
+}
+/**
+ * The quality mode of the project.
+ *
+ * The mode says when the check runs: `during` runs it after every write,
+ * and `after` leaves the findings to this command. A project that names no
+ * mode runs the check after every write, which is the default.
+ */
+async function readQualityMode(root) {
+    const config = await readJsoncFile(join(root, 'openagentsy.jsonc'));
+    const quality = asRecord(config?.quality);
+    const mode = quality?.mode;
+    return mode === 'after' ? 'after' : 'during';
+}
+/** A JSONC file, read the way a person writes one: with comments. */
+async function readJsoncFile(path) {
+    try {
+        const text = await readFile(path, 'utf8');
+        return asRecord(parseJsonc(text));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A value, when it is an object. */
+function asRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return undefined;
+    return value;
+}
+/**
+ * The report, as it is read.
+ */
+export function formatAuditReport(report) {
+    const lines = [];
+    lines.push(`Audit of ${report.files.length} ${scopeWord(report.scope)} (${report.checked.length} checked)`);
+    lines.push(`  path   ${report.path} — ${DEGRADATION_TEXT[report.degraded ?? 'absent']}`);
+    lines.push(`  mode   ${report.mode} — ${modeText(report.mode)}`);
+    lines.push(`  open   ${report.floor} floor, ${report.reflex} reflex, ${report.finish} taste`);
+    lines.push(`  waived ${report.waived.length}`);
+    if (report.problem !== undefined)
+        lines.push(`  ${report.problem}`);
+    lines.push('');
+    for (const finding of report.open)
+        lines.push(findingLine(finding.tier, finding));
+    for (const finding of report.waived)
+        lines.push(findingLine('waived', finding));
+    if (report.findings.length === 0) {
+        lines.push('no findings: the scope is clean');
+        lines.push('');
+    }
+    lines.push(verdictText(report));
+    if (report.reflex > 0) {
+        lines.push(`${report.reflex} open reflex findings: fix them or waive them`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+/** The word for the scope. */
+function scopeWord(scope) {
+    return scope === 'all' ? 'files in the project' : 'changed files';
+}
+/** The mode, and what it means for this report. */
+function modeText(mode) {
+    if (mode === 'after')
+        return 'the hook is off, so this report is the only one there is';
+    return 'the hook reports on every write; this report is a snapshot of the scope';
+}
+/** One finding, one line. */
+function findingLine(tier, finding) {
+    return `  ${tier.padEnd(6)} ${finding.ruleId.padEnd(24)} ${finding.file}:${finding.line}  ${finding.fix}`;
+}
+/** The verdict of the floor rule. */
+function verdictText(report) {
+    if (report.floor > 0) {
+        return `${report.floor} open floor findings: the change does not pass the gate`;
+    }
+    return 'no open floor findings: the change passes the gate';
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/audit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit.test.d.ts.map

package/dist/commands/audit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.test.d.ts","sourceRoot":"","sources":["../../src/commands/audit.test.ts"],"names":[],"mappings":""}

package/dist/commands/audit.test.js

@@ -0,0 +1,194 @@
+import { execFile } from 'node:child_process';
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { describe, expect, it } from 'vitest';
+import { formatAuditReport, runAudit } from './audit.js';
+import { runWaiver } from './waivers.js';
+const exec = promisify(execFile);
+/** The two roots of a project that is its own state root. */
+function rootsOf(root) {
+    return { workspace: root, stateRoot: root };
+}
+/** A stylesheet with a floor finding: the page root clips its overflow. */
+const FLOOR_CSS = 'html {\n  overflow-x: hidden;\n}\n';
+/** A stylesheet with a reflex finding: a colour written out instead of a token. */
+const REFLEX_CSS = '.chip {\n  color: #ff0000;\n}\n';
+/** A project to audit: a directory with a source directory in it. */
+async function project() {
+    const root = await mkdtemp(join(tmpdir(), 'openagentsy-cli-audit-'));
+    await mkdir(join(root, 'src'), { recursive: true });
+    return { root, remove: () => rm(root, { recursive: true, force: true }) };
+}
+/**
+ * The git variables that point a command at a repository.
+ *
+ * A git that runs a hook sets these in the environment of the hook, and a
+ * child inherits them: the child then addresses the repository of the hook
+ * instead of the one it was asked about, and a test that writes into the
+ * repository of the hook writes into the project. The variables are
+ * removed, so the repository is the one the test named.
+ */
+const GIT_REPOSITORY_VARS = [
+    'GIT_DIR',
+    'GIT_WORK_TREE',
+    'GIT_INDEX_FILE',
+    'GIT_COMMON_DIR',
+    'GIT_OBJECT_DIRECTORY',
+    'GIT_ALTERNATE_OBJECT_DIRECTORIES',
+    'GIT_CEILING_DIRECTORIES',
+    'GIT_PREFIX',
+    'GIT_NAMESPACE',
+];
+/** The environment of a git child: the caller's, without the git variables. */
+function cleanEnv() {
+    const env = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value === undefined)
+            continue;
+        if (GIT_REPOSITORY_VARS.includes(key))
+            continue;
+        env[key] = value;
+    }
+    return env;
+}
+/**
+ * The git of a test project.
+ *
+ * The fsmonitor hook is off, as it is in the command: the hook of a
+ * machine whose daemon is not running answers with an error, and the
+ * scope would come back empty.
+ *
+ * The signing is off too, and for the same kind of reason: a machine whose
+ * global config asks for a signature would need a signing agent to answer,
+ * and a test that needs an agent to answer is a test that fails on a
+ * machine without one. A test signs nothing.
+ */
+async function git(root, args) {
+    await exec('git', ['-c', 'core.fsmonitor=false', '-c', 'commit.gpgsign=false', ...args], {
+        cwd: root,
+        env: cleanEnv(),
+    });
+}
+/** A project with a commit in it, so the changed scope has a base. */
+async function repository() {
+    const { root } = await project();
+    await git(root, ['init', '-q']);
+    await git(root, [
+        '-c',
+        'user.email=test@example.com',
+        '-c',
+        'user.name=Test',
+        'commit',
+        '-q',
+        '--allow-empty',
+        '-m',
+        'base',
+    ]);
+    return root;
+}
+describe('the audit command', () => {
+    it('lists the findings of the scope', async () => {
+        const root = await repository();
+        try {
+            await writeFile(join(root, 'src/app.css'), FLOOR_CSS);
+            await git(root, ['add', 'src/app.css']);
+            const report = await runAudit(rootsOf(root));
+            expect(report.scope).toBe('changed');
+            expect(report.files).toContain('src/app.css');
+            expect(report.floor).toBe(1);
+            const text = formatAuditReport(report);
+            expect(text).toContain('css/overflow-clip');
+            expect(text).toContain('src/app.css:2');
+        }
+        finally {
+            await rm(root, { recursive: true, force: true });
+        }
+    });
+    it('prints the path that ran', async () => {
+        const { root, remove } = await project();
+        try {
+            await writeFile(join(root, 'src/app.ts'), 'export const value = 1;\n');
+            const report = await runAudit(rootsOf(root), { scope: 'all' });
+            // The scope holds no page and no stylesheet, so the linter had
+            // nothing to read and the static rules ran alone.
+            expect(report.path).toBe('static');
+            expect(report.degraded).toBe('no-files');
+            expect(formatAuditReport(report)).toContain('static');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('a waived finding is not counted as open', async () => {
+        const { root, remove } = await project();
+        try {
+            await writeFile(join(root, 'src/theme.css'), REFLEX_CSS);
+            const waiver = await runWaiver(root, 'css/token-only-colour-font', 'src/theme.css', 'The file is a fixture, not a page.');
+            expect(waiver.ok).toBe(true);
+            const report = await runAudit(rootsOf(root), { scope: 'all' });
+            expect(report.reflex).toBe(0);
+            expect(report.waived.length).toBe(1);
+            expect(report.waived[0]?.ruleId).toBe('css/token-only-colour-font');
+            expect(report.exitCode).toBe(0);
+            expect(formatAuditReport(report)).toContain('waived');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('the exit code follows the floor rule', async () => {
+        const { root, remove } = await project();
+        try {
+            await writeFile(join(root, 'src/app.css'), FLOOR_CSS);
+            await writeFile(join(root, 'src/theme.css'), REFLEX_CSS);
+            const report = await runAudit(rootsOf(root), { scope: 'all' });
+            expect(report.floor).toBe(1);
+            expect(report.reflex).toBe(1);
+            expect(report.exitCode).toBe(1);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('passes when only reflex findings are open', async () => {
+        const { root, remove } = await project();
+        try {
+            await writeFile(join(root, 'src/theme.css'), REFLEX_CSS);
+            const report = await runAudit(rootsOf(root), { scope: 'all' });
+            expect(report.floor).toBe(0);
+            expect(report.reflex).toBe(1);
+            expect(report.exitCode).toBe(0);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('reads the after mode', async () => {
+        const { root, remove } = await project();
+        try {
+            await writeFile(join(root, 'openagentsy.jsonc'), '{\n  // the check runs on the command, not on every write\n  "quality": { "mode": "after" }\n}\n');
+            const report = await runAudit(rootsOf(root), { scope: 'all' });
+            expect(report.mode).toBe('after');
+            const text = formatAuditReport(report);
+            expect(text).toContain('after');
+            expect(text).toContain('the hook is off');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('runs the check on every write by default', async () => {
+        const { root, remove } = await project();
+        try {
+            const report = await runAudit(rootsOf(root), { scope: 'all' });
+            expect(report.mode).toBe('during');
+            expect(formatAuditReport(report)).toContain('during');
+        }
+        finally {
+            await remove();
+        }
+    });
+});
+//# sourceMappingURL=audit.test.js.map

package/dist/commands/audit.test.js.map

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

package/dist/commands/board.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The board, as a person reads it.
+ *
+ * The plan asks for a read-only view so a human can follow a run along:
+ * the records the agents left, the leases they hold, and the budgets they
+ * spend. It is a command and not a web page, because the thing it has to
+ * do is show what happened, and a page is a server to keep alive.
+ *
+ * The board is the state root's, so a command run in a worktree shows the
+ * board of the project and not a board of its own.
+ */
+export type BoardView = {
+    records: {
+        id: number;
+        kind: string;
+        from: string;
+        bean: string;
+        action: string;
+    }[];
+    leases: {
+        bean: string;
+        agent: string;
+        glob: string;
+    }[];
+    budgets: {
+        bean: string;
+        tokenLimit: number;
+        stopAt: number;
+    }[];
+};
+export declare function runBoard(stateRoot: string): Promise<BoardView>;
+export declare function formatBoard(view: BoardView): string;
+//# sourceMappingURL=board.d.ts.map

package/dist/commands/board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/commands/board.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpF,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxD,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjE,CAAC;AAEF,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmCpE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAkCnD"}

package/dist/commands/board.js

@@ -0,0 +1,65 @@
+import { access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { closeDatabase, listBudgets, listLeases, listRecords, openDatabase, } from '@openagentsy/core';
+export async function runBoard(stateRoot) {
+    const databasePath = join(stateRoot, '.openagentsy', 'board.sqlite');
+    // A project that has no board yet has nothing to show, and reading it
+    // should not create one.
+    const exists = await access(databasePath).then(() => true, () => false);
+    if (!exists)
+        return { records: [], leases: [], budgets: [] };
+    const db = openDatabase(databasePath);
+    try {
+        const inbox = listRecords(db, { limit: 50 });
+        return {
+            records: inbox.records.map((record) => ({
+                id: record.id,
+                kind: record.kind,
+                from: record.from,
+                bean: record.bean,
+                action: record.action,
+            })),
+            leases: listLeases(db).map((lease) => ({
+                bean: lease.bean,
+                agent: lease.agent,
+                glob: lease.glob,
+            })),
+            budgets: listBudgets(db).map((budget) => ({
+                bean: budget.bean,
+                tokenLimit: budget.tokenLimit,
+                stopAt: budget.stopAt,
+            })),
+        };
+    }
+    finally {
+        closeDatabase(db);
+    }
+}
+export function formatBoard(view) {
+    const lines = [];
+    lines.push('records');
+    if (view.records.length === 0) {
+        lines.push('  (none)');
+    }
+    for (const record of view.records) {
+        lines.push(`  ${String(record.id).padStart(4)}  ${record.kind.padEnd(9)} ${record.from.padEnd(12)} ${record.bean.padEnd(14)} ${record.action}`);
+    }
+    lines.push('');
+    lines.push('leases');
+    if (view.leases.length === 0) {
+        lines.push('  (none)');
+    }
+    for (const lease of view.leases) {
+        lines.push(`  ${lease.agent.padEnd(14)} ${lease.glob.padEnd(30)} ${lease.bean}`);
+    }
+    lines.push('');
+    lines.push('budgets');
+    if (view.budgets.length === 0) {
+        lines.push('  (none)');
+    }
+    for (const budget of view.budgets) {
+        lines.push(`  ${budget.bean.padEnd(20)} ${budget.tokenLimit} tokens, stops at ${budget.stopAt}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=board.js.map

package/dist/commands/board.js.map

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