@gmickel/gno 1.8.0 → 1.9.0

package/README.md

@@ -97,7 +97,11 @@ gno daemon --detach  # headless continuous indexing (background; --status / --st
 
 - **Second-brain capture**: `gno capture`, REST `/api/capture`, SDK
   `client.capture()`, MCP `gno_capture`, and Web UI Quick Capture write
-  provenance-rich notes from text, stdin, or files
+  provenance-rich notes from text, stdin, or files, including typed presets for
+  ideas, people, company/projects, and meetings
+- **Schema-lite content types**: optional `contentTypes` rules map configured
+  frontmatter `type` values or path prefixes to canonical `contentType` metadata
+  in JSON search/query results
 - **Publish to [gno.sh](https://gno.sh/publish)**: new `gno publish export` CLI and Web UI action produce a self-contained artifact you upload to the hosted reader — public, secret, invite-only, or locally encrypted before upload
 - **Retrieval Quality Upgrade**: stronger BM25 lexical handling, code-aware chunking, terminal result hyperlinks, and per-collection model overrides
 - **Code Embedding Benchmarks**: new benchmark workflow across canonical, real-GNO, and pinned OSS slices for comparing alternate embedding models
@@ -546,7 +550,7 @@ Open `http://localhost:3000` to:
 - **Browse**: Cross-collection tree workspace with folder detail panes and per-tab browse context
 - **Edit**: Create, edit, and delete documents with live preview
 - **Create in place**: New notes in the current folder/collection with presets and command-palette flows
-- **Capture with provenance**: `gno capture` and Web UI Quick Capture write quick notes to an editable collection with structured `source:` metadata and a receipt that separates write, sync, and embed state
+- **Capture with provenance**: `gno capture` and Web UI Quick Capture write quick notes to an editable collection with structured `source:` metadata, typed preset scaffolds, and a receipt that separates write, sync, and embed state
 - **Same capture contract everywhere**: CLI, MCP `gno_capture`, REST `/api/capture`, SDK `client.capture()`, and Web UI Quick Capture return the same provenance receipt shape
 - **Ask**: AI-powered Q&A with citations
 - **Manage Collections**: Add, remove, and re-index collections

package/assets/skill/SKILL.md

@@ -214,8 +214,21 @@ Use `gno capture` for quick second-brain writes into an editable collection:
 ```bash
 gno capture "thought to remember"
 gno capture --file ./clip.md --source-url https://example.com --source-kind web --json
+gno capture --preset person --title "Jane Doe" --folder people/
+gno capture --preset meeting --title "Weekly sync" --folder meetings/
 ```
 
+Preset IDs: `blank`, `project-note`, `research-note`, `decision-note`,
+`prompt-pattern`, `source-summary`, `idea-original`, `person`,
+`company-project`, `meeting`.
+
+For second-brain pages, prefer the typed presets:
+
+- `idea-original`: exact idea phrasing, context, related concepts, publish potential.
+- `person`: current state, relationship, assessment, open threads, timeline.
+- `company-project`: state, changes, decisions, people, timeline.
+- `meeting`: synthesis/action analysis above `## Timeline`; raw notes below.
+
 The JSON receipt reports write, sync, and embed status separately. Generated
 captures land under `inbox/YYYY-MM-DD/capture-<body-hash>.md` unless `--path`,
 `--folder`, or `--title` overrides the path. Capture does not imply embedding

package/assets/skill/cli-reference.md

@@ -124,6 +124,15 @@ gno capture --file ./clip.md --source-url https://example.com --source-kind web
 gno capture "meeting note" --quiet
 ```
 
+Preset IDs: `blank`, `project-note`, `research-note`, `decision-note`,
+`prompt-pattern`, `source-summary`, `idea-original`, `person`,
+`company-project`, `meeting`.
+
+Second-brain presets keep current synthesis above `## Timeline` and dated
+evidence below it. Use `idea-original` for exact idea wording, `person` for
+relationship/current-state notes, `company-project` for organizations or active
+workstreams, and `meeting` for analysis above transcript/raw notes/action items.
+
 Important behavior:
 
 - Inline content, `--stdin`, and `--file` are mutually exclusive.

package/assets/skill/examples.md

@@ -359,6 +359,27 @@ gno capture "thought to remember"
 gno capture --file ./clip.md --source-url https://example.com --source-kind web --json
 ```
 
+### Typed second-brain presets
+
+```bash
+# Original idea: preserve exact phrasing and related concepts
+gno capture --preset idea-original --title "Local-first inbox triage" --folder ideas/
+
+# Person page: current synthesis plus relationship/open threads/timeline
+gno capture --preset person --title "Jane Doe" --folder people/
+
+# Company/project page: state, decisions, people, and timeline
+gno capture --preset company-project --title "Acme renewal" --folder projects/
+
+# Meeting page: analysis above raw notes, transcript, and action items
+gno capture --preset meeting --title "Weekly sync" --folder meetings/
+```
+
+For these presets, keep current synthesis above `## Timeline`; put dated evidence
+and raw chronology below it. If `contentTypes` are configured in `index.yml`,
+matching frontmatter `type` or path prefixes become `contentType` in JSON search
+results.
+
 ### Web UI quick capture
 
 Press **N** in `gno serve`, write the note, and open **Source** only when you

package/assets/skill/mcp-reference.md

@@ -76,6 +76,12 @@ frontmatter and returns the same provenance receipt shape as CLI, REST, and SDK
 capture, plus legacy MCP fields (`docid`, `absPath`, `overwritten`,
 `serverInstanceId`).
 
+`presetId` accepts `blank`, `project-note`, `research-note`, `decision-note`,
+`prompt-pattern`, `source-summary`, `idea-original`, `person`,
+`company-project`, or `meeting`. The typed second-brain presets use flat
+frontmatter (`type`, `category`, `tags`) and a synthesis/timeline page pattern;
+provenance still comes from the capture `source` fields, not the preset.
+
 Use `collisionPolicy: "open_existing"` to return an existing note without
 rewriting, `create_with_suffix` to create the next available path, or legacy
 `overwrite: true` to replace the target path. Capture content must be text, and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",

package/src/cli/commands/capture.ts

@@ -26,7 +26,7 @@ import {
 } from "../../core/capture";
 import { writeCapturePlanFile } from "../../core/capture-write";
 import { withWriteLock } from "../../core/file-lock";
-import { defaultSyncService } from "../../ingestion";
+import { defaultSyncService, withContentTypeRules } from "../../ingestion";
 import { CliError } from "../errors";
 import { initStore } from "./shared";
 
@@ -140,7 +140,7 @@ export async function capture(
     throw new CliError("VALIDATION", storeInit.error);
   }
 
-  const { store, collections } = storeInit;
+  const { store, collections, config } = storeInit;
   try {
     const collectionName = options.collection?.trim();
     const collection = collectionName
@@ -222,10 +222,13 @@ export async function capture(
         collection,
         store,
         [plan.relPath],
-        {
-          runUpdateCmd: false,
-          gitPull: false,
-        }
+        withContentTypeRules(
+          {
+            runUpdateCmd: false,
+            gitPull: false,
+          },
+          config
+        )
       );
       const syncResult = syncResults[0];
       const docResult = await store.getDocument(collection.name, plan.relPath);

package/src/cli/commands/index-cmd.ts

@@ -5,7 +5,11 @@
  * @module src/cli/commands/indexCmd
  */
 
-import { defaultSyncService, type SyncResult } from "../../ingestion";
+import {
+  defaultSyncService,
+  type SyncResult,
+  withContentTypeRules,
+} from "../../ingestion";
 import { formatSyncResultLines, initStore } from "./shared";
 
 /**
@@ -55,14 +59,21 @@ export async function index(options: IndexOptions = {}): Promise<IndexResult> {
     return { success: false, error: initResult.error };
   }
 
-  const { store, collections } = initResult;
+  const { store, collections, config } = initResult;
 
   try {
     // Run sync service (update phase)
-    const syncResult = await defaultSyncService.syncAll(collections, store, {
-      gitPull: options.gitPull,
-      runUpdateCmd: true,
-    });
+    const syncResult = await defaultSyncService.syncAll(
+      collections,
+      store,
+      withContentTypeRules(
+        {
+          gitPull: options.gitPull,
+          runUpdateCmd: true,
+        },
+        config
+      )
+    );
 
     // Embedding phase
     const embedSkipped = options.noEmbed ?? false;

package/src/cli/commands/shared.ts

@@ -10,7 +10,12 @@ import type { SyncResult } from "../../ingestion";
 import type { SearchResults } from "../../pipeline/types";
 
 import { decorateUriForIndex, getIndexDbPath } from "../../app/constants";
-import { getConfigPaths, isInitialized, loadConfig } from "../../config";
+import {
+  getConfigPaths,
+  isInitialized,
+  loadConfig,
+  writeConfigWarningsToStderr,
+} from "../../config";
 import { SqliteAdapter } from "../../store/sqlite/adapter";
 
 /**
@@ -61,6 +66,7 @@ export async function initStore(
   if (!configResult.ok) {
     return { ok: false, error: configResult.error.message };
   }
+  writeConfigWarningsToStderr(configResult.warnings);
   const config = configResult.value;
 
   // Filter to single collection if specified
@@ -165,6 +171,16 @@ export function formatSyncResultLines(
         lines.push(`    [${err.code}] ${err.relPath}: ${err.message}`);
       }
     }
+    if (options.verbose && c.files?.length) {
+      for (const file of c.files) {
+        if (!file.contentType || !file.contentTypeSource) {
+          continue;
+        }
+        lines.push(
+          `    [${file.status}] ${file.relPath}: contentType=${file.contentType} (${file.contentTypeSource})`
+        );
+      }
+    }
   }
 
   lines.push("");

package/src/cli/commands/update.ts

@@ -5,7 +5,11 @@
  * @module src/cli/commands/update
  */
 
-import { defaultSyncService, type SyncResult } from "../../ingestion";
+import {
+  defaultSyncService,
+  type SyncResult,
+  withContentTypeRules,
+} from "../../ingestion";
 import { formatSyncResultLines, initStore } from "./shared";
 
 /**
@@ -43,14 +47,21 @@ export async function update(
     return { success: false, error: initResult.error };
   }
 
-  const { store, collections } = initResult;
+  const { store, collections, config } = initResult;
 
   try {
     // Run sync service
-    const result = await defaultSyncService.syncAll(collections, store, {
-      gitPull: options.gitPull,
-      runUpdateCmd: true,
-    });
+    const result = await defaultSyncService.syncAll(
+      collections,
+      store,
+      withContentTypeRules(
+        {
+          gitPull: options.gitPull,
+          runUpdateCmd: true,
+        },
+        config
+      )
+    );
 
     return { success: true, result };
   } finally {

package/src/config/content-types.ts

@@ -0,0 +1,140 @@
+/**
+ * Content type config normalization.
+ *
+ * @module src/config/content-types
+ */
+
+import type { NotePresetId } from "../core/note-presets";
+import type { Config, ContentTypeConfig } from "./types";
+
+import { NOTE_PRESETS } from "../core/note-presets";
+
+export type ConfigWarningCode =
+  | "UNKNOWN_CONTENT_TYPE_PRESET"
+  | "DUPLICATE_CONTENT_TYPE_PREFIX";
+
+export interface ConfigWarning {
+  code: ConfigWarningCode;
+  message: string;
+  path: string;
+}
+
+export interface NormalizedContentTypeRule extends ContentTypeConfig {
+  preset: NotePresetId;
+}
+
+export interface ContentTypeNormalizationResult {
+  rules: NormalizedContentTypeRule[];
+  warnings: ConfigWarning[];
+}
+
+export interface ConfigNormalizationResult {
+  config: Config;
+  warnings: ConfigWarning[];
+}
+
+const NOTE_PRESET_IDS = new Set<NotePresetId>(
+  NOTE_PRESETS.map((preset) => preset.id)
+);
+
+function isNotePresetId(value: string): value is NotePresetId {
+  return NOTE_PRESET_IDS.has(value as NotePresetId);
+}
+
+export function normalizeContentTypes(
+  contentTypes: ContentTypeConfig[]
+): ContentTypeNormalizationResult {
+  const warnings: ConfigWarning[] = [];
+  const seenPrefixes = new Set<string>();
+  const rules: NormalizedContentTypeRule[] = [];
+
+  for (const [typeIndex, contentType] of contentTypes.entries()) {
+    const path = `contentTypes[${typeIndex}]`;
+    if (!isNotePresetId(contentType.preset)) {
+      warnings.push({
+        code: "UNKNOWN_CONTENT_TYPE_PRESET",
+        path: `${path}.preset`,
+        message: `Dropped content type "${contentType.id}" because preset "${contentType.preset}" is not a known note preset.`,
+      });
+      continue;
+    }
+
+    const prefixes: string[] = [];
+    for (const [prefixIndex, prefix] of contentType.prefixes.entries()) {
+      if (seenPrefixes.has(prefix)) {
+        warnings.push({
+          code: "DUPLICATE_CONTENT_TYPE_PREFIX",
+          path: `${path}.prefixes[${prefixIndex}]`,
+          message: `Dropped duplicate content type prefix "${prefix}" from "${contentType.id}".`,
+        });
+        continue;
+      }
+
+      seenPrefixes.add(prefix);
+      prefixes.push(prefix);
+    }
+
+    if (prefixes.length === 0) {
+      rules.push({
+        ...contentType,
+        preset: contentType.preset,
+        prefixes,
+      });
+      continue;
+    }
+
+    rules.push({
+      ...contentType,
+      preset: contentType.preset,
+      prefixes: [...prefixes].sort((a, b) => b.length - a.length),
+    });
+  }
+
+  rules.sort((a, b) => {
+    const aLongest = a.prefixes[0]?.length ?? 0;
+    const bLongest = b.prefixes[0]?.length ?? 0;
+    return bLongest - aLongest;
+  });
+
+  return { rules, warnings };
+}
+
+export function normalizeConfigContentTypes(
+  config: Config
+): ConfigNormalizationResult {
+  const normalized = normalizeContentTypes(config.contentTypes ?? []);
+  return {
+    config: {
+      ...config,
+      contentTypes: normalized.rules,
+    },
+    warnings: normalized.warnings,
+  };
+}
+
+export function fingerprintContentTypeRules(
+  rules: NormalizedContentTypeRule[]
+): string {
+  const canonical = rules.map((rule) => ({
+    id: rule.id,
+    preset: rule.preset,
+    prefixes: rule.prefixes,
+  }));
+  const hasher = new Bun.CryptoHasher("sha256");
+  hasher.update(JSON.stringify(canonical));
+  return hasher.digest("hex");
+}
+
+export function formatConfigWarning(warning: ConfigWarning): string {
+  return `[config] ${warning.path}: ${warning.message}`;
+}
+
+export function formatConfigWarnings(warnings?: ConfigWarning[]): string[] {
+  return (warnings ?? []).map(formatConfigWarning);
+}
+
+export function writeConfigWarningsToStderr(warnings?: ConfigWarning[]): void {
+  for (const warning of formatConfigWarnings(warnings)) {
+    process.stderr.write(`${warning}\n`);
+  }
+}

package/src/config/defaults.ts

@@ -16,5 +16,6 @@ export function createDefaultConfig(): Config {
     ftsTokenizer: DEFAULT_FTS_TOKENIZER,
     collections: [],
     contexts: [],
+    contentTypes: [],
   };
 }

package/src/config/index.ts

@@ -5,6 +5,16 @@
  */
 
 export { createDefaultConfig } from "./defaults";
+export {
+  type ConfigWarning,
+  fingerprintContentTypeRules,
+  formatConfigWarning,
+  formatConfigWarnings,
+  normalizeConfigContentTypes,
+  normalizeContentTypes,
+  type NormalizedContentTypeRule,
+  writeConfigWarningsToStderr,
+} from "./content-types";
 // Loading
 export {
   isInitialized,
@@ -40,6 +50,10 @@ export {
   CollectionSchema,
   type Config,
   ConfigSchema,
+  CONTENT_TYPE_GRAPH_HINTS,
+  type ContentTypeConfig,
+  type ContentTypeGraphHint,
+  ContentTypeSchema,
   type Context,
   ContextSchema,
   DEFAULT_EXCLUDES,

package/src/config/loader.ts

@@ -7,6 +7,10 @@
 
 import type { ZodError } from "zod";
 
+import {
+  normalizeConfigContentTypes,
+  type ConfigWarning,
+} from "./content-types";
 import { configExists, expandPath, getConfigPaths } from "./paths";
 import { CONFIG_VERSION, type Config, ConfigSchema } from "./types";
 
@@ -15,7 +19,7 @@ import { CONFIG_VERSION, type Config, ConfigSchema } from "./types";
 // ─────────────────────────────────────────────────────────────────────────────
 
 export type LoadResult<T> =
-  | { ok: true; value: T }
+  | { ok: true; value: T; warnings: ConfigWarning[] }
   | { ok: false; error: LoadError };
 
 export type LoadError =
@@ -128,7 +132,12 @@ export async function loadConfigFromPath(
     };
   }
 
-  return { ok: true, value: result.data };
+  const normalized = normalizeConfigContentTypes(result.data);
+  return {
+    ok: true,
+    value: normalized.config,
+    warnings: normalized.warnings,
+  };
 }
 
 /**

package/src/config/types.ts

@@ -245,6 +245,37 @@ export const ModelConfigSchema = z.object({
 
 export type ModelConfig = z.infer<typeof ModelConfigSchema>;
 
+// ─────────────────────────────────────────────────────────────────────────────
+// Content Type Schema
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const CONTENT_TYPE_GRAPH_HINTS = [
+  "mentions",
+  "works_at",
+  "attended",
+  "decided",
+  "related_to",
+] as const;
+
+export type ContentTypeGraphHint = (typeof CONTENT_TYPE_GRAPH_HINTS)[number];
+
+export const ContentTypeSchema = z.object({
+  /** Stable content type identifier */
+  id: z.string().min(1),
+  /** Relative path prefixes that map to this content type */
+  prefixes: z.array(z.string().min(1)),
+  /** Note preset ID, resolved post-parse so unknown refs warn-and-drop */
+  preset: z.string().min(1),
+  /** Reserved for fn-84 typed graph hints; accepted but no-op in fn-83 */
+  graphHints: z.array(z.string().min(1)).optional(),
+  /** Reserved for future ranking; accepted but no-op in fn-83 */
+  searchBoost: z.number().finite().optional(),
+  /** Marks time-oriented content types; accepted but no-op in fn-83 */
+  temporal: z.boolean().optional(),
+});
+
+export type ContentTypeConfig = z.infer<typeof ContentTypeSchema>;
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Config Schema (root)
 // ─────────────────────────────────────────────────────────────────────────────
