@openagentsy/hooks 0.0.0-stage → 0.2.0

package/dist/quality/rule.js

@@ -0,0 +1,162 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// The narrow paths are the point. The barrel of the quality package carries
+// the comment rules, and the comment rules carry the TypeScript compiler.
+import { check } from '@openagentsy/quality/check';
+import { compilerFreeRegistry } from '@openagentsy/quality/compiler-free';
+import { formatFindings, MAX_REPORTED_FINDINGS } from '@openagentsy/quality/report';
+import { readPreToolCall } from '../event.js';
+import { createFindingsStore } from './findings.js';
+import { loadWaiverLookup } from './waivers.js';
+/**
+ * The quality check, run after a write.
+ *
+ * The rule runs the static rules on the files a call touched, records what
+ * it found, and tells the agent what to fix. It never stops the call: the
+ * plan's blocking is on the task, not on the write, and a write that has
+ * already happened cannot be stopped anyway. What it says is capped, so a
+ * check cannot flood the context of the session that wrote the file.
+ *
+ * The rules it runs are the ones that need no compiler. The comment rules
+ * need a TypeScript parse to find the comments of a file, and this rule
+ * runs on every write, so the plugin would carry the compiler and pay for
+ * a parse per write. The comment lint still runs in the `oa_quality_check`
+ * tool and in the audit command, where a parse is paid for on demand.
+ */
+/** The answer of a rule that lets the call through. */
+const CONTINUE = { continue: true };
+/**
+ * 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 function qualityAfterWrite(options) {
+    const store = options.store ?? createFindingsStore(options.stateRoot);
+    const run = options.check ?? check;
+    return {
+        id: 'quality-after-write',
+        event: 'PostToolCall',
+        block: false,
+        handler: async (event) => {
+            if (options.mode !== 'during')
+                return CONTINUE;
+            const call = readPreToolCall(event);
+            if (call === undefined)
+                return CONTINUE;
+            const paths = writtenPaths(call.files);
+            if (paths.length === 0)
+                return CONTINUE;
+            const findings = await findingsOf(run, paths, options);
+            if (findings === undefined)
+                return CONTINUE;
+            await recordOf(store, options, call.sessionID, paths, findings);
+            const open = await openFindings(findings, options);
+            if (open.length === 0)
+                return CONTINUE;
+            return {
+                transform: {
+                    appendToResult: formatFindings(open.slice(0, MAX_REPORTED_FINDINGS)),
+                },
+            };
+        },
+    };
+}
+/**
+ * The paths a call wrote.
+ *
+ * A file that was deleted is in the list as well: there is nothing to read
+ * of it, and the findings it had are moot, so the store drops them.
+ */
+function writtenPaths(files) {
+    const paths = [];
+    for (const file of files) {
+        if (file.path === undefined || file.path === '')
+            continue;
+        if (!paths.includes(file.path))
+            paths.push(file.path);
+    }
+    return paths;
+}
+/**
+ * The findings of the check, when the check ran.
+ *
+ * A rule that throws is a bug in the rule, and the rules have their own
+ * tests. The write has already happened, so a broken check must not turn it
+ * into an error: the failure is dropped and the agent sees nothing.
+ */
+async function findingsOf(run, paths, options) {
+    try {
+        const design = options.design ?? (await readDesignMd(options.workspace));
+        const ctx = design === undefined ? {} : { design };
+        return await run(paths, ctx, { root: options.workspace, registry: compilerFreeRegistry });
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The findings that are open: not taste, and not waived.
+ *
+ * The waivers are read when there is something to filter: a call that found
+ * nothing does not read the decisions of the project. A waiver a person
+ * recorded covers a finding, and a covered finding is not open.
+ */
+async function openFindings(findings, options) {
+    if (findings.length === 0)
+        return [];
+    const waivers = options.waivers ?? (await loadWaiverLookup(options.stateRoot));
+    return findings.filter((finding) => finding.tier !== 'finish' && !waivers.covers(finding));
+}
+/**
+ * Record the findings, when there is a task to record them for.
+ *
+ * A session with no task records nothing: there is no task to complete, so
+ * there is nothing for the findings to stop. An unwritable state root must
+ * not fail the write either.
+ */
+async function recordOf(store, options, sessionID, paths, findings) {
+    const taskId = await taskIdOf(options, sessionID);
+    if (taskId === undefined)
+        return false;
+    try {
+        await store.record(taskId, paths, findings);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** The task of a session, when there is one. */
+async function taskIdOf(options, sessionID) {
+    if (options.taskId !== undefined)
+        return options.taskId;
+    if (options.taskIdForSession === undefined || sessionID === undefined)
+        return undefined;
+    return await options.taskIdForSession(sessionID);
+}
+/**
+ * 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 async function readDesignMd(workspace) {
+    for (const name of ['DESIGN.md', 'design.md']) {
+        const text = await readDesign(join(workspace, name));
+        if (text !== undefined)
+            return text;
+    }
+    return undefined;
+}
+/** The text of a file, when it can be read. */
+async function readDesign(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=rule.js.map

package/dist/quality/rule.js.map

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

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

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

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

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

package/dist/quality/rule.test.js

@@ -0,0 +1,187 @@
+import { mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { createFindingsStore } from './findings.js';
+import { qualityAfterWrite } from './rule.js';
+import { createWaiverStore } from './waivers.js';
+/** A workspace the test writes into. */
+async function scratch() {
+    return await mkdtemp(join(tmpdir(), 'openagentsy-quality-rule-'));
+}
+/** A finding, for the check to report. */
+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,
+    };
+}
+/** The event a write arrives as. */
+function written(files) {
+    return {
+        toolName: 'apply_patch',
+        args: { patchText: '' },
+        files: files.map((path) => ({ path })),
+        sessionID: 'ses-1',
+    };
+}
+/** The text the rule appended to the result. */
+function appended(result) {
+    if (typeof result !== 'object' || result === null)
+        return undefined;
+    const transform = result.transform;
+    if (typeof transform !== 'object' || transform === null)
+        return undefined;
+    const text = transform.appendToResult;
+    return typeof text === 'string' ? text : undefined;
+}
+describe('the quality rule', () => {
+    it('checks the files the patch touched and not the others', async () => {
+        const root = await scratch();
+        await writeFile(join(root, 'app.css'), '.a { transition: all 0.2s; }\n', 'utf8');
+        await writeFile(join(root, 'other.css'), '.b { transition: all 0.2s; }\n', 'utf8');
+        const rule = qualityAfterWrite({ workspace: root, stateRoot: root, mode: 'during' });
+        const result = await rule.handler(written(['app.css']));
+        const text = appended(result) ?? '';
+        expect(text).toContain('app.css');
+        expect(text).not.toContain('other.css');
+    });
+    it('runs the rules that need no compiler, and not the comment rules', async () => {
+        const root = await scratch();
+        await writeFile(join(root, 'app.css'), '.a { transition: all 0.2s; }\n', 'utf8');
+        await writeFile(join(root, 'app.ts'), '// Step 1: trim the input\nexport const a = 1;\n', 'utf8');
+        const rule = qualityAfterWrite({ workspace: root, stateRoot: root, mode: 'during' });
+        const result = await rule.handler(written(['app.css', 'app.ts']));
+        const text = appended(result) ?? '';
+        expect(text).toContain('css/no-transition-all');
+        expect(text).not.toContain('comment/');
+    });
+    it('shows the agent at most eight lines', async () => {
+        const root = await scratch();
+        const many = Array.from({ length: 12 }, (_unused, index) => finding({ line: index + 1 }));
+        const rule = qualityAfterWrite({
+            workspace: root,
+            stateRoot: root,
+            mode: 'during',
+            check: async () => many,
+        });
+        const result = await rule.handler(written(['src/app.css']));
+        expect((appended(result) ?? '').split('\n')).toHaveLength(8);
+    });
+    it('says nothing about a taste finding', async () => {
+        const root = await scratch();
+        const rule = qualityAfterWrite({
+            workspace: root,
+            stateRoot: root,
+            mode: 'during',
+            check: async () => [finding({ tier: 'finish', ruleId: 'copy/em-dash' })],
+        });
+        const result = await rule.handler(written(['src/app.css']));
+        expect(result).toEqual({ continue: true });
+    });
+    it('says nothing about a finding a waiver covers', async () => {
+        const root = await scratch();
+        await createWaiverStore(root).add({
+            ruleId: 'css/no-transition-all',
+            path: 'src/app.css',
+            reason: 'The file is a fixture, not a page.',
+            decidedBy: 'human',
+            ts: '2026-10-27T10:00:00.000Z',
+        });
+        const rule = qualityAfterWrite({
+            workspace: root,
+            stateRoot: root,
+            mode: 'during',
+            check: async () => [finding()],
+        });
+        const result = await rule.handler(written(['src/app.css']));
+        expect(result).toEqual({ continue: true });
+    });
+    it('still says something about a finding no waiver covers', async () => {
+        const root = await scratch();
+        await createWaiverStore(root).add({
+            ruleId: 'css/no-transition-all',
+            path: 'src/other.css',
+            reason: 'The file is a fixture, not a page.',
+            decidedBy: 'human',
+            ts: '2026-10-27T10:00:00.000Z',
+        });
+        const rule = qualityAfterWrite({
+            workspace: root,
+            stateRoot: root,
+            mode: 'during',
+            check: async () => [finding()],
+        });
+        const result = await rule.handler(written(['src/app.css']));
+        expect(appended(result) ?? '').toContain('css/no-transition-all');
+    });
+    it('records a floor finding for the task of the session', async () => {
+        const root = await scratch();
+        const store = createFindingsStore(root);
+        const rule = qualityAfterWrite({
+            workspace: root,
+            stateRoot: root,
+            mode: 'during',
+            store,
+            taskIdForSession: () => 'oa-1',
+            check: async () => [finding({ tier: 'floor', ruleId: 'copy/unsourced-claim' })],
+        });
+        await rule.handler(written(['src/app.css']));
+        const floor = await store.openFloor('oa-1');
+        expect(floor).toHaveLength(1);
+        expect(floor[0]?.ruleId).toBe('copy/unsourced-claim');
+    });
+    it('records nothing when the session has no task', async () => {
+        const root = await scratch();
+        const store = createFindingsStore(root);
+        const rule = qualityAfterWrite({
+            workspace: root,
+            stateRoot: root,
+            mode: 'during',
+            store,
+            check: async () => [finding({ tier: 'floor' })],
+        });
+        await rule.handler(written(['src/app.css']));
+        expect(await store.forTask('oa-1')).toEqual([]);
+    });
+    it('does nothing in the after mode', async () => {
+        const root = await scratch();
+        const store = createFindingsStore(root);
+        const rule = qualityAfterWrite({
+            workspace: root,
+            stateRoot: root,
+            mode: 'after',
+            store,
+            taskId: 'oa-1',
+            check: async () => [finding({ tier: 'floor' })],
+        });
+        const result = await rule.handler(written(['src/app.css']));
+        expect(result).toEqual({ continue: true });
+        expect(await store.forTask('oa-1')).toEqual([]);
+    });
+    it('does not fail the write when the check throws', async () => {
+        const root = await scratch();
+        const rule = qualityAfterWrite({
+            workspace: root,
+            stateRoot: root,
+            mode: 'during',
+            check: async () => {
+                throw new Error('the rule is broken');
+            },
+        });
+        const result = await rule.handler(written(['src/app.css']));
+        expect(result).toEqual({ continue: true });
+    });
+    it('lets a call that touched no file through', async () => {
+        const root = await scratch();
+        const rule = qualityAfterWrite({ workspace: root, stateRoot: root, mode: 'during' });
+        expect(await rule.handler(written([]))).toEqual({ continue: true });
+    });
+});
+//# sourceMappingURL=rule.test.js.map

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

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

package/dist/quality/tools.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+/**
+ * The tools a session reads the findings with.
+ *
+ * The rule shows the agent eight lines, so that a check cannot flood the
+ * context of the session that wrote the file. The tool returns all of
+ * them: the cap is for the context, not for the answer.
+ *
+ * The tool runs every rule, the comment rules included. A call to the tool
+ * is a call a session made on purpose, and the comment rules need a
+ * TypeScript parse to find the comments of a file. The parse is paid for
+ * on demand here, and it is not paid at all on the write path.
+ */
+/** A tool, in the shape the server registers it in. */
+export interface QualityTool {
+    /** What the tool does, for the model that may call it. */
+    description: string;
+    /** The arguments the tool takes. */
+    args: z.ZodType;
+    /** What the tool answers. */
+    execute(args: unknown, context: {
+        sessionID: string;
+        agent: string;
+    }): Promise<unknown>;
+}
+/** The quality tools, bound to a project. */
+export declare function qualityTools(options: {
+    workspace: string;
+}): Record<string, QualityTool>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/quality/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;GAWG;AAEH,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC;IAChB,6BAA6B;IAC7B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAmBxF"}

package/dist/quality/tools.js

@@ -0,0 +1,33 @@
+import { allRegistry, check } from '@openagentsy/quality';
+import { z } from 'zod';
+import { readDesignMd } from './rule.js';
+/** The quality tools, bound to a project. */
+export function qualityTools(options) {
+    return {
+        oa_quality_check: {
+            description: 'Check files for the quality rules and return every finding. The paths are relative to the project root.',
+            args: z.object({
+                paths: z.array(z.string().min(1)).default([]),
+            }),
+            execute: async (args) => {
+                const design = await readDesignMd(options.workspace);
+                const ctx = design === undefined ? {} : { design };
+                const findings = await check(pathsOf(args), ctx, {
+                    root: options.workspace,
+                    registry: allRegistry,
+                });
+                return { findings };
+            },
+        },
+    };
+}
+/** The paths the call named. */
+function pathsOf(args) {
+    if (typeof args !== 'object' || args === null)
+        return [];
+    const paths = args.paths;
+    if (!Array.isArray(paths))
+        return [];
+    return paths.filter((path) => typeof path === 'string' && path !== '');
+}
+//# sourceMappingURL=tools.js.map

package/dist/quality/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/quality/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAgB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAyBzC,6CAA6C;AAC7C,MAAM,UAAU,YAAY,CAAC,OAA8B;IACzD,OAAO;QACL,gBAAgB,EAAE;YAChB,WAAW,EACT,yGAAyG;YAC3G,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBACb,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;aAC9C,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAA+B,EAAE;gBACnD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrD,MAAM,GAAG,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;gBACnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE;oBAC/C,IAAI,EAAE,OAAO,CAAC,SAAS;oBACvB,QAAQ,EAAE,WAAW;iBACtB,CAAC,CAAC;gBACH,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,gCAAgC;AAChC,SAAS,OAAO,CAAC,IAAa;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACzD,MAAM,KAAK,GAAI,IAA4B,CAAC,KAAK,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC"}

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

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

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

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

package/dist/quality/tools.test.js

@@ -0,0 +1,41 @@
+import { mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { qualityTools } from './tools.js';
+/** A workspace the test writes into. */
+async function scratch() {
+    return await mkdtemp(join(tmpdir(), 'openagentsy-quality-tools-'));
+}
+/** The findings of an answer of the tool. */
+function findingsOf(result) {
+    if (typeof result !== 'object' || result === null)
+        return [];
+    const list = result.findings;
+    return Array.isArray(list) ? list : [];
+}
+describe('the quality tool', () => {
+    it('returns the findings of every rule, the comment rules included', async () => {
+        const root = await scratch();
+        await writeFile(join(root, 'app.ts'), '// Step 1: trim the input\nexport const a = 1;\n', 'utf8');
+        const tools = qualityTools({ workspace: root });
+        const tool = tools.oa_quality_check;
+        if (tool === undefined)
+            throw new Error('the quality tool is missing');
+        const result = await tool.execute({ paths: ['app.ts'] }, { sessionID: 'ses-1', agent: 'oa-builder' });
+        const findings = findingsOf(result);
+        expect(findings.some((finding) => finding.ruleId === 'comment/step-narration')).toBe(true);
+    });
+    it('returns the findings of the rules that need no compiler as well', async () => {
+        const root = await scratch();
+        await writeFile(join(root, 'app.css'), '.a { transition: all 0.2s; }\n', 'utf8');
+        const tools = qualityTools({ workspace: root });
+        const tool = tools.oa_quality_check;
+        if (tool === undefined)
+            throw new Error('the quality tool is missing');
+        const result = await tool.execute({ paths: ['app.css'] }, { sessionID: 'ses-1', agent: 'oa-builder' });
+        const findings = findingsOf(result);
+        expect(findings.some((finding) => finding.ruleId === 'css/no-transition-all')).toBe(true);
+    });
+});
+//# sourceMappingURL=tools.test.js.map

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

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

package/dist/quality/waive.d.ts

@@ -0,0 +1,37 @@
+import { type Waiver } from './waivers.js';
+/**
+ * The recording of a waiver.
+ *
+ * A person records a waiver; an agent may only propose one. The command a
+ * person runs and the tool the server registers both call this function, so
+ * the decision has one implementation and one audit trail.
+ *
+ * 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/waive`.
+ */
+/** What a person decides. */
+export interface WaiveInput {
+    /** Where the waivers live. */
+    stateRoot: string;
+    /** The rule the waiver is for. */
+    ruleId: string;
+    /** The path the waiver covers. */
+    path: string;
+    /** Why. Ten characters at least. */
+    reason: string;
+    /** Who decided. A person, never an agent. */
+    decidedBy: string;
+    /** When the decision was made. */
+    ts?: string | undefined;
+}
+/**
+ * Record a waiver.
+ *
+ * A rule that cannot be waived is refused: a floor rule is honesty, function
+ * or accessibility, and the registry refuses a waivable floor rule at load.
+ * A reason that is too short is refused too, because a waiver without a
+ * reason is a decision nobody can check.
+ */
+export declare function waive(input: WaiveInput): Promise<Waiver>;
+//# sourceMappingURL=waive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"waive.d.ts","sourceRoot":"","sources":["../../src/quality/waive.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,MAAM,EAAgB,MAAM,cAAc,CAAC;AAE5E;;;;;;;;;;GAUG;AAEH,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB9D"}

package/dist/quality/waive.js

@@ -0,0 +1,39 @@
+import { allRegistry } from '@openagentsy/quality';
+import { createWaiverStore, WaiverSchema } from './waivers.js';
+/**
+ * Record a waiver.
+ *
+ * A rule that cannot be waived is refused: a floor rule is honesty, function
+ * or accessibility, and the registry refuses a waivable floor rule at load.
+ * A reason that is too short is refused too, because a waiver without a
+ * reason is a decision nobody can check.
+ */
+export async function waive(input) {
+    const rule = allRegistry.rules().find((candidate) => candidate.id === input.ruleId);
+    if (rule === undefined) {
+        throw new Error(`no rule is named ${input.ruleId}`);
+    }
+    if (!rule.waivable) {
+        throw new Error(`the rule ${input.ruleId} cannot be waived`);
+    }
+    if (input.reason.trim().length < 10) {
+        throw new Error('a waiver needs a reason of ten characters at least');
+    }
+    const waiver = WaiverSchema.safeParse({
+        ruleId: input.ruleId,
+        path: input.path,
+        reason: input.reason,
+        decidedBy: input.decidedBy,
+        ts: input.ts ?? new Date().toISOString(),
+    });
+    if (!waiver.success) {
+        throw new Error(`the waiver is not valid: ${issuesOf(waiver.error)}`);
+    }
+    await createWaiverStore(input.stateRoot).add(waiver.data);
+    return waiver.data;
+}
+/** What is wrong with a waiver, in one line. */
+function issuesOf(error) {
+    return error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('; ');
+}
+//# sourceMappingURL=waive.js.map

package/dist/quality/waive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waive.js","sourceRoot":"","sources":["../../src/quality/waive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAe,YAAY,EAAE,MAAM,cAAc,CAAC;AA8B5E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAiB;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;IACpF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,MAAM,mBAAmB,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;QACpC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACzC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,gDAAgD;AAChD,SAAS,QAAQ,CAAC,KAAsE;IACtF,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7F,CAAC"}