open-wiki-spec 0.1.0

package/dist/core/retrieval/scoring.js

@@ -0,0 +1,169 @@
+import { DEFAULT_WEIGHTS } from './constants.js';
+import { findSystemByTerm, isActiveChangeStatus } from './helpers.js';
+/**
+ * Score all candidates using the 9-signal additive model (section 9.1).
+ */
+export function scoreCandidates(candidateIds, query, index, weights = DEFAULT_WEIGHTS) {
+    const allTerms = [...query.feature_terms, ...query.system_terms, ...query.entity_terms];
+    const searchTerms = allTerms.map((t) => t.toLowerCase());
+    const summaryLower = query.summary.toLowerCase();
+    const scored = [];
+    for (const id of candidateIds) {
+        const record = index.records.get(id);
+        if (!record)
+            continue;
+        const signals = [];
+        // Signal 1: Exact title match
+        const titleLower = record.title.toLowerCase();
+        if (titleLower === summaryLower || searchTerms.some((t) => titleLower === t)) {
+            signals.push({
+                signal: 'exact_title',
+                points: weights.exact_title,
+                reason: `exact title match: "${record.title}"`,
+            });
+        }
+        // Signal 2: Alias match (at most once)
+        for (const alias of record.aliases) {
+            const aliasLower = alias.toLowerCase();
+            if (searchTerms.some((t) => aliasLower.includes(t))) {
+                signals.push({
+                    signal: 'alias_match',
+                    points: weights.alias_match,
+                    reason: `alias match: ${alias}`,
+                });
+                break;
+            }
+        }
+        // Signal 3: Same system match (at most once)
+        const systemRecords = query.system_terms.flatMap((t) => findSystemByTerm(t, index));
+        const systemIds = systemRecords.map((r) => r.id);
+        for (const sysId of systemIds) {
+            if (record.systems.includes(sysId)) {
+                const sysRecord = index.records.get(sysId);
+                signals.push({
+                    signal: 'same_system',
+                    points: weights.same_system,
+                    reason: `same system: ${sysRecord?.title ?? sysId}`,
+                });
+                break;
+            }
+        }
+        // Signal 4: Same feature link match (bidirectional)
+        if (record.type === 'change') {
+            const featureTarget = record.feature ?? null;
+            const featureTargets = record.features ?? [];
+            const allTargets = featureTarget ? [featureTarget, ...featureTargets] : featureTargets;
+            for (const fid of allTargets) {
+                if (candidateIds.has(fid)) {
+                    signals.push({
+                        signal: 'same_feature_link',
+                        points: weights.same_feature_link,
+                        reason: `same feature link: ${index.records.get(fid)?.title ?? fid}`,
+                    });
+                    break;
+                }
+            }
+        }
+        else if (record.type === 'feature') {
+            for (const otherId of candidateIds) {
+                const otherRecord = index.records.get(otherId);
+                if (!otherRecord || otherRecord.type !== 'change')
+                    continue;
+                const otherTargets = otherRecord.feature
+                    ? [otherRecord.feature, ...(otherRecord.features ?? [])]
+                    : (otherRecord.features ?? []);
+                if (otherTargets.includes(record.id)) {
+                    signals.push({
+                        signal: 'same_feature_link',
+                        points: weights.same_feature_link,
+                        reason: `same feature link: targeted by ${otherRecord.title ?? otherId}`,
+                    });
+                    break;
+                }
+            }
+        }
+        // Signal 5: Active change overlap
+        if (record.type === 'feature') {
+            const activeChanges = record.changes
+                .map((cid) => index.records.get(cid))
+                .filter((c) => c && isActiveChangeStatus(c.status));
+            if (activeChanges.length > 0) {
+                signals.push({
+                    signal: 'active_change_overlap',
+                    points: weights.active_change_overlap,
+                    reason: `active change overlap: ${activeChanges.map((c) => c.title).join(', ')}`,
+                });
+            }
+        }
+        else if (record.type === 'change' && isActiveChangeStatus(record.status)) {
+            signals.push({
+                signal: 'active_change_overlap',
+                points: weights.active_change_overlap,
+                reason: `active change: ${record.title}`,
+            });
+        }
+        // Signal 6: Shared source (at most once)
+        for (const srcId of record.sources) {
+            const srcRecord = index.records.get(srcId);
+            if (srcRecord && searchTerms.some((t) => srcRecord.title.toLowerCase().includes(t))) {
+                signals.push({
+                    signal: 'shared_source',
+                    points: weights.shared_source,
+                    reason: `shared source: ${srcRecord.title}`,
+                });
+                break;
+            }
+        }
+        // Signal 7: Shared decision (at most once)
+        for (const decId of record.decisions) {
+            const decRecord = index.records.get(decId);
+            if (decRecord && searchTerms.some((t) => decRecord.title.toLowerCase().includes(t))) {
+                signals.push({
+                    signal: 'shared_decision',
+                    points: weights.shared_decision,
+                    reason: `shared decision: ${decRecord.title}`,
+                });
+                break;
+            }
+        }
+        // Signal 8: Backlink / shared-link proximity
+        const sharedLinks = record.links_out.filter((lid) => candidateIds.has(lid) && lid !== id);
+        const sharedBacklinks = record.links_in.filter((lid) => candidateIds.has(lid) && lid !== id);
+        if (sharedLinks.length + sharedBacklinks.length >= 2) {
+            signals.push({
+                signal: 'backlink_proximity',
+                points: weights.backlink_proximity,
+                reason: `backlink proximity: ${sharedLinks.length + sharedBacklinks.length} shared links`,
+            });
+        }
+        // Signal 9: Full-text match
+        const textLower = record.raw_text.toLowerCase();
+        const matchedTerms = searchTerms.filter((t) => textLower.includes(t));
+        if (matchedTerms.length >= 2 || (matchedTerms.length === 1 && searchTerms.length === 1)) {
+            signals.push({
+                signal: 'full_text_match',
+                points: weights.full_text_match,
+                reason: `strong full-text hit: ${matchedTerms.join(', ')}`,
+            });
+        }
+        // Compute total score
+        let totalScore = signals.reduce((sum, s) => sum + s.points, 0);
+        // Status bias bonus (minor tiebreaker)
+        if (query.status_bias.includes(record.status)) {
+            totalScore += 5;
+        }
+        if (totalScore > 0) {
+            scored.push({
+                id: record.id,
+                type: record.type,
+                title: record.title,
+                score: totalScore,
+                reasons: signals.map((s) => s.reason),
+            });
+        }
+    }
+    // Sort by score descending, then by title ascending for determinism
+    scored.sort((a, b) => b.score - a.score || a.title.localeCompare(b.title));
+    return scored;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/core/retrieval/scoring.js.map

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

package/dist/core/retrieval/warnings.d.ts

@@ -0,0 +1,16 @@
+import type { ScoredCandidate } from '../../types/retrieval.js';
+import type { VaultIndex } from '../../types/index-record.js';
+/**
+ * Internal warning representation with structured details.
+ */
+export interface RetrievalWarning {
+    type: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Collect warnings from index and retrieval-specific concerns.
+ * Returns internal RetrievalWarning objects; the pipeline serializes to string[].
+ */
+export declare function collectWarnings(index: VaultIndex, candidates: ScoredCandidate[]): RetrievalWarning[];
+//# sourceMappingURL=warnings.d.ts.map

package/dist/core/retrieval/warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../../src/core/retrieval/warnings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,eAAe,EAAE,GAC5B,gBAAgB,EAAE,CAyEpB"}

package/dist/core/retrieval/warnings.js

@@ -0,0 +1,73 @@
+import { isActiveChangeStatus } from './helpers.js';
+/**
+ * Collect warnings from index and retrieval-specific concerns.
+ * Returns internal RetrievalWarning objects; the pipeline serializes to string[].
+ */
+export function collectWarnings(index, candidates) {
+    const warnings = [];
+    // Pass through relevant index warnings
+    for (const w of index.warnings) {
+        if (w.type === 'duplicate_id') {
+            warnings.push({
+                type: 'duplicate_id',
+                message: w.message,
+            });
+        }
+    }
+    // Unresolved wikilinks involving candidates
+    const candidateIds = new Set(candidates.map((c) => c.id));
+    const candidatePaths = new Set();
+    for (const c of candidates) {
+        const record = index.records.get(c.id);
+        if (record)
+            candidatePaths.add(record.path);
+    }
+    for (const w of index.warnings) {
+        if (w.type === 'unresolved_wikilink' && candidatePaths.has(w.note_path)) {
+            warnings.push({
+                type: 'unresolved_wikilink',
+                message: w.message,
+            });
+        }
+        if (w.type === 'ambiguous_alias' && candidatePaths.has(w.note_path)) {
+            warnings.push({
+                type: 'ambiguous_alias',
+                message: w.message,
+            });
+        }
+    }
+    // Schema mismatch
+    if (index.schema_version === 'unknown') {
+        warnings.push({
+            type: 'schema_mismatch',
+            message: 'No schema.md found or schema_version is missing',
+        });
+    }
+    // Active change touch-surface collision
+    const activeChangeCandidates = candidates.filter((c) => c.type === 'change' && isActiveChangeStatus(index.records.get(c.id)?.status ?? ''));
+    for (let i = 0; i < activeChangeCandidates.length; i++) {
+        for (let j = i + 1; j < activeChangeCandidates.length; j++) {
+            const recA = index.records.get(activeChangeCandidates[i].id);
+            const recB = index.records.get(activeChangeCandidates[j].id);
+            if (!recA || !recB)
+                continue;
+            const sharedTouches = recA.touches.filter((t) => recB.touches.includes(t));
+            if (sharedTouches.length > 0) {
+                const hasDependency = recA.depends_on.includes(recB.id) || recB.depends_on.includes(recA.id);
+                if (!hasDependency) {
+                    warnings.push({
+                        type: 'active_change_touch_collision',
+                        message: `Active changes "${recA.id}" and "${recB.id}" touch the same surface (${sharedTouches.join(', ')}) without explicit dependency`,
+                        details: {
+                            change_a: recA.id,
+                            change_b: recB.id,
+                            shared_surfaces: sharedTouches,
+                        },
+                    });
+                }
+            }
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=warnings.js.map

package/dist/core/retrieval/warnings.js.map

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

package/dist/core/schema/base.schema.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export declare const NoteTypeEnum: z.ZodEnum<["feature", "change", "system", "decision", "source", "query"]>;
+export type NoteType = z.infer<typeof NoteTypeEnum>;
+export declare const NoteStatusEnum: z.ZodEnum<["active", "deprecated", "draft", "archived", "proposed", "planned", "in_progress", "applied"]>;
+export declare const ChangeStatusEnum: z.ZodEnum<["proposed", "planned", "in_progress", "applied"]>;
+export declare const FeatureStatusEnum: z.ZodEnum<["active", "deprecated"]>;
+export declare const GeneralStatusEnum: z.ZodEnum<["active", "draft", "archived"]>;
+/** Reusable wikilink reference validator */
+export declare const WikilinkRefSchema: z.ZodString;
+/**
+ * Base frontmatter shared by all note types.
+ * Follows 00-unified-types.md BaseFrontmatter.
+ */
+export declare const BaseFrontmatterSchema: z.ZodObject<{
+    type: z.ZodEnum<["feature", "change", "system", "decision", "source", "query"]>;
+    id: z.ZodString;
+    status: z.ZodEnum<["active", "deprecated", "draft", "archived", "proposed", "planned", "in_progress", "applied"]>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodEnum<["feature", "change", "system", "decision", "source", "query"]>;
+    id: z.ZodString;
+    status: z.ZodEnum<["active", "deprecated", "draft", "archived", "proposed", "planned", "in_progress", "applied"]>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodEnum<["feature", "change", "system", "decision", "source", "query"]>;
+    id: z.ZodString;
+    status: z.ZodEnum<["active", "deprecated", "draft", "archived", "proposed", "planned", "in_progress", "applied"]>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type BaseFrontmatter = z.infer<typeof BaseFrontmatterSchema>;
+//# sourceMappingURL=base.schema.d.ts.map

package/dist/core/schema/base.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.schema.d.ts","sourceRoot":"","sources":["../../../src/core/schema/base.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY,2EAEvB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc,2GASzB,CAAC;AAEH,eAAO,MAAM,gBAAgB,8DAA4D,CAAC;AAC1F,eAAO,MAAM,iBAAiB,qCAAmC,CAAC;AAClE,eAAO,MAAM,iBAAiB,4CAA0C,CAAC;AAEzE,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,aAAiE,CAAC;AAEhG;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;gCAOlB,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/core/schema/base.schema.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export const NoteTypeEnum = z.enum([
+    'feature', 'change', 'system', 'decision', 'source', 'query',
+]);
+export const NoteStatusEnum = z.enum([
+    'active',
+    'deprecated',
+    'draft',
+    'archived',
+    'proposed',
+    'planned',
+    'in_progress',
+    'applied',
+]);
+export const ChangeStatusEnum = z.enum(['proposed', 'planned', 'in_progress', 'applied']);
+export const FeatureStatusEnum = z.enum(['active', 'deprecated']);
+export const GeneralStatusEnum = z.enum(['active', 'draft', 'archived']);
+/** Reusable wikilink reference validator */
+export const WikilinkRefSchema = z.string().regex(/^\[\[.+\]\]$/, 'Must be a wikilink [[...]]');
+/**
+ * Base frontmatter shared by all note types.
+ * Follows 00-unified-types.md BaseFrontmatter.
+ */
+export const BaseFrontmatterSchema = z.object({
+    type: NoteTypeEnum,
+    id: z.string()
+        .min(1, 'id is required')
+        .regex(/^[a-z0-9-]+$/, 'id must be lowercase alphanumeric with hyphens'),
+    status: NoteStatusEnum,
+    tags: z.array(z.string()).default([]),
+}).passthrough();
+//# sourceMappingURL=base.schema.js.map

package/dist/core/schema/base.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.schema.js","sourceRoot":"","sources":["../../../src/core/schema/base.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO;CAC7D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,UAAU;IACV,UAAU;IACV,SAAS;IACT,aAAa;IACb,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAEzE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;AAEhG;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;SACX,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC;SACxB,KAAK,CAAC,cAAc,EAAE,gDAAgD,CAAC;IAC1E,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACtC,CAAC,CAAC,WAAW,EAAE,CAAC"}

package/dist/core/schema/change.schema.d.ts

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+/**
+ * Change frontmatter schema.
+ * Follows 00-unified-types.md ChangeFrontmatter.
+ *
+ * Serialization rules (overview 13.2):
+ * - Single-feature: `feature: "[[Feature: Auth Login]]"` (scalar)
+ * - Multi-feature: `features: ["[[Feature: A]]", "[[Feature: B]]"]` (array, min 2)
+ * - Never both, never neither
+ */
+export declare const ChangeFrontmatterSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+} & {
+    type: z.ZodLiteral<"change">;
+    status: z.ZodEnum<["proposed", "planned", "in_progress", "applied"]>;
+    created_at: z.ZodString;
+    feature: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    touches: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    systems: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+} & {
+    type: z.ZodLiteral<"change">;
+    status: z.ZodEnum<["proposed", "planned", "in_progress", "applied"]>;
+    created_at: z.ZodString;
+    feature: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    touches: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    systems: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+} & {
+    type: z.ZodLiteral<"change">;
+    status: z.ZodEnum<["proposed", "planned", "in_progress", "applied"]>;
+    created_at: z.ZodString;
+    feature: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    touches: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    systems: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+    id: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+} & {
+    type: z.ZodLiteral<"change">;
+    status: z.ZodEnum<["proposed", "planned", "in_progress", "applied"]>;
+    created_at: z.ZodString;
+    feature: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    touches: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    systems: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+} & {
+    type: z.ZodLiteral<"change">;
+    status: z.ZodEnum<["proposed", "planned", "in_progress", "applied"]>;
+    created_at: z.ZodString;
+    feature: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    touches: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    systems: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ChangeFrontmatter = z.infer<typeof ChangeFrontmatterSchema>;
+export declare const CHANGE_REQUIRED_SECTIONS: readonly ["Why", "Delta Summary", "Proposed Update", "Impact", "Tasks", "Validation"];
+export declare const CHANGE_SOFT_SECTIONS: readonly ["Design Approach"];
+export declare const CHANGE_OPTIONAL_SECTIONS: readonly ["Status Notes"];
+/** Status transitions allowed for Change notes */
+export declare const CHANGE_STATUS_TRANSITIONS: Record<string, string[]>;
+/**
+ * Hard prerequisites for proposed -> planned transition (overview 15):
+ */
+export declare const PLANNED_HARD_PREREQUISITES: readonly ["Why", "Delta Summary", "Tasks", "Validation"];
+/**
+ * Soft prerequisites for proposed -> planned (warning only):
+ */
+export declare const PLANNED_SOFT_PREREQUISITES: readonly ["Design Approach"];
+//# sourceMappingURL=change.schema.d.ts.map

package/dist/core/schema/change.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.schema.d.ts","sourceRoot":"","sources":["../../../src/core/schema/change.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAkBnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB,uFAO3B,CAAC;AAEX,eAAO,MAAM,oBAAoB,8BAEvB,CAAC;AAEX,eAAO,MAAM,wBAAwB,2BAE3B,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAK9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,0DAK7B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,0BAA0B,8BAE7B,CAAC"}

package/dist/core/schema/change.schema.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { BaseFrontmatterSchema, ChangeStatusEnum, WikilinkRefSchema } from './base.schema.js';
+/**
+ * Change frontmatter schema.
+ * Follows 00-unified-types.md ChangeFrontmatter.
+ *
+ * Serialization rules (overview 13.2):
+ * - Single-feature: `feature: "[[Feature: Auth Login]]"` (scalar)
+ * - Multi-feature: `features: ["[[Feature: A]]", "[[Feature: B]]"]` (array, min 2)
+ * - Never both, never neither
+ */
+export const ChangeFrontmatterSchema = BaseFrontmatterSchema.extend({
+    type: z.literal('change'),
+    status: ChangeStatusEnum,
+    created_at: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'created_at must be ISO date YYYY-MM-DD'),
+    feature: WikilinkRefSchema.optional(),
+    features: z.array(WikilinkRefSchema).min(2).optional(),
+    depends_on: z.array(WikilinkRefSchema).default([]),
+    touches: z.array(WikilinkRefSchema).default([]),
+    systems: z.array(WikilinkRefSchema).default([]),
+    sources: z.array(WikilinkRefSchema).default([]),
+    decisions: z.array(WikilinkRefSchema).default([]),
+}).refine((data) => {
+    const hasFeature = data.feature !== undefined;
+    const hasFeatures = data.features !== undefined && data.features.length > 0;
+    return hasFeature !== hasFeatures;
+}, 'Must have exactly one of feature (scalar) or features (array), not both and not neither');
+export const CHANGE_REQUIRED_SECTIONS = [
+    'Why',
+    'Delta Summary',
+    'Proposed Update',
+    'Impact',
+    'Tasks',
+    'Validation',
+];
+export const CHANGE_SOFT_SECTIONS = [
+    'Design Approach',
+];
+export const CHANGE_OPTIONAL_SECTIONS = [
+    'Status Notes',
+];
+/** Status transitions allowed for Change notes */
+export const CHANGE_STATUS_TRANSITIONS = {
+    proposed: ['planned'],
+    planned: ['in_progress'],
+    in_progress: ['applied'],
+    applied: [],
+};
+/**
+ * Hard prerequisites for proposed -> planned transition (overview 15):
+ */
+export const PLANNED_HARD_PREREQUISITES = [
+    'Why',
+    'Delta Summary',
+    'Tasks',
+    'Validation',
+];
+/**
+ * Soft prerequisites for proposed -> planned (warning only):
+ */
+export const PLANNED_SOFT_PREREQUISITES = [
+    'Design Approach',
+];
+//# sourceMappingURL=change.schema.js.map

package/dist/core/schema/change.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.schema.js","sourceRoot":"","sources":["../../../src/core/schema/change.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9F;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,MAAM,EAAE,gBAAgB;IACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,wCAAwC,CAAC;IAC7F,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAClD,CAAC,CAAC,MAAM,CACP,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5E,OAAO,UAAU,KAAK,WAAW,CAAC;AACpC,CAAC,EACD,yFAAyF,CAC1F,CAAC;AAIF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK;IACL,eAAe;IACf,iBAAiB;IACjB,QAAQ;IACR,OAAO;IACP,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iBAAiB;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,cAAc;CACN,CAAC;AAEX,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAA6B;IACjE,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,OAAO,EAAE,CAAC,aAAa,CAAC;IACxB,WAAW,EAAE,CAAC,SAAS,CAAC;IACxB,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,KAAK;IACL,eAAe;IACf,OAAO;IACP,YAAY;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,iBAAiB;CACT,CAAC"}

package/dist/core/schema/decision.schema.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/**
+ * Decision frontmatter schema.
+ * Follows 00-unified-types.md DecisionFrontmatter.
+ */
+export declare const DecisionFrontmatterSchema: z.ZodObject<{
+    id: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+} & {
+    type: z.ZodLiteral<"decision">;
+    status: z.ZodEnum<["active", "draft", "archived"]>;
+    features: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    changes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+} & {
+    type: z.ZodLiteral<"decision">;
+    status: z.ZodEnum<["active", "draft", "archived"]>;
+    features: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    changes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+} & {
+    type: z.ZodLiteral<"decision">;
+    status: z.ZodEnum<["active", "draft", "archived"]>;
+    features: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    changes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type DecisionFrontmatter = z.infer<typeof DecisionFrontmatterSchema>;
+export declare const DECISION_REQUIRED_SECTIONS: readonly ["Context", "Options Considered", "Decision", "Consequences"];
+//# sourceMappingURL=decision.schema.d.ts.map

package/dist/core/schema/decision.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.schema.d.ts","sourceRoot":"","sources":["../../../src/core/schema/decision.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;gCAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,0BAA0B,wEAK7B,CAAC"}

package/dist/core/schema/decision.schema.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { BaseFrontmatterSchema, GeneralStatusEnum, WikilinkRefSchema } from './base.schema.js';
+/**
+ * Decision frontmatter schema.
+ * Follows 00-unified-types.md DecisionFrontmatter.
+ */
+export const DecisionFrontmatterSchema = BaseFrontmatterSchema.extend({
+    type: z.literal('decision'),
+    status: GeneralStatusEnum,
+    features: z.array(WikilinkRefSchema).default([]),
+    changes: z.array(WikilinkRefSchema).default([]),
+});
+export const DECISION_REQUIRED_SECTIONS = [
+    'Context',
+    'Options Considered',
+    'Decision',
+    'Consequences',
+];
+//# sourceMappingURL=decision.schema.js.map

package/dist/core/schema/decision.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.schema.js","sourceRoot":"","sources":["../../../src/core/schema/decision.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE/F;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IACpE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,SAAS;IACT,oBAAoB;IACpB,UAAU;IACV,cAAc;CACN,CAAC"}