@specferret/core 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+export interface FerretConfig {
+    specDir: string;
+    filePattern: string;
+    includes?: string[];
+    store: "sqlite" | "postgres";
+    importSuggestions?: {
+        enabled?: boolean;
+    };
+    codeContracts?: {
+        include: string[];
+        watchNodes?: string[];
+    };
+}
+export declare const DEFAULT_CONFIG: FerretConfig;
+/**
+ * Loads ferret.config.json from the project root.
+ * Falls back to DEFAULT_CONFIG if the file is not found.
+ */
+export declare function loadConfig(): FerretConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,iBAAiB,CAAC,EAAE;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,aAAa,CAAC,EAAE;QACd,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,YAQ5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAezC"}

package/dist/config.js

@@ -0,0 +1,32 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { findProjectRoot } from "./utils/paths.js";
+export const DEFAULT_CONFIG = {
+    specDir: "contracts/",
+    filePattern: "**/*.contract.md",
+    includes: ["**/*.contract.md"],
+    store: "sqlite",
+    importSuggestions: {
+        enabled: true,
+    },
+};
+/**
+ * Loads ferret.config.json from the project root.
+ * Falls back to DEFAULT_CONFIG if the file is not found.
+ */
+export function loadConfig() {
+    const root = findProjectRoot();
+    const configPath = path.join(root, "ferret.config.json");
+    if (!fs.existsSync(configPath)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    try {
+        const raw = fs.readFileSync(configPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return { ...DEFAULT_CONFIG, ...parsed };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAgBnD,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,OAAO,EAAE,YAAY;IACrB,WAAW,EAAE,kBAAkB;IAC/B,QAAQ,EAAE,CAAC,kBAAkB,CAAC;IAC9B,KAAK,EAAE,QAAQ;IACf,iBAAiB,EAAE;QACjB,OAAO,EAAE,IAAI;KACd;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAEzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;QACxD,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/context/index.d.ts

@@ -0,0 +1,27 @@
+import type { DBStore } from "../store/types.js";
+export interface ContextContract {
+    id: string;
+    type: string;
+    shape: unknown;
+    status: string;
+    specFile: string | null;
+    codeFile: string | null;
+}
+export interface ContextEdge {
+    from: string;
+    to: string;
+}
+export interface FerretContext {
+    version: "2.0";
+    generated: string;
+    contracts: ContextContract[];
+    edges: ContextEdge[];
+    needsReview: string[];
+}
+/**
+ * Reads the full graph from the store and writes .ferret/context.json.
+ * Called automatically at the end of every ferret scan.
+ * Silent — no output. If write fails, it logs to stderr and continues.
+ */
+export declare function writeContext(store: DBStore, projectRoot: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Ef"}

package/dist/context/index.js

@@ -0,0 +1,72 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+/**
+ * Reads the full graph from the store and writes .ferret/context.json.
+ * Called automatically at the end of every ferret scan.
+ * Silent — no output. If write fails, it logs to stderr and continues.
+ */
+export async function writeContext(store, projectRoot) {
+    const [nodes, contracts, dependencies] = await Promise.all([
+        store.getNodes(),
+        store.getContracts(),
+        store.getDependencies(),
+    ]);
+    // Build a map of node_id → node for quick lookup
+    const nodeById = new Map(nodes.map((n) => [n.id, n]));
+    // Map contracts to context shape
+    const contextContracts = contracts.map((c) => {
+        const parentNode = nodeById.get(c.node_id);
+        const nodeType = parentNode?.type ?? "spec"; // nodes don't store type in V2 yet
+        let shape = {};
+        try {
+            shape = JSON.parse(c.shape_schema);
+        }
+        catch {
+            shape = {};
+        }
+        return {
+            id: c.id,
+            type: c.type,
+            shape,
+            status: c.status,
+            specFile: nodeType !== "code"
+                ? (parentNode?.file_path?.replace(/\\/g, "/") ?? null)
+                : null,
+            codeFile: nodeType === "code"
+                ? (parentNode?.file_path?.replace(/\\/g, "/") ?? null)
+                : null,
+        };
+    });
+    // Build edges: source_node file_path → target_contract_id
+    const edges = dependencies.map((d) => {
+        const sourceNode = nodeById.get(d.source_node_id);
+        return {
+            from: (sourceNode?.file_path ?? d.source_node_id).replace(/\\/g, "/"),
+            to: d.target_contract_id,
+        };
+    });
+    // needsReview: contract IDs whose parent node is flagged needs-review
+    const needsReviewNodeIds = new Set(nodes.filter((n) => n.status === "needs-review").map((n) => n.id));
+    const needsReview = contracts
+        .filter((c) => needsReviewNodeIds.has(c.node_id) || c.status === "needs-review")
+        .map((c) => c.id);
+    const context = {
+        version: "2.0",
+        generated: new Date().toISOString(),
+        contracts: contextContracts,
+        edges,
+        needsReview,
+    };
+    const ferretDir = path.join(projectRoot, ".ferret");
+    const contextPath = path.join(ferretDir, "context.json");
+    try {
+        if (!fs.existsSync(ferretDir)) {
+            fs.mkdirSync(ferretDir, { recursive: true });
+        }
+        fs.writeFileSync(contextPath, JSON.stringify(context, null, 2), "utf-8");
+    }
+    catch (err) {
+        process.stderr.write(`⚠ Could not write context.json: ${err}\n`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

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

package/dist/extractor/frontmatter.d.ts

@@ -0,0 +1,25 @@
+export interface ExtractionResult {
+    filePath: string;
+    fileType: 'spec' | 'code';
+    contracts: Array<{
+        id: string;
+        type: string;
+        shape: object;
+        shape_hash: string;
+        imports: string[];
+    }>;
+    extractedBy: 'gray-matter' | 'tree-sitter';
+    extractedAt: number;
+    warning?: 'no-frontmatter';
+}
+/**
+ * Extracts a FerretContract from a spec file's YAML frontmatter.
+ *
+ * Rules:
+ *   - No frontmatter → return empty contracts + warning: 'no-frontmatter'
+ *   - Missing required field (id, type, shape) → throw with field name in message
+ *   - Unsupported schema keyword → warn via validateFerretSchema, continue
+ *   - Identical files → identical shape_hash (deterministic)
+ */
+export declare function extractFromSpecFile(filePath: string, fileContent: string): ExtractionResult;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/extractor/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/extractor/frontmatter.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,WAAW,EAAE,aAAa,GAAG,aAAa,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAuClB"}

package/dist/extractor/frontmatter.js

@@ -0,0 +1,49 @@
+// Synchronous only. No async. No await. Anywhere in this file.
+// Extractor layer — turns a spec file into an ExtractionResult using gray-matter.
+import matter from 'gray-matter';
+import { validateFerretSchema } from './validator.js';
+import { hashSchema } from './hash.js';
+/**
+ * Extracts a FerretContract from a spec file's YAML frontmatter.
+ *
+ * Rules:
+ *   - No frontmatter → return empty contracts + warning: 'no-frontmatter'
+ *   - Missing required field (id, type, shape) → throw with field name in message
+ *   - Unsupported schema keyword → warn via validateFerretSchema, continue
+ *   - Identical files → identical shape_hash (deterministic)
+ */
+export function extractFromSpecFile(filePath, fileContent) {
+    const { data } = matter(fileContent);
+    const ferret = data?.ferret;
+    if (!ferret) {
+        return {
+            filePath,
+            fileType: 'spec',
+            contracts: [],
+            extractedBy: 'gray-matter',
+            extractedAt: Date.now(),
+            warning: 'no-frontmatter',
+        };
+    }
+    const missingFields = ['id', 'type', 'shape'].filter(f => !ferret[f]);
+    if (missingFields.length > 0) {
+        throw new Error(`Missing required frontmatter fields in ${filePath}: ${missingFields.join(', ')}`);
+    }
+    // validateFerretSchema never throws — only warns on unsupported keywords
+    const validation = validateFerretSchema(ferret.shape, filePath);
+    validation.warnings.forEach(w => process.stderr.write(w + '\n'));
+    return {
+        filePath,
+        fileType: 'spec',
+        contracts: [{
+                id: ferret.id,
+                type: ferret.type,
+                shape: ferret.shape,
+                shape_hash: hashSchema(ferret.shape),
+                imports: Array.isArray(ferret.imports) ? ferret.imports : [],
+            }],
+        extractedBy: 'gray-matter',
+        extractedAt: Date.now(),
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/extractor/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/extractor/frontmatter.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kFAAkF;AAElF,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAiBvC;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,WAAmB;IAEnB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;IAE5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,QAAQ;YACR,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,aAAa;YAC1B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;YACvB,OAAO,EAAE,gBAAgB;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,0CAA0C,QAAQ,KAAK,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChE,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAEjE,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,CAAC;gBACV,EAAE,EAAE,MAAM,CAAC,EAAY;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAc;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAe;gBAC7B,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;gBACpC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAmB,CAAC,CAAC,CAAC,EAAE;aACzE,CAAC;QACF,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;KACxB,CAAC;AACJ,CAAC"}

package/dist/extractor/hash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Produces a stable SHA-256 hex fingerprint of a schema object.
+ * Used for quick change detection — if the hash changes, the schema changed.
+ * JSON.stringify is order-sensitive on keys, so we sort keys for stability.
+ */
+export declare function hashSchema(schema: unknown): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/extractor/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/extractor/hash.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAkBlD"}

package/dist/extractor/hash.js

@@ -0,0 +1,25 @@
+import { createHash } from 'node:crypto';
+/**
+ * Produces a stable SHA-256 hex fingerprint of a schema object.
+ * Used for quick change detection — if the hash changes, the schema changed.
+ * JSON.stringify is order-sensitive on keys, so we sort keys for stability.
+ */
+export function hashSchema(schema) {
+    const sortObject = (obj) => {
+        if (obj === null || typeof obj !== 'object') {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(sortObject);
+        }
+        return Object.keys(obj)
+            .sort()
+            .reduce((acc, key) => {
+            acc[key] = sortObject(obj[key]);
+            return acc;
+        }, {});
+    };
+    const stable = JSON.stringify(sortObject(schema));
+    return createHash('sha256').update(stable).digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/extractor/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/extractor/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe;IACxC,MAAM,UAAU,GAAG,CAAC,GAAQ,EAAO,EAAE;QACnC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aACpB,IAAI,EAAE;aACN,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACnB,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAChC,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAS,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC"}

package/dist/extractor/typescript.d.ts

@@ -0,0 +1,14 @@
+export type ContractType = "api" | "table" | "type" | "event" | "flow" | "config";
+export interface ExtractedCodeContract {
+    id: string;
+    type: ContractType;
+    shape: Record<string, unknown>;
+    sourceSymbol: string;
+    filePath: string;
+}
+export interface TypeScriptExtractionResult {
+    contracts: ExtractedCodeContract[];
+    diagnostics: string[];
+}
+export declare function extractContractsFromTypeScript(filePath: string, content: string): TypeScriptExtractionResult;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/extractor/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/extractor/typescript.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AA4PD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,0BAA0B,CAgC5B"}

package/dist/extractor/typescript.js

@@ -0,0 +1,232 @@
+class TypeParser {
+    input;
+    i = 0;
+    constructor(input) {
+        this.input = input;
+    }
+    parseObject() {
+        const diagnostics = [];
+        const object = this.parseObjectType(diagnostics);
+        return { shape: object, diagnostics };
+    }
+    parseObjectType(diagnostics) {
+        this.skipWs();
+        if (this.peek() !== "{") {
+            diagnostics.push("Expected object type starting with '{'.");
+            return { type: "object", properties: {}, required: [] };
+        }
+        this.i++; // '{'
+        const properties = {};
+        const required = [];
+        while (this.i < this.input.length) {
+            this.skipWs();
+            if (this.peek() === "}") {
+                this.i++; // '}'
+                break;
+            }
+            const name = this.readIdentifier();
+            if (!name) {
+                diagnostics.push("Unable to parse property name in object type.");
+                this.advanceToDelimiter();
+                continue;
+            }
+            this.skipWs();
+            let optional = false;
+            if (this.peek() === "?") {
+                optional = true;
+                this.i++;
+            }
+            this.skipWs();
+            if (this.peek() !== ":") {
+                diagnostics.push(`Expected ':' after property '${name}'.`);
+                this.advanceToDelimiter();
+                continue;
+            }
+            this.i++; // ':'
+            this.skipWs();
+            const schema = this.parseTypeExpr(diagnostics);
+            properties[name] = schema;
+            if (!optional) {
+                required.push(name);
+            }
+            this.skipWs();
+            if (this.peek() === ";" || this.peek() === ",") {
+                this.i++;
+            }
+        }
+        return {
+            type: "object",
+            properties,
+            required,
+        };
+    }
+    parseTypeExpr(diagnostics) {
+        this.skipWs();
+        if (this.peek() === "{") {
+            return this.parseObjectType(diagnostics);
+        }
+        const ident = this.readIdentifier();
+        if (!ident) {
+            diagnostics.push("Unable to parse type expression.");
+            return { type: "object" };
+        }
+        let base;
+        switch (ident) {
+            case "string":
+                base = { type: "string" };
+                break;
+            case "number":
+                base = { type: "number" };
+                break;
+            case "boolean":
+                base = { type: "boolean" };
+                break;
+            case "Date":
+                base = { type: "string", format: "date-time" };
+                break;
+            default:
+                diagnostics.push(`Unsupported referenced type '${ident}'. Falling back to object.`);
+                base = { type: "object" };
+                break;
+        }
+        while (true) {
+            this.skipWs();
+            if (this.peek() === "[" && this.peek(1) === "]") {
+                this.i += 2;
+                base = { type: "array", items: base };
+                continue;
+            }
+            break;
+        }
+        this.skipWs();
+        if (this.peek() === "|") {
+            diagnostics.push("Union types are not supported in Sprint 3 extraction.");
+            while (this.i < this.input.length) {
+                const ch = this.peek();
+                if (ch === ";" || ch === "," || ch === "}" || ch === "\n") {
+                    break;
+                }
+                this.i++;
+            }
+        }
+        return base;
+    }
+    readIdentifier() {
+        this.skipWs();
+        const start = this.i;
+        while (this.i < this.input.length) {
+            const ch = this.input[this.i];
+            const ok = /[A-Za-z0-9_]/.test(ch);
+            if (!ok) {
+                break;
+            }
+            this.i++;
+        }
+        return this.input.slice(start, this.i);
+    }
+    skipWs() {
+        while (this.i < this.input.length) {
+            const ch = this.input[this.i];
+            if (!/\s/.test(ch)) {
+                break;
+            }
+            this.i++;
+        }
+    }
+    advanceToDelimiter() {
+        while (this.i < this.input.length) {
+            const ch = this.input[this.i];
+            if (ch === ";" || ch === "\n" || ch === "}") {
+                return;
+            }
+            this.i++;
+        }
+    }
+    peek(offset = 0) {
+        return this.input[this.i + offset] ?? "";
+    }
+}
+function parseAnnotations(content) {
+    const pattern = /^\s*\/\/\s*@ferret-contract:\s*([^\s]+)\s+(api|table|type|event|flow|config)\s*$/gm;
+    const out = [];
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        out.push({
+            id: match[1],
+            type: match[2],
+            index: match.index + match[0].length,
+        });
+    }
+    return out;
+}
+function extractDeclaration(content, start) {
+    const tail = content.slice(start);
+    const decl = /(?:export\s+)?(interface|type)\s+([A-Za-z0-9_]+)\s*(?:=)?\s*/m.exec(tail);
+    if (!decl || decl.index === undefined) {
+        return {
+            symbol: "unknown",
+            objectBody: "",
+            error: "No interface/type declaration found after annotation.",
+        };
+    }
+    const symbol = decl[2];
+    const offset = start + decl.index + decl[0].length;
+    const bodyStart = content.indexOf("{", offset);
+    if (bodyStart === -1) {
+        return {
+            symbol,
+            objectBody: "",
+            error: `Declaration '${symbol}' is not an object-like type.`,
+        };
+    }
+    let depth = 0;
+    let end = -1;
+    for (let i = bodyStart; i < content.length; i++) {
+        const ch = content[i];
+        if (ch === "{")
+            depth++;
+        if (ch === "}") {
+            depth--;
+            if (depth === 0) {
+                end = i;
+                break;
+            }
+        }
+    }
+    if (end === -1) {
+        return {
+            symbol,
+            objectBody: "",
+            error: `Unclosed object type for declaration '${symbol}'.`,
+        };
+    }
+    const objectBody = content.slice(bodyStart, end + 1);
+    return { symbol, objectBody };
+}
+export function extractContractsFromTypeScript(filePath, content) {
+    const annotations = parseAnnotations(content);
+    const contracts = [];
+    const diagnostics = [];
+    for (const annotation of annotations) {
+        const declaration = extractDeclaration(content, annotation.index);
+        if (declaration.error) {
+            diagnostics.push(`${filePath}: ${declaration.error}`);
+            continue;
+        }
+        const parser = new TypeParser(declaration.objectBody);
+        const { shape, diagnostics: parserDiagnostics } = parser.parseObject();
+        for (const d of parserDiagnostics) {
+            diagnostics.push(`${filePath} (${declaration.symbol}): ${d}`);
+        }
+        contracts.push({
+            id: annotation.id,
+            type: annotation.type,
+            shape,
+            sourceSymbol: declaration.symbol,
+            filePath,
+        });
+    }
+    contracts.sort((a, b) => a.id.localeCompare(b.id));
+    return { contracts, diagnostics };
+}
+//# sourceMappingURL=typescript.js.map

package/dist/extractor/typescript.js.map

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

package/dist/extractor/validator.d.ts

@@ -0,0 +1,24 @@
+export type ChangeClassification = 'breaking' | 'non-breaking' | 'no-change';
+export interface SchemaValidationResult {
+    valid: boolean;
+    warnings: string[];
+}
+export interface SchemaComparisonResult {
+    classification: ChangeClassification;
+    reason: string;
+}
+/**
+ * Validates a schema object against the Ferret JSON Schema subset.
+ * Always returns valid: true — unsupported keywords produce warnings, not errors.
+ */
+export declare function validateFerretSchema(shape: unknown, filePath: string): SchemaValidationResult;
+/**
+ * Compares two schema objects and classifies the change.
+ *
+ * Breaking:     required field removed, field type changed, enum value removed,
+ *               response/array type changed, required field added
+ * Non-breaking: optional field added, enum value added
+ * No-change:    property order changed, whitespace, required array reordered
+ */
+export declare function compareSchemas(previous: unknown, current: unknown): SchemaComparisonResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/extractor/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/extractor/validator.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,CAAC;AAE7E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,oBAAoB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,sBAAsB,CAqBxB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,GACf,sBAAsB,CAqGxB"}