@aitne/daemon 0.1.8 → 0.1.10

package/dist/core/context-paths.js

@@ -1,210 +1,297 @@
 import { join } from "node:path";
 /**
- * Canonical path constants for the vault layout (B-007 §5.1, shipped).
- * Every daemon module that references files inside `~/.personal-agent/context/`
- * imports from here instead of hardcoding strings. The full tree is
- * documented in `docs/design/06-memory.md`.
+ * Canonical path constants for the vault layout
+ * (CONTEXT_VAULT_REDESIGN_PLAN.md §3 — six authority classes).
+ *
+ * Every daemon module that references files inside the vault imports
+ * symbols from here instead of hardcoding strings. Symbol names are
+ * preserved across the restructure (CONTEXT_VAULT_REDESIGN_PLAN.md §14.1)
+ * — only the values move. That keeps 37+ importers "automatically"
+ * pointing at the new layout once this module flips.
  *
  * Two layers:
- *  - `CONTEXT_RELATIVE_PATHS` — relative paths for DB / API / wikilink uses
- *    (no leading slash, kept stable across clean reinstall).
+ *  - `CONTEXT_RELATIVE_PATHS` — relative paths for DB / API / wikilink
+ *    uses (no leading slash).
  *  - Helper `fullPath(contextDir, relativePath)` — joins against runtime
  *    `contextDir` (usually `~/.personal-agent/context`).
+ *
+ * Backward-compatibility for HTTP callers happens at the API layer via
+ * `core/context-vault-aliases.ts:aliasVaultPath`. This file ships the
+ * canonical destinations only.
  */
 export const CONTEXT_RELATIVE_PATHS = {
     rootIndex: "_index.md",
-    today: "today.md",
-    yesterday: "yesterday.md",
-    roadmap: "roadmap.md",
-    contextIndex: "context-index.md",
+    // ── state/ ────────────────────────────────────────────────────
+    today: "state/today.md",
+    yesterday: "state/yesterday.md",
+    // Reconciler-merged index. The legacy top-level `context-index.md`
+    // is folded into `_index.md`'s `<!-- reconciler-section -->` block
+    // by the vault-restructure migration; the standalone path is gone.
+    // Kept as a stem alias for code that snapshots by `contextIndex`.
+    contextIndex: "_index.md",
+    // ── identity/ ← user/ ────────────────────────────────────────
     user: {
-        index: "user/_index.md",
-        profile: "user/profile.md",
-        people: "user/people.md",
-        work: "user/work.md",
-        expertise: "user/expertise.md",
-        personal: "user/personal.md",
-        goals: "user/goals.md",
+        index: "identity/_index.md",
+        profile: "identity/profile.md",
+        people: "identity/people.md",
+        work: "identity/work.md",
+        expertise: "identity/expertise.md",
+        personal: "identity/personal.md",
+        goals: "identity/goals.md",
     },
+    // ── policies/ ← rules/ + routines/ ───────────────────────────
     rules: {
-        index: "rules/_index.md",
-        management: "rules/management.md",
-        mcp: "rules/mcp.md",
-        journalFormat: "rules/journal-format.md",
-        journalExport: "rules/journal-export.md",
-        redaction: "rules/redaction.md",
-        policiesDir: "rules/policies",
-        policiesIndex: "rules/policies/_index.md",
+        index: "policies/_index.md",
+        management: "policies/management.md",
+        mcp: "policies/mcp.md",
+        journalFormat: "policies/journal-format.md",
+        journalExport: "policies/journal-export.md",
+        redaction: "policies/redaction.md",
+        /**
+         * `policies/management-captures/` — per
+         * MANAGEMENT-POLICY-CAPTURE-PLAN §4.1, originally lived at
+         * `rules/policies/`. Renamed in lockstep with the six-class move // drift-allow
+         * to avoid the `policies/policies/` anti-pattern and to make the
+         * directory name self-documenting.
+         */
+        policiesDir: "policies/management-captures",
+        policiesIndex: "policies/management-captures/_index.md",
     },
     routines: {
-        index: "routines/_index.md",
-        hourly: "routines/hourly.md",
-        morning: "routines/morning.md",
-        evening: "routines/evening.md",
-        weekly: "routines/weekly.md",
-        monthly: "routines/monthly.md",
-        customDir: "routines/custom",
+        index: "policies/routines/_index.md",
+        hourly: "policies/routines/hourly.md",
+        morning: "policies/routines/morning.md",
+        evening: "policies/routines/evening.md",
+        weekly: "policies/routines/weekly.md",
+        monthly: "policies/routines/monthly.md",
+        customDir: "policies/routines/custom",
     },
+    // `~/.personal-agent/integrations.md` moved under `policies/`.
+    integrations: "policies/integrations.md",
+    // Feedback Learning Loop (FEEDBACK_LEARNING_LOOP_DESIGN.md §3.3) —
+    // global `agent`-scope lessons store, lazy-created on first nightly
+    // consolidation write. Per-agent (`agent:<slug>`) lessons live next to
+    // the agent definition under `policies/agents/<slug>/lessons.md` (Phase 4).
+    agentLessons: "policies/agent-lessons.md",
+    // User-registered skill bundles (lazy-created).
+    skillsDir: "policies/skills",
+    // ── plans/ ← projects/ + roadmap.md ──────────────────────────
+    roadmap: "plans/roadmap.md",
     projects: {
-        index: "projects/_index.md",
-        activeBase: "projects/_active.base",
-        dir: "projects",
+        index: "plans/projects/_index.md",
+        activeBase: "plans/projects/_active.base",
+        dir: "plans/projects",
     },
-    /**
-     * @deprecated Legacy lightweight git-repo registry path. Replaced by the
-     * `git/<slug>/overview.md` layout (docs/design/appendices/unified-repositories.md
-     * §4.5). Kept as a const for transitional reads only — new writes go to
-     * `git/<slug>/`.
-     */
-    gitRepos: {
-        dir: "git-repos",
+    // ── knowledge/repos/ ← git/<slug>/ overview ──────────────────
+    git: {
+        dir: "knowledge/repos",
     },
     /**
-     * Unified repositories — per-repo project overview + per-day journal.
-     * See `docs/design/appendices/unified-repositories.md` §4.5.
+     * @deprecated Legacy lightweight git-repo registry path. Replaced by
+     * the unified `knowledge/repos/<slug>/overview.md` layout. Pre-existing
+     * vaults preserve `git-repos/` content under
+     * `knowledge/repos/legacy-registry/`; no new code writes here.
      */
-    git: {
-        dir: "git",
+    gitRepos: {
+        dir: "knowledge/repos/legacy-registry",
     },
-    daily: { dir: "daily" },
-    weekly: { dir: "weekly" },
-    monthly: { dir: "monthly" },
+    // ── journal/ ← daily/ + weekly/ + monthly/ + agent/journal.md +
+    //              git/<slug>/journal/ ─────────────────────────────
+    daily: { dir: "journal/daily" },
+    weekly: { dir: "journal/weekly" },
+    monthly: { dir: "journal/monthly" },
+    // ── knowledge/dossiers/ ← dossiers/ ──────────────────────────
     dossiers: {
-        index: "dossiers/_index.md",
-        dir: "dossiers",
+        index: "knowledge/dossiers/_index.md",
+        dir: "knowledge/dossiers",
     },
-    inbox: { dir: "inbox" },
+    // ── state/ subpaths ──────────────────────────────────────────
+    inbox: { dir: "state/inbox" },
     agent: {
-        journal: "agent/journal.md",
-        scratchDir: "agent/scratch",
+        /** Agent decision log; CREATE_ONLY_PUT + append-only PATCH. */
+        journal: "journal/agent.md",
+        /** 48h-TTL agent scratch dir (state/scratch/YYYY-MM-DD-<slug>.md). */
+        scratchDir: "state/scratch",
+        /** Profile-question queue — agent-owned operational state. */
+        profileQuestions: "state/profile-questions.md",
     },
+    // Generated 90-day activity views written by the activity reconciler.
+    activityDir: "state/activity",
+    // ── knowledge/entities/ — management registry surface ────────
+    entitiesDir: "knowledge/entities",
+    // ── knowledge/wiki/ ← <dataDir>/wiki/ ────────────────────────
+    wikiDir: "knowledge/wiki",
 };
 /**
- * Directory names (no trailing slash) allowed under context/ for listing /
- * validation. Used by API route whitelists and reinstall planner.
+ * Directory names (no trailing slash) the daemon creates under
+ * contextDir on `initDirectories`. Listed in dependency order so
+ * `mkdir -p` resolves nested entries.
+ *
+ * Each of the six classes is present here so a fresh install lands on
+ * the new layout before any migration runs. The
+ * CONTEXT_VAULT_REDESIGN_PLAN.md v4.1 V18 invariant pins this: step 4
+ * (`bootstrapManagementMd`) writes `<contextDir>/policies/integrations.md`
+ * and runs before `ensureSkeletonFiles`, so `policies/` MUST exist by
+ * the time `initDirectories` completes.
  */
 export const CONTEXT_DIR_NAMES = [
-    "user",
-    "rules",
-    "rules/policies",
-    "routines",
-    "routines/custom",
-    "projects",
-    "git-repos",
-    "git",
-    "daily",
-    "weekly",
-    "monthly",
-    "dossiers",
-    "inbox",
-    "agent",
-    "agent/scratch",
+    "identity",
+    "state",
+    "state/inbox",
+    "state/scratch",
+    "state/activity",
+    "plans",
+    "plans/projects",
+    "journal",
+    "journal/daily",
+    "journal/weekly",
+    "journal/monthly",
+    "journal/repos",
+    "knowledge",
+    "knowledge/dossiers",
+    "knowledge/wiki",
+    "knowledge/repos",
+    "knowledge/entities",
+    "policies",
+    "policies/routines",
+    "policies/routines/custom",
+    "policies/management-captures",
+    "policies/skills",
 ];
 /**
- * File types permitted inside context/. `.md` for all human-editable prose;
- * `.base` for Obsidian Bases views (B-007 §11).
+ * File types permitted inside context/. `.md` for all human-editable
+ * prose; `.base` for Obsidian Bases views.
  */
 export const CONTEXT_FILE_EXTENSIONS = [".md", ".base"];
 /**
- * Relative paths that are stored on disk as `.base` files. The context API
- * accepts these with or without the trailing extension and must never
- * silently fall back to a `.md` sibling.
+ * Relative paths that are stored on disk as `.base` files. The context
+ * API accepts these with or without the trailing extension and must
+ * never silently fall back to a `.md` sibling.
  */
 export const CONTEXT_BASE_FILE_STEMS = [
     CONTEXT_RELATIVE_PATHS.projects.activeBase.replace(/\.base$/, ""),
 ];
 /**
- * Relative path to a daily synthesized journal file. The morning routine
- * writes this every 04:00 (B-007 §5.9).
+ * Relative path to a daily synthesized journal file. The morning
+ * routine writes this every 04:00.
  */
 export function dailyJournalPath(dateStr) {
-    return `daily/${dateStr}.md`;
+    return `journal/daily/${dateStr}.md`;
 }
 /**
  * Relative path to a weekly review file (ISO year-week format, e.g. 2026-W16).
  */
 export function weeklyReviewPath(isoYearWeek) {
-    return `weekly/${isoYearWeek}.md`;
+    return `journal/weekly/${isoYearWeek}.md`;
 }
 /**
  * Relative path to a monthly review file (YYYY-MM).
  */
 export function monthlyReviewPath(yearMonth) {
-    return `monthly/${yearMonth}.md`;
+    return `journal/monthly/${yearMonth}.md`;
 }
 /**
  * Relative path to a project file by slug (kebab-case, no extension).
  */
 export function projectPath(slug) {
-    return `projects/${slug}.md`;
+    return `plans/projects/${slug}.md`;
 }
 /**
  * Relative path to a lightweight git repository registry file.
  *
- * @deprecated Use `gitRepoOverviewPath(slug)` from the unified-repositories
- * layout. This helper is retained transitionally for reading legacy files
- * left behind in pre-cutover vaults.
+ * @deprecated Use `gitRepoOverviewPath(slug)`. Retained for reading the
+ * pre-restructure legacy entries preserved under
+ * `knowledge/repos/legacy-registry/`.
  */
 export function gitRepoPath(slug) {
-    return `git-repos/${slug}.md`;
+    return `knowledge/repos/legacy-registry/${slug}.md`;
 }
 /**
- * Relative path to the project-level overview MD for a unified repository.
- * Written by `git.project.init` and updated when something durable
- * changes during a daily scan. See appendix §4.5.
+ * Relative path to the project-level overview MD for a unified
+ * repository.
  */
 export function gitRepoOverviewPath(slug) {
-    return `git/${slug}/overview.md`;
+    return `knowledge/repos/${slug}/overview.md`;
 }
 /**
- * Relative path to the per-day git journal entry for a unified repository.
- * Written by `git.project.update` (daily scan) when the day had activity.
+ * Relative path to the per-day git journal entry for a unified
+ * repository.
  */
 export function gitRepoJournalPath(slug, dateStr) {
-    return `git/${slug}/journal/${dateStr}.md`;
+    return `journal/repos/${slug}/${dateStr}.md`;
 }
 /**
  * Relative path to a custom routine definition.
  */
 export function customRoutinePath(slug) {
-    return `routines/custom/${slug}.md`;
+    return `policies/routines/custom/${slug}.md`;
+}
+/**
+ * Relative path to an Agent's per-agent (`agent:<slug>`) feedback lessons store
+ * (FEEDBACK_LEARNING_LOOP_DESIGN.md §3.3, Phase 4). Sits next to the agent
+ * definition at `policies/agents/<slug>/agent.md`; lazy-created on the first
+ * nightly consolidation write and injected only into that agent's own
+ * executions. The slug is assumed pre-validated (`isSafeAgentSlug`); this
+ * helper does not re-validate — it only composes the canonical path.
+ */
+export function agentLessonsPath(slug) {
+    return `policies/agents/${slug}/lessons.md`;
 }
 /**
  * Relative path to a dossier file for a given flow slug.
  */
 export function dossierPath(flowSlug) {
-    return `dossiers/${flowSlug}.md`;
+    return `knowledge/dossiers/${flowSlug}.md`;
 }
 /**
- * Relative path to a management policy file
+ * Relative path to a management policy capture file
  * (MANAGEMENT-POLICY-CAPTURE-PLAN §4.1). Slug must match the validator's
  * kebab-case pattern; this helper does not re-validate.
  */
 export function policyPath(slug) {
-    return `rules/policies/${slug}.md`;
+    return `policies/management-captures/${slug}.md`;
 }
 /**
- * Relative path for an agent scratch file (ephemeral, 48h TTL — B-007 §5.3).
+ * Relative path for an agent scratch file (ephemeral, 48h TTL).
  */
 export function agentScratchPath(dateStr, slug) {
-    return `agent/scratch/${dateStr}-${slug}.md`;
+    return `state/scratch/${dateStr}-${slug}.md`;
 }
 /**
  * Relative path for an inbox dump file (user-pasted memo, morning triage).
  */
 export function inboxPath(dateStr, slug) {
-    return `inbox/${dateStr}-${slug}.md`;
+    return `state/inbox/${dateStr}-${slug}.md`;
+}
+/**
+ * Relative path to a 90-day Activity view file.
+ */
+export function activityViewPath(source) {
+    return `state/activity/${source}.md`;
+}
+/**
+ * Relative path to a management-registry entity file.
+ */
+export function entityPath(domain, typePlural, slug) {
+    return `knowledge/entities/${domain}/${typePlural}/${slug}.md`;
+}
+/**
+ * Relative path to a management-registry domain index.
+ */
+export function entityDomainIndexPath(domain) {
+    return `knowledge/entities/${domain}/_index.md`;
 }
 /**
- * Join a relative context path with the runtime contextDir to produce an
- * absolute filesystem path.
+ * Join a relative context path with the runtime contextDir to produce
+ * an absolute filesystem path.
  */
 export function fullPath(contextDir, relativePath) {
     return join(contextDir, relativePath);
 }
 /**
- * Return true if the relative path is one of the user-area files B-006/B-007
- * expect to exist post-setup. Used by validators and dashboard tree views.
+ * Return true if the relative path is one of the identity-area files
+ * post-setup expects to exist. Used by validators and dashboard tree
+ * views.
  */
 export const USER_AREA_FILE_PATHS = [
     CONTEXT_RELATIVE_PATHS.user.profile,
@@ -219,8 +306,12 @@ export function isKnownUserAreaFile(relativePath) {
     return USER_AREA_FILES.has(relativePath);
 }
 /**
- * B-007 §6 — type field values for common frontmatter. Used by schema
- * validators and Bases view definitions.
+ * Frontmatter `type:` field values used by schema validators and Bases
+ * view definitions. CONTEXT_VAULT_REDESIGN_PLAN.md §5.2 keeps this
+ * legacy enum alongside the new `kind:` field — both coexist during
+ * the Phase 1 → Phase 2 transition. New entity shapes that ride along
+ * with the restructure (management registry meetings/trips/etc, agent
+ * profile-question queue, activity-log views) are listed here.
  */
 export const CONTEXT_FRONTMATTER_TYPES = [
     "project",
@@ -237,5 +328,12 @@ export const CONTEXT_FRONTMATTER_TYPES = [
     "journal-entry",
     "scratch",
     "inbox",
+    // Added in lockstep with the vault restructure (v4 V10).
+    "agent_questions",
+    "activity-log",
+    "meeting",
+    "trip",
+    "receipt",
+    "book",
+    "note",
 ];
-//# sourceMappingURL=context-paths.js.map

package/dist/core/context-staleness.d.ts

@@ -42,4 +42,3 @@ export declare function resolvePromptContextStaleness(input: {
     setupInProgress: boolean;
 }): PromptContextStalenessDecision;
 export declare function applyPromptContextStaleness(input: PromptContextStalenessInput, opts: ApplyPromptContextStalenessOptions): PromptContextStalenessDecision;
-//# sourceMappingURL=context-staleness.d.ts.map

package/dist/core/context-staleness.js

@@ -14,7 +14,7 @@ export function normalizeContextSection(section) {
 export function classifyContextWriteStaleness(input) {
     const path = normalizeContextWritePath(input.path);
     const section = normalizeContextSection(input.section);
-    if (path === "today" && input.method === "PATCH") {
+    if (path === "state/today" && input.method === "PATCH") {
         if (section === "agent_log") {
             return {
                 tier: "quiet",
@@ -31,7 +31,7 @@ export function classifyContextWriteStaleness(input) {
             };
         }
     }
-    if (path.startsWith("projects/")
+    if (path.startsWith("plans/projects/")
         && input.method === "PATCH"
         && QUIET_PROJECT_ACTIVITY_SECTIONS.has(section)) {
         return {
@@ -85,4 +85,3 @@ function looksLikeAgentLogEntry(content) {
         return false;
     return /^-\s*(?:\d{2}:\d{2}\b|\[[a-z0-9_.:-]+\s+\d{2}:\d{2}\])/i.test(firstLine);
 }
-//# sourceMappingURL=context-staleness.js.map

package/dist/core/context-validation/frontmatter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Frontmatter parser for the six-class vault contract
+ * (CONTEXT_VAULT_REDESIGN_PLAN.md §5).
+ *
+ * Parses the advisory `kind` / `authority` / `mutability` / `slug` / `title`
+ * fields from a Markdown file's YAML frontmatter and returns structured
+ * advisories that the daemon's write-step uses to log warnings.
+ *
+ * **Phase 1 contract (advisory only).** A missing or malformed field logs
+ * a warning and proceeds; nothing rejects the write. The Phase 2 cut-over
+ * is gated behind `runtimeSettings.contextVault.enforceFrontmatter` (not
+ * exposed yet) — when that lands, the same advisory shape will become a
+ * 4xx structured-error response.
+ *
+ * **Coexistence with `context-frontmatter.ts`.** The legacy validator
+ * (`type`, `owner`, `updated`, plus daily-skeleton / policy-file rules)
+ * is unchanged and remains the strict gate for the surfaces it already
+ * covers. The new parser is additive: it reads the new fields without
+ * interpreting the old ones, so a file can carry both shapes during the
+ * Phase 1 → Phase 2 transition. The single YAML extractor is shared via
+ * `readContextFrontmatterValues` so the two paths cannot diverge on what
+ * they consider "frontmatter."
+ */
+/** Class — top-level directory class in the six-class layout. */
+export declare const VAULT_FRONTMATTER_KINDS: readonly ["identity", "state", "plan", "journal", "knowledge", "policy"];
+export type VaultFrontmatterKind = (typeof VAULT_FRONTMATTER_KINDS)[number];
+/** Authority — who owns the file. */
+export declare const VAULT_FRONTMATTER_AUTHORITIES: readonly ["user", "agent", "mixed"];
+export type VaultFrontmatterAuthority = (typeof VAULT_FRONTMATTER_AUTHORITIES)[number];
+/** Mutability — how writes are permitted to modify the file. */
+export declare const VAULT_FRONTMATTER_MUTABILITIES: readonly ["replace", "patch", "append", "readonly"];
+export type VaultFrontmatterMutability = (typeof VAULT_FRONTMATTER_MUTABILITIES)[number];
+/**
+ * Parsed vault frontmatter. Every field is optional in Phase 1 — a file
+ * without any of the new fields produces an object where every property
+ * is `undefined`. Field-level advisories surface in `advisories`.
+ */
+export interface VaultFrontmatter {
+    kind?: VaultFrontmatterKind;
+    authority?: VaultFrontmatterAuthority;
+    mutability?: VaultFrontmatterMutability;
+    slug?: string;
+    title?: string;
+}
+export type VaultFrontmatterAdvisoryCode = "missing_frontmatter" | "missing_kind" | "missing_authority" | "missing_mutability" | "invalid_kind" | "invalid_authority" | "invalid_mutability" | "kind_path_mismatch" | "invalid_slug";
+export interface VaultFrontmatterAdvisory {
+    code: VaultFrontmatterAdvisoryCode;
+    message: string;
+}
+export interface VaultFrontmatterParseResult {
+    values: VaultFrontmatter;
+    advisories: VaultFrontmatterAdvisory[];
+}
+/**
+ * Parse the optional vault frontmatter from a Markdown file. Returns the
+ * parsed values plus a list of advisories that callers (the write-step
+ * chokepoint) translate into structured log warnings.
+ *
+ * `relativePath` is required so a stated `kind` can be cross-checked
+ * against the path's top-level directory. Pass the path the writer is
+ * targeting (e.g. `identity/profile.md`); the helper is a no-op for any
+ * non-`.md` path and for files that are out-of-scope per §5.3.
+ */
+export declare function parseVaultFrontmatter(content: string, relativePath: string): VaultFrontmatterParseResult;
+/**
+ * The set of writeable vault paths whose frontmatter the new parser
+ * advises on. Phase 1 scope: any `.md` file under one of the six class
+ * directories OR a legacy top-level path that still maps cleanly under
+ * the upcoming layout (so the alias resolver in PR-3 transparently
+ * routes both). `_index.md` files are excluded — they are
+ * machine-rebuilt or user-curated navigation, not authored content.
+ */
+export declare function shouldParseVaultFrontmatter(relativePath: string): boolean;