@openagentsy/hooks 0.0.0-stage → 0.2.0

package/dist/policy.js

@@ -0,0 +1,22 @@
+/** The result of a policy that let the thing through. */
+export function allow() {
+    return { action: 'allow' };
+}
+/** The result of a policy that noted something. */
+export function flag(findings, severity = 'warn') {
+    return { action: 'flag', findings, severity };
+}
+/** The result of a policy that stopped the thing. */
+export function block(reason, finding) {
+    return finding === undefined ? { action: 'block', reason } : { action: 'block', reason, finding };
+}
+/**
+ * The findings of a set of matches.
+ *
+ * The policy id is on every finding, so a finding that travels on its own
+ * still says which policy produced it.
+ */
+export function findingsOf(policyId, type, matches) {
+    return matches.map((match) => ({ policyId, type, match }));
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AA0GA,yDAAyD;AACzD,MAAM,UAAU,KAAK;IACnB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,IAAI,CAAC,QAAyB,EAAE,WAA2B,MAAM;IAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,OAAuB;IAC3D,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACpG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,IAAY,EACZ,OAA0B;IAE1B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/quality/audit.d.ts

@@ -0,0 +1,56 @@
+import { type Finding, type SloplintDegradation, type SloplintPath } from '@openagentsy/quality';
+import { type WaiverLookup } from './waivers.js';
+export type { Finding, SloplintDegradation, SloplintPath };
+/**
+ * The audit.
+ *
+ * The hook reports the findings of a write to the agent that made it, and
+ * in the `after` mode the hook does nothing at all: the audit is the report
+ * then. The audit runs the whole rule set over a scope of files, runs the
+ * optional linter over the pages and the stylesheets in it, and marks the
+ * findings a person waived.
+ *
+ * The whole rule set is the one the audit runs, the comment rules
+ * included: the comment lint needs a TypeScript parse, and the audit is a
+ * call a person made on purpose, so the parse is paid for on demand here
+ * and not at all on the write path.
+ *
+ * The module is not exported from the package barrel: the whole rule set
+ * carries the TypeScript compiler, and the plugin must not pay for it. The
+ * callers reach it by its own path, `@openagentsy/hooks/quality/audit`.
+ */
+/** What the audit looks at. */
+export interface QualityAuditOptions {
+    /** The project root. The files are relative to it. */
+    root: string;
+    /** The files to audit. */
+    files: readonly string[];
+    /** The waivers that cover a finding. */
+    waivers?: WaiverLookup | undefined;
+}
+/** What the audit found. */
+export interface QualityAuditResult {
+    /** The files the check read. */
+    files: string[];
+    /** Every finding, the waived ones included. */
+    findings: Finding[];
+    /** The findings no waiver covers. */
+    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 script the linter ran, when one ran. */
+    script?: string | undefined;
+}
+/**
+ * The audit of a scope of files.
+ *
+ * The static findings stand in every case: a linter that is absent, that
+ * crashes or that says something the bridge cannot read leaves the static
+ * findings exactly as they were, and the report says which path ran.
+ */
+export declare function runQualityAudit(options: QualityAuditOptions): Promise<QualityAuditResult>;
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/quality/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EAEZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AAEH,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,wCAAwC;IACxC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACpC;AAED,4BAA4B;AAC5B,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,qCAAqC;IACrC,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,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiB/F"}

package/dist/quality/audit.js

@@ -0,0 +1,52 @@
+import { allRegistry, check, runSloplint, } from '@openagentsy/quality';
+import { readDesignMd } from './rule.js';
+import { loadWaiverLookup } from './waivers.js';
+/**
+ * The audit of a scope of files.
+ *
+ * The static findings stand in every case: a linter that is absent, that
+ * crashes or that says something the bridge cannot read leaves the static
+ * findings exactly as they were, and the report says which path ran.
+ */
+export async function runQualityAudit(options) {
+    const files = auditedFiles(options.files);
+    const findings = await findingsOf(files, options.root);
+    const linter = await runSloplint({ root: options.root, files });
+    const all = [...findings, ...linter.findings];
+    const waivers = options.waivers ?? (await loadWaiverLookup(options.root));
+    const waived = all.filter((finding) => waivers.covers(finding));
+    const open = all.filter((finding) => !waivers.covers(finding));
+    return {
+        files,
+        findings: all,
+        open,
+        waived,
+        path: linter.path,
+        ...(linter.degraded !== undefined ? { degraded: linter.degraded } : {}),
+        ...(linter.script !== undefined ? { script: linter.script } : {}),
+    };
+}
+/**
+ * The files a rule applies to.
+ *
+ * A file no rule reads is not read: the check reads every file it is given,
+ * and a scope of a whole project holds a thousand files that no rule has an
+ * opinion about.
+ */
+function auditedFiles(files) {
+    return files.filter((path) => allRegistry.forFile(path).length > 0);
+}
+/**
+ * The findings of the check, when there is a file to check.
+ *
+ * The design file is read as data: it can name a taste rule and turn it
+ * off, and nothing else.
+ */
+async function findingsOf(files, root) {
+    if (files.length === 0)
+        return [];
+    const design = await readDesignMd(root);
+    const ctx = design === undefined ? {} : { design };
+    return await check(files, ctx, { root, registry: allRegistry });
+}
+//# sourceMappingURL=audit.js.map

package/dist/quality/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/quality/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,EAEL,WAAW,GAGZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAqB,MAAM,cAAc,CAAC;AAmDnE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA4B;IAChE,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,OAAO;QACL,KAAK;QACL,QAAQ,EAAE,GAAG;QACb,IAAI;QACJ,MAAM;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,KAAwB;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,UAAU,CAAC,KAAwB,EAAE,IAAY;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACnD,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/quality/findings.d.ts

@@ -0,0 +1,34 @@
+import type { Finding } from '@openagentsy/quality';
+/**
+ * The findings store.
+ *
+ * The findings a check produced have to outlive the session that produced
+ * them: the task store reads them when a task is completed, and that is
+ * another process, hours later. So they live in a file under the state
+ * root, beside the waivers the next bean writes, and the file is the only
+ * truth.
+ *
+ * A record replaces the findings of the files it checked and keeps the
+ * findings of the other files. So a finding that has been fixed goes away
+ * when the file is written again, and a finding of another file is not
+ * lost by the write.
+ */
+/** The file the findings live in. */
+export declare function findingsPath(stateRoot: string): string;
+/** What the store can do. */
+export interface FindingsStore {
+    /** Record what a check found, for the files the check looked at. */
+    record(taskId: string, files: readonly string[], findings: readonly Finding[]): Promise<void>;
+    /** Every finding recorded for a task. */
+    forTask(taskId: string): Promise<Finding[]>;
+    /** The floor findings that are open for a task. */
+    openFloor(taskId: string): Promise<Finding[]>;
+}
+/**
+ * The store of a project.
+ *
+ * The state root is the root of the project, and the file is under it, so
+ * two projects never read each other's findings.
+ */
+export declare function createFindingsStore(stateRoot: string): FindingsStore;
+//# sourceMappingURL=findings.d.ts.map

package/dist/quality/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../src/quality/findings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD;;;;;;;;;;;;;GAaG;AAEH,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,yCAAyC;IACzC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,mDAAmD;IACnD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC/C;AAmDD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAgBpE"}

package/dist/quality/findings.js

@@ -0,0 +1,121 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { normalizePath } from '@openagentsy/core';
+import { z } from 'zod';
+/**
+ * The findings store.
+ *
+ * The findings a check produced have to outlive the session that produced
+ * them: the task store reads them when a task is completed, and that is
+ * another process, hours later. So they live in a file under the state
+ * root, beside the waivers the next bean writes, and the file is the only
+ * truth.
+ *
+ * A record replaces the findings of the files it checked and keeps the
+ * findings of the other files. So a finding that has been fixed goes away
+ * when the file is written again, and a finding of another file is not
+ * lost by the write.
+ */
+/** The file the findings live in. */
+export function findingsPath(stateRoot) {
+    return join(stateRoot, '.openagentsy', 'quality', 'findings.json');
+}
+/** A finding, as the file holds it. */
+const FindingSchema = z.object({
+    ruleId: z.string(),
+    source: z.string(),
+    tier: z.enum(['floor', 'reflex', 'finish']),
+    file: z.string(),
+    line: z.number(),
+    message: z.string(),
+    fix: z.string(),
+    kind: z.enum(['claim']).optional(),
+});
+/** The file, as it holds the findings. */
+const FindingsFileSchema = z.object({
+    version: z.number(),
+    tasks: z.record(z.string(), z.array(FindingSchema)),
+});
+/**
+ * A finding, as the quality package says it.
+ *
+ * The schema knows an absent kind and an undefined kind alike, and the
+ * package says the kind is there or not there, so the absent one is
+ * dropped on the way out.
+ */
+function toFinding(entry) {
+    const base = {
+        ruleId: entry.ruleId,
+        source: entry.source,
+        tier: entry.tier,
+        file: entry.file,
+        line: entry.line,
+        message: entry.message,
+        fix: entry.fix,
+    };
+    return entry.kind === undefined ? base : { ...base, kind: entry.kind };
+}
+/** The state of a project that has no findings yet. */
+function emptyState() {
+    return {};
+}
+/**
+ * The store of a project.
+ *
+ * The state root is the root of the project, and the file is under it, so
+ * two projects never read each other's findings.
+ */
+export function createFindingsStore(stateRoot) {
+    const path = findingsPath(stateRoot);
+    return {
+        record: async (taskId, files, findings) => {
+            const state = await readState(path);
+            const checked = new Set(files.map((file) => normalizePath(file)));
+            const kept = (state[taskId] ?? []).filter((finding) => !checked.has(normalizePath(finding.file)));
+            state[taskId] = [...kept, ...findings];
+            await writeState(path, state);
+        },
+        forTask: async (taskId) => (await readState(path))[taskId] ?? [],
+        openFloor: async (taskId) => ((await readState(path))[taskId] ?? []).filter((finding) => finding.tier === 'floor'),
+    };
+}
+/** What the file holds, when it holds something a store can read. */
+async function readState(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch {
+        return emptyState();
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return emptyState();
+    }
+    const result = FindingsFileSchema.safeParse(parsed);
+    if (!result.success)
+        return emptyState();
+    const tasks = {};
+    for (const [taskId, entries] of Object.entries(result.data.tasks)) {
+        tasks[taskId] = entries.map(toFinding);
+    }
+    return tasks;
+}
+/**
+ * Write the state.
+ *
+ * The write goes to a temporary file that is renamed over the old one, so
+ * a reader never sees half a file: the task store reads this file while
+ * the plugin writes it.
+ */
+async function writeState(path, state) {
+    await mkdir(dirname(path), { recursive: true });
+    const temporary = `${path}.tmp`;
+    const file = { version: 1, tasks: state };
+    await writeFile(temporary, `${JSON.stringify(file, null, 2)}\n`, 'utf8');
+    await rename(temporary, path);
+}
+//# sourceMappingURL=findings.js.map

package/dist/quality/findings.js.map

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

package/dist/quality/findings.test.d.ts

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

package/dist/quality/findings.test.d.ts.map

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

package/dist/quality/findings.test.js

@@ -0,0 +1,79 @@
+import { mkdtemp, readFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { createFindingsStore, findingsPath } from './findings.js';
+/** A state root the test writes into. */
+async function scratch() {
+    return await mkdtemp(join(tmpdir(), 'openagentsy-findings-'));
+}
+/** A finding, for the store to hold. */
+function finding(over = {}) {
+    return {
+        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',
+        ...over,
+    };
+}
+describe('the findings store', () => {
+    it('writes the findings under the state root', async () => {
+        const root = await scratch();
+        const store = createFindingsStore(root);
+        await store.record('oa-1', ['src/app.css'], [finding()]);
+        const written = await readFile(findingsPath(root), 'utf8');
+        expect(written).toContain('css/no-transition-all');
+        expect(findingsPath(root)).toBe(join(root, '.openagentsy', 'quality', 'findings.json'));
+    });
+    it('reads the findings back in a store that was made later', async () => {
+        const root = await scratch();
+        await createFindingsStore(root).record('oa-1', ['src/app.css'], [finding()]);
+        const found = await createFindingsStore(root).forTask('oa-1');
+        expect(found).toHaveLength(1);
+        expect(found[0]?.ruleId).toBe('css/no-transition-all');
+    });
+    it('keeps the findings of one task apart from the findings of another', async () => {
+        const root = await scratch();
+        const store = createFindingsStore(root);
+        await store.record('oa-1', ['src/app.css'], [finding()]);
+        await store.record('oa-2', ['src/other.css'], [finding({ file: 'src/other.css' })]);
+        expect(await store.forTask('oa-1')).toHaveLength(1);
+        expect((await store.forTask('oa-2'))[0]?.file).toBe('src/other.css');
+    });
+    it('holds the floor findings apart from the rest', async () => {
+        const root = await scratch();
+        const store = createFindingsStore(root);
+        await store.record('oa-1', ['src/app.css'], [
+            finding({ tier: 'floor' }),
+            finding({ tier: 'reflex', ruleId: 'copy/buzzwords' }),
+            finding({ tier: 'finish', ruleId: 'copy/em-dash' }),
+        ]);
+        const floor = await store.openFloor('oa-1');
+        expect(floor).toHaveLength(1);
+        expect(floor[0]?.tier).toBe('floor');
+    });
+    it('drops the findings of a file that was checked again', async () => {
+        const root = await scratch();
+        const store = createFindingsStore(root);
+        await store.record('oa-1', ['src/app.css'], [finding()]);
+        await store.record('oa-1', ['src/app.css'], []);
+        expect(await store.forTask('oa-1')).toEqual([]);
+    });
+    it('keeps the findings of the files that were not checked', async () => {
+        const root = await scratch();
+        const store = createFindingsStore(root);
+        await store.record('oa-1', ['src/app.css'], [finding()]);
+        await store.record('oa-1', ['src/other.css'], [finding({ file: 'src/other.css' })]);
+        const found = await store.forTask('oa-1');
+        expect(found.map((entry) => entry.file).sort()).toEqual(['src/app.css', 'src/other.css']);
+    });
+    it('starts empty for a project that has no findings yet', async () => {
+        const root = await scratch();
+        expect(await createFindingsStore(root).forTask('oa-1')).toEqual([]);
+    });
+});
+//# sourceMappingURL=findings.test.js.map

package/dist/quality/findings.test.js.map

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

package/dist/quality/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The quality check in the harness.
+ *
+ * The store holds the findings of the checks, and the rule runs a check
+ * after every write. The waivers are the decisions of people about those
+ * findings: a waiver a person recorded covers a finding, and a covered
+ * finding is not open.
+ *
+ * The tools are not here: they carry the whole rule set, and the whole
+ * rule set carries the TypeScript compiler. The plugin bundles this
+ * package, so the tools are reached by their own path,
+ * `@openagentsy/hooks/quality/tools`, and the board server imports them
+ * from there. The recording of a waiver is reached the same way,
+ * `@openagentsy/hooks/quality/waive`, because it asks the whole rule set
+ * whether a rule may be waived.
+ */
+export * from './findings.js';
+export * from './rule.js';
+export * from './waivers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/quality/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quality/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/quality/index.js

@@ -0,0 +1,20 @@
+/**
+ * The quality check in the harness.
+ *
+ * The store holds the findings of the checks, and the rule runs a check
+ * after every write. The waivers are the decisions of people about those
+ * findings: a waiver a person recorded covers a finding, and a covered
+ * finding is not open.
+ *
+ * The tools are not here: they carry the whole rule set, and the whole
+ * rule set carries the TypeScript compiler. The plugin bundles this
+ * package, so the tools are reached by their own path,
+ * `@openagentsy/hooks/quality/tools`, and the board server imports them
+ * from there. The recording of a waiver is reached the same way,
+ * `@openagentsy/hooks/quality/waive`, because it asks the whole rule set
+ * whether a rule may be waived.
+ */
+export * from './findings.js';
+export * from './rule.js';
+export * from './waivers.js';
+//# sourceMappingURL=index.js.map

package/dist/quality/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/quality/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/quality/rule.d.ts

@@ -0,0 +1,43 @@
+import { check } from '@openagentsy/quality/check';
+import type { Rule } from '../registry.js';
+import { type FindingsStore } from './findings.js';
+import { type WaiverLookup } from './waivers.js';
+/** When the check runs. */
+export type QualityMode = 'during' | 'after';
+/** What the rule needs to know. */
+export interface QualityRuleOptions {
+    /** The project the agent works in. */
+    workspace: string;
+    /** Where the `.openagentsy/` directory lives. */
+    stateRoot: string;
+    /** When the check runs. */
+    mode: QualityMode;
+    /** The task the findings belong to, when there is one. */
+    taskId?: string | undefined;
+    /** The task of a session, when the session has one. */
+    taskIdForSession?: (sessionID: string) => string | undefined | Promise<string | undefined>;
+    /** The design file, read as data. */
+    design?: string | undefined;
+    /** The waivers that cover a finding. */
+    waivers?: WaiverLookup;
+    /** The store the findings go into. */
+    store?: FindingsStore;
+    /** How the check runs. */
+    check?: typeof check;
+}
+/**
+ * The rule.
+ *
+ * The mode decides what the rule does: `during` runs the check after every
+ * write, and `after` does nothing here — the findings are reported by the
+ * audit command instead.
+ */
+export declare function qualityAfterWrite(options: QualityRuleOptions): Rule;
+/**
+ * The design file of a project, read as data.
+ *
+ * The file is optional, and it is never read as instructions: it can name
+ * a taste rule and turn it off, and nothing else.
+ */
+export declare function readDesignMd(workspace: string): Promise<string | undefined>;
+//# sourceMappingURL=rule.d.ts.map

package/dist/quality/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/quality/rule.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAKnD,OAAO,KAAK,EAAiB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAqBnE,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7C,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3F,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,wCAAwC;IACxC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAyBnE;AAwFD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMjF"}