@aitne/daemon 0.1.0

package/dist/core/skill-curation/auto-revert.js

@@ -0,0 +1,155 @@
+// P22 §5.3 — auto-revert + 2-cycle freeze.
+//
+// Each cadence cycle, before spawning a new optimizer run, the daemon
+// re-evaluates recently-applied proposals: if the section has accumulated
+// MORE signals (post-apply) than were present at apply time, the apply
+// did not "settle" the drift and is rolled back automatically. The section
+// is then marked `frozen` for two cadence cycles to prevent thrashing.
+//
+// This is the ONLY roll-back path. Owner-driven approve/reject/revert
+// endpoints were removed alongside the approval queue (P22 preview-scope
+// note); the operator's only manual escape is the on/off toggle, which
+// stops new runs and tells SkillsCompiler to render seeds only.
+//
+// Detection heuristic (deterministic, no LLM):
+//   - Walk every `applied` proposal whose `decided_at` falls within the
+//     regression window (default 21 days — covers 2 weekly cycles plus a
+//     slack day so revert fires before the cooldown lifts).
+//   - Compute total weighted signal weight observed for `(skill_slug,
+//     section_id)` AFTER `decided_at`. Use the same weight table as
+//     selectSkillsForRun (so the threshold is consistent).
+//   - If post-apply weight ≥ `regressionThresholdWeight` (default 3),
+//     auto-revert via `autoRevertProposal()` and add
+//     `<slug>:<section_id>` to `runtime_state.skill_curation.frozen[]`
+//     with a 2-cycle countdown.
+//
+// Cycle countdown:
+//   - On every successful auto-revert, the entry's `cycles_remaining` is
+//     set to 2.
+//   - On every cadence fire (call to `tickFrozenCycles()`), every entry's
+//     counter decrements. Entries reaching 0 are removed.
+//   - The smoke-test gate `frozen_sections_unchanged` consults this set
+//     via `readFrozenSet()`.
+import { readRuntimeState, writeRuntimeState, } from "../../db/runtime-state.js";
+import { autoRevertProposal } from "./apply-proposal.js";
+import { weightFor } from "./signals.js";
+import { createLogger } from "../../logging.js";
+const logger = createLogger("skill-curation-auto-revert");
+const FROZEN_KEY = "skill_curation.frozen";
+const DEFAULT_REGRESSION_WINDOW_MS = 21 * 24 * 60 * 60 * 1000;
+const DEFAULT_REGRESSION_THRESHOLD = 3;
+const DEFAULT_FREEZE_CYCLES = 2;
+/** Read the current frozen entries set as a flat `<slug>:<section_id>` set,
+ *  the form expected by the smoke-test `frozen_sections_unchanged` check. */
+export function readFrozenSet(db) {
+    const state = readRuntimeState(db, FROZEN_KEY);
+    if (!state)
+        return new Set();
+    return new Set(state.entries.map((e) => e.key));
+}
+/** Decrement every entry's `cycles_remaining`, drop entries reaching 0.
+ *  Call once per cadence cycle BEFORE spawning the optimizer (so a section
+ *  that was frozen 2 cycles ago becomes eligible again on the third). */
+export function tickFrozenCycles(db) {
+    const state = readRuntimeState(db, FROZEN_KEY);
+    if (!state || state.entries.length === 0)
+        return { unfrozen: [] };
+    const unfrozen = [];
+    const next = [];
+    for (const entry of state.entries) {
+        const remaining = entry.cycles_remaining - 1;
+        if (remaining <= 0) {
+            const [slug, section_id] = entry.key.split(":");
+            unfrozen.push({ slug, section_id });
+        }
+        else {
+            next.push({ ...entry, cycles_remaining: remaining });
+        }
+    }
+    writeRuntimeState(db, FROZEN_KEY, { entries: next });
+    return { unfrozen };
+}
+/** Add (or refresh) a freeze entry. Idempotent; if the same key already
+ *  exists, its countdown is reset to `freezeCycles`. */
+export function freezeSection(db, slug, section_id, reason, options) {
+    const cycles = options?.freezeCycles ?? DEFAULT_FREEZE_CYCLES;
+    const now = options?.now ?? Date.now();
+    const key = `${slug}:${section_id}`;
+    const state = readRuntimeState(db, FROZEN_KEY) ?? { entries: [] };
+    const without = state.entries.filter((e) => e.key !== key);
+    const entry = {
+        key,
+        cycles_remaining: cycles,
+        frozen_at: now,
+        reason,
+        ...(options?.proposal_id !== undefined ? { proposal_id: options.proposal_id } : {}),
+    };
+    writeRuntimeState(db, FROZEN_KEY, { entries: [...without, entry] });
+}
+/** Detect regressed proposals + auto-revert + freeze. Idempotent — every
+ *  proposal that has already been reverted is skipped on subsequent calls
+ *  because its status flips to `reverted`. */
+export function autoRevertSweep(db, overlay, options = {}) {
+    const now = options.now ?? Date.now();
+    const windowMs = options.regressionWindowMs ?? DEFAULT_REGRESSION_WINDOW_MS;
+    const thresholdWeight = options.regressionThresholdWeight ?? DEFAULT_REGRESSION_THRESHOLD;
+    const freezeCycles = options.freezeCycles ?? DEFAULT_FREEZE_CYCLES;
+    const revertImpl = options.revertProposalImpl ?? autoRevertProposal;
+    const cutoff = now - windowMs;
+    const candidates = db
+        .prepare(`SELECT id, skill_slug, section_id, status, decided_at, proposed_at
+       FROM skill_curation_proposals
+       WHERE status = 'applied'
+         AND COALESCE(decided_at, proposed_at) >= ?
+       ORDER BY COALESCE(decided_at, proposed_at) ASC`)
+        .all(cutoff);
+    const newlyFrozen = [];
+    let reverted = 0;
+    for (const c of candidates) {
+        const appliedAt = c.decided_at ?? c.proposed_at;
+        const postApplyWeight = computeWeightSince(db, c.skill_slug, c.section_id, appliedAt, now);
+        if (postApplyWeight < thresholdWeight)
+            continue;
+        const r = revertImpl({ db, overlay, proposalId: c.id, now });
+        if (!r.ok) {
+            logger.warn({ proposal_id: c.id, status: r.status, message: r.message }, "auto-revert failed");
+            continue;
+        }
+        reverted++;
+        freezeSection(db, c.skill_slug, c.section_id, "regression", {
+            freezeCycles,
+            now,
+            proposal_id: c.id,
+        });
+        newlyFrozen.push({ slug: c.skill_slug, section_id: c.section_id });
+        logger.info({
+            proposal_id: c.id,
+            slug: c.skill_slug,
+            section_id: c.section_id,
+            post_apply_weight: postApplyWeight,
+        }, "auto-revert + freeze");
+    }
+    return {
+        reverted,
+        proposals_inspected: candidates.length,
+        newly_frozen: newlyFrozen,
+    };
+}
+/** Sum signal weights for `(slug, section_id)` whose `observed_at >= since`.
+ *  `section_id IS NULL` whole-skill signals don't count toward a single
+ *  section's regression — they're tracked separately. */
+function computeWeightSince(db, slug, section_id, since, now) {
+    const rows = db
+        .prepare(`SELECT id, skill_slug, section_id, signal_type, payload_json, observed_at,
+              consumed_at, consumed_by_proposal_id
+       FROM skill_curation_signals
+       WHERE skill_slug = ?
+         AND section_id = ?
+         AND observed_at > ?`)
+        .all(slug, section_id, since);
+    let weight = 0;
+    for (const row of rows)
+        weight += weightFor(row, now);
+    return weight;
+}
+//# sourceMappingURL=auto-revert.js.map

