agent-bober 0.17.1 → 0.19.0

package/dist/seo/builder/approved-finding.js

@@ -0,0 +1,145 @@
+/**
+ * ApprovedFinding — the structural safety boundary between the hub and the
+ * Sprint-12 `SeoBuilder` (spec-20260717-seo-improver-builder, Sprint 11;
+ * ADR-4, `.bober/architecture/arch-20260716-seo-improver-builder-extension-adr-4.md`).
+ *
+ * Constructible ONLY via `ApprovedFinding.from(...)` — the sole factory,
+ * itself never throwing — which asserts the hub Finding is human-approved
+ * AND carries a well-formed `cite:` evidence URL before minting an instance.
+ * A raw/dropped/downgraded/uncited `SeoFinding` has NO public path into this
+ * type: a dropped finding never reached the hub as an approved action, so no
+ * `ApprovedFinding` can exist for it (resurrection structurally impossible,
+ * sc-11-1/sc-11-2).
+ *
+ * Schema-vs-contract reconciliation (see the Sprint-11 briefing §0): the
+ * canonical hub `FindingSchema.status` (`../hub/finding.js:23`) is
+ * `z.enum(["open","in-progress","snoozed","done","dropped"])` — there is NO
+ * `"approved"` status, so `finding.status === "approved"` against a raw
+ * `Finding` is a TS2367 compile error. Mirroring the do-bridge port-local
+ * pattern (`../do-bridge/finding-port.ts:10-19`, "the hub schema is NOT
+ * modified"), `ApprovedHubFindingSchema` below WIDENS the status union
+ * locally — `../hub/finding.ts` stays byte-identical. Likewise `Finding` has
+ * no top-level `citationUrl`; the SEO citation round-trips inside
+ * `evidence[]` as a `cite:<url>` string (encoded at
+ * `../hub-emitter.ts:76`, decode precedent at `../benchmark/harness.ts:112-121`)
+ * — `extractCitationUrl` below decodes exactly what the emitter encoded.
+ */
+import { z } from "zod";
+import { FindingSchema } from "../../hub/finding.js";
+// -- Widened hub Finding view (port-local; ../../hub/finding.ts untouched) --
+/**
+ * Builder-local widened view of the hub `Finding` shape — adds `"approved"`
+ * to the status union WITHOUT mutating the canonical `FindingSchema`
+ * (mirrors `../../do-bridge/finding-port.ts:10-19`). Every other field is
+ * reused verbatim via `.extend()`.
+ */
+export const ApprovedHubFindingSchema = FindingSchema.extend({
+    status: z.enum(["open", "in-progress", "snoozed", "done", "dropped", "approved"]),
+});
+// -- Local single-purpose URL check (no shared util exists in src) --------
+/**
+ * A citationUrl is well-formed when it is a non-empty, non-whitespace string
+ * that parses as an absolute http(s) URL. Mirrors `../citation-gate.ts:34-42`
+ * (`isWellFormedCitationUrl`) — no shared URL-validation util exists in
+ * `src`; this is a local copy per that file's own precedent comment.
+ */
+function isWellFormedCitationUrl(url) {
+    if (typeof url !== "string" || url.trim().length === 0)
+        return false;
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === "http:" || parsed.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+// -- cite:/tag extraction (decodes exactly what hub-emitter.ts encoded) ----
+/**
+ * Extract `sourceCitationUrl` from the `evidence[]` entry that starts with
+ * `cite:` (mirrors `../benchmark/harness.ts:112-121`, `lacksWellFormedCitation`).
+ * Returns `null` — never throws — when the entry is absent or the URL is
+ * malformed. NEVER invents a URL.
+ */
+function extractCitationUrl(finding) {
+    const citeEntry = finding.evidence.find((e) => e.startsWith("cite:"));
+    if (citeEntry === undefined)
+        return null;
+    const url = citeEntry.slice("cite:".length);
+    return isWellFormedCitationUrl(url) ? url : null;
+}
+/**
+ * Extract the first `tags[]` entry starting with `prefix`, minus the prefix.
+ * Mirrors `../benchmark/harness.ts:106-108` (`extractPlaybookRef`). SEO
+ * findings carry `tags: ["seo","workflow:<w>","playbook:<ref>","confidence:<c>"]`
+ * (`../hub-emitter.ts:79-84`).
+ */
+function extractTag(finding, prefix) {
+    const tag = finding.tags.find((t) => t.startsWith(prefix));
+    return tag !== undefined ? tag.slice(prefix.length) : undefined;
+}
+// -- ApprovedFinding --------------------------------------------------------
+/**
+ * A hub Finding a human has approved, carrying a decoded, well-formed
+ * citation. The private constructor + private brand field together make
+ * this type NOMINAL: a structurally-similar plain object (e.g. a raw
+ * `SeoFinding` literal) is never assignable, and `new ApprovedFinding(...)`
+ * is unreachable outside this module. `ApprovedFinding.from` is the ONLY
+ * public construction path.
+ */
+export class ApprovedFinding {
+    sourceFindingId;
+    title;
+    sourceCitationUrl;
+    severity;
+    playbookRef;
+    workflow;
+    // Private INSTANCE field => TS compares this class nominally. A plain
+    // object literal (e.g. a raw SeoFinding) can NEVER satisfy this private
+    // member, so it can never be assigned to ApprovedFinding (sc-11-1/sc-11-2,
+    // compile-proof — see approved-finding.test.ts).
+    __brand = "ApprovedFinding";
+    constructor(
+    /** The hub Finding id this instance was derived from (provenance). */
+    sourceFindingId, title, 
+    /** Extracted from the `cite:` evidence entry — never invented. */
+    sourceCitationUrl, severity, 
+    /** From the `playbook:` tag; empty string if the tag is absent. */
+    playbookRef, 
+    /** From the `workflow:` tag; empty string if the tag is absent. */
+    workflow) {
+        this.sourceFindingId = sourceFindingId;
+        this.title = title;
+        this.sourceCitationUrl = sourceCitationUrl;
+        this.severity = severity;
+        this.playbookRef = playbookRef;
+        this.workflow = workflow;
+    }
+    /** Debug representation; also reads `__brand` so it is not flagged unused under `noUnusedLocals`. */
+    toString() {
+        return `${this.__brand}(${this.sourceFindingId})`;
+    }
+    /**
+     * The ONLY way to build an `ApprovedFinding`. Returns `null` — NEVER
+     * throws — when `finding.status !== "approved"` or the `cite:` evidence
+     * entry is missing/malformed. This is the single gate ADR-4's Risk
+     * section calls out: "if the adapter itself trusts an un-approved
+     * Finding, the guarantee leaks" — so both checks happen here, in the one
+     * place an `ApprovedFinding` can be minted.
+     */
+    static from(finding) {
+        if (finding.status !== "approved")
+            return null;
+        const citationUrl = extractCitationUrl(finding);
+        if (citationUrl === null)
+            return null;
+        // bober: playbookRef/workflow default to "" when the tag is absent
+        // rather than gating construction on them — ADR-4's Risk section only
+        // requires status===approved + a well-formed citation; these tags are
+        // enrichment provenance for Sprint-12, not part of the safety gate.
+        const playbookRef = extractTag(finding, "playbook:") ?? "";
+        const workflow = extractTag(finding, "workflow:") ?? "";
+        return new ApprovedFinding(finding.id, finding.title, citationUrl, finding.severity, playbookRef, workflow);
+    }
+}
+//# sourceMappingURL=approved-finding.js.map

package/dist/seo/builder/approved-finding.js.map

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

package/dist/seo/builder/build-runner.d.ts

@@ -0,0 +1,41 @@
+import type { BoberConfig } from "../../config/schema.js";
+import { SeoReportStore } from "../report-store.js";
+import type { SeoFindingSink } from "../hub-emitter.js";
+import { SeoBuilder } from "./seo-builder.js";
+import type { ApprovedFinding } from "./approved-finding.js";
+import type { SeoDraft } from "./draft-types.js";
+import { SeoDraftStore } from "./draft-store.js";
+export type SeoBuildRunInput = {
+    projectRoot: string;
+    config: BoberConfig;
+    reportId: string;
+    /** ISO timestamp, stamped ONCE by the `seo build` CLI action. */
+    now: string;
+    /** Default = `new SeoReportStore()`. */
+    reportStore?: SeoReportStore;
+    /** Default = `new SeoDraftStore()`. */
+    draftStore?: SeoDraftStore;
+    /** Default = `new SeoBuilder(new NeverEncodeFilter())`. */
+    builder?: SeoBuilder;
+    /** Default = open a real `FactStore` + `readApprovedSeoFindings`. */
+    readApproved?: (projectRoot: string) => Promise<ApprovedFinding[]>;
+    /** Default binds `ingestFinding` to a real `FactStore`. */
+    findingSink?: SeoFindingSink;
+};
+export type SeoBuildRunOutcome = {
+    drafts?: SeoDraft[];
+    skipped?: number;
+    exitCode: 0 | 2;
+};
+export declare class SeoBuildRunner {
+    /**
+     * Run one `seo build <reportId>` invocation end-to-end. NEVER throws:
+     * every fallible step (report read, approved-findings read, build,
+     * persist) is wrapped in one top-level try/catch -> `exitCode: 2`. An
+     * unknown reportId or a report with no approved findings is a CLEAN
+     * `exitCode: 0` with an informational stdout message and ZERO hub emits
+     * (sc-13-4) — `2` is reserved for a caught unexpected error.
+     */
+    run(input: SeoBuildRunInput): Promise<SeoBuildRunOutcome>;
+}
+//# sourceMappingURL=build-runner.d.ts.map

package/dist/seo/builder/build-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-runner.d.ts","sourceRoot":"","sources":["../../../src/seo/builder/build-runner.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IAEZ,wCAAwC;IACxC,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,uCAAuC;IACvC,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,qEAAqE;IACrE,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnE,2DAA2D;IAC3D,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB,CAAC;AA+FF,qBAAa,cAAc;IACzB;;;;;;;OAOG;IACG,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA8ChE"}

package/dist/seo/builder/build-runner.js

@@ -0,0 +1,156 @@
+/**
+ * SeoBuildRunner — drives reportId -> approved hub findings -> SeoBuilder.build
+ * -> SeoDraftStore persist -> best-effort hub 'action' emission
+ * (spec-20260717-seo-improver-builder, Sprint 13). NEVER throws; exit 0/2.
+ * `now` is caller-injected (never re-stamped here) — mirrors
+ * `SeoWorkflowRunner.run` (`../runner.ts`) fail-closed/never-throw discipline
+ * and `emitFindingsToHub`'s best-effort hub-emit pattern.
+ *
+ * reportId -> approved-findings linkage (no stored reportId link exists on
+ * hub findings, sprint briefing §5): the report is read FIRST (supplies
+ * `report.target`, required by `SeoBuilder.build`, and detects an unknown
+ * reportId), then approved SEO findings are narrowed to
+ * `af.workflow === report.workflow` — the only available linkage.
+ */
+import { createHash } from "node:crypto";
+import { FactStore, factsDbPath, ensureFactsDir } from "../../state/facts.js";
+import { ingestFinding } from "../../hub/finding-store.js";
+import { logger } from "../../utils/logger.js";
+import { SeoReportStore } from "../report-store.js";
+import { NeverEncodeFilter } from "../never-encode-filter.js";
+import { SeoBuilder } from "./seo-builder.js";
+import { readApprovedSeoFindings } from "./hub-approved-source.js";
+import { SeoDraftStore } from "./draft-store.js";
+// ── Defaults ─────────────────────────────────────────────────────────
+/** Opens a real `FactStore` (closed in `finally`) to read approved SEO findings. */
+async function defaultReadApproved(projectRoot) {
+    await ensureFactsDir(projectRoot);
+    const store = new FactStore(factsDbPath(projectRoot));
+    try {
+        return readApprovedSeoFindings(store);
+    }
+    finally {
+        store.close();
+    }
+}
+/**
+ * Map a `SeoDraft` -> hub `Finding` (kind ALWAYS `"action"` — every
+ * `SeoDraft` carries `humanApprovalRequired: true`, the type literal,
+ * `draft-types.ts:29`). Mirrors `SeoHubEmitter`'s title/id/evidence
+ * conventions (`../hub-emitter.ts:54-90`) but maps `SeoDraft`, not
+ * `SeoFinding` — there is no existing draft->Finding mapper to reuse.
+ *
+ * bober: `SeoDraft` carries no severity/urgency of its own (it is
+ * decoupled from the source finding by `SeoBuilder.build`) — default both
+ * to `3` (mid-scale) rather than inventing a provenance link back to the
+ * approved finding's severity. Revisit if a future sprint threads
+ * `ApprovedFinding.severity` through `SeoBuildResult`.
+ */
+function draftToFinding(draft, now) {
+    const title = `[seo] draft ${draft.kind}: ${draft.artifact.slice(0, 80)}`;
+    const kind = "action";
+    return {
+        id: deriveDraftFindingId(title, kind),
+        domain: "seo",
+        title,
+        kind,
+        urgency: 3,
+        severity: 3,
+        evidence: [draft.artifact, `cite:${draft.sourceCitationUrl}`],
+        surfacedAt: now,
+        tags: ["seo", `playbook:${draft.playbookRef}`, `draft-kind:${draft.kind}`, "seo-draft"],
+        status: "open",
+    };
+}
+/** Content-stable id: hash of domain|title|kind (mirrors `../hub-emitter.ts:32-34`). */
+function deriveDraftFindingId(title, kind) {
+    return createHash("sha256").update(`seo|${title}|${kind}`).digest("hex").slice(0, 16);
+}
+/**
+ * Best-effort emit each draft as a hub 'action' Finding. NEVER throws and
+ * NEVER changes the caller's exit code — mirrors `emitFindingsToHub`
+ * (`../runner.ts:391-421`). Checks emptiness BEFORE opening a store so a
+ * fully-skipped build never touches the hub (sprint briefing Pitfall 8).
+ */
+async function emitDraftsToHub(drafts, projectRoot, now, findingSink) {
+    if (drafts.length === 0)
+        return;
+    const findings = drafts.map((d) => draftToFinding(d, now));
+    if (findingSink !== undefined) {
+        try {
+            for (const finding of findings) {
+                await findingSink(finding);
+            }
+        }
+        catch (err) {
+            logger.warn(`SEO draft hub emission failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return;
+    }
+    let store;
+    try {
+        await ensureFactsDir(projectRoot);
+        const opened = new FactStore(factsDbPath(projectRoot));
+        store = opened;
+        for (const finding of findings) {
+            await ingestFinding(opened, finding, { now });
+        }
+    }
+    catch (err) {
+        logger.warn(`SEO draft hub emission failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        store?.close();
+    }
+}
+// ── SeoBuildRunner ───────────────────────────────────────────────────
+export class SeoBuildRunner {
+    /**
+     * Run one `seo build <reportId>` invocation end-to-end. NEVER throws:
+     * every fallible step (report read, approved-findings read, build,
+     * persist) is wrapped in one top-level try/catch -> `exitCode: 2`. An
+     * unknown reportId or a report with no approved findings is a CLEAN
+     * `exitCode: 0` with an informational stdout message and ZERO hub emits
+     * (sc-13-4) — `2` is reserved for a caught unexpected error.
+     */
+    async run(input) {
+        try {
+            const report = await (input.reportStore ?? new SeoReportStore()).read(input.projectRoot, input.reportId);
+            if (report === null) {
+                process.stdout.write(`seo build: no report found for id "${input.reportId}"\n`);
+                return { exitCode: 0 };
+            }
+            const approvedAll = await (input.readApproved ?? defaultReadApproved)(input.projectRoot);
+            // Narrow to the report's workflow — the only available reportId->
+            // approved-findings linkage (sprint briefing §5).
+            const approved = approvedAll.filter((a) => a.workflow === report.workflow);
+            if (approved.length === 0) {
+                process.stdout.write(`seo build: report "${input.reportId}" has no approved findings\n`);
+                return { exitCode: 0 };
+            }
+            const builder = input.builder ?? new SeoBuilder(new NeverEncodeFilter());
+            const { drafts, skipped } = builder.build({
+                approvedFindings: approved,
+                target: report.target,
+                config: input.config,
+                now: input.now,
+            });
+            const bundle = {
+                reportId: report.reportId,
+                target: report.target,
+                generatedAt: input.now,
+                drafts,
+                skipped,
+            };
+            await (input.draftStore ?? new SeoDraftStore()).save(input.projectRoot, bundle);
+            // Best-effort AFTER persist — a hub failure never changes the exit code.
+            await emitDraftsToHub(drafts, input.projectRoot, input.now, input.findingSink);
+            return { drafts, skipped, exitCode: 0 };
+        }
+        catch {
+            // Unexpected throw (report/approved-findings read, build, or persist) -> fail-closed.
+            return { exitCode: 2 };
+        }
+    }
+}
+//# sourceMappingURL=build-runner.js.map

package/dist/seo/builder/build-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-runner.js","sourceRoot":"","sources":["../../../src/seo/builder/build-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA8BjD,wEAAwE;AAExE,oFAAoF;AACpF,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IACpD,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,cAAc,CAAC,KAAe,EAAE,GAAW;IAClD,MAAM,KAAK,GAAG,eAAe,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1E,MAAM,IAAI,GAAoB,QAAQ,CAAC;IAEvC,OAAO;QACL,EAAE,EAAE,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC;QACrC,MAAM,EAAE,KAAK;QACb,KAAK;QACL,IAAI;QACJ,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC7D,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,CAAC,WAAW,EAAE,EAAE,cAAc,KAAK,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC;QACvF,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,SAAS,oBAAoB,CAAC,KAAa,EAAE,IAAY;IACvD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxF,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAC5B,MAAkB,EAClB,WAAmB,EACnB,GAAW,EACX,WAAuC;IAEvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEhC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAE3D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,KAA4B,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;QACvD,KAAK,GAAG,MAAM,CAAC;QACf,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpG,CAAC;YAAS,CAAC;QACT,KAAK,EAAE,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED,wEAAwE;AAExE,MAAM,OAAO,cAAc;IACzB;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,CAAC,KAAuB;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,cAAc,EAAE,CAAC,CAAC,IAAI,CACnE,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,QAAQ,CACf,CAAC;YACF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC;gBAChF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACzB,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,mBAAmB,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACzF,kEAAkE;YAClE,kDAAkD;YAClD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,KAAK,CAAC,QAAQ,8BAA8B,CAAC,CAAC;gBACzF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACzB,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,UAAU,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;YACzE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;gBACxC,gBAAgB,EAAE,QAAQ;gBAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,EAAE,KAAK,CAAC,GAAG;aACf,CAAC,CAAC;YAEH,MAAM,MAAM,GAAmB;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,WAAW,EAAE,KAAK,CAAC,GAAG;gBACtB,MAAM;gBACN,OAAO;aACR,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAEhF,yEAAyE;YACzE,MAAM,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YAE/E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,sFAAsF;YACtF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/seo/builder/draft-generators.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Deterministic draft-artifact templates (spec-20260717-seo-improver-builder,
+ * Sprint 12; ADR-4). Network-free by construction — no LLM, no `fetch`.
+ * Every template is pure: no clock, no `Math.random`, no I/O. Each template
+ * echoes the `ApprovedFinding.title` verbatim into the produced artifact text
+ * so a banned-implying finding yields a banned-implying draft the Sprint-12
+ * `SeoBuilder`'s re-filter can catch and drop (sc-12-4).
+ *
+ * The generators map is injected into `SeoBuilder`'s constructor (optional,
+ * defaulting to `DEFAULT_DRAFT_GENERATORS`) so a test can substitute a
+ * generator that forces a banned artifact without touching real templates —
+ * mirrors how `runner.ts` injects `analyzer`/`dataSource`/`findingSink`.
+ */
+import type { ApprovedFinding } from "./approved-finding.js";
+import type { SeoDraftKind } from "./draft-types.js";
+/** Turns one `ApprovedFinding` + `target` into the proposed artifact TEXT. */
+export type DraftGenerator = (finding: ApprovedFinding, target: string) => string;
+/**
+ * One deterministic template per `SeoDraftKind`. Each MUST echo
+ * `finding.title` into the artifact text — this is what lets the
+ * `SeoBuilder`'s re-filter (`../never-encode-filter.js`) catch a banned
+ * tactic implied by the approved finding's own title (sc-12-4).
+ */
+export declare const DEFAULT_DRAFT_GENERATORS: Record<SeoDraftKind, DraftGenerator>;
+/**
+ * Deterministically selects the `SeoDraftKind` for an `ApprovedFinding` from
+ * its `playbookRef` prefix (`../hub-emitter.ts` encodes `playbook:<ref>` per
+ * finding). Falls back to `"title-meta"` — the most generic, broadly
+ * applicable draft kind — when no prefix matches. Pure; never throws.
+ */
+export declare function kindForApprovedFinding(finding: ApprovedFinding): SeoDraftKind;
+//# sourceMappingURL=draft-generators.d.ts.map

package/dist/seo/builder/draft-generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-generators.d.ts","sourceRoot":"","sources":["../../../src/seo/builder/draft-generators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIrD,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAIlF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CAMzE,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,CAG7E"}

package/dist/seo/builder/draft-generators.js

@@ -0,0 +1,31 @@
+// -- Default templates (one per SeoDraftKind, pure) -------------------------
+/**
+ * One deterministic template per `SeoDraftKind`. Each MUST echo
+ * `finding.title` into the artifact text — this is what lets the
+ * `SeoBuilder`'s re-filter (`../never-encode-filter.js`) catch a banned
+ * tactic implied by the approved finding's own title (sc-12-4).
+ */
+export const DEFAULT_DRAFT_GENERATORS = {
+    "schema-jsonld": (finding, target) => JSON.stringify({ "@context": "https://schema.org", "@type": "WebPage", name: finding.title, url: target }),
+    "internal-link": (finding, target) => `Add an internal link on ${target} implementing: ${finding.title}`,
+    "title-meta": (finding, _target) => `<title>${finding.title}</title>`,
+    "content-refresh": (finding, target) => `Refresh ${target}: ${finding.title}`,
+};
+// -- Kind selection ----------------------------------------------------------
+/** Deterministic mapping from `playbookRef` prefix to the `SeoDraftKind` produced. */
+const PLAYBOOK_KIND_RULES = [
+    { prefix: "seo.schema", kind: "schema-jsonld" },
+    { prefix: "seo.internal-linking", kind: "internal-link" },
+    { prefix: "seo.content-decay", kind: "content-refresh" },
+];
+/**
+ * Deterministically selects the `SeoDraftKind` for an `ApprovedFinding` from
+ * its `playbookRef` prefix (`../hub-emitter.ts` encodes `playbook:<ref>` per
+ * finding). Falls back to `"title-meta"` — the most generic, broadly
+ * applicable draft kind — when no prefix matches. Pure; never throws.
+ */
+export function kindForApprovedFinding(finding) {
+    const match = PLAYBOOK_KIND_RULES.find((rule) => finding.playbookRef.startsWith(rule.prefix));
+    return match?.kind ?? "title-meta";
+}
+//# sourceMappingURL=draft-generators.js.map

package/dist/seo/builder/draft-generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-generators.js","sourceRoot":"","sources":["../../../src/seo/builder/draft-generators.ts"],"names":[],"mappings":"AAqBA,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAyC;IAC5E,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACnC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC5G,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,2BAA2B,MAAM,kBAAkB,OAAO,CAAC,KAAK,EAAE;IACxG,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,OAAO,CAAC,KAAK,UAAU;IACrE,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,MAAM,KAAK,OAAO,CAAC,KAAK,EAAE;CAC9E,CAAC;AAEF,+EAA+E;AAE/E,sFAAsF;AACtF,MAAM,mBAAmB,GAA0D;IACjF,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE;IAC/C,EAAE,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,eAAe,EAAE;IACzD,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,iBAAiB,EAAE;CACzD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAwB;IAC7D,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9F,OAAO,KAAK,EAAE,IAAI,IAAI,YAAY,CAAC;AACrC,CAAC"}

package/dist/seo/builder/draft-store.d.ts

@@ -0,0 +1,30 @@
+import type { SeoDraft } from "./draft-types.js";
+/** One `SeoBuildRunner.run` invocation's persisted output, keyed by `reportId`. */
+export type SeoDraftBundle = {
+    reportId: string;
+    target: string;
+    /** = the injected `now`, never `Date.now()`. */
+    generatedAt: string;
+    drafts: SeoDraft[];
+    skipped: number;
+};
+export declare class SeoDraftStore {
+    /**
+     * Write `bundle` atomically (temp file + POSIX-atomic rename) under
+     * `.bober/seo/drafts/`. Overwrites any existing bundle with the same
+     * `reportId`. Throws on an unrecoverable fs failure — callers (the build
+     * runner) are expected to catch and fail closed.
+     */
+    save(projectRoot: string, bundle: SeoDraftBundle): Promise<void>;
+    /**
+     * Read a persisted `SeoDraftBundle` by `reportId`. Returns `null` on a
+     * missing file — NEVER throws (mirrors `SeoReportStore.read`).
+     */
+    read(projectRoot: string, reportId: string): Promise<SeoDraftBundle | null>;
+    /**
+     * List all persisted draft-bundle reportIds, sorted by filename. Returns
+     * `[]` if the drafts directory does not exist — never throws.
+     */
+    list(projectRoot: string): Promise<string[]>;
+}
+//# sourceMappingURL=draft-store.d.ts.map

package/dist/seo/builder/draft-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-store.d.ts","sourceRoot":"","sources":["../../../src/seo/builder/draft-store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAmBjD,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,qBAAa,aAAa;IACxB;;;;;OAKG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAStE;;;OAGG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAUjF;;;OAGG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAanD"}

package/dist/seo/builder/draft-store.js

@@ -0,0 +1,76 @@
+/**
+ * SeoDraftStore — persists a `SeoDraftBundle` JSON under `.bober/seo/drafts/`
+ * (spec-20260717-seo-improver-builder, Sprint 13). MIRRORS `SeoReportStore`
+ * (`../report-store.ts`): atomic temp-file + POSIX rename, sanitized
+ * filename, `null`-on-missing read, `[]`-on-missing list. Write-once id =
+ * the source `reportId` (one draft bundle per built report).
+ *
+ * `generatedAt` on the bundle is ALWAYS the caller-injected `now` — this
+ * file never reads the clock for that purpose. The `.tmp` suffix below uses
+ * `Date.now()` purely as a uniqueness token for the temp filename (same
+ * carve-out `report-store.ts:67-68` documents), never as a bundle timestamp.
+ */
+import { readFile, writeFile, readdir, rename } from "node:fs/promises";
+import { randomBytes } from "node:crypto";
+import { join } from "node:path";
+import { ensureDir } from "../../utils/fs.js";
+// ── Paths ────────────────────────────────────────────────────────────
+const SEO_DRAFTS_DIR = ".bober/seo/drafts";
+const DRAFT_SUFFIX = "-seo-drafts.json";
+function draftsDir(projectRoot) {
+    return join(projectRoot, SEO_DRAFTS_DIR);
+}
+/** fs-safe filename — mirrors `report-store.ts`'s sanitization. */
+function draftPath(projectRoot, reportId) {
+    const safeId = reportId.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(draftsDir(projectRoot), `${safeId}${DRAFT_SUFFIX}`);
+}
+// ── Store ────────────────────────────────────────────────────────────
+export class SeoDraftStore {
+    /**
+     * Write `bundle` atomically (temp file + POSIX-atomic rename) under
+     * `.bober/seo/drafts/`. Overwrites any existing bundle with the same
+     * `reportId`. Throws on an unrecoverable fs failure — callers (the build
+     * runner) are expected to catch and fail closed.
+     */
+    async save(projectRoot, bundle) {
+        await ensureDir(draftsDir(projectRoot));
+        const path = draftPath(projectRoot, bundle.reportId);
+        // Uniqueness token for the temp filename only — NOT a bundle timestamp.
+        const tmp = `${path}.${process.pid}.${Date.now()}.${randomBytes(4).toString("hex")}.tmp`;
+        await writeFile(tmp, JSON.stringify(bundle, null, 2) + "\n", { encoding: "utf-8" });
+        await rename(tmp, path);
+    }
+    /**
+     * Read a persisted `SeoDraftBundle` by `reportId`. Returns `null` on a
+     * missing file — NEVER throws (mirrors `SeoReportStore.read`).
+     */
+    async read(projectRoot, reportId) {
+        const path = draftPath(projectRoot, reportId);
+        try {
+            const raw = await readFile(path, "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * List all persisted draft-bundle reportIds, sorted by filename. Returns
+     * `[]` if the drafts directory does not exist — never throws.
+     */
+    async list(projectRoot) {
+        let entries;
+        try {
+            entries = await readdir(draftsDir(projectRoot));
+        }
+        catch {
+            return [];
+        }
+        return entries
+            .filter((f) => f.endsWith(DRAFT_SUFFIX))
+            .sort()
+            .map((f) => f.slice(0, -DRAFT_SUFFIX.length));
+    }
+}
+//# sourceMappingURL=draft-store.js.map

package/dist/seo/builder/draft-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-store.js","sourceRoot":"","sources":["../../../src/seo/builder/draft-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,wEAAwE;AAExE,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAC3C,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAExC,SAAS,SAAS,CAAC,WAAmB;IACpC,OAAO,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED,mEAAmE;AACnE,SAAS,SAAS,CAAC,WAAmB,EAAE,QAAgB;IACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,GAAG,YAAY,EAAE,CAAC,CAAC;AAClE,CAAC;AAcD,wEAAwE;AAExE,MAAM,OAAO,aAAa;IACxB;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB,EAAE,MAAsB;QACpD,MAAM,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrD,wEAAwE;QACxE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QACzF,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACpF,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB,EAAE,QAAgB;QAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;aACvC,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/seo/builder/draft-types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SeoDraft artifact types (spec-20260717-seo-improver-builder, Sprint 11;
+ * ADR-4). Pure `type` declarations only — no runtime code, no imports —
+ * mirrors `../types.ts`'s "no runtime" discipline (`types.ts:1-12`).
+ *
+ * A `SeoDraft` is a PROPOSAL the Sprint-12 `SeoBuilder.build` produces from
+ * an `ApprovedFinding` (`./approved-finding.js`); it is never auto-applied.
+ * `humanApprovalRequired` is pinned to the LITERAL `true` (not `boolean`) —
+ * ADR-4 explicitly rejected a boolean flag as forgeable/mutable, so the type
+ * itself must reject `false`. `sourceCitationUrl` must be COPIED verbatim
+ * from the `ApprovedFinding` that produced the draft — never invented.
+ */
+/** The four artifact kinds the Sprint-12 `SeoBuilder.build` can draft. */
+export type SeoDraftKind = "schema-jsonld" | "internal-link" | "title-meta" | "content-refresh";
+/**
+ * One drafted artifact. Every field is provenance-preserving: `artifact` is
+ * a proposed text/content string, never auto-applied; `sourceCitationUrl`
+ * and `sourceFindingId` trace back to the exact `ApprovedFinding` this draft
+ * was derived from.
+ */
+export type SeoDraft = {
+    kind: SeoDraftKind;
+    /** LITERAL `true` — a forgeable plain `boolean` was explicitly rejected (ADR-4). */
+    humanApprovalRequired: true;
+    /** Copied verbatim from `ApprovedFinding.sourceCitationUrl` — never invented. */
+    sourceCitationUrl: string;
+    /** The hub Finding id this draft was derived from. */
+    sourceFindingId: string;
+    /** The URL/page/entity this draft targets. */
+    target: string;
+    /** The proposed artifact text/content — a proposal, never auto-applied. */
+    artifact: string;
+    /** The playbook whose tactic produced this draft. */
+    playbookRef: string;
+};
+//# sourceMappingURL=draft-types.d.ts.map

package/dist/seo/builder/draft-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-types.d.ts","sourceRoot":"","sources":["../../../src/seo/builder/draft-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,0EAA0E;AAC1E,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,eAAe,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAIhG;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,oFAAoF;IACpF,qBAAqB,EAAE,IAAI,CAAC;IAC5B,iFAAiF;IACjF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/seo/builder/draft-types.js

@@ -0,0 +1,14 @@
+/**
+ * SeoDraft artifact types (spec-20260717-seo-improver-builder, Sprint 11;
+ * ADR-4). Pure `type` declarations only — no runtime code, no imports —
+ * mirrors `../types.ts`'s "no runtime" discipline (`types.ts:1-12`).
+ *
+ * A `SeoDraft` is a PROPOSAL the Sprint-12 `SeoBuilder.build` produces from
+ * an `ApprovedFinding` (`./approved-finding.js`); it is never auto-applied.
+ * `humanApprovalRequired` is pinned to the LITERAL `true` (not `boolean`) —
+ * ADR-4 explicitly rejected a boolean flag as forgeable/mutable, so the type
+ * itself must reject `false`. `sourceCitationUrl` must be COPIED verbatim
+ * from the `ApprovedFinding` that produced the draft — never invented.
+ */
+export {};
+//# sourceMappingURL=draft-types.js.map

package/dist/seo/builder/draft-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-types.js","sourceRoot":"","sources":["../../../src/seo/builder/draft-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/seo/builder/hub-approved-source.d.ts

@@ -0,0 +1,11 @@
+import type { FactStore } from "../../state/facts.js";
+import { ApprovedFinding } from "./approved-finding.js";
+/**
+ * Reads approved, cited, SEO-domain hub Findings from `store` and maps each
+ * to an `ApprovedFinding` via `ApprovedFinding.from`. Never throws: malformed
+ * JSON, schema-invalid rows, non-`"seo"`-domain rows, non-`"approved"`
+ * status, and uncited/malformed-citation rows are all silently skipped
+ * (sc-11-4).
+ */
+export declare function readApprovedSeoFindings(store: FactStore): ApprovedFinding[];
+//# sourceMappingURL=hub-approved-source.d.ts.map

package/dist/seo/builder/hub-approved-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-approved-source.d.ts","sourceRoot":"","sources":["../../../src/seo/builder/hub-approved-source.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAA4B,MAAM,uBAAuB,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,EAAE,CAqB3E"}