youmd 0.6.21 → 0.6.27

package/dist/lib/okf-health.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * OKF brain-health audit.
+ *
+ * Audits an OKF bundle for the failure modes that rot agent knowledge bases
+ * (the Familiar-second-brain "graph health" idea, applied to OKF): concepts
+ * missing a type, thin/un-sourced concepts, agent-authored low-confidence
+ * concepts that need a human pass, stale concepts, unresolved [CONFLICT]/[STALE]
+ * markers, and orphans nothing links to.
+ *
+ * Pure — operates on in-memory files so it can be unit-tested and reused by the
+ * CLI against either the live bundle or any OKF directory on disk.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditOkfBundle = auditOkfBundle;
+const gray_matter_1 = __importDefault(require("gray-matter"));
+const okf_1 = require("./okf");
+/** Extract every link target from markdown: [text](target) and [[wikilink]]. */
+function extractLinkTargets(text) {
+    const targets = [];
+    const mdLink = /\]\(([^)\s]+)\)/g;
+    let m;
+    while ((m = mdLink.exec(text)) !== null)
+        targets.push(m[1]);
+    const wiki = /\[\[([^\]]+)\]\]/g;
+    while ((m = wiki.exec(text)) !== null)
+        targets.push(m[1]);
+    return targets;
+}
+/** Normalize a link target to a concept id (strip leading slash, .md, anchors). */
+function targetToConceptId(target) {
+    return target
+        .replace(/^\.?\//, "")
+        .replace(/#.*$/, "")
+        .replace(/\.md$/i, "")
+        .trim();
+}
+const EMPTY_SUMMARY = () => ({
+    missing_type: 0,
+    no_description: 0,
+    unsourced: 0,
+    needs_review: 0,
+    stale: 0,
+    conflict: 0,
+    orphan: 0,
+});
+const PENALTY = {
+    error: 10,
+    warning: 3,
+    info: 1,
+};
+/**
+ * Audit a set of OKF files. A bundle is `ok` when there are no errors (a
+ * missing `type` is the only error; everything else is advisory).
+ */
+function auditOkfBundle(files, options = {}) {
+    const staleDays = options.staleDays ?? 30;
+    const now = options.now ?? new Date();
+    const concepts = [];
+    const referenced = new Set();
+    for (const file of files) {
+        const rel = file.path.replace(/\\/g, "/");
+        if (!rel.toLowerCase().endsWith(".md"))
+            continue;
+        // Every file (including index.md/log.md) contributes graph edges.
+        for (const target of extractLinkTargets(file.content)) {
+            referenced.add(targetToConceptId(target));
+        }
+        if ((0, okf_1.isReservedFile)(rel))
+            continue;
+        const { data, content } = (0, gray_matter_1.default)(file.content);
+        const fm = (data || {});
+        // `related` frontmatter edges count toward the graph too.
+        if (Array.isArray(fm.related)) {
+            for (const target of fm.related) {
+                if (typeof target === "string")
+                    referenced.add(targetToConceptId(target));
+            }
+        }
+        concepts.push({
+            file: rel,
+            id: (0, okf_1.conceptId)(rel),
+            data: fm,
+            body: content,
+        });
+    }
+    const issues = [];
+    const summary = EMPTY_SUMMARY();
+    const add = (issue) => {
+        issues.push(issue);
+        summary[issue.category] += 1;
+    };
+    for (const concept of concepts) {
+        const { file, id, data, body } = concept;
+        const type = data.type;
+        if (typeof type !== "string" || type.trim() === "") {
+            add({ category: "missing_type", level: "error", file, message: "missing required `type`" });
+        }
+        if (typeof data.description !== "string" || !data.description.trim()) {
+            add({ category: "no_description", level: "info", file, message: "no description" });
+        }
+        const linkedSources = data.linked_sources;
+        if (!Array.isArray(linkedSources) || linkedSources.length === 0) {
+            add({ category: "unsourced", level: "info", file, message: "no linked_sources (un-sourced)" });
+        }
+        const confidence = typeof data.confidence === "string" ? data.confidence : "";
+        const author = typeof data.last_updated_by === "string" ? data.last_updated_by : "";
+        if (confidence === "low" || (author === "agent" && !confidence)) {
+            add({
+                category: "needs_review",
+                level: "warning",
+                file,
+                message: confidence === "low"
+                    ? "low confidence — needs a human pass"
+                    : "agent-authored with no confidence — needs a human pass",
+            });
+        }
+        const timestamp = typeof data.timestamp === "string" ? data.timestamp : "";
+        if (timestamp) {
+            const ts = Date.parse(timestamp);
+            if (!Number.isNaN(ts)) {
+                const ageDays = (now.getTime() - ts) / (1000 * 60 * 60 * 24);
+                if (ageDays > staleDays) {
+                    add({
+                        category: "stale",
+                        level: "warning",
+                        file,
+                        message: `not updated in ${Math.floor(ageDays)} days (> ${staleDays})`,
+                    });
+                }
+            }
+        }
+        if (/\[STALE\]/.test(body)) {
+            add({ category: "stale", level: "warning", file, message: "contains a [STALE] marker" });
+        }
+        if (/\[CONFLICT\]/.test(body)) {
+            add({ category: "conflict", level: "warning", file, message: "contains an unresolved [CONFLICT] marker" });
+        }
+        // Orphan: no other file links to this concept id.
+        if (!referenced.has(id)) {
+            add({ category: "orphan", level: "info", file, message: "orphan — nothing links to it" });
+        }
+    }
+    const ok = issues.every((i) => i.level !== "error");
+    const penalty = issues.reduce((sum, i) => sum + PENALTY[i.level], 0);
+    const score = Math.max(0, 100 - penalty);
+    return { ok, totalConcepts: concepts.length, issues, summary, score };
+}
+//# sourceMappingURL=okf-health.js.map

package/dist/lib/okf-health.js.map

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

package/dist/lib/okf-stack.d.ts

@@ -0,0 +1,47 @@
+/**
+ * YouStack  ->  OKF bundle.
+ *
+ * A YouStack is a manifest (youstack.json) plus typed markdown files — skills,
+ * workflows, docs, tests, prompts. This module renders a stack as a conformant
+ * OKF bundle so a published "Gstack-style" stack is readable by any OKF
+ * consumer (an LLM, Obsidian, MkDocs, a static server) with no You.md SDK. The
+ * canonical youstack.json is carried alongside so the stack stays installable.
+ *
+ * Export-focused: the OKF rendering is the shareable/consumable view; the
+ * youstack.json remains the source of truth for installation and routing.
+ */
+import { OkfBundleFile, OkfValidationResult } from "./okf";
+import { YouStackManifest } from "./youstack";
+export interface StackSourceFile {
+    /** Bundle-relative path, e.g. "skills/youstack-start/SKILL.md". */
+    path: string;
+    /** Declared file type from the manifest, if known. */
+    declaredType?: string;
+    content: string;
+}
+export interface BuildStackOkfResult {
+    files: OkfBundleFile[];
+    conceptCount: number;
+    validation: OkfValidationResult;
+}
+/** Pure: build the full OKF file set for a stack manifest + its source files. */
+export declare function buildStackOkfFiles(manifest: YouStackManifest, sourceFiles: StackSourceFile[], options?: {
+    timestamp?: string;
+    defaultAuthor?: string;
+    defaultConfidence?: string;
+}): BuildStackOkfResult;
+/** Collect all markdown source files from a stack root, tagging declared
+ *  types from manifest.files where available. */
+export declare function collectStackSourceFiles(rootDir: string, manifest: YouStackManifest): StackSourceFile[];
+export interface ExportStackToOkfResult {
+    outDir: string;
+    written: string[];
+    conceptCount: number;
+    validation: OkfValidationResult;
+}
+/** Export a loaded stack (manifest + rootDir) as a conformant OKF bundle. */
+export declare function exportYouStackToOkf(manifest: YouStackManifest, rootDir: string, outDir: string, options?: {
+    defaultAuthor?: string;
+    defaultConfidence?: string;
+}): ExportStackToOkfResult;
+//# sourceMappingURL=okf-stack.d.ts.map

package/dist/lib/okf-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okf-stack.d.ts","sourceRoot":"","sources":["../../src/lib/okf-stack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAEL,aAAa,EAOb,mBAAmB,EACpB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,gBAAgB,EAA2B,MAAM,YAAY,CAAC;AAuBvE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAoHD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,EAC1B,WAAW,EAAE,eAAe,EAAE,EAC9B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,mBAAmB,CAsGrB;AAID;iDACiD;AACjD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,GACzB,eAAe,EAAE,CA2BnB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,sBAAsB,CA6BxB"}

package/dist/lib/okf-stack.js

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * YouStack  ->  OKF bundle.
+ *
+ * A YouStack is a manifest (youstack.json) plus typed markdown files — skills,
+ * workflows, docs, tests, prompts. This module renders a stack as a conformant
+ * OKF bundle so a published "Gstack-style" stack is readable by any OKF
+ * consumer (an LLM, Obsidian, MkDocs, a static server) with no You.md SDK. The
+ * canonical youstack.json is carried alongside so the stack stays installable.
+ *
+ * Export-focused: the OKF rendering is the shareable/consumable view; the
+ * youstack.json remains the source of truth for installation and routing.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStackOkfFiles = buildStackOkfFiles;
+exports.collectStackSourceFiles = collectStackSourceFiles;
+exports.exportYouStackToOkf = exportYouStackToOkf;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const gray_matter_1 = __importDefault(require("gray-matter"));
+const okf_1 = require("./okf");
+const youstack_1 = require("./youstack");
+/** Declared file `type` -> human-friendly OKF `type` + index heading. */
+const FILE_TYPE_META = {
+    skill: { type: "Skill", heading: "Skills" },
+    workflow: { type: "Workflow", heading: "Workflows" },
+    docs: { type: "Documentation", heading: "Docs" },
+    doc: { type: "Documentation", heading: "Docs" },
+    prompt: { type: "Prompt", heading: "Prompts" },
+    test: { type: "Test", heading: "Tests" },
+    example: { type: "Example", heading: "Examples" },
+};
+/** Directory name -> declared file type, for files not listed in manifest.files. */
+const DIR_TYPE_HINT = {
+    skills: "skill",
+    workflows: "workflow",
+    docs: "docs",
+    prompts: "prompt",
+    tests: "test",
+    examples: "example",
+};
+function titleCase(slug) {
+    return slug
+        .split(/[-_.]/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+function deriveDescription(body) {
+    for (const raw of body.split("\n")) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        if (/^[#>*\-+|]/.test(line))
+            continue;
+        const sentence = line.split(/(?<=[.!?])\s/)[0].trim();
+        if (!sentence)
+            continue;
+        return sentence.length > 160 ? sentence.slice(0, 157).trimEnd() + "..." : sentence;
+    }
+    return undefined;
+}
+function dropUndefined(obj) {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined && !(Array.isArray(v) && v.length === 0))
+            out[k] = v;
+    }
+    return out;
+}
+function typeMetaFor(file) {
+    if (file.declaredType && FILE_TYPE_META[file.declaredType]) {
+        return FILE_TYPE_META[file.declaredType];
+    }
+    const topDir = file.path.replace(/\\/g, "/").split("/")[0];
+    const hinted = DIR_TYPE_HINT[topDir];
+    if (hinted && FILE_TYPE_META[hinted])
+        return FILE_TYPE_META[hinted];
+    return { type: "Stack File", heading: "Other" };
+}
+/** Read provenance fields from a parsed frontmatter block, applying defaults. */
+function readProvenance(data, defaults) {
+    const lastUpdatedBy = (typeof data.last_updated_by === "string" && data.last_updated_by) || defaults.author;
+    const confidence = (typeof data.confidence === "string" && data.confidence) || defaults.confidence;
+    const linkedSources = Array.isArray(data.linked_sources)
+        ? data.linked_sources.filter((s) => typeof s === "string")
+        : undefined;
+    return {
+        last_updated_by: lastUpdatedBy || undefined,
+        confidence: confidence || undefined,
+        linked_sources: linkedSources && linkedSources.length > 0 ? linkedSources : undefined,
+    };
+}
+/** Build the manifest summary concept (type: YouStack). */
+function buildStackManifestConcept(manifest, timestamp, defaults = {}) {
+    const capabilities = (0, youstack_1.getYouStackCapabilities)(manifest);
+    const lines = [];
+    lines.push(`# ${manifest.name}`);
+    lines.push("");
+    if (manifest.description) {
+        lines.push(manifest.description);
+        lines.push("");
+    }
+    lines.push("## Identity");
+    lines.push("");
+    lines.push(`- Slug: ${manifest.slug}`);
+    lines.push(`- Version: ${manifest.version}`);
+    lines.push(`- Visibility: ${manifest.visibility}`);
+    if (manifest.domain)
+        lines.push(`- Domain: ${manifest.domain}`);
+    if (manifest.tags?.length)
+        lines.push(`- Tags: ${manifest.tags.join(", ")}`);
+    lines.push("");
+    lines.push("## Capabilities");
+    lines.push("");
+    for (const capability of capabilities) {
+        const mode = capability.localOnly ? "local" : "protected";
+        lines.push(`- ${capability.id} (${mode}): ${capability.intent || "No intent declared."}`);
+    }
+    if (manifest.improvement) {
+        lines.push("");
+        lines.push("## Self-Improvement");
+        lines.push("");
+        lines.push(`- Mode: ${manifest.improvement.mode || "observe"}`);
+        if (manifest.improvement.cadence)
+            lines.push(`- Cadence: ${manifest.improvement.cadence}`);
+    }
+    const frontmatter = dropUndefined({
+        type: "YouStack",
+        title: manifest.name,
+        description: manifest.description,
+        tags: manifest.tags && manifest.tags.length > 0 ? manifest.tags : undefined,
+        timestamp,
+        last_updated_by: defaults.author,
+        confidence: defaults.confidence,
+        youmd_kind: "youstack",
+        stack_slug: manifest.slug,
+        stack_version: manifest.version,
+        stack_visibility: manifest.visibility,
+    });
+    return {
+        path: "youstack.md",
+        content: (0, okf_1.serializeOkfFile)({ frontmatter, body: lines.join("\n") }),
+    };
+}
+/** Pure: build the full OKF file set for a stack manifest + its source files. */
+function buildStackOkfFiles(manifest, sourceFiles, options = {}) {
+    const timestamp = options.timestamp || new Date().toISOString();
+    const date = timestamp.split("T")[0];
+    const provDefaults = { author: options.defaultAuthor, confidence: options.defaultConfidence };
+    const manifestConcept = buildStackManifestConcept(manifest, timestamp, provDefaults);
+    const conceptFiles = sourceFiles.map((file) => {
+        const meta = typeMetaFor(file);
+        const { data, content } = (0, gray_matter_1.default)(file.content);
+        const slug = path.basename(file.path, path.extname(file.path));
+        const title = (typeof data.title === "string" && data.title.trim()) ||
+            (typeof data.name === "string" && data.name.trim()) ||
+            titleCase(slug);
+        const description = (typeof data.description === "string" && data.description.trim()) ||
+            deriveDescription(content);
+        const provenance = readProvenance(data, provDefaults);
+        const frontmatter = dropUndefined({
+            type: meta.type,
+            title,
+            description,
+            timestamp,
+            last_updated_by: provenance.last_updated_by,
+            confidence: provenance.confidence,
+            linked_sources: provenance.linked_sources,
+            // Every stack file belongs to the stack — link it to the manifest concept.
+            related: ["youstack"],
+            youmd_kind: file.path.replace(/\\/g, "/").replace(/\.md$/i, ""),
+            stack_slug: manifest.slug,
+        });
+        return {
+            path: file.path.replace(/\\/g, "/"),
+            content: (0, okf_1.serializeOkfFile)({ frontmatter, body: content.trim() }),
+        };
+    });
+    // index.md grouped by heading.
+    const headingOrder = ["Skills", "Workflows", "Prompts", "Docs", "Tests", "Examples", "Other"];
+    const grouped = new Map();
+    // Manifest summary goes in an "Overview" section first.
+    grouped.set("Overview", {
+        heading: "Overview",
+        entries: [{ conceptId: "youstack", title: manifest.name, description: manifest.description }],
+    });
+    for (const file of sourceFiles) {
+        const meta = typeMetaFor(file);
+        const { data, content } = (0, gray_matter_1.default)(file.content);
+        const slug = path.basename(file.path, path.extname(file.path));
+        const title = (typeof data.title === "string" && data.title.trim()) ||
+            (typeof data.name === "string" && data.name.trim()) ||
+            titleCase(slug);
+        const section = grouped.get(meta.heading) || { heading: meta.heading, entries: [] };
+        section.entries.push({
+            conceptId: file.path.replace(/\\/g, "/").replace(/\.md$/i, ""),
+            title,
+            description: (typeof data.description === "string" && data.description.trim()) ||
+                deriveDescription(content),
+        });
+        grouped.set(meta.heading, section);
+    }
+    const indexSections = [
+        grouped.get("Overview"),
+        ...headingOrder
+            .filter((h) => grouped.has(h))
+            .map((h) => grouped.get(h)),
+    ];
+    const indexMd = (0, okf_1.buildIndexMd)(indexSections, {
+        title: `${manifest.name} — YouStack`,
+        intro: manifest.description ||
+            "A portable YouStack in Open Knowledge Format. Skills, workflows, and docs an agent can read natively.",
+        okfVersion: okf_1.OKF_VERSION,
+    });
+    const log = [
+        {
+            date,
+            label: "Export",
+            message: `Generated OKF bundle for ${manifest.name} v${manifest.version} — ${conceptFiles.length + 1} concepts.`,
+        },
+    ];
+    const files = [
+        { path: "index.md", content: indexMd },
+        manifestConcept,
+        ...conceptFiles,
+        { path: "log.md", content: (0, okf_1.buildLogMd)(log, { title: "Change Log" }) },
+    ];
+    return {
+        files,
+        conceptCount: conceptFiles.length + 1,
+        validation: (0, okf_1.validateOkfBundle)(files),
+    };
+}
+// ─── Filesystem wrapper ────────────────────────────────────────────────
+/** Collect all markdown source files from a stack root, tagging declared
+ *  types from manifest.files where available. */
+function collectStackSourceFiles(rootDir, manifest) {
+    const declaredType = new Map();
+    for (const file of manifest.files || []) {
+        declaredType.set(file.path.replace(/\\/g, "/"), file.type);
+    }
+    const collected = [];
+    const walk = (dir, prefix) => {
+        if (!fs.existsSync(dir))
+            return;
+        for (const entry of fs
+            .readdirSync(dir, { withFileTypes: true })
+            .sort((a, b) => a.name.localeCompare(b.name))) {
+            const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+            const abs = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(abs, rel);
+            }
+            else if (entry.name.endsWith(".md")) {
+                collected.push({
+                    path: rel,
+                    declaredType: declaredType.get(rel),
+                    content: fs.readFileSync(abs, "utf-8"),
+                });
+            }
+        }
+    };
+    walk(rootDir, "");
+    return collected;
+}
+/** Export a loaded stack (manifest + rootDir) as a conformant OKF bundle. */
+function exportYouStackToOkf(manifest, rootDir, outDir, options = {}) {
+    const sourceFiles = collectStackSourceFiles(rootDir, manifest);
+    const built = buildStackOkfFiles(manifest, sourceFiles, {
+        defaultAuthor: options.defaultAuthor,
+        defaultConfidence: options.defaultConfidence,
+    });
+    fs.mkdirSync(outDir, { recursive: true });
+    const written = [];
+    for (const file of built.files) {
+        const dest = path.join(outDir, file.path);
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.writeFileSync(dest, file.content);
+        written.push(file.path);
+    }
+    // Carry the canonical manifest so the OKF bundle stays installable.
+    const manifestSrc = path.join(rootDir, "youstack.json");
+    if (fs.existsSync(manifestSrc)) {
+        fs.copyFileSync(manifestSrc, path.join(outDir, "youstack.json"));
+        written.push("youstack.json");
+    }
+    return {
+        outDir,
+        written,
+        conceptCount: built.conceptCount,
+        validation: built.validation,
+    };
+}
+//# sourceMappingURL=okf-stack.js.map

package/dist/lib/okf-stack.js.map

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

package/dist/lib/okf-view.d.ts

@@ -0,0 +1,49 @@
+/**
+ * OKF brain view — a framework-agnostic view model over an OKF bundle plus a
+ * self-contained HTML renderer.
+ *
+ * This is the substrate for two surfaces that should feel identical: the future
+ * Obsidian-style desktop client and the web app. Both render the SAME view
+ * model (`buildBrainView`) so an OKF bundle looks the same everywhere. The HTML
+ * renderer is dependency-free (inline CSS, no JS, no network) so the generated
+ * page opens locally as a "daily brain page" and seeds the desktop client.
+ *
+ * Pure — no filesystem. The CLI wraps it to read a directory or the live bundle.
+ */
+import { OkfBundleFile } from "./okf";
+import { OkfHealthReport } from "./okf-health";
+export interface BrainConcept {
+    id: string;
+    type: string;
+    title: string;
+    description?: string;
+    lastUpdatedBy?: string;
+    confidence?: string;
+    linkedSources: string[];
+    related: string[];
+    href: string;
+}
+export interface BrainView {
+    title: string;
+    okfVersion: string;
+    generatedAt: string;
+    concepts: BrainConcept[];
+    groups: Array<{
+        type: string;
+        concepts: BrainConcept[];
+    }>;
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+    health: OkfHealthReport;
+}
+/** Build the framework-agnostic view model from a set of OKF files. */
+export declare function buildBrainView(files: OkfBundleFile[], options?: {
+    title?: string;
+    now?: Date;
+    staleDays?: number;
+}): BrainView;
+/** Render the brain view as a self-contained HTML page (no JS, no network). */
+export declare function renderBrainHtml(view: BrainView): string;
+//# sourceMappingURL=okf-view.d.ts.map

package/dist/lib/okf-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okf-view.d.ts","sourceRoot":"","sources":["../../src/lib/okf-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,aAAa,EAAuD,MAAM,OAAO,CAAC;AAC3F,OAAO,EAAkB,eAAe,EAAoB,MAAM,cAAc,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1D,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,MAAM,EAAE,eAAe,CAAC;CACzB;AAeD,uEAAuE;AACvE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,SAAS,CAsDX;AA8FD,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CA2BvD"}