@aitne/daemon 0.1.8 → 0.1.9

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

@@ -6,10 +6,10 @@
 // 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.
+// This is the ONLY roll-back path. There is no owner-driven approve /
+// reject / revert API — the operator's only manual handle 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
@@ -152,4 +152,3 @@ function computeWeightSince(db, slug, section_id, since, now) {
         weight += weightFor(row, now);
     return weight;
 }
-//# sourceMappingURL=auto-revert.js.map

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

@@ -24,4 +24,3 @@ export declare function exceedsDiffCaps(diff: DiffResult, kind: SectionKind, pre
 /** 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/declarations.d.ts

@@ -29,4 +29,3 @@ export declare function loadSkillCurationContext(skillsRoot: string, slug: strin
 /** 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.js

@@ -167,4 +167,3 @@ export function loadAllCurationDeclarations(skillsRoot) {
     // wiki slugs are enumerated alongside flat skills.
     return listBuiltinSlugs(skillsRoot).map((slug) => loadSkillCurationContext(skillsRoot, slug));
 }
-//# sourceMappingURL=declarations.js.map

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

@@ -23,4 +23,3 @@ export declare function snapshotMatchesPath(snapshot: KnowledgeMapSnapshot, path
  *  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.js

@@ -151,4 +151,3 @@ export function snapshotMatchesSection(snapshot, pathSpec, sectionHeading) {
 export function filterSnapshotByScope(snapshot, scopePaths) {
     return snapshot.files.filter((f) => matchScopePath(f.path, scopePaths));
 }
-//# sourceMappingURL=knowledge-map.js.map

package/dist/core/skill-curation/orphan-overlay.d.ts

@@ -13,8 +13,8 @@ export interface OrphanOverlaysReport {
     orphans: OrphanOverlay[];
     scanned_overlays: number;
 }
-/** Walks `PA_DATA_DIR/skills/overlays/<slug>/*.json` and cross-references each
- *  envelope against the current `curation.json` declaration for that slug.
+/** Walks `PA_DATA_DIR/skill-curation-overlays/<slug>/*.json` and cross-references
+ *  each envelope against the current `curation.json` declaration for that slug.
  *  Returns one record per orphan. Does not mutate disk. */
 export declare function detectOrphanOverlays(dataDir: string, skillsRoot: string): OrphanOverlaysReport;
 /** Boot-time scan: emits one log line per orphan + persists a summary in
@@ -32,4 +32,3 @@ export declare function discardOrphanOverlay(dataDir: string, skillsRoot: string
     ok: false;
     reason: string;
 };
-//# sourceMappingURL=orphan-overlay.d.ts.map

package/dist/core/skill-curation/orphan-overlay.js

@@ -1,7 +1,7 @@
 // P22 §5.4 — orphan overlay detector.
 //
 // An overlay is "orphaned" when its on-disk overlay JSON
-// (`PA_DATA_DIR/skills/overlays/<slug>/<section_id>.json`) has no matching
+// (`PA_DATA_DIR/skill-curation-overlays/<slug>/<section_id>.json`) has no matching
 // declaration in the skill's `curation.json`. This happens when a framework
 // PR removes a section from `curation.json` while a previously-applied
 // overlay still exists on disk for that section.
@@ -26,14 +26,14 @@ import { join } from "node:path";
 import { OverlayEnvelope, } from "@aitne/shared";
 import { readFileSync } from "node:fs";
 import { loadAllCurationDeclarations } from "./declarations.js";
-import { OverlayStore } from "./overlay-store.js";
+import { OverlayStore, SKILL_CURATION_OVERLAYS_DIR } from "./overlay-store.js";
 import { createLogger } from "../../logging.js";
 const logger = createLogger("skill-curation-orphan");
-/** Walks `PA_DATA_DIR/skills/overlays/<slug>/*.json` and cross-references each
- *  envelope against the current `curation.json` declaration for that slug.
+/** Walks `PA_DATA_DIR/skill-curation-overlays/<slug>/*.json` and cross-references
+ *  each envelope against the current `curation.json` declaration for that slug.
  *  Returns one record per orphan. Does not mutate disk. */
 export function detectOrphanOverlays(dataDir, skillsRoot) {
-    const overlaysRoot = join(dataDir, "skills", "overlays");
+    const overlaysRoot = join(dataDir, SKILL_CURATION_OVERLAYS_DIR);
     if (!existsSync(overlaysRoot))
         return { orphans: [], scanned_overlays: 0 };
     const declarations = new Map();
@@ -164,4 +164,3 @@ export function discardOrphanOverlay(dataDir, skillsRoot, slug, sectionId) {
     logger.info({ slug, section_id: sectionId, reason: orphan.reason }, "skill_curation.declaration.orphan_overlay_discarded");
     return { ok: true, discarded_path: orphan.overlay_path };
 }
-//# sourceMappingURL=orphan-overlay.js.map

package/dist/core/skill-curation/overlay-store.d.ts

@@ -1,10 +1,13 @@
 import { type CurationPayloadValue, type OverlayEnvelopeValue, type SectionKind } from "@aitne/shared";
+/** Operational overlay root under PA_DATA_DIR. Shared with `orphan-overlay.ts`
+ *  and the migration runner — kept out of the vault per v4 V11. */
+export declare const SKILL_CURATION_OVERLAYS_DIR = "skill-curation-overlays";
 export interface OverlayStorePaths {
-    /** PA_DATA_DIR / skills / overlays / <slug> */
+    /** PA_DATA_DIR / skill-curation-overlays / <slug> */
     overlaysDir(slug: string): string;
-    /** PA_DATA_DIR / skills / overlays / <slug> / <section_id>.json */
+    /** PA_DATA_DIR / skill-curation-overlays / <slug> / <section_id>.json */
     overlayPath(slug: string, sectionId: string): string;
-    /** PA_DATA_DIR / skills / overlays / <slug> / history / <proposal_id>.json */
+    /** PA_DATA_DIR / skill-curation-overlays / <slug> / history / <proposal_id>.json */
     historyPath(slug: string, proposalId: number): string;
     /** agent-assets / skills / <slug> / curation.seed.json */
     seedPath(slug: string, sectionId: string): string;
@@ -38,4 +41,3 @@ export declare function payloadHash(payload: CurationPayloadValue): string;
  *  through the (currently empty) migrator chain. */
 export declare function migrateOverlay(env: OverlayEnvelopeValue): OverlayEnvelopeValue;
 export declare function isKnownSectionKind(value: string): value is SectionKind;
-//# sourceMappingURL=overlay-store.d.ts.map

package/dist/core/skill-curation/overlay-store.js

@@ -1,9 +1,12 @@
 // P22 §1.5, §5.4 — overlay store.
 //
-// Layout (under PA_DATA_DIR):
+// Layout (under PA_DATA_DIR — CONTEXT_VAULT_REDESIGN_PLAN.md v4 V11 moved
+// these out of `<dataDir>/skills/overlays/` because overlays are operational
+// metadata, not vault content; user skill MD files moved into the vault at
+// `<contextDir>/policies/skills/` but the JSON envelopes stay here):
 //
-//   ~/.personal-agent/skills/overlays/<slug>/<section_id>.json   ← active overlay
-//   ~/.personal-agent/skills/overlays/<slug>/history/<proposal_id>.json
+//   ~/.personal-agent/skill-curation-overlays/<slug>/<section_id>.json   ← active overlay
+//   ~/.personal-agent/skill-curation-overlays/<slug>/history/<proposal_id>.json
 //
 // Read precedence at session-materialization time:
 //
@@ -20,6 +23,9 @@ import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
 import { dirname, join } from "node:path";
 import { CurationPayload, OverlayEnvelope, SECTION_KINDS, SKILL_CURATION_SCHEMA_VERSION, } from "@aitne/shared";
+/** Operational overlay root under PA_DATA_DIR. Shared with `orphan-overlay.ts`
+ *  and the migration runner — kept out of the vault per v4 V11. */
+export const SKILL_CURATION_OVERLAYS_DIR = "skill-curation-overlays";
 export class OverlayStore {
     dataDir;
     skillsRoot;
@@ -32,9 +38,9 @@ export class OverlayStore {
         this.skillsRoot = skillsRoot;
     }
     paths = {
-        overlaysDir: (slug) => join(this.dataDir, "skills", "overlays", slug),
-        overlayPath: (slug, sectionId) => join(this.dataDir, "skills", "overlays", slug, `${sectionId}.json`),
-        historyPath: (slug, proposalId) => join(this.dataDir, "skills", "overlays", slug, "history", `${proposalId}.json`),
+        overlaysDir: (slug) => join(this.dataDir, SKILL_CURATION_OVERLAYS_DIR, slug),
+        overlayPath: (slug, sectionId) => join(this.dataDir, SKILL_CURATION_OVERLAYS_DIR, slug, `${sectionId}.json`),
+        historyPath: (slug, proposalId) => join(this.dataDir, SKILL_CURATION_OVERLAYS_DIR, slug, "history", `${proposalId}.json`),
         seedPath: (slug, sectionId) => join(this.skillsRoot, slug, "seeds", `${sectionId}.seed.json`),
     };
     hasOverlay(slug, sectionId) {
@@ -140,4 +146,3 @@ export function migrateOverlay(env) {
 export function isKnownSectionKind(value) {
     return SECTION_KINDS.includes(value);
 }
-//# sourceMappingURL=overlay-store.js.map

package/dist/core/skill-curation/render/convention-notes.d.ts

@@ -1,4 +1,3 @@
 import type { ConventionNotesValue } from "@aitne/shared";
 export declare const RENDERER_VERSION = "convention_notes/1";
 export declare function renderConventionNotes(payload: ConventionNotesValue): string;
-//# sourceMappingURL=convention-notes.d.ts.map

package/dist/core/skill-curation/render/convention-notes.js

@@ -10,4 +10,3 @@ export function renderConventionNotes(payload) {
     })
         .join("\n");
 }
-//# sourceMappingURL=convention-notes.js.map

package/dist/core/skill-curation/render/cross-references.d.ts

@@ -1,4 +1,3 @@
 import type { CrossReferencesValue } from "@aitne/shared";
 export declare const RENDERER_VERSION = "cross_references/1";
 export declare function renderCrossReferences(payload: CrossReferencesValue): string;
-//# sourceMappingURL=cross-references.d.ts.map

package/dist/core/skill-curation/render/cross-references.js

@@ -7,4 +7,3 @@ export function renderCrossReferences(payload) {
         .map((ref) => `- \`${ref.from_path}\` ↔ \`${ref.to_path}\` — ${ref.relation}`)
         .join("\n");
 }
-//# sourceMappingURL=cross-references.js.map

package/dist/core/skill-curation/render/frontmatter-schema.d.ts

@@ -1,4 +1,3 @@
 import type { FrontmatterSchemaValue } from "@aitne/shared";
 export declare const RENDERER_VERSION = "frontmatter_schema/1";
 export declare function renderFrontmatterSchema(payload: FrontmatterSchemaValue): string;
-//# sourceMappingURL=frontmatter-schema.d.ts.map

package/dist/core/skill-curation/render/frontmatter-schema.js

@@ -22,4 +22,3 @@ export function renderFrontmatterSchema(payload) {
     }
     return blocks.join("\n\n");
 }
-//# sourceMappingURL=frontmatter-schema.js.map

package/dist/core/skill-curation/render/index.d.ts

@@ -2,4 +2,3 @@ import type { CurationPayloadValue, SectionKind } from "@aitne/shared";
 export declare const RENDERER_VERSIONS: Record<SectionKind, string>;
 export declare function rendererVersionFor(kind: SectionKind): string;
 export declare function renderCurationSection(kind: SectionKind, payload: CurationPayloadValue): string;
-//# sourceMappingURL=index.d.ts.map

package/dist/core/skill-curation/render/index.js

@@ -39,4 +39,3 @@ export function renderCurationSection(kind, payload) {
             return renderCrossReferences(payload);
     }
 }
-//# sourceMappingURL=index.js.map

package/dist/core/skill-curation/render/knowledge-layout.d.ts

@@ -1,4 +1,3 @@
 import type { KnowledgeLayoutValue } from "@aitne/shared";
 export declare const RENDERER_VERSION = "knowledge_layout/1";
 export declare function renderKnowledgeLayout(payload: KnowledgeLayoutValue): string;
-//# sourceMappingURL=knowledge-layout.d.ts.map

package/dist/core/skill-curation/render/knowledge-layout.js

@@ -33,4 +33,3 @@ export function renderKnowledgeLayout(payload) {
     }
     return files.map(renderBullet).join("\n");
 }
-//# sourceMappingURL=knowledge-layout.js.map

package/dist/core/skill-curation/render/routing-table.d.ts

@@ -1,4 +1,3 @@
 import type { RoutingTableValue } from "@aitne/shared";
 export declare const RENDERER_VERSION = "routing_table/1";
 export declare function renderRoutingTable(payload: RoutingTableValue): string;
-//# sourceMappingURL=routing-table.d.ts.map

package/dist/core/skill-curation/render/routing-table.js

@@ -34,4 +34,3 @@ export function renderRoutingTable(payload) {
     })
         .join("\n");
 }