@@ -265,11 +296,16 @@ export const ConfigSchema = z.object({
   /** Context metadata */
   contexts: z.array(ContextSchema).default([]),
 
+  /** Opt-in schema-lite content type rules */
+  contentTypes: z.array(ContentTypeSchema).default([]),
+
   /** Model configuration */
   models: ModelConfigSchema.optional(),
 });
 
-export type Config = z.infer<typeof ConfigSchema>;
+export type Config = Omit<z.infer<typeof ConfigSchema>, "contentTypes"> & {
+  contentTypes?: ContentTypeConfig[];
+};
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Scope Utilities

package/src/core/config-mutation.ts

@@ -7,7 +7,12 @@
 import type { Config } from "../config/types";
 import type { SqliteAdapter } from "../store/sqlite/adapter";
 
-import { loadConfig, saveConfig } from "../config";
+import {
+  formatConfigWarnings,
+  loadConfig,
+  normalizeConfigContentTypes,
+  saveConfig,
+} from "../config";
 
 export interface ConfigMutationContext {
   store: SqliteAdapter;
@@ -53,6 +58,9 @@ export async function applyConfigChange<T = void>(
         code: "LOAD_ERROR",
       };
     }
+    for (const warning of formatConfigWarnings(loadResult.warnings)) {
+      console.warn(warning);
+    }
 
     const mutationResult = await mutate(loadResult.value);
     if (!mutationResult.ok) {
@@ -63,7 +71,11 @@ export async function applyConfigChange<T = void>(
       };
     }
 