package/dist/core/skill-curation/auto-revert.js.map

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

package/dist/core/skill-curation/classify-diff.d.ts

@@ -0,0 +1,27 @@
+import type { CurationPayloadValue, SectionKind } from "@aitne/shared";
+export interface DiffResult {
+    additions: number;
+    modifications: number;
+    removals: number;
+    cosmeticOnly: boolean;
+    isAdditiveOnly: boolean;
+    kind: "additive_only" | "cosmetic_only" | "mixed" | "destructive";
+}
+export declare function classifyDiff(prev: CurationPayloadValue, next: CurationPayloadValue, kind: SectionKind): DiffResult;
+export interface DiffCaps {
+    additions: number;
+    modifications: number;
+    removals: number;
+}
+/** P22 §2.2 step 5 — per-kind diff caps applied to a single proposal. */
+export declare function diffCapsFor(kind: SectionKind, prevSize: number): DiffCaps;
+export declare function exceedsDiffCaps(diff: DiffResult, kind: SectionKind, prevSize: number): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Number of primary-key entries in a payload — used by diffCapsFor as the
+ *  base size and by the smoke test's no_duplicate_entries check. */
+export declare function payloadEntryCount(p: CurationPayloadValue): number;
+//# sourceMappingURL=classify-diff.d.ts.map