-//# sourceMappingURL=routing-table.js.map

package/dist/core/skill-curation/render/search-recipes.d.ts

@@ -1,4 +1,3 @@
 import type { SearchRecipesValue } from "@aitne/shared";
 export declare const RENDERER_VERSION = "search_recipes/1";
 export declare function renderSearchRecipes(payload: SearchRecipesValue): string;
-//# sourceMappingURL=search-recipes.d.ts.map

package/dist/core/skill-curation/render/search-recipes.js

@@ -36,4 +36,3 @@ export function renderSearchRecipes(payload) {
     })
         .join("\n");
 }
-//# sourceMappingURL=search-recipes.js.map

package/dist/core/skill-curation/run-token.d.ts

@@ -24,4 +24,3 @@ export declare class RunTokenManager {
         error: RunTokenError;
     }>;
 }
-//# sourceMappingURL=run-token.d.ts.map

package/dist/core/skill-curation/run-token.js

@@ -78,4 +78,3 @@ function constantTimeEquals(a, b) {
         return false;
     return timingSafeEqual(ab, bb);
 }
-//# sourceMappingURL=run-token.js.map

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

@@ -46,4 +46,3 @@ export interface SelectionOptions {
     now?: number;
 }
 export declare function selectSkillsForRun(db: Database.Database, options?: SelectionOptions): SkillSelection[];
