@cmnwlth/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,955 @@
+import { z } from 'zod';
+
+/**
+ * The four note kinds that make up a brain. See docs/02-data-model.md.
+ * One concept per file; kind determines the folder it lives in.
+ */
+declare const NOTE_KINDS: readonly ["memory", "decision", "work-state", "person"];
+type NoteKind = (typeof NOTE_KINDS)[number];
+/** Folder each kind is stored in, relative to the brain root. */
+declare const KIND_DIR: Record<NoteKind, string>;
+/**
+ * Dates are stored as `YYYY-MM-DD` strings. YAML parsers coerce unquoted dates to
+ * JS `Date`; this preprocessor normalizes both back to the canonical string form.
+ */
+declare const IsoDate: z.ZodEffects<z.ZodString, string, unknown>;
+declare const MemoryFrontmatter: z.ZodObject<{
+    kind: z.ZodLiteral<"memory">;
+    status: z.ZodDefault<z.ZodEnum<["active", "superseded", "stale"]>>;
+    /** Last time this fact was checked against reality (Kage-style verification). */
+    verified: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodLiteral<"memory">;
+    status: z.ZodDefault<z.ZodEnum<["active", "superseded", "stale"]>>;
+    /** Last time this fact was checked against reality (Kage-style verification). */
+    verified: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodLiteral<"memory">;
+    status: z.ZodDefault<z.ZodEnum<["active", "superseded", "stale"]>>;
+    /** Last time this fact was checked against reality (Kage-style verification). */
+    verified: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+type MemoryFrontmatter = z.infer<typeof MemoryFrontmatter>;
+declare const DecisionFrontmatter: z.ZodObject<{
+    kind: z.ZodLiteral<"decision">;
+    status: z.ZodDefault<z.ZodEnum<["proposed", "accepted", "superseded"]>>;
+    supersedes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deciders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodLiteral<"decision">;
+    status: z.ZodDefault<z.ZodEnum<["proposed", "accepted", "superseded"]>>;
+    supersedes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deciders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodLiteral<"decision">;
+    status: z.ZodDefault<z.ZodEnum<["proposed", "accepted", "superseded"]>>;
+    supersedes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deciders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+type DecisionFrontmatter = z.infer<typeof DecisionFrontmatter>;
+declare const WorkStateFrontmatter: z.ZodObject<{
+    kind: z.ZodLiteral<"work-state">;
+    owner: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["planned", "in-progress", "blocked", "done"]>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodLiteral<"work-state">;
+    owner: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["planned", "in-progress", "blocked", "done"]>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodLiteral<"work-state">;
+    owner: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["planned", "in-progress", "blocked", "done"]>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+type WorkStateFrontmatter = z.infer<typeof WorkStateFrontmatter>;
+declare const PersonFrontmatter: z.ZodObject<{
+    kind: z.ZodLiteral<"person">;
+    name: z.ZodString;
+    org: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodLiteral<"person">;
+    name: z.ZodString;
+    org: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodLiteral<"person">;
+    name: z.ZodString;
+    org: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+type PersonFrontmatter = z.infer<typeof PersonFrontmatter>;
+/**
+ * Discriminated union over `kind` — the validated frontmatter of any note. Each member is
+ * `.passthrough()` so unknown keys survive parse→serialize (#81): a field this build's schema
+ * doesn't know (a user's custom key, or one a newer schema added) is preserved rather than
+ * silently dropped when a note is re-serialized (e.g. sync's conflict sibling rewrite).
+ */
+declare const Frontmatter: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"memory">;
+    status: z.ZodDefault<z.ZodEnum<["active", "superseded", "stale"]>>;
+    /** Last time this fact was checked against reality (Kage-style verification). */
+    verified: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodLiteral<"memory">;
+    status: z.ZodDefault<z.ZodEnum<["active", "superseded", "stale"]>>;
+    /** Last time this fact was checked against reality (Kage-style verification). */
+    verified: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodLiteral<"memory">;
+    status: z.ZodDefault<z.ZodEnum<["active", "superseded", "stale"]>>;
+    /** Last time this fact was checked against reality (Kage-style verification). */
+    verified: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
+    kind: z.ZodLiteral<"decision">;
+    status: z.ZodDefault<z.ZodEnum<["proposed", "accepted", "superseded"]>>;
+    supersedes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deciders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodLiteral<"decision">;
+    status: z.ZodDefault<z.ZodEnum<["proposed", "accepted", "superseded"]>>;
+    supersedes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deciders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodLiteral<"decision">;
+    status: z.ZodDefault<z.ZodEnum<["proposed", "accepted", "superseded"]>>;
+    supersedes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deciders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
+    kind: z.ZodLiteral<"work-state">;
+    owner: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["planned", "in-progress", "blocked", "done"]>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodLiteral<"work-state">;
+    owner: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["planned", "in-progress", "blocked", "done"]>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodLiteral<"work-state">;
+    owner: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["planned", "in-progress", "blocked", "done"]>>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
+    kind: z.ZodLiteral<"person">;
+    name: z.ZodString;
+    org: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodLiteral<"person">;
+    name: z.ZodString;
+    org: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodLiteral<"person">;
+    name: z.ZodString;
+    org: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created: z.ZodEffects<z.ZodString, string, unknown>;
+    updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Originating project the note was captured from — a stable repo identity (git `origin`
+     * slug, else the repo-root basename). Lets a shared brain group/filter notes by project
+     * (ADR-0015). Optional: pre-existing and non-project notes are "unattributed".
+     */
+    source: z.ZodOptional<z.ZodString>;
+    /** Wikilink targets (`[[id]]` or bare id) to related notes. */
+    relates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>]>;
+type Frontmatter = z.infer<typeof Frontmatter>;
+/** A parsed note: validated frontmatter + markdown body + repo-relative path. */
+interface Note {
+    frontmatter: Frontmatter;
+    /** Markdown content after the frontmatter block. */
+    body: string;
+    /** Path relative to the brain root, e.g. `memory/2026-07-01-foo-a1b2.md`. */
+    path: string;
+}
+/** Current on-disk schema version, pinned in `.commonwealth/schema-version`. */
+declare const SCHEMA_VERSION = 1;
+
+/**
+ * Secret scanner (issue #16). A shared, synced brain must never carry credentials, so
+ * we detect and redact common, low-false-positive secrets. Used to block secrets at
+ * capture (curate) and to scrub hand-edited notes at pre-commit (sync) as defense in
+ * depth. Detection is intentionally conservative: patterns are tuned to real credential
+ * shapes so ordinary prose (e.g. "the password is rotated monthly") does not match.
+ */
+/** A single detected secret. Never carries the raw value — only a masked preview. */
+interface SecretMatch {
+    /** Which pattern matched (e.g. "aws-access-key-id", "github-token"). */
+    kind: string;
+    /** Zero-based index of the match start within the scanned text. */
+    index: number;
+    /** Length in characters of the matched substring. */
+    length: number;
+    /** The match with its middle masked (first4 + "..." + last2); never the full secret. */
+    preview: string;
+}
+/**
+ * Credential patterns, ordered most-specific first so a value that could match both a
+ * specific provider and the generic assignment is attributed to the specific provider.
+ * Each `re` MUST be global (`g`) so {@link findSecrets} can iterate all matches.
+ */
+declare const SECRET_PATTERNS: ReadonlyArray<{
+    kind: string;
+    re: RegExp;
+}>;
+/**
+ * Shannon entropy of `s` in BITS PER CHARACTER (0 for empty). A uniform random base64 string
+ * approaches ~6, hex ~4, English prose ~1–1.5. Used by the opt-in entropy detector to flag
+ * high-randomness tokens that match no named pattern (novel/custom secrets, #46).
+ */
+declare function shannonEntropy(s: string): number;
+/** Options for the scanners: opt-in entropy detection and a false-positive allowlist (#46). */
+interface ScanOptions {
+    /**
+     * Also flag high-entropy base64/hex tokens that match no named pattern. Default OFF: it needs
+     * the {@link ScanOptions.allowlist} to stay usable (git SHAs, UUIDs, base64 data can trip it),
+     * so a brain opts in via config rather than it changing the zero-FP default everywhere.
+     */
+    detectEntropy?: boolean;
+    /** Exact token values to never flag (accepted values / known false positives). Per-brain. */
+    allowlist?: readonly string[];
+}
+/**
+ * Scan `text` with every pattern in {@link ALL_PATTERNS} (our hand-tuned
+ * {@link SECRET_PATTERNS} first, then {@link GITLEAKS_PATTERNS}) and return the matches,
+ * deduplicated by start index and sorted by position. When two patterns hit the same
+ * index, the earlier (more specific) pattern wins. Previews are masked — the raw secret
+ * is never returned.
+ */
+declare function findSecrets(text: string, opts?: ScanOptions): SecretMatch[];
+/** True if `text` contains at least one detected secret. */
+declare function hasSecrets(text: string, opts?: ScanOptions): boolean;
+/**
+ * Replace every detected secret in `text` with a `[REDACTED:<kind>]` placeholder,
+ * preserving all surrounding content. Overlapping/duplicate matches are handled by
+ * {@link findSecrets}; replacement runs right-to-left so earlier indices stay valid.
+ */
+declare function redactSecrets(text: string, opts?: ScanOptions): string;
+
+/**
+ * Brain-level (shared, synced) configuration, stored at `<brain>/.commonwealth/config.json`
+ * (ADR-0009). Distinct from the per-user, unsynced scope config at `~/.commonwealth/config.json`
+ * (ADR-0008). Because it lives in the repo, `features` apply to the whole team.
+ */
+interface BrainConfig {
+    /** Human-readable brain name (defaults to the brain directory's basename). */
+    name: string;
+    /** On-disk schema version this brain is pinned to. */
+    schemaVersion: number;
+    /** Configured git remotes for sync (names or URLs). */
+    remotes: string[];
+    /** Free-form curation settings, reserved for the curator seam (ADR-0007). */
+    curation: Record<string, unknown>;
+    /** Team-wide feature toggles; see {@link FEATURE_FLAGS}. */
+    features: Record<string, boolean>;
+    /**
+     * Secret-scanner tuning (#46), committed so it applies team-wide. `entropy` opts into
+     * high-entropy detection beyond the named patterns; `allowlist` holds accepted values /
+     * known false positives to suppress. Off + empty by default (preserves the zero-FP default).
+     */
+    secretScan: {
+        entropy: boolean;
+        allowlist: string[];
+    };
+}
+/** Build the {@link ScanOptions} for the secret scanner from a brain's config (#46). */
+declare function scanOptions(config: BrainConfig): ScanOptions;
+/**
+ * Registry of the known feature flags: their name, a human-readable description, and the
+ * default (off unless a team opts in). New flags are added here; scaffold and
+ * {@link defaultBrainConfig} build the `features` block from this list.
+ */
+declare const FEATURE_FLAGS: ReadonlyArray<{
+    name: string;
+    description: string;
+    default: boolean;
+}>;
+/**
+ * A fresh {@link BrainConfig} for a brain named `name`: no remotes, empty curation, and the
+ * `features` block filled from {@link FEATURE_FLAGS} defaults. Pinned to `SCHEMA_VERSION`.
+ */
+declare function defaultBrainConfig(name: string): BrainConfig;
+/** Absolute path to a brain's shared config file (`<brainDir>/.commonwealth/config.json`). */
+declare function brainConfigPath(brainDir: string): string;
+/**
+ * Load a brain's shared config, merged over {@link defaultBrainConfig} so any missing
+ * top-level field AND any missing feature key is filled in (file values win; unknown
+ * feature keys present in the file are preserved). Never throws on a missing or unparseable
+ * file — returns the defaults in that case.
+ */
+declare function loadBrainConfig(brainDir: string): Promise<BrainConfig>;
+/**
+ * Persist a brain's shared config as pretty (2-space) JSON with a trailing newline at
+ * {@link brainConfigPath}, creating the `.commonwealth/` parent directory if needed.
+ */
+declare function saveBrainConfig(brainDir: string, config: BrainConfig): Promise<void>;
+/**
+ * True when `feature` is enabled in the brain's shared config. Unknown or unset flags are
+ * treated as disabled (`false`). Never throws on a missing config file.
+ */
+declare function isFeatureEnabled(brainDir: string, feature: string): Promise<boolean>;
+/**
+ * Set `feature` to `on` in the brain's shared config and persist it (load-modify-save).
+ * Missing top-level fields and feature keys are filled from defaults on the way through.
+ */
+declare function setFeature(brainDir: string, feature: string, on: boolean): Promise<void>;
+
+/** A fresh collision-avoidance suffix. */
+declare function shortId(): string;
+/** URL/filename-safe slug of a title, capped so filenames stay reasonable. */
+declare function slugify(title: string): string;
+/**
+ * Build a note id of the form `<created>-<slug>-<shortid>`, e.g.
+ * `2026-07-01-auth-choice-a1b2`. The id equals the filename stem and is stable.
+ */
+declare function makeNoteId(title: string, created: string, suffix?: string): string;
+/**
+ * A filesystem-safe single path segment for a project `source` (ADR-0015). The source may be
+ * an `owner/repo` slug; we flatten separators so a project is exactly one folder level
+ * (`<project>/<kind>/<id>.md`), keeping the tree a fixed depth. The full source stays in
+ * frontmatter. Empty/invalid input yields "" (→ unattributed, note lives at the kind root).
+ */
+declare function sourceSegment(source: string | undefined): string;
+/**
+ * Repo-relative path for a note. With a project `source` the note lives under a per-project
+ * subtree (`<project>/<kind>/<id>.md`, ADR-0015); without one it stays at the kind root
+ * (`<kind>/<id>.md`) — which is also the back-compat location for pre-provenance notes.
+ */
+declare function pathForNote(kind: NoteKind, id: string, source?: string): string;
+/** `YYYY-MM-DD` for a given date (defaults to now). */
+declare function today(date?: Date): string;
+
+/**
+ * Input to create a new note. `id`, `created` (defaults to today), and the file path are
+ * derived; kind-specific fields (e.g. a decision's `deciders`) go in `fields` and are
+ * validated against the schema.
+ */
+interface NewNoteInput {
+    kind: NoteKind;
+    title: string;
+    body: string;
+    tags?: string[];
+    author?: string;
+    /** Originating project (git repo identity); recorded as frontmatter `source` (ADR-0015). */
+    source?: string;
+    /** `YYYY-MM-DD`; defaults to today. */
+    created?: string;
+    /** Extra kind-specific frontmatter fields, validated against the schema. */
+    fields?: Record<string, unknown>;
+}
+/**
+ * Parse a raw markdown-with-frontmatter string into a validated {@link Note}.
+ * Throws (zod) if the frontmatter does not satisfy the schema for its `kind`.
+ */
+declare function parseNote(raw: string, notePath: string): Note;
+/**
+ * Resolve `relPath` under `brainDir` and assert it stays inside the brain (path containment).
+ * A `relPath` containing `../` — from a malicious MCP `read` arg or an attacker-controlled note
+ * id — would otherwise escape the brain and read/write arbitrary files (#76, #77). Boundary-safe:
+ * `/brain` does not contain `/brainiac`. Returns the resolved absolute path.
+ */
+declare function resolveWithinBrain(brainDir: string, relPath: string): string;
+/** Serialize a {@link Note} back to canonical `---`-fenced frontmatter + body. */
+declare function serializeNote(note: Note): string;
+/**
+ * Create a new note atomically under `brainDir`. The id embeds a random suffix
+ * (`makeNoteId`), so two concurrent writers of the same title+date produce distinct
+ * files that git unions rather than conflicts (ADR-0003). Writes to a temp file then
+ * renames, so readers never observe a partial file.
+ */
+declare function writeNote(brainDir: string, input: NewNoteInput): Promise<Note>;
+/**
+ * Overwrite an existing note's file with `note` (its `path`), atomically (tmp + rename). Unlike
+ * {@link writeNote} this INTENDS to replace an existing file — used to supersede a note in place
+ * (#29), never to create. Throws if the resolved path escapes the brain (#76).
+ */
+declare function overwriteNote(brainDir: string, note: Note): Promise<void>;
+/**
+ * Mark a memory/decision note superseded IN PLACE (supersede-not-delete, ADR-0008/#29): set
+ * `status: "superseded"` and `superseded_by: <survivorId>`, additive so it union-merges. Only
+ * memory and decision carry these fields; other kinds are returned unchanged (no-op). Returns
+ * the updated note, or the original when it isn't a supersede-able kind / is already superseded
+ * by the same survivor.
+ */
+declare function supersedeNote(brainDir: string, relPath: string, survivorId: string): Promise<Note>;
+/** Read and parse a single note by its repo-relative path. */
+declare function readNote(brainDir: string, relPath: string): Promise<Note>;
+/**
+ * List all notes, optionally filtered to one kind. Layout-agnostic (ADR-0015): notes may live
+ * at the kind root (`<kind>/<id>.md`, unattributed) or under a per-project subtree
+ * (`<project>/<kind>/<id>.md`). A file is a note when its PARENT folder is a kind folder and it
+ * is not the generated `INDEX.md`; the authoritative kind comes from frontmatter. Skips derived
+ * (`index/`), local (`staging/`), and vcs dirs so canon never includes staged/derived files.
+ */
+declare function listNotes(brainDir: string, kind?: NoteKind): Promise<Note[]>;
+
+interface InitBrainOptions {
+    /** Human-readable brain name, written into COMMONWEALTH.md / .commonwealth/config. */
+    name?: string;
+    /** Proceed even if the directory already contains files. */
+    force?: boolean;
+}
+/**
+ * Initialize a brain repository skeleton at `dir` (see docs/01-architecture.md §1,
+ * docs/02-data-model.md). Creates:
+ *   - the four kind folders: memory/ decisions/ work-state/ people/ (each with `.gitkeep`)
+ *   - `.commonwealth/` with `schema-version` and a `config.json` (name, schemaVersion, remotes, curation)
+ *   - `.gitattributes` with `merge=union` for derived/append-only files (ADR-0003)
+ *   - `.gitignore` ignoring the derived `index/` and `*.db`
+ *   - a generated `COMMONWEALTH.md` router and per-folder `INDEX.md` placeholders
+ *   - a git repository with an initial commit (a brain *is* a git repo; ADR-0003, ADR-0013)
+ *
+ * Idempotent: safe to call again; missing files are (re)created and an existing `.git` is left
+ * untouched. Throws if `dir` already contains non-Commonwealth files and `force` is not set.
+ */
+declare function initBrain(dir: string, opts?: InitBrainOptions): Promise<void>;
+declare const BRAIN_KIND_DIRS: readonly string[];
+
+interface SearchOptions {
+    kind?: NoteKind;
+    /** Restrict to notes from one originating project (frontmatter `source`; ADR-0015). */
+    source?: string;
+    /** Max results (default 20). */
+    limit?: number;
+}
+interface SearchResult {
+    id: string;
+    kind: NoteKind;
+    title: string;
+    path: string;
+    /** Originating project, when the note carries one. */
+    source?: string;
+    /** Highlighted excerpt around the match. */
+    snippet: string;
+    /** Relevance score (higher = better). */
+    score: number;
+}
+/**
+ * (Re)build the derived SQLite FTS5 index from the markdown notes under `brainDir`.
+ * The index lives at `index/commonwealth.db`, is gitignored, and is fully disposable —
+ * it can always be rebuilt from the files. See ADR-0005.
+ *
+ * Performs a FULL rebuild each call (DROP + CREATE) so the result is a pure function
+ * of the note set and running it twice is idempotent. Returns the count indexed.
+ */
+declare function buildIndex(brainDir: string): Promise<{
+    indexed: number;
+}>;
+/**
+ * Lexical (FTS5) search over title, body, and tags. Builds the index on first use if it
+ * is missing, but does NOT detect subsequent note additions/edits/removals — the index
+ * refreshes only when {@link buildIndex} is called. Callers that need fresh results after
+ * writes should rebuild first.
+ */
+declare function search(brainDir: string, query: string, opts?: SearchOptions): Promise<SearchResult[]>;
+/**
+ * Regenerate derived, never-hand-merged artifacts from the note set: the `COMMONWEALTH.md`
+ * router (grouped by project, ADR-0015) and an `INDEX.md` in every directory that holds notes
+ * (`<kind>/` and `<project>/<kind>/`). Idempotent — output is a pure function of the files
+ * (ADR-0003), so running twice yields byte-identical files.
+ */
+declare function regenerateDerived(brainDir: string): Promise<void>;
+
+/** One prefix → brain mapping entry in the user registry file. */
+interface RegistryMapping {
+    /** A path prefix (tilde-allowed); a `cwd` under it maps to {@link brain}. */
+    prefix: string;
+    /** The brain directory (tilde-allowed) to use for cwds under {@link prefix}. */
+    brain: string;
+}
+/** Shape of the user registry JSON file (`~/.commonwealth/registry.json`). */
+interface Registry {
+    mappings: RegistryMapping[];
+}
+/** Options for {@link resolveBrainDir}; all optional (env + registry path overrides). */
+interface ResolveBrainOptions {
+    /** Explicit value to use instead of `process.env.COMMONWEALTH_BRAIN_DIR` (step 4). */
+    env?: string;
+    /** Explicit registry file path, overriding the default resolution (step 3). */
+    registryPath?: string;
+}
+/**
+ * Resolve the brain directory for `startDir`. First hit wins:
+ *
+ * 1. Walk up from `startDir`: a `.commonwealth/brain` marker file (a path, `~`-expanded and
+ *    resolved relative to the dir holding it) pins the brain explicitly — but only when that
+ *    target directory exists. A marker pointing at a missing brain is skipped so a stale/
+ *    dangling marker falls through to the registry instead of hijacking resolution (#68).
+ * 2. Walk up: a directory that is itself a brain (`.commonwealth/schema-version`) resolves to
+ *    itself.
+ * 3. The user registry file (`opts.registryPath` ?? `$COMMONWEALTH_REGISTRY` ?? sibling of
+ *    `$COMMONWEALTH_CONFIG` ?? `~/.commonwealth/registry.json`): the first `prefix` (tilde-expanded,
+ *    resolved) that `startDir` is under → its `brain` (tilde-expanded).
+ * 4. `opts.env` ?? `process.env.COMMONWEALTH_BRAIN_DIR`, if set.
+ * 5. `null`.
+ *
+ * Never throws on missing/unreadable files.
+ */
+declare function resolveBrainDir(startDir: string, opts?: ResolveBrainOptions): Promise<string | null>;
+/**
+ * Write the `.commonwealth/brain` marker in `projectDir` naming `brainPath`, creating the
+ * `.commonwealth/` directory if needed. Used to pin a project to its brain (registry step 1).
+ */
+declare function setBrainMarker(projectDir: string, brainPath: string): Promise<void>;
+/**
+ * The default user registry path (public wrapper over the internal resolver): honors
+ * `$COMMONWEALTH_REGISTRY`, then a `registry.json` sibling of `$COMMONWEALTH_CONFIG`, then
+ * `~/.commonwealth/registry.json`. This is where onboarding writes the project→brain map
+ * (resolution layer 3, the default source of truth).
+ */
+declare function defaultRegistryPath(): string;
+/**
+ * The default convenience-symlink directory (`brains/` next to the registry file), where
+ * `~/.commonwealth/brains/<name>` symlinks let a human `ls`/`cd` their brains.
+ */
+declare function defaultBrainsDir(): string;
+/**
+ * Add (or update) a `prefix → brain` mapping in the user registry, the default brain-wiring
+ * source of truth (resolution layer 3). Both `prefix` and `brain` are `~`-expanded and
+ * resolved to absolute paths; dedupe is by expanded prefix:
+ *
+ * - no mapping with this prefix → push `{ prefix, brain }` (`added: true`);
+ * - a mapping with this prefix but a DIFFERENT brain → update it (`updated: true`);
+ * - an identical mapping → no-op (`{ added: false, updated: false }`).
+ *
+ * Idempotent. Creates the registry's directory if missing and persists pretty (2-space) JSON
+ * atomically (tmp file + rename) so a crash mid-write cannot corrupt it. A present-but-corrupt
+ * registry is NOT clobbered: it is backed up to `registry.json.corrupt-<ts>` and a clear error is
+ * thrown, so a transient/partial-write corruption never silently wipes every other project's
+ * brain wiring (#78). A missing file is treated as an empty registry (the normal first-run case).
+ */
+declare function addRegistryMapping(prefix: string, brain: string, registryPath?: string): Promise<{
+    added: boolean;
+    updated: boolean;
+}>;
+/**
+ * Drop a convenience symlink `<brainsDir>/<name> → <brainDir>` so a human can `ls`/`cd` their
+ * brains. `name` is sanitized via `path.basename`; an empty/`.`/`..` name is rejected. If a
+ * symlink already resolves to the target it is a no-op; a symlink pointing elsewhere is
+ * replaced; a real (non-symlink) file/dir at the path is left intact and reported as skipped.
+ * Never throws for unsupported/permission cases (Windows/EPERM/EACCES/ENOSYS/EEXIST) — those
+ * are reported via `skipped`.
+ */
+declare function linkBrain(name: string, brainDir: string, brainsDir?: string): Promise<{
+    path: string;
+    linked: boolean;
+    skipped?: string;
+}>;
+
+/**
+ * Resolve a stable project identity for `cwd` — the value stamped as a note's frontmatter
+ * `source` so a shared brain can group/filter notes by originating project (ADR-0015).
+ *
+ * Order: the nearest ancestor git repo's `origin` remote, slugified to `owner/repo` → else
+ * that repo root's basename → else the basename of `cwd`. Best-effort and never throws: git
+ * being absent/erroring degrades to the basename. Returns `null` only for an empty input.
+ */
+declare function resolveProjectSource(cwd: string): Promise<string | null>;
+/**
+ * Reduce a git remote URL to a stable `owner/repo` identity (or bare `repo` when there is no
+ * owner segment). Handles `git@host:owner/repo.git`, `https://host/owner/repo(.git)`, and
+ * `ssh://host/owner/repo`. Returns null when nothing usable can be extracted.
+ */
+declare function slugFromRemote(remote: string): string | null;
+
+/**
+ * Brain-health / trust rollup (#109). A shared brain rots if it can't tell fresh from stale, so
+ * this surfaces decay: stale, never-verified, contradiction-flagged, and orphaned notes, plus a
+ * single headline freshness/trust score. Pure and read-only — computed from the note set (the
+ * source of truth), never written back (ADR-0003).
+ */
+/** Default age (days) past which an active memory note counts as stale. Overridable per call. */
+declare const DEFAULT_STALE_AFTER_DAYS = 90;
+/** One bucket of the rollup: how many notes, and which (by id, for drill-down). */
+interface HealthBucket {
+    count: number;
+    ids: string[];
+}
+/** The brain-health rollup for a note set. */
+interface HealthReport {
+    /** Notes considered. */
+    total: number;
+    /** Explicitly `status: stale`, or an active memory note older than the stale threshold. */
+    stale: HealthBucket;
+    /** Active memory notes never checked against reality (no `verified` date). */
+    unverified: HealthBucket;
+    /** Notes flagged as contradicted (a `contradicted` tag; the future embeddings signal, #107). */
+    contradicted: HealthBucket;
+    /** Notes nothing else links to (no inbound `relates`/`supersedes`/`superseded_by`/`sources`). */
+    orphaned: HealthBucket;
+    /** Composite freshness/trust score, 0–100 (100 = nothing decayed; empty brain = 100). */
+    score: number;
+}
+/** Options for {@link brainHealth}. */
+interface HealthOptions {
+    /** Age in days past which an active memory note is stale (default {@link DEFAULT_STALE_AFTER_DAYS}). */
+    staleAfterDays?: number;
+    /** "Today" as `YYYY-MM-DD`; defaults to the real date. Injectable for deterministic tests. */
+    now?: string;
+}
+/**
+ * Compute the {@link HealthReport} for `notes`. Definitions:
+ * - **stale**: `status: stale` (memory), OR an `active` memory note whose last touch
+ *   (`verified` ?? `updated` ?? `created`) is older than `staleAfterDays`.
+ * - **unverified**: `active` memory notes with no `verified` date.
+ * - **contradicted**: any note carrying a `contradicted` tag.
+ * - **orphaned**: notes whose id is referenced by NO other note (no inbound links).
+ * - **score**: `100 * (1 - (serious + 0.5·soft)/total)`, where serious = stale ∪ contradicted and
+ *   soft = (unverified ∪ orphaned) minus serious. Clamped to [0,100]; empty brain scores 100.
+ */
+declare function brainHealth(notes: Note[], opts?: HealthOptions): HealthReport;
+/** Load a brain's notes and compute its {@link HealthReport}. Read-only; never writes canon. */
+declare function computeBrainHealth(brainDir: string, opts?: HealthOptions): Promise<HealthReport>;
+
+/**
+ * Try to acquire the sync lock for `brainDir`. Returns a `release` function on success, or
+ * `null` when another LIVE process currently holds it (the caller should skip this pass). A
+ * stale lock (dead owner, or unreadable) is reclaimed and acquisition retried once. Never throws
+ * for the contended case; genuine IO errors propagate.
+ */
+declare function acquireSyncLock(brainDir: string): Promise<(() => Promise<void>) | null>;
+
+export { BRAIN_KIND_DIRS, type BrainConfig, DEFAULT_STALE_AFTER_DAYS, DecisionFrontmatter, FEATURE_FLAGS, Frontmatter, type HealthBucket, type HealthOptions, type HealthReport, type InitBrainOptions, IsoDate, KIND_DIR, MemoryFrontmatter, NOTE_KINDS, type NewNoteInput, type Note, type NoteKind, PersonFrontmatter, type Registry, type RegistryMapping, type ResolveBrainOptions, SCHEMA_VERSION, SECRET_PATTERNS, type ScanOptions, type SearchOptions, type SearchResult, type SecretMatch, WorkStateFrontmatter, acquireSyncLock, addRegistryMapping, brainConfigPath, brainHealth, buildIndex, computeBrainHealth, defaultBrainConfig, defaultBrainsDir, defaultRegistryPath, findSecrets, hasSecrets, initBrain, isFeatureEnabled, linkBrain, listNotes, loadBrainConfig, makeNoteId, overwriteNote, parseNote, pathForNote, readNote, redactSecrets, regenerateDerived, resolveBrainDir, resolveProjectSource, resolveWithinBrain, saveBrainConfig, scanOptions, search, serializeNote, setBrainMarker, setFeature, shannonEntropy, shortId, slugFromRemote, slugify, sourceSegment, supersedeNote, today, writeNote };