@aitne/daemon 0.1.0

package/dist/core/skill-curation/smoke-test.js

@@ -0,0 +1,313 @@
+// P22 §2.3 — smoke-test runner.
+//
+// Runs deterministic checks on a *validated and rendered* proposal before
+// the chokepoint applies the overlay atomically. Failure produces a
+// `failures[]` list the API caller (and the dashboard's "why did the
+// optimizer give up on X?" view) can show verbatim. A failed smoke test
+// persists the proposal with `status='smoke_failed'` and the failures
+// JSON; no overlay is written.
+//
+// Checks (all hard rejects):
+//   render_parses              — CommonMark round-trip
+//   render_within_budget       — byte budget (also enforced at API step 6)
+//   no_embedded_markers        — final MD has no marker injection
+//   decision_language_clean    — free-text fields pass linter post-render
+//   paths_resolve              — payload paths resolve in current snapshot
+//   sections_resolve           — referenced sections exist (or mode allows create)
+//   cross_section_consistency  — destination_section also exists in some
+//                                knowledge_layout payload owned by same skill
+//   no_duplicate_entries       — primary keys unique within payload
+//   frozen_sections_unchanged  — section is not frozen
+//   signal_citations_valid     — every signal_id exists, unconsumed, same skill
+import { containsDecisionLanguage, SKILL_CURATION_BYTE_BUDGET, } from "@aitne/shared";
+import { snapshotMatchesPath, snapshotMatchesSection, } from "./knowledge-map.js";
+export function runSmokeTest(input) {
+    const failures = [];
+    const add = (check, message) => failures.push({ check, message });
+    // 1. render_parses — minimal CommonMark sanity. Full CommonMark-AST round-
+    //    trip would pull in another dep; the lightweight checks below catch the
+    //    breakages we actually see (table column count, fence balance).
+    if (!isWellFormedTable(input.rendered_md)) {
+        add("render_parses", "rendered markdown has malformed table structure");
+    }
+    if (!isFenceBalanced(input.rendered_md)) {
+        add("render_parses", "rendered markdown has unbalanced code fence");
+    }
+    // 2. render_within_budget
+    const bytes = Buffer.byteLength(input.rendered_md, "utf-8");
+    const budget = SKILL_CURATION_BYTE_BUDGET[input.section_kind];
+    if (bytes > budget) {
+        add("render_within_budget", `rendered ${bytes}B exceeds ${budget}B budget for kind=${input.section_kind}`);
+    }
+    // 3. no_embedded_markers — schema-level guard restated post-render in case
+    //    a future renderer expansion injects new prose.
+    if (/<!--\s*(CURATION|safety|integration_modes|mode:|today_write_lock_id)/i.test(input.rendered_md) ||
+        /<\s*integration_modes\b/i.test(input.rendered_md)) {
+        add("no_embedded_markers", "rendered markdown contains a reserved marker pattern");
+    }
+    // 4. decision_language_clean
+    for (const text of freeTextFields(input.payload)) {
+        if (containsDecisionLanguage(text)) {
+            add("decision_language_clean", `imperative phrasing in field: ${truncate(text, 60)}`);
+            break;
+        }
+    }
+    // 5. paths_resolve
+    for (const p of payloadPaths(input.payload)) {
+        if (!snapshotMatchesPath(input.snapshot, p)) {
+            add("paths_resolve", `path "${p}" does not resolve under context dir`);
+        }
+    }
+    // 6. sections_resolve — only meaningful for routing_table + search_recipes.
+    if (input.payload.kind === "routing_table") {
+        for (const r of input.payload.rules) {
+            if (r.destination_mode === "append_to_file")
+                continue;
+            if (!snapshotMatchesPath(input.snapshot, r.destination_path))
+                continue; // captured by paths_resolve
+            if (!snapshotMatchesSection(input.snapshot, r.destination_path, r.destination_section)) {
+                add("sections_resolve", `section "${r.destination_section}" missing in ${r.destination_path}`);
+            }
+        }
+    }
+    else if (input.payload.kind === "search_recipes") {
+        for (const r of input.payload.recipes) {
+            if (!r.lookup_section)
+                continue;
+            if (!snapshotMatchesPath(input.snapshot, r.lookup_path))
+                continue;
+            if (!snapshotMatchesSection(input.snapshot, r.lookup_path, r.lookup_section)) {
+                add("sections_resolve", `section "${r.lookup_section}" missing in ${r.lookup_path}`);
+            }
+        }
+    }
+    // 7. cross_section_consistency — when curating routing_table, every
+    //    destination_section referenced must also exist in some
+    //    knowledge_layout payload owned by the same skill.
+    if (input.payload.kind === "routing_table") {
+        const ownedSections = collectKnowledgeLayoutSections(input.siblingPayloads ?? {});
+        if (ownedSections.size > 0) {
+            for (const r of input.payload.rules) {
+                const section = stripHeading(r.destination_section);
+                const targetKey = `${r.destination_path.toLowerCase()}#${section}`;
+                if (!ownedSections.has(targetKey)) {
+                    // It's only an inconsistency if the path is one this skill manages
+                    // — heuristic: at least one knowledge_layout file matches the path.
+                    const skillManagesPath = Array.from(ownedSections).some((k) => k.startsWith(r.destination_path.toLowerCase() + "#"));
+                    if (skillManagesPath) {
+                        add("cross_section_consistency", `routing rule references "${r.destination_path}#${section}" not in this skill's knowledge_layout`);
+                    }
+                }
+            }
+        }
+    }
+    // 7b. cross_section_consistency (inverse) — when curating knowledge_layout,
+    //     reject removals of sections still referenced by an existing
+    //     routing_table sibling. Per §2.3: "the inverse: a knowledge_layout
+    //     removal that drops a section still referenced by an unconsidered
+    //     routing rule is rejected". The optimizer is supposed to co-submit
+    //     a routing_table proposal in the same run; without that, the
+    //     knowledge_layout proposal alone would silently break navigation.
+    if (input.payload.kind === "knowledge_layout") {
+        const newSectionKeys = new Set();
+        for (const f of input.payload.files) {
+            for (const s of f.sections) {
+                newSectionKeys.add(`${f.path.toLowerCase()}#${stripHeading(s.heading)}`);
+            }
+        }
+        const referencedByRouting = collectRoutingTableReferences(input.siblingPayloads ?? {});
+        for (const ref of referencedByRouting) {
+            // Only flag references whose destination_path is one this proposal
+            // describes — references to paths owned by other skills are out of
+            // scope (§9 risk #3 cross-skill is not arbitrated here).
+            const refPath = ref.split("#")[0];
+            const proposalCoversPath = input.payload.files.some((f) => f.path.toLowerCase() === refPath);
+            if (proposalCoversPath && !newSectionKeys.has(ref)) {
+                add("cross_section_consistency", `knowledge_layout removes "${ref}" but a sibling routing_table rule still references it`);
+            }
+        }
+    }
+    // 8. no_duplicate_entries — primary keys unique within the payload.
+    const keys = primaryKeys(input.payload);
+    const seen = new Set();
+    for (const k of keys) {
+        if (seen.has(k)) {
+            add("no_duplicate_entries", `duplicate primary key "${k}" within payload`);
+            break;
+        }
+        seen.add(k);
+    }
+    // 9. frozen_sections_unchanged
+    if (input.frozenSet.has(`${input.skill_slug}:${input.section_id}`)) {
+        add("frozen_sections_unchanged", `section ${input.skill_slug}:${input.section_id} is frozen`);
+    }
+    // 10. signal_citations_valid
+    if (input.signal_ids.length === 0) {
+        add("signal_citations_valid", "proposal must cite at least one signal");
+    }
+    else {
+        const placeholders = input.signal_ids.map(() => "?").join(",");
+        const rows = input.db
+            .prepare(`SELECT id, skill_slug, consumed_at FROM skill_curation_signals WHERE id IN (${placeholders})`)
+            .all(...input.signal_ids);
+        if (rows.length !== input.signal_ids.length) {
+            add("signal_citations_valid", "one or more signal_ids not found");
+        }
+        for (const row of rows) {
+            if (row.skill_slug !== input.skill_slug) {
+                add("signal_citations_valid", `signal ${row.id} belongs to skill ${row.skill_slug}, not ${input.skill_slug}`);
+            }
+            if (row.consumed_at !== null) {
+                add("signal_citations_valid", `signal ${row.id} already consumed`);
+            }
+        }
+    }
+    return { ok: failures.length === 0, failures };
+}
+// ── Helpers ─────────────────────────────────────────────────────────────
+function isWellFormedTable(md) {
+    const lines = md.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line.startsWith("|"))
+            continue;
+        const next = lines[i + 1];
+        if (!next || !/^\|\s*[-:]+/.test(next))
+            continue;
+        // Count columns in header and separator
+        const hcols = countTableColumns(line);
+        const scols = countTableColumns(next);
+        if (hcols !== scols || hcols < 2)
+            return false;
+        // Walk subsequent rows until non-table line; column counts must match
+        for (let j = i + 2; j < lines.length; j++) {
+            if (!lines[j].startsWith("|"))
+                break;
+            if (countTableColumns(lines[j]) !== hcols)
+                return false;
+        }
+    }
+    return true;
+}
+function countTableColumns(line) {
+    // Count `|` separators, stripping one leading and one trailing pipe when
+    // present. Using replace() avoids branch coverage issues from dead ternaries.
+    const s = line.trim().replace(/^\|/, "").replace(/\|$/, "");
+    return s.split("|").length;
+}
+function isFenceBalanced(md) {
+    const m = md.match(/```/g);
+    return !m || m.length % 2 === 0;
+}
+function* freeTextFields(p) {
+    switch (p.kind) {
+        case "knowledge_layout":
+            for (const f of p.files) {
+                yield f.purpose;
+                for (const s of f.sections)
+                    yield s.contains;
+            }
+            return;
+        case "routing_table":
+            for (const r of p.rules)
+                if (r.note)
+                    yield r.note;
+            return;
+        case "frontmatter_schema":
+            for (const ft of p.file_types) {
+                for (const c of ft.conventional)
+                    yield c.purpose;
+            }
+            return;
+        case "search_recipes":
+            for (const r of p.recipes) {
+                yield r.question_shape;
+                if (r.note)
+                    yield r.note;
+            }
+            return;
+        case "convention_notes":
+            for (const n of p.notes)
+                yield n.rule;
+            return;
+        case "cross_references":
+            for (const r of p.refs)
+                yield r.relation;
+            return;
+    }
+}
+function* payloadPaths(p) {
+    switch (p.kind) {
+        case "knowledge_layout":
+            for (const f of p.files)
+                yield f.path;
+            return;
+        case "routing_table":
+            for (const r of p.rules)
+                yield r.destination_path;
+            return;
+        case "frontmatter_schema":
+            for (const ft of p.file_types)
+                yield ft.glob;
+            return;
+        case "search_recipes":
+            for (const r of p.recipes)
+                yield r.lookup_path;
+            return;
+        case "convention_notes":
+            return;
+        case "cross_references":
+            for (const r of p.refs) {
+                yield r.from_path;
+                yield r.to_path;
+            }
+            return;
+    }
+}
+function primaryKeys(p) {
+    switch (p.kind) {
+        case "knowledge_layout": return p.files.map((f) => f.path.toLowerCase());
+        case "routing_table": return p.rules.map((r) => `${r.trigger_pattern}|${r.destination_path.toLowerCase()}|${r.destination_section}`);
+        case "frontmatter_schema": return p.file_types.map((ft) => ft.glob.toLowerCase());
+        case "search_recipes": return p.recipes.map((r) => r.question_shape.toLowerCase());
+        case "convention_notes": return p.notes.map((n) => n.topic.toLowerCase());
+        case "cross_references": return p.refs.map((r) => `${r.from_path.toLowerCase()}|${r.to_path.toLowerCase()}`);
+    }
+}
+function collectKnowledgeLayoutSections(siblingPayloads) {
+    const out = new Set();
+    for (const payload of Object.values(siblingPayloads)) {
+        if (payload.kind !== "knowledge_layout")
+            continue;
+        for (const f of payload.files) {
+            for (const s of f.sections) {
+                out.add(`${f.path.toLowerCase()}#${stripHeading(s.heading)}`);
+            }
+        }
+    }
+    return out;
+}
+/** Collect every (destination_path, destination_section) pair referenced by
+ *  routing_table siblings — used by the inverse cross_section_consistency
+ *  check to refuse a knowledge_layout removal that would orphan a routing
+ *  rule. Excludes `append_to_file` rules whose section is implicit. */
+function collectRoutingTableReferences(siblingPayloads) {
+    const out = new Set();
+    for (const payload of Object.values(siblingPayloads)) {
+        if (payload.kind !== "routing_table")
+            continue;
+        for (const r of payload.rules) {
+            if (r.destination_mode === "append_to_file")
+                continue;
+            out.add(`${r.destination_path.toLowerCase()}#${stripHeading(r.destination_section)}`);
+        }
+    }
+    return out;
+}
+function stripHeading(s) {
+    return s.replace(/^##{1,2}\s+/, "").trim();
+}
+function truncate(s, n) {
+    return s.length <= n ? s : s.slice(0, n) + "…";
+}
+//# sourceMappingURL=smoke-test.js.map

package/dist/core/skill-curation/smoke-test.js.map

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

package/dist/core/skill-curation/splicer.d.ts

@@ -0,0 +1,16 @@
+import type { CurationPayloadValue, SectionKind } from "@aitne/shared";
+export interface SplicerWarning {
+    code: "splicer_orphan_anchor" | "splicer_kind_mismatch" | "splicer_render_error";
+    anchorId: string;
+    message: string;
+}
+export type ResolveOverlay = (sectionId: string, kind: SectionKind) => CurationPayloadValue | null;
+export interface SpliceResult {
+    body: string;
+    warnings: SplicerWarning[];
+}
+export declare function spliceCurationAnchors(md: string, resolveOverlay: ResolveOverlay, options?: {
+    knownSectionIds?: Set<string>;
+}): SpliceResult;
+export declare function hasCurationAnchors(md: string): boolean;
+//# sourceMappingURL=splicer.d.ts.map

package/dist/core/skill-curation/splicer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splicer.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/splicer.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAKvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,uBAAuB,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,KACd,oBAAoB,GAAG,IAAI,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAO,GAC9C,YAAY,CAoDd;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/core/skill-curation/splicer.js

@@ -0,0 +1,78 @@
+// P22 §1.5 — anchor splicer.
+//
+// Substitutes `<!-- CURATION:<kind> id="<id>" -->` anchors in a SKILL.md
+// body with the rendered overlay content. Pure function — no I/O, no
+// dependency on the file system. Callers (SkillsCompiler) load overlays
+// and pass the resolved payload map; this module produces the spliced
+// markdown.
+//
+// When an anchor has no payload (no overlay AND no seed), the anchor LINE
+// is removed entirely. Removing only the anchor would leave an orphan
+// heading; the §1.6 rule "anchor MUST be the only content between its
+// owning heading and the next heading" lets us do this safely AND we
+// keep the heading line so the SKILL.md author retains editorial control.
+//
+// When an anchor has a kind/id mismatch with the declaration, the line
+// is removed and a `splicer_kind_mismatch` log line is emitted via the
+// caller-provided `onWarning` callback.
+import { renderCurationSection } from "./render/index.js";
+const ANCHOR_RE = /<!--\s*CURATION:([a-z_]+)\s+id="([a-z0-9-]+)"\s*-->/i;
+export function spliceCurationAnchors(md, resolveOverlay, options = {}) {
+    const warnings = [];
+    const lines = md.split("\n");
+    const out = [];
+    for (const line of lines) {
+        const m = ANCHOR_RE.exec(line);
+        if (!m) {
+            out.push(line);
+            continue;
+        }
+        const kind = m[1].toLowerCase();
+        const id = m[2];
+        if (options.knownSectionIds && !options.knownSectionIds.has(id)) {
+            warnings.push({ code: "splicer_orphan_anchor", anchorId: id, message: `no declaration for "${id}"` });
+            // Drop the line.
+            continue;
+        }
+        let payload;
+        try {
+            payload = resolveOverlay(id, kind);
+        }
+        catch (err) {
+            warnings.push({
+                code: "splicer_render_error",
+                anchorId: id,
+                message: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        if (!payload) {
+            // No overlay, no seed — strip the anchor entirely.
+            continue;
+        }
+        if (payload.kind !== kind) {
+            warnings.push({
+                code: "splicer_kind_mismatch",
+                anchorId: id,
+                message: `anchor kind=${kind} but overlay payload kind=${payload.kind}`,
+            });
+            continue;
+        }
+        try {
+            const rendered = renderCurationSection(kind, payload);
+            out.push(rendered);
+        }
+        catch (err) {
+            warnings.push({
+                code: "splicer_render_error",
+                anchorId: id,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return { body: out.join("\n"), warnings };
+}
+export function hasCurationAnchors(md) {
+    return ANCHOR_RE.test(md);
+}
+//# sourceMappingURL=splicer.js.map

package/dist/core/skill-curation/splicer.js.map

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

package/dist/core/skill-curation/workdir.d.ts

@@ -0,0 +1,40 @@
+import type Database from "better-sqlite3";
+import type { SecretStore } from "../../secrets/secret-store.js";
+export interface MaterializeOptimizerWorkdirParams {
+    db: Database.Database;
+    dataDir: string;
+    /** Repo root (for agent-assets resolution). */
+    workspaceDir: string;
+    contextDir: string;
+    secretStore: SecretStore;
+    /** Cadence label persisted on the run row + inlined into the preamble. */
+    cadence: "daily" | "weekly" | "monthly";
+    /** Hard limit on inlined data size to keep the workdir bounded. */
+    maxInlineBytes?: number;
+    /**
+     * P22 §6.4 — owner-clicked "Run optimization now" runs in manual mode.
+     * In manual mode the run row is flagged `is_manual=1` (used by the
+     * scheduler's cadence-interval gate to extend the next auto-fire), the
+     * skill-selection threshold (`sum(weight) ≥ 3`) is bypassed so any skill
+     * with at least one unconsumed signal becomes a target, and per-section
+     * cooldowns (7 d post-apply, 14 d post-revert) are ignored — the owner
+     * has explicitly asked the optimizer to look again.
+     */
+    manual?: boolean;
+    /**
+     * Optional owner-narrowed target list (manual run only). When set,
+     * skill selection is restricted to this whitelist *intersected* with
+     * skills that have unconsumed signals; excluded_skills still applies.
+     */
+    targetSkillsOverride?: string[];
+}
+export interface OptimizerWorkdir {
+    runId: string;
+    runToken: string;
+    workdirPath: string;
+    skillsRoot: string;
+    targetSkills: string[];
+}
+export declare function materializeOptimizerWorkdir(params: MaterializeOptimizerWorkdirParams): Promise<OptimizerWorkdir>;
+export declare function teardownOptimizerWorkdir(workdirPath: string): void;
+//# sourceMappingURL=workdir.d.ts.map

package/dist/core/skill-curation/workdir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workdir.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/workdir.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAU3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAMjE,MAAM,WAAW,iCAAiC;IAChD,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,0EAA0E;IAC1E,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAgI3B;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAElE"}