@drewpayment/mink 0.1.0 → 0.2.0

package/src/core/vault-templates.ts

@@ -0,0 +1,179 @@
+import { join } from "path";
+import { existsSync, writeFileSync, readFileSync, mkdirSync } from "fs";
+
+export const DEFAULT_TEMPLATES: Record<string, string> = {
+  "quick-capture": `---
+created: "{{created}}"
+updated: "{{updated}}"
+tags: []
+category: inbox
+---
+
+# {{title}}
+
+{{body}}
+`,
+
+  "daily-note": `---
+created: "{{created}}"
+updated: "{{updated}}"
+tags: [daily]
+category: areas
+---
+
+# {{date}}
+
+## Focus
+
+-
+
+## Notes
+
+-
+
+## Tasks
+
+- [ ]
+
+## Reflections
+
+`,
+
+  meeting: `---
+created: "{{created}}"
+updated: "{{updated}}"
+tags: [meeting]
+category: areas
+---
+
+# {{title}}
+
+**Date**: {{date}}
+**Attendees**:
+
+## Agenda
+
+-
+
+## Discussion
+
+-
+
+## Decisions
+
+-
+
+## Action Items
+
+- [ ]
+`,
+
+  project: `---
+created: "{{created}}"
+updated: "{{updated}}"
+tags: [project]
+category: projects
+status: active
+---
+
+# {{title}}
+
+## Overview
+
+{{body}}
+
+## Goals
+
+-
+
+## Key Decisions
+
+-
+
+## Links
+
+-
+`,
+
+  area: `---
+created: "{{created}}"
+updated: "{{updated}}"
+tags: [area]
+category: areas
+---
+
+# {{title}}
+
+## Purpose
+
+{{body}}
+
+## Standards
+
+-
+
+## Key Resources
+
+-
+`,
+
+  person: `---
+created: "{{created}}"
+updated: "{{updated}}"
+tags: [person]
+category: resources
+---
+
+# {{title}}
+
+## Role
+
+## Context
+
+## 1:1 Notes
+
+-
+
+## Key Projects
+
+-
+`,
+};
+
+export function seedTemplates(templatesDir: string): void {
+  mkdirSync(templatesDir, { recursive: true });
+  for (const [name, content] of Object.entries(DEFAULT_TEMPLATES)) {
+    const filePath = join(templatesDir, `${name}.md`);
+    if (!existsSync(filePath)) {
+      writeFileSync(filePath, content);
+    }
+  }
+}
+
+export function loadTemplate(
+  templatesDir: string,
+  templateName: string,
+  vars: Record<string, string>
+): string | null {
+  const filePath = join(templatesDir, `${templateName}.md`);
+  let content: string;
+  if (existsSync(filePath)) {
+    content = readFileSync(filePath, "utf-8");
+  } else if (DEFAULT_TEMPLATES[templateName]) {
+    content = DEFAULT_TEMPLATES[templateName];
+  } else {
+    return null;
+  }
+  return fillTemplate(content, vars);
+}
+
+export function fillTemplate(
+  template: string,
+  vars: Record<string, string>
+): string {
+  let result = template;
+  for (const [key, value] of Object.entries(vars)) {
+    result = result.replaceAll(`{{${key}}}`, value);
+  }
+  return result;
+}

package/src/core/vault.ts

