lobsidian 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lobsidian Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+<p align="center">
+  <img src="assets/logo.jpg" alt="Lobsidian" width="480">
+</p>
+
+# Lobsidian
+
+[![npm version](https://img.shields.io/npm/v/lobsidian.svg)](https://www.npmjs.com/package/lobsidian)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**Structured accountability for AI agents.** Plain markdown files that are simultaneously the agent's memory and the team's knowledge base.
+
+## Quick Start
+
+```bash
+npx lobsidian init ./my-project
+```
+
+That's it. Open `my-project/Start Here.md` to see what was created, or point an AI agent at `my-project/_lobsidian/AGENT.md` and it immediately knows how to operate.
+
+To install globally:
+
+```bash
+npm install -g lobsidian
+```
+
+Requires Node.js 18+.
+
+## Why Lobsidian?
+
+Existing AI memory tools (Mem0, Zep, Letta) solve what an agent can *recall*. Lobsidian solves what an agent is *accountable for* -- who delegated that authority, and how improvements surface.
+
+Give an AI agent access to files and it will *do things*. But:
+
+- **Who said it should?** No record of why work was started or who approved it.
+- **Is it working?** No success criteria, no review dates, no feedback loop.
+- **What's the scope?** Agents drift. Without boundaries, they reorganize your entire vault.
+- **Where's the audit trail?** Actions happen, but the reasoning disappears with the conversation.
+
+Lobsidian fixes this with a simple protocol: every piece of work traces a chain from **motive** (why) to **decision** (what, with human consent) to **task** (concrete work, with outcome). Decisions carry review dates, closing the loop.
+
+## How It Works
+
+```
+MOTIVE (why)         "Website is slow, losing visitors"
+    |
+DECISION (what)      "Implement CDN caching"
+    |                 success_criteria: "Lighthouse > 90"
+    |                 review_date: 2026-05-20
+    |                 status: proposed -> [human consents] -> active
+    |
+TASK (work)          "Configure CloudFront distribution"
+    |                 assignee: my-agent
+    |                 outcome: "Lighthouse 94, load time 1.4s"
+    |
+REVIEW               Is the motive still relevant?
+                      Did the decision meet its criteria?
+```
+
+Every file is a markdown file with YAML frontmatter. Frontmatter is the API. Folders are human convenience.
+
+## Usage
+
+### Create a Vault
+
+```bash
+lobsidian init ./my-project
+```
+
+The path is where Lobsidian creates the vault structure. Use any directory -- `./my-project`, `/path/to/vault`, or `.` for the current directory.
+
+Options:
+- `--name "My Project"` -- vault display name (defaults to directory name)
+- `--agent "my-agent"` -- default agent name (defaults to "agent")
+
+This creates:
+```
+my-project/
+  _lobsidian/           # System files (agent skill, config, templates, procedures)
+  Motives/              # Why something needs attention
+  Decisions/            # What was decided and why
+  Tasks/                # Concrete work items
+  Knowledge/            # Reference material and notes
+  Journal/              # Chronological entries
+  Inbox/                # Unprocessed items
+  Archive/              # Completed items (nothing is deleted)
+  Start Here.md         # Orientation guide
+  .gitignore
+```
+
+### Validate a Vault
+
+```bash
+lobsidian validate ./my-project
+# OK  7 files checked, 0 errors, 0 warnings
+
+lobsidian validate ./my-project --fix    # Auto-fix: stale claims, orphaned tasks
+lobsidian validate ./my-project --json   # Machine-readable output
+```
+
+21 checks covering frontmatter schemas, broken wiki-links, circular references, consent bypasses, overdue reviews, and more.
+
+### Connect an Agent
+
+**Agent Skills (recommended):**
+If your platform supports [Agent Skills](https://agentskills.io), Lobsidian ships a skill file at `skills/lobsidian/SKILL.md`. No extra configuration needed -- the agent discovers it automatically.
+
+**Manual one-liner:**
+```bash
+lobsidian init ./my-project --print-shim
+```
+Outputs a shim you can paste into your agent's startup context (e.g. `CLAUDE.md`, `.cursorrules`).
+
+**Direct context injection:**
+Load `_lobsidian/AGENT.md` (~1,500 tokens) into the agent's system prompt or context window. Set `LOBSIDIAN_AGENT_NAME` env var for identity.
+
+### Integration Contract
+
+- **File access:** read/write to the vault directory (plain markdown files only)
+- **Startup context:** load `_lobsidian/AGENT.md` (~1,500 tokens) at agent startup
+- **Quick setup:** `lobsidian init --print-shim` outputs a one-liner for agent config files
+
+## What Makes This Different
+
+**No infrastructure.** No databases, no servers, no vector stores. Just markdown files on disk. Works offline. Works with git.
+
+**Self-documenting agents.** An agent reads one file (`_lobsidian/AGENT.md`, ~1,500 tokens) and knows the entire protocol. No training, no fine-tuning, no SDK integration.
+
+**Consent gates.** Agent-created decisions start as `draft` or `proposed`. An agent *cannot* set `status: active` on its own decisions -- human consent is a hard requirement, not a suggestion.
+
+**Review cycles.** Every decision carries a `review_date` and `success_criteria`. When the date arrives, the agent surfaces the review. This is the feedback loop that most AI systems lack entirely.
+
+**Domain boundaries.** Each agent operates within a defined domain -- a set of filesystem paths with explicit permissions. Built-in WIP limits prevent agents from claiming everything at once.
+
+**Framework-agnostic.** Lobsidian is a convention layer. It works with any agent that can read and write files.
+
+**Human-compatible.** Everything is plain markdown. Browse motives in Obsidian. Review decisions in VS Code. Approve tasks in your terminal. The vault works without any agent at all.
+
+## Agent Skill
+
+Lobsidian ships an [Agent Skill](https://agentskills.io) at [`skills/lobsidian/SKILL.md`](skills/lobsidian/SKILL.md). Compatible with any platform supporting the Agent Skills standard:
+
+- Claude Code
+- OpenAI Codex
+- Gemini CLI
+- Cursor
+- GitHub Copilot
+- OpenClaw / ClawHub
+- Goose
+- Any agent supporting Agent Skills
+
+If your platform doesn't support Agent Skills, load `_lobsidian/AGENT.md` directly into the agent's context window.
+
+## The Protocol
+
+### Core Types
+
+| Type | Folder | Purpose |
+|------|--------|---------|
+| `motive` | `Motives/` | Why something needs attention (situation + need + effect) |
+| `decision` | `Decisions/` | What was decided, with success criteria and review date |
+| `task` | `Tasks/` | Concrete work with assignee, deliverables, and outcome |
+| `note` | `Knowledge/` | Captured insights and reference material |
+| `log` | `Journal/` | Chronological entries (daily, activity, meeting, reflection) |
+| `domain` | `_lobsidian/domains/` | Agent scope, permissions, and boundaries |
+
+### Status Flows
+
+**Motives:** `open` -> `addressed` -> `obsolete`
+
+**Decisions:** `draft` -> `proposed` -> `active` -> `under-review` -> `retired` or `superseded`
+
+**Tasks:** `pending` -> `claimed` -> `in-progress` -> `done` or `cancelled`
+
+## Spec
+
+The full protocol specification is in [`spec.md`](spec.md) (~960 lines). Advanced multi-agent coordination, cascade protocols, and domain emergence are in [`spec-advanced.md`](spec-advanced.md).
+
+The spec was developed through 15 expert agent reviews and 67 fixes across 8 versions. Design history is in [`CHANGELOG.md`](CHANGELOG.md).
+
+## Contributing
+
+Found a bug or have a suggestion? [Open an issue](https://github.com/cannuri/lobsidian/issues).
+
+## License
+
+[MIT](LICENSE)

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { Command } from 'commander';
+import { registerInitCommand } from './commands/init.js';
+import { validateCommand } from './commands/validate.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const program = new Command()
+    .name('lobsidian')
+    .description('Lobsidian — markdown-based knowledge protocol for AI agents')
+    .version(pkg.version, '-v, --version');
+registerInitCommand(program);
+program.addCommand(validateCommand);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC1B,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AAEzC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAEpC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerInitCommand(program: Command): void;

package/dist/commands/init.js

@@ -0,0 +1,24 @@
+import { resolve, basename, join } from 'node:path';
+import { defaultVars } from '../lib/content.js';
+import { init, summary } from '../lib/scaffold.js';
+export function registerInitCommand(program) {
+    program
+        .command('init [path]')
+        .description('Scaffold a new Lobsidian vault')
+        .option('--name <name>', 'vault name (default: directory basename)')
+        .option('--agent <agent>', 'default agent name', 'agent')
+        .option('--print-shim', 'output one-liner for agent startup context')
+        .action((pathArg, opts) => {
+        const target = resolve(pathArg ?? '.');
+        const vaultName = opts.name || basename(target);
+        const vars = defaultVars(vaultName, opts.agent);
+        const result = init(target, vars);
+        console.log(summary(result));
+        if (opts.printShim) {
+            const agentMd = join(target, '_lobsidian', 'AGENT.md');
+            console.log(`\nOn startup, read ${agentMd} and follow its conventions.`);
+            console.log(`Your Lobsidian agent name is: ${opts.agent}`);
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC;SACnE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,OAAO,CAAC;SACxD,MAAM,CAAC,cAAc,EAAE,4CAA4C,CAAC;SACpE,MAAM,CAAC,CAAC,OAA2B,EAAE,IAA2D,EAAE,EAAE;QACnG,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;QAEvC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAE7B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,8BAA8B,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const validateCommand: Command;

package/dist/commands/validate.js

@@ -0,0 +1,35 @@
+import { Command } from "commander";
+import { run, formatReport, Severity } from "../lib/validate/index.js";
+export const validateCommand = new Command("validate")
+    .description("Check a Lobsidian vault for issues")
+    .argument("[path]", "path to vault root", ".")
+    .option("--fix", "auto-fix safe issues (stale claims, orphaned tasks)", false)
+    .option("--json", "output results as JSON", false)
+    .option("--no-color", "disable colored output")
+    .option("--quiet", "show summary only", false)
+    .action((path, options) => {
+    const opts = {
+        path,
+        fix: options.fix === true,
+        json: options.json === true,
+        noColor: options.color === false, // commander negates --no-color to color=false
+        quiet: options.quiet === true,
+    };
+    const { findings, fileCount } = run(opts);
+    const output = formatReport(findings, fileCount, opts);
+    process.stdout.write(output);
+    // Exit codes: 0=clean, 1=warnings only, 2=errors
+    let hasErrors = false;
+    let hasWarnings = false;
+    for (const r of findings) {
+        if (r.severity === Severity.Error)
+            hasErrors = true;
+        else if (r.severity === Severity.Warning)
+            hasWarnings = true;
+    }
+    if (hasErrors)
+        process.exit(2);
+    if (hasWarnings)
+        process.exit(1);
+});
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KACnD,WAAW,CAAC,oCAAoC,CAAC;KACjD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,CAAC;KAC7C,MAAM,CAAC,OAAO,EAAE,qDAAqD,EAAE,KAAK,CAAC;KAC7E,MAAM,CAAC,QAAQ,EAAE,wBAAwB,EAAE,KAAK,CAAC;KACjD,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC;KAC9C,MAAM,CAAC,SAAS,EAAE,mBAAmB,EAAE,KAAK,CAAC;KAC7C,MAAM,CAAC,CAAC,IAAY,EAAE,OAAgC,EAAE,EAAE;IACzD,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,GAAG,EAAE,OAAO,CAAC,GAAG,KAAK,IAAI;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI;QAC3B,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,8CAA8C;QAChF,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI;KAC9B,CAAC;IAEF,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE7B,iDAAiD;IACjD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK;YAAE,SAAS,GAAG,IAAI,CAAC;aAC/C,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,OAAO;YAAE,WAAW,GAAG,IAAI,CAAC;IAC/D,CAAC;IAED,IAAI,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,WAAW;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/lib/content.d.ts

@@ -0,0 +1,11 @@
+export interface TemplateVars {
+    vaultName: string;
+    agentName: string;
+    date: string;
+    reviewDate: string;
+}
+export declare function defaultVars(vaultName: string, agentName: string): TemplateVars;
+export declare function render(content: string, vars: TemplateVars, filename: string): string;
+export declare function stripTmplExtension(filename: string): string;
+export declare function readEmbedded(path: string): string;
+export declare function listEmbedded(dir: string): string[];

package/dist/lib/content.js

@@ -0,0 +1,80 @@
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// defaultVars returns TemplateVars with sensible defaults.
+export function defaultVars(vaultName, agentName) {
+    const now = new Date();
+    const review = new Date(now);
+    review.setMonth(review.getMonth() + 3);
+    const fmt = (d) => d.getFullYear() + '-' +
+        String(d.getMonth() + 1).padStart(2, '0') + '-' +
+        String(d.getDate()).padStart(2, '0');
+    return {
+        vaultName,
+        agentName,
+        date: fmt(now),
+        reviewDate: fmt(review),
+    };
+}
+// render applies template variables to content if it contains Go-style template syntax.
+// Files ending in .tmpl are always treated as templates.
+// Other files are checked for {{ markers before processing.
+export function render(content, vars, filename) {
+    const isTemplate = filename.endsWith('.tmpl');
+    if (!isTemplate && !content.includes('{{'))
+        return content;
+    return content
+        .replace(/\{\{\.VaultName\}\}/g, vars.vaultName)
+        .replace(/\{\{\.AgentName\}\}/g, vars.agentName)
+        .replace(/\{\{\.Date\}\}/g, vars.date)
+        .replace(/\{\{\.ReviewDate\}\}/g, vars.reviewDate);
+}
+// stripTmplExtension removes the .tmpl suffix if present.
+export function stripTmplExtension(filename) {
+    return filename.endsWith('.tmpl') ? filename.slice(0, -5) : filename;
+}
+// Resolve the path to the embedded/ directory.
+// Works both from source (src/) and compiled (dist/) locations.
+function resolveEmbeddedDir() {
+    try {
+        // import.meta.url points to dist/lib/content.js or src/lib/content.ts
+        // embedded/ is at the package root, so ../../embedded from here
+        const thisDir = fileURLToPath(new URL('.', import.meta.url));
+        const candidate = resolve(thisDir, '..', '..', 'embedded');
+        statSync(candidate);
+        return candidate;
+    }
+    catch {
+        // Fallback: walk up from __dirname-like resolution
+        const thisDir = fileURLToPath(new URL('.', import.meta.url));
+        return resolve(thisDir, '..', '..', 'embedded');
+    }
+}
+const embeddedDir = resolveEmbeddedDir();
+// readEmbedded reads a file from the embedded directory.
+// path is relative to embedded/, e.g. "templates/motive.md"
+export function readEmbedded(path) {
+    return readFileSync(join(embeddedDir, path), 'utf-8');
+}
+// listEmbedded lists all files under a directory in the embedded filesystem.
+// Returns paths relative to embedded/, e.g. ["templates/motive.md", ...].
+export function listEmbedded(dir) {
+    const paths = [];
+    const base = join(embeddedDir, dir);
+    function walk(current) {
+        const entries = readdirSync(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = join(current, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+            }
+            else {
+                // Return path relative to embeddedDir
+                paths.push(full.slice(embeddedDir.length + 1));
+            }
+        }
+    }
+    walk(base);
+    return paths;
+}
+//# sourceMappingURL=content.js.map

package/dist/lib/content.js.map

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

package/dist/lib/frontmatter.d.ts

@@ -0,0 +1,29 @@
+export type ContentType = 'motive' | 'decision' | 'task' | 'domain' | 'log' | 'note' | 'config' | 'dashboard' | 'cascade-checkpoint' | 'bootstrap-consent';
+export declare const ALL_TYPES: ContentType[];
+export declare const CORE_TYPES: ContentType[];
+export declare const SYSTEM_TYPES: ContentType[];
+export declare function isKnownType(t: string): t is ContentType;
+export declare enum Severity {
+    Warning = 0,
+    Error = 1
+}
+export declare function severityString(s: Severity): string;
+export interface ValidationResult {
+    severity: Severity;
+    path: string;
+    line: number;
+    message: string;
+}
+export declare class Frontmatter {
+    fields: Record<string, unknown>;
+    fieldLines: Record<string, number>;
+    body: string;
+    rawYAML: string;
+    constructor(fields: Record<string, unknown>, fieldLines: Record<string, number>, body: string, rawYAML: string);
+    type(): ContentType | '';
+    getString(key: string): string;
+    getStringSlice(key: string): string[] | null;
+}
+export declare function parse(content: string): Frontmatter;
+export declare const EXPECTED_FOLDER: Partial<Record<ContentType, string>>;
+export declare function validate(fm: Frontmatter | null, path: string): ValidationResult[];