package/dist/core/skill-curation/classify-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-diff.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/classify-diff.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAGV,oBAAoB,EAKpB,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,OAAO,GAAG,aAAa,CAAC;CACnE;AA0OD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,WAAW,GAChB,UAAU,CAWZ;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CASzE;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,GACf;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAY9C;AAED;oEACoE;AACpE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CASjE"}

package/dist/core/skill-curation/classify-diff.js.map

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

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

@@ -0,0 +1,32 @@
+import { type CurationDeclarationValue, type SectionKind } from "@aitne/shared";
+export interface AnchorOccurrence {
+    /** 1-based line number of the anchor line in SKILL.md. */
+    line: number;
+    /** Raw anchor line (whitespace-stripped). */
+    raw: string;
+    /** Parsed anchor kind (`<!-- CURATION:knowledge_layout id="..." -->`). */
+    kind: SectionKind;
+    /** Parsed anchor id. */
+    id: string;
+}
+export interface AnchorDiagnostic {
+    level: "error" | "warning";
+    code: "anchor_missing_heading" | "anchor_kind_mismatch" | "anchor_orphan" | "anchor_id_duplicate" | "section_missing_anchor" | "anchor_count_exceeded";
+    message: string;
+    anchorId?: string;
+    line?: number;
+}
+export interface LoadedCurationDeclaration {
+    slug: string;
+    declaration: CurationDeclarationValue | null;
+    anchors: AnchorOccurrence[];
+    diagnostics: AnchorDiagnostic[];
+}
+export declare function parseAnchorsFromMarkdown(md: string): AnchorOccurrence[];
+export declare function lintAnchorPlacement(md: string, declaration: CurationDeclarationValue | null, anchors: AnchorOccurrence[]): AnchorDiagnostic[];
+export declare function loadCurationDeclaration(skillsRoot: string, slug: string): CurationDeclarationValue | null;
+export declare function loadSkillCurationContext(skillsRoot: string, slug: string): LoadedCurationDeclaration;
+/** Walk the skills root and return one record per slug — used by anchor-lint
+ *  test and by `/health.skillCuration.misconfigured[]`. */
+export declare function loadAllCurationDeclarations(skillsRoot: string): LoadedCurationDeclaration[];
+//# sourceMappingURL=declarations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/declarations.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,wBAAwB,EAE7B,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,IAAI,EAAE,WAAW,CAAC;IAClB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,IAAI,EACA,wBAAwB,GACxB,sBAAsB,GACtB,eAAe,GACf,qBAAqB,GACrB,wBAAwB,GACxB,uBAAuB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC7C,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAID,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAgBvE;AAOD,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,wBAAwB,GAAG,IAAI,EAC5C,OAAO,EAAE,gBAAgB,EAAE,GAC1B,gBAAgB,EAAE,CAiGpB;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,wBAAwB,GAAG,IAAI,CAMjC;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,yBAAyB,CAO3B;AAED;2DAC2D;AAC3D,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GACjB,yBAAyB,EAAE,CAQ7B"}

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