@@ -0,0 +1,132 @@
+import { join } from "path";
+import { homedir } from "os";
+import { existsSync, mkdirSync } from "fs";
+import { resolveConfigValue } from "./global-config";
+import { safeReadJson } from "./fs-utils";
+import type { VaultManifest } from "../types/note";
+
+const DEFAULT_VAULT_PATH = join(homedir(), ".mink", "wiki");
+
+export function resolveVaultPath(): string {
+  const resolved = resolveConfigValue("wiki.path");
+  const raw = resolved.value;
+  if (raw.startsWith("~/")) {
+    return join(homedir(), raw.slice(2));
+  }
+  return raw;
+}
+
+export function vaultRoot(): string {
+  return resolveVaultPath();
+}
+
+export function vaultInbox(): string {
+  return join(resolveVaultPath(), "inbox");
+}
+
+export function vaultProjects(slug?: string): string {
+  const base = join(resolveVaultPath(), "projects");
+  return slug ? join(base, slug) : base;
+}
+
+export function vaultAreas(): string {
+  return join(resolveVaultPath(), "areas");
+}
+
+export function vaultDailyDir(): string {
+  return join(resolveVaultPath(), "areas", "daily");
+}
+
+export function vaultResources(): string {
+  return join(resolveVaultPath(), "resources");
+}
+
+export function vaultArchives(): string {
+  return join(resolveVaultPath(), "archives");
+}
+
+export function vaultTemplates(): string {
+  return join(resolveVaultPath(), "templates");
+}
+
+export function vaultPatterns(): string {
+  return join(resolveVaultPath(), "patterns");
+}
+
+export function vaultManifestPath(): string {
+  return join(resolveVaultPath(), ".mink-vault.json");
+}
+
+export function vaultIndexPath(): string {
+  return join(resolveVaultPath(), ".mink-index.json");
+}
+
+export function vaultMasterIndexPath(): string {
+  return join(resolveVaultPath(), "_index.md");
+}
+
+export function isVaultInitialized(): boolean {
+  return existsSync(vaultManifestPath());
+}
+
+export function isInsideVault(cwd: string): boolean {
+  const vault = resolveVaultPath();
+  const normalizedCwd = cwd.replace(/\/+$/, "");
+  const normalizedVault = vault.replace(/\/+$/, "");
+  return (
+    normalizedCwd === normalizedVault ||
+    normalizedCwd.startsWith(normalizedVault + "/")
+  );
+}
+
+export function isWikiEnabled(): boolean {
+  const resolved = resolveConfigValue("wiki.enabled");
+  return resolved.value === "true";
+}
+
+export function loadVaultManifest(): VaultManifest | null {
+  const raw = safeReadJson(vaultManifestPath());
+  if (raw === null || typeof raw !== "object") return null;
+  return raw as VaultManifest;
+}
+
+const VAULT_DIRS = [
+  "",
+  "inbox",
+  "projects",
+  "areas",
+  "areas/daily",
+  "resources",
+  "archives",
+  "templates",
+  "patterns",
+];
+
+export function ensureVaultStructure(): void {
+  const root = resolveVaultPath();
+  for (const dir of VAULT_DIRS) {
+    mkdirSync(join(root, dir), { recursive: true });
+  }
+}
+
+export function categoryToDir(
+  category: string,
+  projectSlug?: string
+): string {
+  const root = resolveVaultPath();
+  switch (category) {
+    case "projects":
+      return projectSlug
+        ? join(root, "projects", projectSlug)
+        : join(root, "projects");
+    case "areas":
+      return join(root, "areas");
+    case "resources":
+      return join(root, "resources");
+    case "archives":
+      return join(root, "archives");
+    case "inbox":
+    default:
+      return join(root, "inbox");
+  }
+}

package/src/types/config.ts

@@ -4,6 +4,7 @@ export interface GlobalConfig {
   "wiki.sync-mode"?: string;
   "wiki.git-backup"?: string;
   "wiki.git-remote"?: string;
+  "notes.default-category"?: string;
 }
 
 export type ConfigKey = keyof GlobalConfig & string;
@@ -46,6 +47,12 @@ export const CONFIG_KEYS: ConfigKeyMeta[] = [
     envVar: "MINK_WIKI_GIT_REMOTE",
     description: "Git remote name for push",
   },
+  {
+    key: "notes.default-category",
+    default: "inbox",
+    envVar: "MINK_NOTES_DEFAULT_CATEGORY",
+    description: "Default category for notes captured via CLI",
+  },
 ];
 
 const VALID_KEYS = new Set<string>(CONFIG_KEYS.map((k) => k.key));

package/src/types/note.ts

@@ -0,0 +1,60 @@
+export type NoteCategory =
+  | "inbox"
+  | "projects"
+  | "areas"
+  | "resources"
+  | "archives";
+
+export const NOTE_CATEGORIES: NoteCategory[] = [
+  "inbox",
+  "projects",
+  "areas",
+  "resources",
+  "archives",
+];
+
+export interface NoteMetadata {
+  title: string;
+  category: NoteCategory;
+  tags: string[];
+  created: string;
+  updated: string;
+  template?: string;
+  projectSlug?: string;
+  sourceProject?: string;
+  body: string;
+}
+
+export interface NoteFrontmatter {
+  created: string;
+  updated: string;
+  tags: string[];
+  category: NoteCategory;
+  source_project?: string;
+  aliases?: string[];
+  [key: string]: unknown;
+}
+
+export interface VaultManifest {
+  version: number;
+  createdAt: string;
+  totalNotes: number;
+  categories: Record<NoteCategory, number>;
+  lastOrganized: string;
+}
+
+export interface VaultIndexEntry {
+  filePath: string;
+  title: string;
+  description: string;
+  tags: string[];
+  category: NoteCategory;
+  estimatedTokens: number;
+  lastModified: string;
+}
+
+export interface VaultIndex {
+  lastScanTimestamp: string;
+  totalNotes: number;
+  entries: Record<string, VaultIndexEntry>;
+}