-//# sourceMappingURL=signals.d.ts.map

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

@@ -146,4 +146,3 @@ function isOnCooldown(db, skillSlug, now, appliedCooldownMs, revertedCooldownMs)
         return true;
     return false;
 }
-//# sourceMappingURL=signals.js.map

package/dist/core/skill-curation/smoke-test.d.ts

@@ -36,4 +36,3 @@ export interface RunSmokeTestInput {
     siblingPayloads?: Record<string, CurationPayloadValue>;
 }
 export declare function runSmokeTest(input: RunSmokeTestInput): SmokeResult;
-//# sourceMappingURL=smoke-test.d.ts.map

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

@@ -310,4 +310,3 @@ function stripHeading(s) {
 function truncate(s, n) {
     return s.length <= n ? s : s.slice(0, n) + "…";
 }
-//# sourceMappingURL=smoke-test.js.map

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

@@ -13,4 +13,3 @@ export declare function spliceCurationAnchors(md: string, resolveOverlay: Resolv
     knownSectionIds?: Set<string>;
 }): SpliceResult;
 export declare function hasCurationAnchors(md: string): boolean;
-//# sourceMappingURL=splicer.d.ts.map

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

@@ -75,4 +75,3 @@ export function spliceCurationAnchors(md, resolveOverlay, options = {}) {
 export function hasCurationAnchors(md) {
     return ANCHOR_RE.test(md);
 }
-//# sourceMappingURL=splicer.js.map

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

@@ -37,4 +37,3 @@ export interface OptimizerWorkdir {
 }
 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.js

@@ -239,4 +239,3 @@ function summarizeWorkdir(targetSkills, decls, fileCount) {
         "- `.claude/skills/` — your three working skills (read-only references)",
     ].join("\n");
 }