@@ -0,0 +1,171 @@
+// P22 §1.5, §1.6 — curation declaration loader.
+//
+// A skill declares its curatable sections via `curation.json` next to its
+// `SKILL.md`. This loader:
+//   - Resolves the file from `agent-assets/skills/<slug>/curation.json`.
+//   - Validates against the `CurationDeclaration` Zod schema (kebab-case
+//     section IDs, ≤4 sections per skill, etc.).
+//   - Asserts §1.6 anchor placement contract on the SKILL.md body:
+//       * Every declared section has exactly one anchor.
+//       * Every anchor is preceded by a `## ` or `### ` heading.
+//       * Anchor IDs are unique within the skill.
+//       * Anchor kinds match the declaration's kind.
+//       * Orphan anchors (no matching declaration) are flagged.
+//
+// Returns a `LoadedCurationDeclaration` with the parsed declaration plus
+// any anchor-lint diagnostics. Callers decide whether to soft-warn or
+// hard-reject based on context (CI lint = reject, runtime materialization
+// = soft-warn + emit `skill_curation.declaration.*` log).
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CurationDeclaration, SECTION_KINDS, } from "@aitne/shared";
+const ANCHOR_RE = /<!--\s*CURATION:([a-z_]+)\s+id="([a-z0-9-]+)"\s*-->/i;
+export function parseAnchorsFromMarkdown(md) {
+    const out = [];
+    const lines = md.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const m = ANCHOR_RE.exec(lines[i]);
+        if (!m)
+            continue;
+        const kind = m[1].toLowerCase();
+        if (!SECTION_KINDS.includes(kind))
+            continue;
+        out.push({
+            line: i + 1,
+            raw: lines[i].trim(),
+            kind: kind,
+            id: m[2],
+        });
+    }
+    return out;
+}
+function isHeadingLine(line) {
+    const t = line.trimStart();
+    return t.startsWith("## ") || t.startsWith("### ");
+}
+export function lintAnchorPlacement(md, declaration, anchors) {
+    const diags = [];
+    const lines = md.split("\n");
+    // Rule 4 — anchor IDs are unique within a skill.
+    const seenIds = new Map();
+    for (const a of anchors) {
+        const prev = seenIds.get(a.id);
+        if (prev !== undefined) {
+            diags.push({
+                level: "error",
+                code: "anchor_id_duplicate",
+                message: `duplicate anchor id "${a.id}" at lines ${prev} and ${a.line}`,
+                anchorId: a.id,
+                line: a.line,
+            });
+        }
+        else {
+            seenIds.set(a.id, a.line);
+        }
+    }
+    // Rule 3 — soft cap of 4 anchors per skill.
+    if (anchors.length > 4) {
+        diags.push({
+            level: "error",
+            code: "anchor_count_exceeded",
+            message: `skill has ${anchors.length} anchors (cap is 4)`,
+        });
+    }
+    // Rule 1 — anchor preceded by ## or ### heading on the immediately previous
+    // non-blank line.
+    for (const a of anchors) {
+        let prev = a.line - 2; // line - 1 is the anchor row index in 0-based
+        while (prev >= 0 && lines[prev].trim() === "")
+            prev--;
+        if (prev < 0 || !isHeadingLine(lines[prev])) {
+            diags.push({
+                level: "error",
+                code: "anchor_missing_heading",
+                message: `anchor "${a.id}" is not preceded by a ## or ### heading`,
+                anchorId: a.id,
+                line: a.line,
+            });
+        }
+    }
+    if (declaration) {
+        const declById = new Map(declaration.sections.map((s) => [s.id, s]));
+        // Rule 5 — kind matches declaration; orphan anchors with no declaration.
+        for (const a of anchors) {
+            const d = declById.get(a.id);
+            if (!d) {
+                diags.push({
+                    level: "error",
+                    code: "anchor_orphan",
+                    message: `anchor "${a.id}" has no matching declaration`,
+                    anchorId: a.id,
+                    line: a.line,
+                });
+                continue;
+            }
+            if (d.kind !== a.kind) {
+                diags.push({
+                    level: "error",
+                    code: "anchor_kind_mismatch",
+                    message: `anchor "${a.id}" kind=${a.kind} but declaration says kind=${d.kind}`,
+                    anchorId: a.id,
+                    line: a.line,
+                });
+            }
+        }
+        // Soft failure — declared section with no anchor in SKILL.md.
+        const anchorIds = new Set(anchors.map((a) => a.id));
+        for (const sec of declaration.sections) {
+            if (!anchorIds.has(sec.id)) {
+                diags.push({
+                    level: "warning",
+                    code: "section_missing_anchor",
+                    message: `declared section "${sec.id}" has no anchor in SKILL.md`,
+                    anchorId: sec.id,
+                });
+            }
+        }
+    }
+    else if (anchors.length > 0) {
+        // Anchors but no declaration → all orphans.
+        for (const a of anchors) {
+            diags.push({
+                level: "error",
+                code: "anchor_orphan",
+                message: `anchor "${a.id}" present but no curation.json declaration found`,
+                anchorId: a.id,
+                line: a.line,
+            });
+        }
+    }
+    return diags;
+}
+export function loadCurationDeclaration(skillsRoot, slug) {
+    const path = join(skillsRoot, slug, "curation.json");
+    if (!existsSync(path))
+        return null;
+    const raw = readFileSync(path, "utf-8");
+    const json = JSON.parse(raw);
+    return CurationDeclaration.parse(json);
+}
+export function loadSkillCurationContext(skillsRoot, slug) {
+    const declaration = loadCurationDeclaration(skillsRoot, slug);
+    const skillPath = join(skillsRoot, slug, "SKILL.md");
+    const md = existsSync(skillPath) ? readFileSync(skillPath, "utf-8") : "";
+    const anchors = parseAnchorsFromMarkdown(md);
+    const diagnostics = lintAnchorPlacement(md, declaration, anchors);
+    return { slug, declaration, anchors, diagnostics };
+}
+/** Walk the skills root and return one record per slug — used by anchor-lint
+ *  test and by `/health.skillCuration.misconfigured[]`. */
+export function loadAllCurationDeclarations(skillsRoot) {
+    if (!existsSync(skillsRoot))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(skillsRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        out.push(loadSkillCurationContext(skillsRoot, entry.name));
+    }
+    return out;
+}
+//# sourceMappingURL=declarations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.js","sourceRoot":"","sources":["../../../src/core/skill-curation/declarations.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,0EAA0E;AAC1E,2BAA2B;AAC3B,yEAAyE;AACzE,yEAAyE;AACzE,iDAAiD;AACjD,mEAAmE;AACnE,yDAAyD;AACzD,iEAAiE;AACjE,kDAAkD;AAClD,qDAAqD;AACrD,gEAAgE;AAChE,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,0EAA0E;AAC1E,0DAA0D;AAE1D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,mBAAmB,EAEnB,aAAa,GAEd,MAAM,eAAe,CAAC;AAkCvB,MAAM,SAAS,GAAG,sDAAsD,CAAC;AAEzE,MAAM,UAAU,wBAAwB,CAAC,EAAU;IACjD,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QACnE,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,CAAC,GAAG,CAAC;YACX,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YACpB,IAAI,EAAE,IAAmB;YACzB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;SACT,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAC3B,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,EAAU,EACV,WAA4C,EAC5C,OAA2B;IAE3B,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7B,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,wBAAwB,CAAC,CAAC,EAAE,cAAc,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE;gBACvE,QAAQ,EAAE,CAAC,CAAC,EAAE;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,aAAa,OAAO,CAAC,MAAM,qBAAqB;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,8CAA8C;QACrE,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,IAAI,EAAE,CAAC;QACtD,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,0CAA0C;gBAClE,QAAQ,EAAE,CAAC,CAAC,EAAE;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,yEAAyE;QACzE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,KAAK,CAAC,IAAI,CAAC;oBACT,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,+BAA+B;oBACvD,QAAQ,EAAE,CAAC,CAAC,EAAE;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC;oBACT,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,8BAA8B,CAAC,CAAC,IAAI,EAAE;oBAC9E,QAAQ,EAAE,CAAC,CAAC,EAAE;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,8DAA8D;QAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC;oBACT,KAAK,EAAE,SAAS;oBAChB,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,qBAAqB,GAAG,CAAC,EAAE,6BAA6B;oBACjE,QAAQ,EAAE,GAAG,CAAC,EAAE;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,4CAA4C;QAC5C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,kDAAkD;gBAC1E,QAAQ,EAAE,CAAC,CAAC,EAAE;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,IAAY;IAEZ,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,UAAkB,EAClB,IAAY;IAEZ,MAAM,WAAW,GAAG,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,OAAO,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,mBAAmB,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAClE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AACrD,CAAC;AAED;2DAC2D;AAC3D,MAAM,UAAU,2BAA2B,CACzC,UAAkB;IAElB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,GAAG,GAAgC,EAAE,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,26 @@
+export interface SnapshotFile {
+    path: string;
+    headings: string[];
+    frontmatter: Record<string, unknown>;
+    last_modified_at: number;
+}
+export interface KnowledgeMapSnapshot {
+    context_dir: string;
+    taken_at: number;
+    files: SnapshotFile[];
+}
+export declare function buildKnowledgeMap(contextDir: string): KnowledgeMapSnapshot;
+export declare function extractHeadings(md: string): string[];
+export declare function extractFrontmatter(md: string): Record<string, unknown>;
+/** Test whether `relativePath` matches one of `scopePaths` (a list of literal
+ *  paths or glob patterns like `user/*.md`). Used by the structure-diff walker
+ *  and the API's smoke-test `paths_resolve` check. */
+export declare function matchScopePath(relativePath: string, scopePaths: string[]): boolean;
+/** Returns true when the snapshot contains a file matching the given path
+ *  spec (literal or glob). */
+export declare function snapshotMatchesPath(snapshot: KnowledgeMapSnapshot, pathSpec: string): boolean;
+/** Returns true when at least one file matching `pathSpec` contains a
+ *  heading matching `sectionHeading` (compared after stripping leading `## `). */
+export declare function snapshotMatchesSection(snapshot: KnowledgeMapSnapshot, pathSpec: string, sectionHeading: string): boolean;
+export declare function filterSnapshotByScope(snapshot: KnowledgeMapSnapshot, scopePaths: string[]): SnapshotFile[];
+//# sourceMappingURL=knowledge-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-map.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/knowledge-map.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAID,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAU1E;AAoCD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYtE;AAaD;;sDAEsD;AACtD,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAOlF;AAsBD;8BAC8B;AAC9B,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK7F;AAED;kFACkF;AAClF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAQT;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE,MAAM,EAAE,GACnB,YAAY,EAAE,CAEhB"}

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

