hafez 1.0.1

package/dist/contracts.js

@@ -0,0 +1,87 @@
+const CAPTURE = {
+    type: 'capture',
+    description: 'Quick capture. A link, a thought, a bug report. No structure required — just get it in.',
+    kind: 'item',
+    requiredFields: ['name', 'type', 'status', 'created', 'last-touched'],
+    optionalFields: ['domain', 'tags'],
+    validStatuses: ['active', 'done'],
+    defaultSections: ['Notes'],
+    // Brief/Next Actions: the CLI never type-gated setBrief/addNextAction, so captures
+    // carrying a delivery brief and actions are established practice — the contract
+    // follows observed behaviour (decided 2026-07-19).
+    optionalSections: ['Session Log', 'Brief', 'Next Actions'],
+    canPromoteTo: ['entity', 'project', 'knowledge'],
+};
+const ENTITY = {
+    type: 'entity',
+    description: 'Tracked work with substance. A bug, feature, decision, or task. The atomic unit of work.',
+    kind: 'item',
+    requiredFields: ['name', 'type', 'status', 'created', 'last-touched'],
+    optionalFields: ['domain', 'parent', 'related', 'tags', 'staleness-days'],
+    validStatuses: ['active', 'paused', 'done'],
+    defaultSections: ['Context', 'Session Log'],
+    optionalSections: ['Brief', 'Next Actions', 'Current State'],
+    canPromoteTo: ['project'],
+};
+const PROJECT = {
+    type: 'project',
+    description: 'Scoped effort with goals and deliverables. Can have children. Can be finite or perpetual.',
+    kind: 'item',
+    requiredFields: ['name', 'type', 'status', 'created', 'last-touched'],
+    optionalFields: ['domain', 'parent', 'related', 'tags', 'staleness-days'],
+    validStatuses: ['active', 'paused', 'done'],
+    defaultSections: ['Purpose', 'Goals', 'Session Log'],
+    optionalSections: ['Brief', 'Next Actions', 'Current State', 'Open Questions'],
+    canPromoteTo: [],
+};
+const KNOWLEDGE = {
+    type: 'knowledge',
+    description: 'Insight or plan. Searchable, linkable, timestamped. Insights mature through reinforcement.',
+    kind: 'knowledge',
+    requiredFields: ['name', 'created'],
+    optionalFields: ['subtype', 'domain', 'related', 'tags', 'confidence', 'reinforcement-count', 'last-reinforced', 'session-date', 'status', 'last-touched'],
+    validStatuses: [],
+    defaultSections: ['Synthesis', 'Evidence', 'Sources'],
+    optionalSections: [],
+    canPromoteTo: [],
+};
+const CONTRACT_MAP = {
+    capture: CAPTURE,
+    entity: ENTITY,
+    project: PROJECT,
+    knowledge: KNOWLEDGE,
+};
+export const ALL_CONTRACTS = [CAPTURE, ENTITY, PROJECT, KNOWLEDGE];
+export function getContract(type) {
+    const contract = CONTRACT_MAP[type];
+    if (!contract)
+        throw new Error(`Unknown type: ${type}. Valid types: ${Object.keys(CONTRACT_MAP).join(', ')}`);
+    return contract;
+}
+export function hasCapability(type, section) {
+    const contract = getContract(type);
+    return contract.defaultSections.includes(section) || contract.optionalSections.includes(section);
+}
+// --- Canonical enum tuples (single source of truth) ---
+// Every consumer (file validators, CLI input validator, help renderer) imports these.
+// The cli-schema-parity test enforces that no other file declares local copies.
+export const ENTITY_TYPES = ['capture', 'entity', 'project'];
+export const ENTITY_STATUSES = ['active', 'paused', 'done'];
+export const SESSION_LOG_TYPES = ['progress', 'decision', 'blocker', 'research'];
+export const CONFIDENCE_LEVELS = ['observation', 'pattern', 'principle'];
+// 'insight' is the subtype (frontmatter classification), 'Synthesis' is the section heading.
+// The rename was insight→synthesis for the section/field only; the subtype stays 'insight'.
+export const VALID_SUBTYPES = ['insight', 'plan'];
+// --- Alias table ---
+// Declared-alias fields that parseBatchInput normalizes to their canonical name.
+// schema-introspect cannot infer these from Zod alone (both are declared .optional()),
+// so rendering code reads this table to strip aliased keys from user-facing output.
+export const ALIAS_KEYS = {
+    'update.fields.insight': 'synthesis',
+    'create.knowledge.fields.insight': 'synthesis',
+    'create.session.fields.insight': 'synthesis',
+};
+export const SUBTYPE_SECTIONS = {
+    insight: ['Synthesis', 'Evidence', 'Sources'],
+    plan: ['Goal', 'Steps', 'Dependencies'],
+};

package/dist/db.d.ts

@@ -0,0 +1,68 @@
+import type { SearchResult, VaultStats } from './types.js';
+export declare const SCHEMA_VERSION = "7";
+interface IndexItem {
+    slug: string;
+    kind: 'entity' | 'knowledge';
+    name: string;
+    type: string | null;
+    status: string | null;
+    parent: string | null;
+    next_action: string | null;
+    next_action_count: number;
+    staleness_days: number | null;
+    confidence: string | null;
+    reinforcement_count: number | null;
+    last_reinforced: string | null;
+    created: string;
+    last_touched: string | null;
+    body: string;
+    file_hash: string;
+    subtype: string | null;
+    description: string | null;
+    resource: string | null;
+    brief: string | null;
+    session_log_count: number;
+    last_session_date: string | null;
+    last_session_type: string | null;
+    last_session_summary: string | null;
+}
+export interface IndexQueryResult {
+    items: IndexItem[];
+    total: number;
+}
+export interface HafezIndex {
+    rebuild(): void;
+    syncIfStale(): void;
+    upsertFromFile(slug: string, kind: 'entity' | 'knowledge'): void;
+    removeItem(slug: string): void;
+    queryItems(opts: QueryOpts): IndexQueryResult;
+    search(query: string, kind?: 'entity' | 'knowledge' | 'all'): SearchResult[];
+    getStats(): VaultStats;
+    close(): void;
+}
+export interface QueryOpts {
+    kind?: 'entity' | 'knowledge' | 'all';
+    status?: string;
+    type?: string;
+    subtype?: string;
+    parent?: string;
+    relatedTo?: string;
+    relation?: string;
+    domain?: string;
+    confidence?: string;
+    filter?: string;
+    since?: string;
+    before?: string;
+    createdSince?: string;
+    createdBefore?: string;
+    tags?: string[];
+    sort_by?: 'last_touched' | 'created' | 'name' | 'staleness' | 'last_reinforced' | 'reinforcement_count';
+    sort_order?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+export declare function createIndex(vaultPath: string): HafezIndex;
+export declare function createIndex(vaultPath: string, opts: {
+    readonly: true;
+}): HafezIndex | null;
+export {};