-//# sourceMappingURL=workdir.js.map

package/dist/core/skill-source-paths.d.ts

@@ -11,4 +11,3 @@ export declare function listBuiltinSkillDirs(skillsRoot: string): ReadonlyArray<
     slug: string;
     dir: string;
 }>;
-//# sourceMappingURL=skill-source-paths.d.ts.map

package/dist/core/skill-source-paths.js

@@ -79,4 +79,3 @@ export function listBuiltinSlugs(skillsRoot) {
 export function listBuiltinSkillDirs(skillsRoot) {
     return walkSlugDirs(skillsRoot);
 }
-//# sourceMappingURL=skill-source-paths.js.map

package/dist/core/skills-compiler-cli-renderer.d.ts

@@ -0,0 +1,79 @@
+import { type BackendId } from "@aitne/shared";
+import type { SessionInstructionParams } from "./skills-compiler-types.js";
+/**
+ * Return the backend-specific dotfile namespace name for a given backend's
+ * skill directory, **without** the trailing `skills` segment — callers
+ * join `skills` themselves. Returns `null` only for Claude (which is
+ * dispatched through `materializeClaudeSession` and writes
+ * `<sessionDir>/.claude/skills/` directly).
+ *
+ * docs/design/appendices/skills-unification.md Phase 1 — every non-Claude backend now writes
+ * to its own brand-aligned namespace:
+ *   - `codex`    → `.codex`
+ *   - `gemini`   → `.gemini`
+ *   - `opencode` → `.opencode` (V2 path (c); flipped from prior `.claude/`
+ *                  redundancy-avoiding alias).
+ */
+export declare function cliSkillsDirName(backendId: BackendId): string | null;
+/**
+ * Return the CLI instruction-file name for a given backend. Codex and
+ * OpenCode both auto-discover `AGENTS.md` from cwd; Gemini reads
+ * `GEMINI.md`. Throws for `claude` — the Claude SDK consumes a per-cwd
+ * `CLAUDE.md` written by `materializeClaudeSession`, not an instruction
+ * file from this helper.
+ *
+ * Single helper so the choice is consistent between the wide
+ * `materializeCliSession` and the slim `materializeFetchWindowCliSession`
+ * paths (docs/design/appendices/fetch-window-cost-reduction.md §4.5.7).
+ */
+export declare function cliInstructionFileName(backendId: Exclude<BackendId, "claude">): "AGENTS.md" | "GEMINI.md";
+/**
+ * Rewrite the `## Character (user-defined)` block inside every backend
+ * instruction file that currently lives in `workdir`. Used by the
+ * `PATCH /api/config` live-overwrite path (§15.6.1) so an owner editing
+ * character on the dashboard doesn't have to wait for the next session
+ * spawn for the change to land.
+ *
+ * Multi-backend aware: a workdir that has seen a Claude→Codex fallback
+ * contains both CLAUDE.md and AGENTS.md, and both must end up byte-
+ * identical in their character block. Each write is atomic (tmp +
+ * rename, both on the same filesystem so rename stays cheap) and
+ * per-file errors are logged without failing the whole call.
+ *
+ * Returns a summary of how many files were rewritten. Useful for
+ * instrumentation and for the dashboard PATCH handler to log.
+ *
+ * The helper is an FS wrapper: its pure parse/compose half lives in
+ * `character-block.ts` and is covered 100% there. This side is excluded
+ * from coverage along with the rest of `skills-compiler.ts`.
+ */
+export declare function rewriteCharacterBlock(workdir: string, character: string): {
+    rewritten: number;
+    skipped: number;
+    failed: number;
+};
+export declare function renderCliInstructionFile(params: SessionInstructionParams): string;
+/**
+ * Daemon-API usage section. Pulled by `renderCliInstructionFile` for CLI
+ * backends (passing `params.backendId !== "codex"`) and by
+ * `SkillsCompiler.materializeClaudeSession` for the Claude SDK path
+ * (always `true` — Claude holds the read-sensitive token). The single
+ * source of truth keeps the rendered prose byte-identical across all four
+ * backends.
+ */
+export declare function renderDaemonApiUsageSection(readSensitiveAvailable: boolean): string;
+/**
+ * docs/design/appendices/skills-unification.md Phase 1 §"Codex read-sensitive banner
+ * inheritance" — prepend the 3-line caveat banner to a Codex skill body
+ * whose contents reference any read-sensitive `/api/*` endpoint. The
+ * banner sits immediately after the YAML frontmatter (so the frontmatter
+ * parser on the agent side still picks up `name`/`description`/
+ * `allowed-tools` first) and is idempotent — re-running on an already-
+ * banner-bearing file is a no-op (the HTML-comment sentinel lets us
+ * detect prior insertion without false positives from user prose).
+ *
+ * No-op when:
+ *  - The skill body references zero read-sensitive endpoints.
+ *  - The banner is already present (sentinel hit).
+ */
+export declare function prependCodexReadSensitiveBanner(skillMdPath: string): void;