create-agentfs 0.1.1

package/dist/memory/confidence.js

@@ -0,0 +1,125 @@
+/**
+ * Confidence scoring engine for PATTERN entries in semantic memory.
+ *
+ * Implements the rules from docs/architecture.md Section 4:
+ *
+ *   New PATTERN  → confidence: 0.3  (DEFAULT_CONFIDENCE.initial)
+ *   Confirmed    → confidence += 0.2  (max 1.0)
+ *   Denied       → confidence -= 0.3
+ *   Inactive 30 days → confidence -= 0.1  (decay)
+ *   confidence < 0.1 → mark as superseded
+ *
+ * All functions are pure — they return a new `SemanticEntry` and never
+ * mutate the input.  Non-PATTERN entries are returned unchanged.
+ *
+ * @module memory/confidence
+ */
+import { DEFAULT_CONFIDENCE } from '../types/index.js';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Clamp a number to [min, max].
+ */
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+/**
+ * Returns the effective confidence for an entry.
+ * For non-PATTERN entries this is always 1.0 (not used in scoring).
+ * For PATTERN entries it defaults to DEFAULT_CONFIDENCE.initial when absent.
+ */
+function effectiveConfidence(entry) {
+    if (entry.type !== 'PATTERN')
+        return 1.0;
+    return entry.confidence ?? DEFAULT_CONFIDENCE.initial;
+}
+/**
+ * Returns a copy of `entry` with the given confidence applied, automatically
+ * marking the entry as superseded when the score drops below the threshold.
+ */
+function withConfidence(entry, score) {
+    const clamped = clamp(score, 0, 1.0);
+    if (clamped < DEFAULT_CONFIDENCE.supersededThreshold) {
+        // Use today's date in YYYY-MM-DD format for the superseded marker.
+        const today = new Date().toISOString().slice(0, 10);
+        return {
+            ...entry,
+            confidence: clamped,
+            status: `superseded:${today}`,
+        };
+    }
+    return { ...entry, confidence: clamped, status: 'active' };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Increases the confidence of a PATTERN entry by `confirmBoost` (default 0.2),
+ * capped at 1.0.
+ *
+ * Non-PATTERN entries are returned unchanged.
+ *
+ * @param entry - The entry to confirm.
+ * @returns A new entry with updated confidence.
+ */
+export function confirmPattern(entry) {
+    if (entry.type !== 'PATTERN')
+        return entry;
+    return withConfidence(entry, effectiveConfidence(entry) + DEFAULT_CONFIDENCE.confirmBoost);
+}
+/**
+ * Decreases the confidence of a PATTERN entry by `denyPenalty` (default 0.3).
+ *
+ * If the result drops below `supersededThreshold` (0.1) the entry is
+ * automatically marked as superseded.
+ *
+ * Non-PATTERN entries are returned unchanged.
+ *
+ * @param entry - The entry to deny.
+ * @returns A new entry with updated confidence and status.
+ */
+export function denyPattern(entry) {
+    if (entry.type !== 'PATTERN')
+        return entry;
+    return withConfidence(entry, effectiveConfidence(entry) - DEFAULT_CONFIDENCE.denyPenalty);
+}
+/**
+ * Applies time-based confidence decay to a PATTERN entry.
+ *
+ * Each full `decayDays`-period (default 30 days) of inactivity reduces
+ * confidence by `decayRate` (default 0.1).  Fractional periods are truncated.
+ *
+ * Examples:
+ * - 29 days inactive → 0 decay periods → no change
+ * - 30 days inactive → 1 decay period  → -0.1
+ * - 75 days inactive → 2 decay periods → -0.2
+ *
+ * Non-PATTERN entries are returned unchanged.
+ *
+ * @param entry             - The entry to decay.
+ * @param daysSinceLastSeen - Number of days since the pattern was last confirmed.
+ * @returns A new entry with decayed confidence (and possibly superseded status).
+ */
+export function decayPattern(entry, daysSinceLastSeen) {
+    if (entry.type !== 'PATTERN')
+        return entry;
+    const periods = Math.floor(daysSinceLastSeen / DEFAULT_CONFIDENCE.decayDays);
+    if (periods === 0)
+        return entry;
+    return withConfidence(entry, effectiveConfidence(entry) - periods * DEFAULT_CONFIDENCE.decayRate);
+}
+/**
+ * Returns `true` when an entry has been marked as superseded.
+ *
+ * An entry is superseded when its `status` string starts with "superseded:".
+ * This covers both confidence-driven supersession and manual date-based
+ * supersession (e.g. `FACT: [superseded:2026-04-01] …`).
+ *
+ * @param entry - Any semantic entry.
+ * @returns Whether the entry is superseded.
+ */
+export function isSuperseded(entry) {
+    return entry.status.startsWith('superseded:');
+}
+//# sourceMappingURL=confidence.js.map

package/dist/memory/confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../src/memory/confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,KAAoB;IAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACzC,OAAO,KAAK,CAAC,UAAU,IAAI,kBAAkB,CAAC,OAAO,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAoB,EAAE,KAAa;IACzD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAErC,IAAI,OAAO,GAAG,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;QACrD,mEAAmE;QACnE,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,OAAO;YACL,GAAG,KAAK;YACR,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,cAAc,KAAK,EAAE;SAC9B,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,cAAc,CACnB,KAAK,EACL,mBAAmB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,YAAY,CAC7D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,cAAc,CACnB,KAAK,EACL,mBAAmB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,WAAW,CAC5D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAoB,EACpB,iBAAyB;IAEzB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAE3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC7E,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEhC,OAAO,cAAc,CACnB,KAAK,EACL,mBAAmB,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,kBAAkB,CAAC,SAAS,CACpE,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,OAAO,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAChD,CAAC"}

package/dist/memory/episodic.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Episodic memory writer — creates/appends to daily event logs.
+ *
+ * Episodic memory stores timestamped session events in per-day markdown files:
+ *   `.agentos/memory/episodic/YYYY-MM-DD.md`
+ *
+ * Each file contains sections for events, decisions, and lessons learned.
+ * Appending is idempotent — duplicate event lines are skipped.
+ *
+ * @module memory/episodic
+ */
+import type { EpisodicEntry } from '../types/index.js';
+/**
+ * Write or append an episodic entry for a given date.
+ *
+ * If the file for the date already exists, new events/decisions/lessons are
+ * appended only if they are not already present (substring dedup).
+ *
+ * If the file does not exist, it is created with the full entry.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @param entry     - The episodic entry to persist
+ */
+export declare function writeEpisodicEntry(vaultRoot: string, entry: EpisodicEntry): Promise<void>;
+/**
+ * Read an episodic entry for a specific date, returning null if it doesn't exist.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @param date      - Date string in YYYY-MM-DD format
+ * @returns The raw markdown content, or null
+ */
+export declare function readEpisodicEntry(vaultRoot: string, date: string): Promise<string | null>;
+/**
+ * List all episodic entry dates available in the vault.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @returns Sorted array of date strings (YYYY-MM-DD)
+ */
+export declare function listEpisodicDates(vaultRoot: string): Promise<string[]>;
+//# sourceMappingURL=episodic.d.ts.map

package/dist/memory/episodic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episodic.d.ts","sourceRoot":"","sources":["../../src/memory/episodic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAYvD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB"}

package/dist/memory/episodic.js

@@ -0,0 +1,139 @@
+/**
+ * Episodic memory writer — creates/appends to daily event logs.
+ *
+ * Episodic memory stores timestamped session events in per-day markdown files:
+ *   `.agentos/memory/episodic/YYYY-MM-DD.md`
+ *
+ * Each file contains sections for events, decisions, and lessons learned.
+ * Appending is idempotent — duplicate event lines are skipped.
+ *
+ * @module memory/episodic
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const EPISODIC_DIR = '.agentos/memory/episodic';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Write or append an episodic entry for a given date.
+ *
+ * If the file for the date already exists, new events/decisions/lessons are
+ * appended only if they are not already present (substring dedup).
+ *
+ * If the file does not exist, it is created with the full entry.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @param entry     - The episodic entry to persist
+ */
+export async function writeEpisodicEntry(vaultRoot, entry) {
+    const dir = path.join(vaultRoot, EPISODIC_DIR);
+    await fs.mkdir(dir, { recursive: true });
+    const filePath = path.join(dir, `${entry.date}.md`);
+    let existing = null;
+    try {
+        existing = await fs.readFile(filePath, 'utf8');
+    }
+    catch {
+        // File doesn't exist — will create fresh
+    }
+    if (existing === null) {
+        // Create new file
+        const content = renderEpisodicEntry(entry);
+        await fs.writeFile(filePath, content, 'utf8');
+        return;
+    }
+    // Append new items that don't already exist
+    const linesToAppend = [];
+    for (const event of entry.events) {
+        if (!existing.includes(event)) {
+            linesToAppend.push(`- ${event}`);
+        }
+    }
+    for (const decision of entry.decisions) {
+        if (!existing.includes(decision)) {
+            linesToAppend.push(`- **Decision:** ${decision}`);
+        }
+    }
+    for (const lesson of entry.lessons) {
+        if (!existing.includes(lesson)) {
+            linesToAppend.push(`- **Lesson:** ${lesson}`);
+        }
+    }
+    if (linesToAppend.length > 0) {
+        const separator = existing.endsWith('\n') ? '' : '\n';
+        await fs.appendFile(filePath, `${separator}${linesToAppend.join('\n')}\n`, 'utf8');
+    }
+}
+/**
+ * Read an episodic entry for a specific date, returning null if it doesn't exist.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @param date      - Date string in YYYY-MM-DD format
+ * @returns The raw markdown content, or null
+ */
+export async function readEpisodicEntry(vaultRoot, date) {
+    const filePath = path.join(vaultRoot, EPISODIC_DIR, `${date}.md`);
+    try {
+        return await fs.readFile(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all episodic entry dates available in the vault.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @returns Sorted array of date strings (YYYY-MM-DD)
+ */
+export async function listEpisodicDates(vaultRoot) {
+    const dir = path.join(vaultRoot, EPISODIC_DIR);
+    try {
+        const files = await fs.readdir(dir);
+        return files
+            .filter((f) => f.endsWith('.md'))
+            .map((f) => f.replace(/\.md$/, ''))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Render a full episodic entry as markdown.
+ */
+function renderEpisodicEntry(entry) {
+    const lines = [];
+    lines.push(`# ${entry.date}`);
+    lines.push('');
+    if (entry.events.length > 0) {
+        lines.push('## Events');
+        for (const event of entry.events) {
+            lines.push(`- ${event}`);
+        }
+        lines.push('');
+    }
+    if (entry.decisions.length > 0) {
+        lines.push('## Decisions');
+        for (const decision of entry.decisions) {
+            lines.push(`- ${decision}`);
+        }
+        lines.push('');
+    }
+    if (entry.lessons.length > 0) {
+        lines.push('## Lessons');
+        for (const lesson of entry.lessons) {
+            lines.push(`- ${lesson}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=episodic.js.map

package/dist/memory/episodic.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Memory module — barrel export.
+ *
+ * Re-exports the semantic memory parser and confidence scoring engine so
+ * consumers can import from a single path:
+ *
+ * ```ts
+ * import { parseSemanticMemory, confirmPattern } from './memory/index.js';
+ * ```
+ *
+ * @module memory
+ */
+export { parseSemanticMemory, serializeSemanticEntry, appendSemanticEntry, } from './parser.js';
+export { confirmPattern, denyPattern, decayPattern, isSuperseded, } from './confidence.js';
+export { writeEpisodicEntry, readEpisodicEntry, listEpisodicDates, } from './episodic.js';
+export { writeProceduralEntry, readProceduralEntry, listProceduralSkills, slugify, } from './procedural.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,GACR,MAAM,iBAAiB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,17 @@
+/**
+ * Memory module — barrel export.
+ *
+ * Re-exports the semantic memory parser and confidence scoring engine so
+ * consumers can import from a single path:
+ *
+ * ```ts
+ * import { parseSemanticMemory, confirmPattern } from './memory/index.js';
+ * ```
+ *
+ * @module memory
+ */
+export { parseSemanticMemory, serializeSemanticEntry, appendSemanticEntry, } from './parser.js';
+export { confirmPattern, denyPattern, decayPattern, isSuperseded, } from './confidence.js';
+export { writeEpisodicEntry, readEpisodicEntry, listEpisodicDates, } from './episodic.js';
+export { writeProceduralEntry, readProceduralEntry, listProceduralSkills, slugify, } from './procedural.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,GACR,MAAM,iBAAiB,CAAC"}

package/dist/memory/parser.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Semantic memory parser — reads and writes `semantic.md` entry lines.
+ *
+ * Supported line formats (from docs/architecture.md Section 4):
+ *
+ *   PREF: no emoji in headings
+ *   FACT: [active] primary stack is Kubernetes + ArgoCD
+ *   FACT: [superseded:2026-04-01] old stack was AWS
+ *   PATTERN: [confidence:0.85] more productive in the morning
+ *   AVOID: don't suggest LangChain
+ *
+ * Rules:
+ * - PREF and AVOID carry no bracketed modifier — status defaults to "active".
+ * - FACT carries [active] or [superseded:YYYY-MM-DD].
+ * - PATTERN carries [confidence:X.XX] — status always "active" unless confidence
+ *   drops below the superseded threshold (handled by confidence.ts).
+ * - Lines that do not match the recognised format are silently ignored.
+ * - Duplicate detection in `appendSemanticEntry` is substring-based on `content`.
+ *
+ * @module memory/parser
+ */
+import type { SemanticEntry } from '../types/index.js';
+/**
+ * Parses a `semantic.md` file content string into structured `SemanticEntry`
+ * objects.
+ *
+ * Only lines that match the canonical format are returned; markdown headings,
+ * comments, blank lines, and unrecognised lines are discarded.
+ *
+ * @param content - Raw text content of the file.
+ * @returns Array of parsed entries in document order.
+ *
+ * @example
+ * ```ts
+ * const entries = parseSemanticMemory(
+ *   'FACT: [active] primary stack is Kubernetes\nAVOID: don\'t use LangChain'
+ * );
+ * // entries[0] → { type: 'FACT', content: 'primary stack is Kubernetes', status: 'active' }
+ * // entries[1] → { type: 'AVOID', content: "don't use LangChain", status: 'active' }
+ * ```
+ */
+export declare function parseSemanticMemory(content: string): SemanticEntry[];
+/**
+ * Converts a `SemanticEntry` back to its single-line string representation.
+ *
+ * Output examples:
+ * ```
+ * PREF: no emoji in headings
+ * FACT: [active] primary stack is Kubernetes + ArgoCD
+ * FACT: [superseded:2026-04-01] old stack was AWS
+ * PATTERN: [confidence:0.85] more productive in the morning
+ * AVOID: don't suggest LangChain
+ * ```
+ *
+ * @param entry - The entry to serialise.
+ * @returns A single line without a trailing newline.
+ */
+export declare function serializeSemanticEntry(entry: SemanticEntry): string;
+/**
+ * Appends a `SemanticEntry` to a `semantic.md` file at `filePath`.
+ *
+ * Duplicate detection: if any existing entry's `content` is a substring of
+ * (or exactly equals) the new entry's `content`, the append is skipped
+ * silently.  Comparison is case-sensitive and whitespace-sensitive.
+ *
+ * The file must already exist.  If the file does not end with a newline the
+ * appended line is still placed on its own line.
+ *
+ * @param filePath - Absolute path to the target `semantic.md` file.
+ * @param entry    - Entry to append.
+ */
+export declare function appendSemanticEntry(filePath: string, entry: SemanticEntry): Promise<void>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/memory/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/memory/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,mBAAmB,CAAC;AAqBvF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CA+CpE;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAiBnE;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/memory/parser.js

@@ -0,0 +1,156 @@
+/**
+ * Semantic memory parser — reads and writes `semantic.md` entry lines.
+ *
+ * Supported line formats (from docs/architecture.md Section 4):
+ *
+ *   PREF: no emoji in headings
+ *   FACT: [active] primary stack is Kubernetes + ArgoCD
+ *   FACT: [superseded:2026-04-01] old stack was AWS
+ *   PATTERN: [confidence:0.85] more productive in the morning
+ *   AVOID: don't suggest LangChain
+ *
+ * Rules:
+ * - PREF and AVOID carry no bracketed modifier — status defaults to "active".
+ * - FACT carries [active] or [superseded:YYYY-MM-DD].
+ * - PATTERN carries [confidence:X.XX] — status always "active" unless confidence
+ *   drops below the superseded threshold (handled by confidence.ts).
+ * - Lines that do not match the recognised format are silently ignored.
+ * - Duplicate detection in `appendSemanticEntry` is substring-based on `content`.
+ *
+ * @module memory/parser
+ */
+import fs from 'node:fs/promises';
+// ---------------------------------------------------------------------------
+// Internal regex
+// ---------------------------------------------------------------------------
+/**
+ * Matches any recognised semantic entry line.
+ *
+ * Capture groups:
+ *   1 — entry type  (PREF | FACT | PATTERN | AVOID | DIRECTIVE)
+ *   2 — optional bracketed modifier, without the brackets
+ *   3 — content text (trimmed)
+ */
+const ENTRY_RE = /^(PREF|FACT|PATTERN|AVOID|DIRECTIVE):\s+(?:\[([^\]]+)\]\s+)?(.+)$/;
+// ---------------------------------------------------------------------------
+// parseSemanticMemory
+// ---------------------------------------------------------------------------
+/**
+ * Parses a `semantic.md` file content string into structured `SemanticEntry`
+ * objects.
+ *
+ * Only lines that match the canonical format are returned; markdown headings,
+ * comments, blank lines, and unrecognised lines are discarded.
+ *
+ * @param content - Raw text content of the file.
+ * @returns Array of parsed entries in document order.
+ *
+ * @example
+ * ```ts
+ * const entries = parseSemanticMemory(
+ *   'FACT: [active] primary stack is Kubernetes\nAVOID: don\'t use LangChain'
+ * );
+ * // entries[0] → { type: 'FACT', content: 'primary stack is Kubernetes', status: 'active' }
+ * // entries[1] → { type: 'AVOID', content: "don't use LangChain", status: 'active' }
+ * ```
+ */
+export function parseSemanticMemory(content) {
+    const entries = [];
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        const match = ENTRY_RE.exec(line);
+        if (match === null)
+            continue;
+        const [, rawType, modifier, entryContent] = match;
+        const type = rawType;
+        const trimmedContent = entryContent.trim();
+        // Determine status and confidence from the optional modifier.
+        let status = 'active';
+        let confidence;
+        if (modifier !== undefined) {
+            if (modifier === 'active') {
+                status = 'active';
+            }
+            else if (modifier.startsWith('superseded:')) {
+                status = modifier;
+            }
+            else if (modifier.startsWith('confidence:')) {
+                const raw = modifier.slice('confidence:'.length);
+                const parsed = parseFloat(raw);
+                if (!isNaN(parsed)) {
+                    confidence = parsed;
+                }
+                // PATTERN entries with confidence tag keep status "active"
+                status = 'active';
+            }
+        }
+        const entry = { type, content: trimmedContent, status };
+        if (confidence !== undefined) {
+            entry.confidence = confidence;
+        }
+        entries.push(entry);
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// serializeSemanticEntry
+// ---------------------------------------------------------------------------
+/**
+ * Converts a `SemanticEntry` back to its single-line string representation.
+ *
+ * Output examples:
+ * ```
+ * PREF: no emoji in headings
+ * FACT: [active] primary stack is Kubernetes + ArgoCD
+ * FACT: [superseded:2026-04-01] old stack was AWS
+ * PATTERN: [confidence:0.85] more productive in the morning
+ * AVOID: don't suggest LangChain
+ * ```
+ *
+ * @param entry - The entry to serialise.
+ * @returns A single line without a trailing newline.
+ */
+export function serializeSemanticEntry(entry) {
+    const { type, content, status, confidence } = entry;
+    // PATTERN entries encode confidence in the modifier slot.
+    if (type === 'PATTERN') {
+        const score = confidence !== undefined ? confidence : 0.3;
+        // Format to two decimal places, matching the canonical format.
+        return `PATTERN: [confidence:${score.toFixed(2)}] ${content}`;
+    }
+    // PREF, AVOID, and DIRECTIVE have no modifier when status is active.
+    if (type === 'PREF' || type === 'AVOID' || type === 'DIRECTIVE') {
+        return `${type}: ${content}`;
+    }
+    // FACT always carries an explicit status modifier.
+    return `FACT: [${status}] ${content}`;
+}
+// ---------------------------------------------------------------------------
+// appendSemanticEntry
+// ---------------------------------------------------------------------------
+/**
+ * Appends a `SemanticEntry` to a `semantic.md` file at `filePath`.
+ *
+ * Duplicate detection: if any existing entry's `content` is a substring of
+ * (or exactly equals) the new entry's `content`, the append is skipped
+ * silently.  Comparison is case-sensitive and whitespace-sensitive.
+ *
+ * The file must already exist.  If the file does not end with a newline the
+ * appended line is still placed on its own line.
+ *
+ * @param filePath - Absolute path to the target `semantic.md` file.
+ * @param entry    - Entry to append.
+ */
+export async function appendSemanticEntry(filePath, entry) {
+    const raw = await fs.readFile(filePath, 'utf8');
+    const existing = parseSemanticMemory(raw);
+    // Duplicate check: skip if the incoming content already appears.
+    const isDuplicate = existing.some((e) => e.content === entry.content && e.type === entry.type);
+    if (isDuplicate)
+        return;
+    const line = serializeSemanticEntry(entry);
+    // Ensure the new line starts on a fresh line.
+    const separator = raw.endsWith('\n') || raw.length === 0 ? '' : '\n';
+    await fs.appendFile(filePath, `${separator}${line}\n`, 'utf8');
+}
+//# sourceMappingURL=parser.js.map

package/dist/memory/parser.js.map

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

package/dist/memory/procedural.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Procedural memory writer — creates/updates skill files.
+ *
+ * Procedural memory stores learned workflows as individual markdown files:
+ *   `.agentos/memory/procedural/{skill-name}.md`
+ *
+ * Each file documents: description, steps, context, and optional examples.
+ * Creates new files or overwrites existing ones (skills are versioned as a
+ * whole, not appended line-by-line like episodic memory).
+ *
+ * @module memory/procedural
+ */
+import type { ProceduralEntry } from '../types/index.js';
+/**
+ * Write or overwrite a procedural skill file.
+ *
+ * The skill name is slugified for the filename (lowercase, hyphens).
+ * The full content is always rewritten — procedural skills are atomic.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @param entry     - The procedural entry to persist
+ */
+export declare function writeProceduralEntry(vaultRoot: string, entry: ProceduralEntry): Promise<void>;
+/**
+ * Read a procedural entry by skill name, returning null if it doesn't exist.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @param name      - Skill name (will be slugified)
+ * @returns The raw markdown content, or null
+ */
+export declare function readProceduralEntry(vaultRoot: string, name: string): Promise<string | null>;
+/**
+ * List all procedural skill names available in the vault.
+ *
+ * @param vaultRoot - Absolute path to the vault root directory
+ * @returns Sorted array of skill names (derived from filenames)
+ */
+export declare function listProceduralSkills(vaultRoot: string): Promise<string[]>;
+/**
+ * Slugify a skill name: lowercase, spaces → hyphens, strip non-alnum.
+ */
+export declare function slugify(name: string): string;
+//# sourceMappingURL=procedural.d.ts.map

package/dist/memory/procedural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedural.d.ts","sourceRoot":"","sources":["../../src/memory/procedural.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAYzD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAMD;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C"}