@voxslopuli/openagentsy 0.0.0-stage → 0.2.1

package/dist/commands/report.js

@@ -0,0 +1,164 @@
+import { buildConformanceReport, ethicalReportJson, renderEthicalReport, } from '@openagentsy/core';
+import { loadWaiverLookup } from '@openagentsy/hooks/quality/waivers';
+import { acceptGate, readFindings } from '@openagentsy/quality';
+import { ledgerFacts } from '../report/ledger.js';
+import { oversightFacts, scopedFindings } from '../report/oversight.js';
+import { parseScope } from '../report/scope.js';
+/**
+ * The facts of a project with nothing in it.
+ *
+ * A command that cannot build a scope has no report to render, and the
+ * problem it reports is the whole of its output.
+ */
+function emptyFacts(scope) {
+    return {
+        scope,
+        cost: {
+            present: false,
+            messages: 0,
+            tokens: 0,
+            roles: [],
+            reportedUsd: null,
+            estimatedUsd: null,
+            unpricedModels: 0,
+            unpricedMessages: 0,
+        },
+        footprint: {
+            present: false,
+            energyKwh: null,
+            waterL: null,
+            co2Kg: null,
+            method: null,
+            dominantUncertainty: null,
+            grid: null,
+            undisclosedProviders: 0,
+        },
+        waste: { present: false, tokens: 0, percentage: 0, byKind: [] },
+        value: {
+            present: false,
+            tasksCompleted: 0,
+            tasksScrapped: 0,
+            commits: 0,
+            prsMerged: 0,
+            tokensPerTask: null,
+            tokensPerCommit: null,
+            offloadMessages: 0,
+            offloadTokens: 0,
+            offloadUsd: null,
+            offloadCloudUsd: null,
+            offloadSavedUsd: null,
+        },
+        oversight: {
+            records: 0,
+            lessons: 0,
+            memory: 0,
+            waivers: 0,
+            auditEntries: 0,
+            openFloor: 0,
+            openFloorFindings: [],
+            mismatches: { known: false, reason: 'no package compares the board with a report' },
+            redactions: { known: false, reason: 'no package keeps a counter' },
+        },
+        conformance: {
+            total: 0,
+            observed: 0,
+            provenStatic: 0,
+            unverified: 0,
+            unverifiedIds: [],
+            pluginOrderWarnings: [],
+        },
+        policies: { present: false, firings: 0, top: [], neverFired: [] },
+    };
+}
+/**
+ * The conformance of the project, as the report shows it.
+ *
+ * The counts and the unverified capabilities are the conformance report of
+ * §11, and the unverified ones are named: a guess about the host must not
+ * read as a tested fact.
+ */
+async function conformanceFacts(roots) {
+    const report = await buildConformanceReport({
+        workspace: roots.workspace,
+        stateRoot: roots.stateRoot,
+    });
+    return {
+        total: report.counts.total,
+        observed: report.counts.observed,
+        provenStatic: report.counts.proven_static,
+        unverified: report.counts.unverified,
+        unverifiedIds: report.capabilities
+            .filter((capability) => capability.state === 'unverified')
+            .map((capability) => capability.id),
+        pluginOrderWarnings: report.pluginOrderWarnings.map((warning) => ({
+            plugin: warning.plugin,
+            detail: warning.detail,
+        })),
+    };
+}
+/**
+ * The report.
+ *
+ * The scope names the rows the ledger is read for, the board records the
+ * oversight counts, and the findings store the gate. Nothing is written.
+ */
+export async function runEthicalReport(roots, options = {}) {
+    const parsed = parseScope(options);
+    if (!parsed.ok) {
+        return { facts: emptyFacts({ kind: 'project' }), exitCode: 2, problem: parsed.error };
+    }
+    const scope = parsed.scope;
+    const findings = await readFindings(roots.stateRoot);
+    const ledger = await ledgerFacts(roots.stateRoot, scope);
+    const oversight = await oversightFacts(roots.stateRoot, scope, findings);
+    const conformance = await conformanceFacts(roots);
+    // The gate decides, not the report: the rule is the quality package's,
+    // and the report asks it whether a ship of this work would be accepted.
+    const waivers = await loadWaiverLookup(roots.stateRoot);
+    const gate = acceptGate({
+        raw: { verdict: 'ship' },
+        findings: scopedFindings(findings, scope),
+        waivers,
+    });
+    const facts = {
+        scope,
+        cost: ledger.cost,
+        footprint: ledger.footprint,
+        waste: ledger.waste,
+        value: ledger.value,
+        oversight,
+        conformance,
+        policies: ledger.policies,
+    };
+    const refusing = !gate.accepted;
+    return {
+        facts,
+        exitCode: options.check === true && refusing ? 1 : 0,
+        ...(refusing
+            ? { refusal: `the gate refuses the ship: ${gate.openFloor.length} floor findings are open` }
+            : {}),
+    };
+}
+/**
+ * The report, as plain text.
+ *
+ * The text carries no colour, and a refusal is said in words rather than in
+ * an exit code alone, so a reader of the output knows what happened.
+ */
+export function formatEthicalReport(report) {
+    if (report.problem !== undefined)
+        return `${report.problem}\n`;
+    const text = renderEthicalReport(report.facts);
+    if (report.refusal === undefined)
+        return text;
+    return `${text}\n${report.refusal}\n`;
+}
+/**
+ * The report, as JSON.
+ *
+ * The same facts the text is rendered from, so the two can never disagree.
+ */
+export function ethicalReportAsJson(report) {
+    return `${JSON.stringify(ethicalReportJson(report.facts), null, 2)}\n`;
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/report.js.map

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

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

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

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

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

package/dist/commands/report.test.js

@@ -0,0 +1,294 @@
+import { mkdir, mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { closeDatabase, createRecord, migrate, openDatabase, } from '@openagentsy/core';
+import { closeLedger, openLedger, recordFootprint } from '@openagentsy/ledger';
+import { describe, expect, it } from 'vitest';
+import { formatEthicalReport, runEthicalReport } from './report.js';
+/**
+ * A project with a run in it.
+ *
+ * The fixture is the whole state of a project: a ledger with usage, waste,
+ * outcomes and a footprint, a board with records, the lessons, the waivers,
+ * the audit log, the findings of a check and the evidence of a live
+ * observation. Every number the report prints is read out of one of them.
+ */
+/** The state of a project, as the report reads it. */
+async function scratch() {
+    const root = await mkdtemp(join(tmpdir(), 'openagentsy-report-'));
+    await seedLedger(root);
+    await seedBoard(root);
+    await seedStores(root);
+    return { workspace: root, stateRoot: root };
+}
+/** The moment the fixture was written. */
+const NOW = new Date().toISOString();
+/** The usage insert, with the columns the report reads. */
+const USAGE_INSERT = `INSERT INTO usage
+  (message_id, session_id, root_session_id, role, provider, model,
+   input, output, reasoning, cache_read, cache_write,
+   cost_reported, cost_estimated, task_id, ts)
+  VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`;
+/** The footprint of one message, as the estimator produced it. */
+const IMPACT = {
+    energyWh: [2100, 4800],
+    waterL: [210, 980],
+    co2Kg: [0.9, 2.1],
+    warmingC: [3.1e-17, 7.3e-17],
+    dominantUncertainty: 'model-size',
+    notes: ['output tokens only (EcoLogits method)'],
+};
+/** The ledger of the fixture. */
+async function seedLedger(root) {
+    const db = openLedger(root);
+    try {
+        const usage = db.query(USAGE_INSERT);
+        usage.run('msg-1', 'ses_1', 'ses_1', 'builder', 'anthropic', 'claude-x', 100_000, 200_000, 50_000, 0, 10_000, 0.42, null, '2e-4a', NOW);
+        usage.run('msg-2', 'ses_1', 'ses_1', 'lead', 'anthropic', 'claude-x', 50_000, 10_000, 0, 0, 0, null, 0.01, '2e-4a', NOW);
+        usage.run('msg-3', 'ses_2', 'ses_2', 'reviewer', 'ollama', 'qwen3:8b', 10_000, 5_000, 0, 0, 0, null, null, 'other-bean', NOW);
+        const waste = db.query('INSERT INTO waste (root_session_id, message_id, kind, tokens, detail, ts) VALUES (?,?,?,?,?,?)');
+        waste.run('ses_1', 'msg-1', 'retry', 100_000, 'the same call twice', NOW);
+        waste.run('ses_1', 'msg-1', 'tool_error_loop', 50_000, 'the tool failed', NOW);
+        const outcome = db.query('INSERT INTO outcome (root_session_id, task_id, commit_sha, kind, ts) VALUES (?,?,?,?,?)');
+        outcome.run('ses_1', '2e-4a', 'abc123', 'task_completed', NOW);
+        outcome.run('ses_1', '2e-4a', null, 'task_scrapped', NOW);
+        outcome.run('ses_1', '2e-4a', 'abc123', 'commit', NOW);
+        recordFootprint(db, 'msg-1', IMPACT);
+        seedPolicyFirings(db);
+    }
+    finally {
+        closeLedger(db);
+    }
+}
+/**
+ * The policy firings of the fixture.
+ *
+ * The rows are the ones §21.3 holds: the policy id, the version it carried
+ * when it fired, the session and the outcome.
+ */
+function seedPolicyFirings(db) {
+    const insert = db.query(`INSERT INTO policy_firing
+      (id, session_id, policy_id, policy_version, layer, action, severity, reason, origin, ts)
+     VALUES (?,?,?,?,?,?,?,?,?,?)`);
+    insert.run('f1', 'ses_1', 'oa.anti-sycophancy', '1.0.0', 4, 'flag', 'warn', null, 'first-party', NOW);
+    insert.run('f2', 'ses_1', 'oa.anti-sycophancy', '1.0.0', 4, 'flag', 'warn', null, 'first-party', NOW);
+    insert.run('f3', 'ses_1', 'oa.anti-sycophancy', '1.0.0', 4, 'block', null, 'high risk', 'first-party', NOW);
+    insert.run('f4', 'ses_1', 'oa.agi-framing', '1.0.0', 4, 'flag', 'info', null, 'first-party', NOW);
+    insert.run('f5', 'ses_1', 'oa.policy.stack', '1.0.0', 2, 'allow', null, 'stack-assembled', 'first-party', NOW);
+}
+/** The board of the fixture. */
+async function seedBoard(root) {
+    const path = join(root, '.openagentsy', 'board.sqlite');
+    await mkdir(join(root, '.openagentsy'), { recursive: true });
+    const db = openDatabase(path);
+    try {
+        migrate(db);
+        createRecord(db, {
+            bean: '2e-4a',
+            kind: 'status',
+            from: 'oa-builder',
+            action: 'The ethical report',
+            state: 'the report is written',
+            confidence: 'verified',
+        });
+        createRecord(db, {
+            bean: 'memory',
+            kind: 'finding',
+            from: 'oa-archivist',
+            action: 'A candidate memory',
+            state: 'candidate',
+            confidence: 'inferred',
+        });
+        createRecord(db, {
+            bean: 'other-bean',
+            kind: 'status',
+            from: 'oa-builder',
+            action: 'Something else',
+            state: 'done',
+            confidence: 'verified',
+        });
+    }
+    finally {
+        closeDatabase(db);
+    }
+}
+/** The stores of the fixture: the lessons, the waivers, the audit and the findings. */
+async function seedStores(root) {
+    const state = join(root, '.openagentsy');
+    await mkdir(join(state, 'lessons'), { recursive: true });
+    await mkdir(join(state, 'quality'), { recursive: true });
+    await writeFile(join(state, 'lessons', 'oa-lesson-abcd1234.json'), `${JSON.stringify({
+        id: 'oa-lesson-abcd1234',
+        state: 'candidate',
+        summary: 'A call that was made twice',
+        occurrences: 2,
+        packet: {},
+        history: [],
+        kind: 'retry',
+        detail: 'the same call twice',
+        sessions: ['ses_1'],
+        created_at: NOW,
+        updated_at: NOW,
+    }, null, 2)}\n`, 'utf8');
+    await writeFile(join(state, 'quality', 'waivers.json'), `${JSON.stringify({
+        version: 1,
+        waivers: [
+            {
+                ruleId: 'css/no-transition-all',
+                path: 'src/app.css',
+                reason: 'the transition is deliberate here',
+                decidedBy: 'daniel',
+                ts: NOW,
+            },
+        ],
+    }, null, 2)}\n`, 'utf8');
+    await writeFile(join(state, 'quality', 'findings.json'), `${JSON.stringify({
+        version: 1,
+        tasks: {
+            '2e-4a': [
+                {
+                    ruleId: 'a11y/no-aria-label',
+                    source: 'hallmark:floor-1',
+                    tier: 'floor',
+                    file: 'src/app.html',
+                    line: 4,
+                    message: 'A control has no name.',
+                    fix: 'Name the control',
+                },
+                {
+                    ruleId: 'css/no-transition-all',
+                    source: 'hallmark:floor-2',
+                    tier: 'reflex',
+                    file: 'src/app.css',
+                    line: 12,
+                    message: 'A transition of all moves every property.',
+                    fix: 'Name the properties to transition instead of all',
+                },
+            ],
+        },
+    }, null, 2)}\n`, 'utf8');
+    const audit = [
+        {
+            ts: NOW,
+            policyId: 'oa.record.post',
+            policyVersion: 'v1',
+            actor: 'oa-builder',
+            action: 'post',
+            resource: '2e-4a',
+            effect: 'allow',
+        },
+        {
+            ts: NOW,
+            policyId: 'oa.lease.grant',
+            policyVersion: 'v1',
+            actor: 'oa-lead',
+            action: 'grant',
+            resource: 'packages/cli/**',
+            effect: 'allow',
+        },
+    ];
+    await writeFile(join(state, 'audit.jsonl'), `${audit.map((entry) => JSON.stringify(entry)).join('\n')}\n`, 'utf8');
+    await writeFile(join(state, 'conformance.json'), `${JSON.stringify({
+        version: 1,
+        capabilities: {
+            'message-token-fields': {
+                observations: [
+                    {
+                        capabilityId: 'message-token-fields',
+                        eventType: 'message.tokens',
+                        at: NOW,
+                        kind: 'live',
+                        note: 'the token fields were read off a live message',
+                        source: { ref: 'session ses_1', date: '2026-10-28' },
+                    },
+                ],
+            },
+        },
+    }, null, 2)}\n`, 'utf8');
+}
+describe('the ethical report', () => {
+    it('renders every section from a seeded project', async () => {
+        const roots = await scratch();
+        const report = await runEthicalReport(roots);
+        const text = formatEthicalReport(report);
+        expect(text).toContain('Cost and footprint');
+        expect(text).toContain('tokens by role: builder 360k · lead 60k · reviewer 15k');
+        expect(text).toContain('spend: $0.42 reported · $0.01 estimated · 1 model unpriced');
+        expect(text).toContain('electricity 2.1–4.8 kWh');
+        expect(text).toContain('water 210–980 L');
+        expect(text).toContain('carbon 0.9–2.1 kg CO2');
+        expect(text).toContain('method ecologits-0.11.3');
+        expect(text).toContain('Waste');
+        expect(text).toContain('34% of tokens went to retries, undos and reverted code');
+        expect(text).toContain('Value');
+        expect(text).toContain('1 task completed · 1 scrapped task');
+        expect(text).toContain('tokens per completed task: 420k');
+        expect(text).toContain('Oversight');
+        expect(text).toContain('1 lesson to review · 1 memory to triage · 1 waiver recorded');
+        expect(text).toContain('open floor findings: 1');
+        expect(text).toContain('Conformance');
+        expect(text).toContain('unverified:');
+    });
+    it('shows the policies with the most firings', async () => {
+        const roots = await scratch();
+        const text = formatEthicalReport(await runEthicalReport(roots));
+        expect(text).toContain('Policies');
+        expect(text).toContain('oa.anti-sycophancy 3 firings (1.0.0) · 1 blocks · 2 flags');
+        expect(text).toContain('oa.agi-framing 1 firing (1.0.0) · 0 blocks · 1 flags');
+        const never = text.split('\n').find((entry) => entry.includes('never fired:')) ?? '';
+        expect(never).toContain('oa.structural-bias');
+    });
+    it('reads the firings of one session', async () => {
+        const roots = await scratch();
+        const text = formatEthicalReport(await runEthicalReport(roots, { session: 'ses_1' }));
+        expect(text).toContain('oa.anti-sycophancy 3 firings');
+    });
+    it('says what nobody computes instead of showing a zero', async () => {
+        const roots = await scratch();
+        const text = formatEthicalReport(await runEthicalReport(roots));
+        expect(text).toContain('board/report mismatches: not computed (no package compares the board with a report)');
+        expect(text).toContain('redactions: not computed (no package keeps a counter)');
+        expect(text).toContain('grid: not recorded by the ledger');
+    });
+    it('says that a scope with nothing in it is empty', async () => {
+        const roots = await scratch();
+        const text = formatEthicalReport(await runEthicalReport(roots, { bean: 'no-such-bean' }));
+        expect(text).toContain('bean no-such-bean');
+        expect(text).toContain('tokens by role: none — the scope holds no usage rows');
+        expect(text).toContain('spend: nothing to price');
+        expect(text).toContain('no waste was recorded for the scope');
+        expect(text).toContain('the scope holds no outcome');
+        expect(text).not.toContain('360k');
+    });
+    it('reads the rows of one session', async () => {
+        const roots = await scratch();
+        const text = formatEthicalReport(await runEthicalReport(roots, { session: 'ses_1' }));
+        expect(text).toContain('tokens by role: builder 360k · lead 60k');
+        expect(text).not.toContain('reviewer');
+    });
+    it('reads the rows of a window', async () => {
+        const roots = await scratch();
+        const text = formatEthicalReport(await runEthicalReport(roots, { since: '30d' }));
+        expect(text).toContain('the last 30 d');
+        expect(text).toContain('tokens by role: builder 360k · lead 60k · reviewer 15k');
+    });
+    it('refuses a scope that names two things', async () => {
+        const roots = await scratch();
+        const report = await runEthicalReport(roots, { bean: '2e-4a', session: 'ses_1' });
+        expect(report.exitCode).toBe(2);
+        expect(report.problem).toContain('names more than one thing');
+    });
+    it('fails the check while a floor finding is open', async () => {
+        const roots = await scratch();
+        const report = await runEthicalReport(roots, { check: true });
+        expect(report.exitCode).toBe(1);
+        expect(report.refusal).toContain('the gate refuses the ship');
+        expect(formatEthicalReport(report)).toContain('open floor findings: 1');
+    });
+    it('passes the check without the flag, because the report is not a gate', async () => {
+        const roots = await scratch();
+        const report = await runEthicalReport(roots);
+        expect(report.exitCode).toBe(0);
+    });
+});
+//# sourceMappingURL=report.test.js.map

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

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

package/dist/commands/scope.d.ts

@@ -0,0 +1,34 @@
+import { type ScopeDeclaration } from '@openagentsy/core';
+/**
+ * The `oa scope` command (§22.3).
+ *
+ * It prints the scope declaration of one role, or of every role. It is a
+ * command a person runs: the declarations are there to be read, and the
+ * refusal a role makes is built from the same text.
+ *
+ * The command reads the declarations the core package ships. A project that
+ * declares its own roles reads them from its own roles file, and that is a
+ * follow-up: the roles file is a person's file and the parser that would
+ * read a declaration out of it does not exist yet.
+ */
+/** What the command found. */
+export type ScopeReport = {
+    /** The role that was asked for, when one was named. */
+    role: string | undefined;
+    /** The declarations to print. */
+    declarations: ScopeDeclaration[];
+    /** The role that was asked for and is not there. */
+    unknownRole: string | undefined;
+};
+/**
+ * The declarations to print.
+ *
+ * With a role, the declaration of that role. Without one, every
+ * declaration.
+ */
+export declare function runScope(role?: string | undefined): ScopeReport;
+/**
+ * The declarations, as they are read.
+ */
+export declare function formatScope(report: ScopeReport): string;
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/commands/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EAEtB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;GAWG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG;IACxB,uDAAuD;IACvD,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,iCAAiC;IACjC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,oDAAoD;IACpD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AASF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAa/D;AAiCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAcvD"}

package/dist/commands/scope.js

@@ -0,0 +1,78 @@
+import { isReviewed, listScopeDeclarations, REQUIRED_REVIEWERS, scopeDeclaration, } from '@openagentsy/core';
+/** The names of the roles, for a message that needs them. */
+function roleNames() {
+    return listScopeDeclarations()
+        .map((declaration) => declaration.role)
+        .join(', ');
+}
+/**
+ * The declarations to print.
+ *
+ * With a role, the declaration of that role. Without one, every
+ * declaration.
+ */
+export function runScope(role) {
+    if (role === undefined || role.trim() === '') {
+        return {
+            role: undefined,
+            declarations: [...listScopeDeclarations()],
+            unknownRole: undefined,
+        };
+    }
+    const declaration = scopeDeclaration(role);
+    if (declaration === undefined) {
+        return { role: role.trim(), declarations: [], unknownRole: role.trim() };
+    }
+    return { role: declaration.role, declarations: [declaration], unknownRole: undefined };
+}
+/**
+ * One declaration, as it is read.
+ */
+function formatDeclaration(declaration) {
+    const lines = [];
+    lines.push(`${declaration.role} (${declaration.display}):`);
+    lines.push(`  Purpose: ${declaration.purpose}`);
+    lines.push('  In scope:');
+    for (const entry of declaration.in_scope)
+        lines.push(`    - ${entry.statement}`);
+    lines.push('  Out of scope:');
+    for (const entry of declaration.out_of_scope)
+        lines.push(`    - ${entry.statement}`);
+    lines.push(`  Refusal: ${declaration.refusal_pattern}`);
+    lines.push(`  Redirect: ${declaration.redirect}`);
+    lines.push(`  Review: ${formatReview(declaration)}`);
+    return lines;
+}
+/**
+ * Where the ethics review stands.
+ *
+ * A proposal says so: the declaration has not been through the maintainer
+ * review of §17.5, and a person reading it should know that.
+ */
+function formatReview(declaration) {
+    if (isReviewed(declaration)) {
+        return `reviewed by ${declaration.review.reviewers.join(', ')}`;
+    }
+    const signed = declaration.review.reviewers.length;
+    return `proposed — ${signed} of ${REQUIRED_REVIEWERS} maintainers have reviewed it (§17.5)`;
+}
+/**
+ * The declarations, as they are read.
+ */
+export function formatScope(report) {
+    if (report.declarations.length === 0) {
+        return [
+            `no scope declaration for ${report.unknownRole ?? 'that role'}`,
+            `the roles that have one: ${roleNames()}`,
+            '',
+        ].join('\n');
+    }
+    const lines = [];
+    report.declarations.forEach((declaration, index) => {
+        if (index > 0)
+            lines.push('');
+        lines.push(...formatDeclaration(declaration));
+    });
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=scope.js.map

package/dist/commands/scope.js.map

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

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

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

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

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