@@ -0,0 +1,154 @@
+// P22 §3.3 + §4 walker — knowledge-map snapshot.
+//
+// Walks the live `getContextDir(config)` tree and returns a structural
+// snapshot the optimizer agent can read AND the smoke test's
+// `paths_resolve` / `sections_resolve` checks can validate against.
+//
+// Globs declared in a skill's `curation.json` `scope_paths` (e.g.
+// `user/*.md`) are NOT pre-expanded here — callers do the expansion via
+// `matchScopePath()`. The snapshot is a flat list of files, each with
+// frontmatter + heading list in document order.
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+const SKIP_DIRS = new Set([".git", "node_modules", ".obsidian", "history"]);
+export function buildKnowledgeMap(contextDir) {
+    const files = [];
+    if (existsSync(contextDir)) {
+        walk(contextDir, contextDir, files);
+    }
+    return {
+        context_dir: contextDir,
+        taken_at: Date.now(),
+        files,
+    };
+}
+function walk(root, dir, out) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        if (SKIP_DIRS.has(entry.name))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walk(root, full, out);
+            continue;
+        }
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        let content;
+        let mtime;
+        try {
+            content = readFileSync(full, "utf-8");
+            mtime = statSync(full).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        const rel = relative(root, full).split(/[\\/]/g).join("/");
+        out.push({
+            path: rel,
+            headings: extractHeadings(content),
+            frontmatter: extractFrontmatter(content),
+            last_modified_at: mtime,
+        });
+    }
+}
+export function extractHeadings(md) {
+    const out = [];
+    for (const line of md.split("\n")) {
+        if (/^##{1,2}\s+/.test(line)) {
+            out.push(line.replace(/^##{1,2}\s+/, "").trim());
+        }
+    }
+    return out;
+}
+export function extractFrontmatter(md) {
+    if (!md.startsWith("---\n"))
+        return {};
+    const end = md.indexOf("\n---", 4);
+    if (end === -1)
+        return {};
+    const block = md.slice(4, end);
+    const out = {};
+    for (const line of block.split("\n")) {
+        const m = /^([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(line);
+        if (!m)
+            continue;
+        out[m[1]] = parseScalar(m[2].trim());
+    }
+    return out;
+}
+function parseScalar(value) {
+    if (value === "" || value === "~" || value === "null")
+        return null;
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    if (/^-?\d+(\.\d+)?$/.test(value))
+        return Number(value);
+    if ((value.startsWith("\"") && value.endsWith("\"")) || (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+/** Test whether `relativePath` matches one of `scopePaths` (a list of literal
+ *  paths or glob patterns like `user/*.md`). Used by the structure-diff walker
+ *  and the API's smoke-test `paths_resolve` check. */
+export function matchScopePath(relativePath, scopePaths) {
+    const norm = relativePath.replace(/\\/g, "/");
+    for (const sp of scopePaths) {
+        if (sp === norm)
+            return true;
+        if (matchesGlob(norm, sp))
+            return true;
+    }
+    return false;
+}
+function matchesGlob(path, pattern) {
+    // Minimal glob: "/", "*", "**" — not full minimatch.
+    // Translate to a regex that does not span `/` on `*` and does on `**`.
+    const re = new RegExp("^" +
+        pattern
+            .split("/")
+            .map((segment) => segment
+            .replace(/[.+?^${}()|[\]\\]/g, "\\$&")
+            .replace(/\*\*/g, "::DOUBLESTAR::")
+            .replace(/\*/g, "[^/]*")
+            .replace(/::DOUBLESTAR::/g, ".*"))
+            .join("/") +
+        "$");
+    return re.test(path);
+}
+/** Returns true when the snapshot contains a file matching the given path
+ *  spec (literal or glob). */
+export function snapshotMatchesPath(snapshot, pathSpec) {
+    if (pathSpec.includes("*")) {
+        return snapshot.files.some((f) => matchScopePath(f.path, [pathSpec]));
+    }
+    return snapshot.files.some((f) => f.path === pathSpec);
+}
+/** Returns true when at least one file matching `pathSpec` contains a
+ *  heading matching `sectionHeading` (compared after stripping leading `## `). */
+export function snapshotMatchesSection(snapshot, pathSpec, sectionHeading) {
+    const target = sectionHeading.replace(/^##{1,2}\s+/, "").trim();
+    for (const f of snapshot.files) {
+        const ok = pathSpec.includes("*") ? matchScopePath(f.path, [pathSpec]) : f.path === pathSpec;
+        if (!ok)
+            continue;
+        if (f.headings.some((h) => h === target))
+            return true;
+    }
+    return false;
+}
+export function filterSnapshotByScope(snapshot, scopePaths) {
+    return snapshot.files.filter((f) => matchScopePath(f.path, scopePaths));
+}
+//# sourceMappingURL=knowledge-map.js.map

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

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