-    const newConfig = mutationResult.config;
+    const normalized = normalizeConfigContentTypes(mutationResult.config);
+    for (const warning of formatConfigWarnings(normalized.warnings)) {
+      console.warn(warning);
+    }
+    const newConfig = normalized.config;
     const saveResult = await saveConfig(newConfig, ctx.configPath);
     if (!saveResult.ok) {
       return {

package/src/core/note-presets.ts

@@ -14,7 +14,11 @@ export type NotePresetId =
   | "research-note"
   | "decision-note"
   | "prompt-pattern"
-  | "source-summary";
+  | "source-summary"
+  | "idea-original"
+  | "person"
+  | "company-project"
+  | "meeting";
 
 export interface NotePresetDefinition {
   id: NotePresetId;
@@ -104,14 +108,14 @@ export const NOTE_PRESETS: NotePresetDefinition[] = [
   {
     id: "decision-note",
     label: "Decision Note",
-    description: "Context, decision, rationale, and consequences.",
+    description: "Current synthesis, decision, rationale, and timeline.",
     defaultTags: ["decision"],
     frontmatter: {
       category: "decision",
       status: "proposed",
     },
     body: (title) =>
-      `# ${title}\n\n## Context\n\n## Decision\n\n## Rationale\n\n## Consequences\n`,
+      `# ${title}\n\n## Current Synthesis\n\n## Decision\n\n## Rationale\n\n## Consequences\n\n## Timeline\n`,
   },
   {
     id: "prompt-pattern",
@@ -127,14 +131,66 @@ export const NOTE_PRESETS: NotePresetDefinition[] = [
   {
     id: "source-summary",
     label: "Source Summary",
-    description: "Summarize an article, paper, or external source cleanly.",
+    description: "Summarize a source with synthesis above evidence timeline.",
     defaultTags: ["source", "summary"],
     frontmatter: {
       category: "source-summary",
       sources: [],
     },
     body: (title) =>
-      `# ${title}\n\n## Summary\n\n## Important Claims\n\n## Evidence / Quotes\n\n## Takeaways\n`,
+      `# ${title}\n\n## Current Synthesis\n\n## Important Claims\n\n## Assessment\n\n## Timeline\n\n## Evidence / Quotes\n`,
+  },
+  {
+    id: "idea-original",
+    label: "Original Idea",
+    description:
+      "Capture exact phrasing, context, related concepts, and publish potential.",
+    frontmatter: {
+      type: "idea-original",
+      category: "idea-original",
+      tags: [],
+    },
+    body: (title) =>
+      `# ${title}\n\n## Current Synthesis\n\n## Open Threads\n\n## Assessment\n\n## Timeline\n\n## Exact Phrasing\n\n## Related Concepts\n`,
+  },
+  {
+    id: "person",
+    label: "Person",
+    description:
+      "Track current state, relationship, assessment, open threads, and timeline.",
+    frontmatter: {
+      type: "person",
+      category: "person",
+      tags: [],
+    },
+    body: (title) =>
+      `# ${title}\n\n## Current Synthesis\n\n## Open Threads\n\n## Assessment\n\n## Timeline\n\n## Relationship\n`,
+  },
+  {
+    id: "company-project",
+    label: "Company / Project",
+    description:
+      "Track state, changes, decisions, people, open threads, and timeline.",
+    frontmatter: {
+      type: "company-project",
+      category: "company-project",
+      tags: [],
+    },
+    body: (title) =>
+      `# ${title}\n\n## Current Synthesis\n\n## Open Threads\n\n## Assessment\n\n## Timeline\n\n## Decisions\n\n## People\n`,
+  },
+  {
+    id: "meeting",
+    label: "Meeting",
+    description:
+      "Put analysis above the timeline; keep transcript, notes, and actions below.",
+    frontmatter: {
+      type: "meeting",
+      category: "meeting",
+      tags: [],
+    },
+    body: (title) =>
+      `# ${title}\n\n## Current Synthesis\n\n## Open Threads\n\n## Assessment\n\n## Timeline\n\n## Transcript / Notes\n\n## Action Items\n`,
   },
 ];