frontend-harness 0.7.10 → 0.8.1

package/dist/runtime/ingest.js

@@ -0,0 +1,157 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { harnessPath, relativeHarnessPath } from "../storage/paths.js";
+import { isRegularFileWithoutSymlink, readJson, writeJson } from "../storage/json.js";
+import { resolveProjectRelativePath } from "./project-paths.js";
+const MAX_INGEST_SOURCE_HASH_BYTES = 10 * 1024 * 1024;
+const MAX_INGEST_RECORD_BYTES = 256 * 1024;
+export const MAX_INGEST_LIST_RECORDS = 20;
+export function recordIngestSource(projectRoot, input) {
+    const kind = parseIngestKind(input.kind);
+    const id = parseIngestId(input.id);
+    const source = input.source?.trim();
+    const summary = input.summary?.trim();
+    if (!source) {
+        throw new Error("ingest record requires --source");
+    }
+    if (!summary) {
+        throw new Error("ingest record requires --summary");
+    }
+    const sourceInfo = describeSource(projectRoot, source);
+    const artifactPath = relativeHarnessPath("ingest", kind, `${id}.json`);
+    const record = {
+        contractVersion: 1,
+        id,
+        kind,
+        ingestRef: `ingest://${kind}/${id}`,
+        source: sourceInfo,
+        summary,
+        producedKnowledgeCardIds: splitList(input.cards),
+        recordedAt: new Date().toISOString(),
+        artifactPath
+    };
+    writeJson(path.join(projectRoot, artifactPath), record);
+    return record;
+}
+export function listIngestRecords(projectRoot, kindInput, options = {}) {
+    const kind = kindInput ? parseIngestKind(kindInput) : null;
+    const root = harnessPath(projectRoot, "ingest");
+    const records = [];
+    const kinds = kind ? [kind] : ["openapi", "prd", "ui-package"];
+    for (const entryKind of kinds) {
+        const dir = path.join(root, entryKind);
+        const stat = fs.lstatSync(dir, { throwIfNoEntry: false });
+        if (!stat?.isDirectory() || stat.isSymbolicLink()) {
+            continue;
+        }
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isFile() || !entry.name.endsWith(".json")) {
+                continue;
+            }
+            const record = readIngestRecordFile(path.join(dir, entry.name));
+            if (record) {
+                records.push(record);
+            }
+        }
+    }
+    const sortedRecords = records.sort((left, right) => left.ingestRef.localeCompare(right.ingestRef));
+    const limit = options.limit === "all" ? sortedRecords.length : Math.max(0, options.limit ?? MAX_INGEST_LIST_RECORDS);
+    const selectedRecords = sortedRecords.slice(0, limit);
+    return {
+        records: selectedRecords,
+        limits: {
+            selected: selectedRecords.length,
+            total: sortedRecords.length,
+            omitted: Math.max(0, sortedRecords.length - selectedRecords.length)
+        }
+    };
+}
+export function showIngestRecord(projectRoot, refOrId) {
+    const value = refOrId?.trim();
+    if (!value) {
+        throw new Error("ingest show requires --ref ingest://<kind>/<source-id>");
+    }
+    const { kind, id } = parseIngestRef(value);
+    const fullPath = harnessPath(projectRoot, "ingest", kind, `${id}.json`);
+    const record = readIngestRecordFile(fullPath);
+    if (!record) {
+        throw new Error(`ingest record not found: ${value}`);
+    }
+    return record;
+}
+function describeSource(projectRoot, source) {
+    if (isExternalReference(source)) {
+        return {
+            value: source,
+            type: "external-reference",
+            sha256: null,
+            sizeBytes: null
+        };
+    }
+    const { relativePath, fullPath } = resolveProjectRelativePath(projectRoot, source, "ingest source");
+    if (!isRegularFileWithoutSymlink(fullPath)) {
+        throw new Error(`ingest source cannot be read: ${source}`);
+    }
+    const stat = fs.statSync(fullPath);
+    if (stat.size > MAX_INGEST_SOURCE_HASH_BYTES) {
+        throw new Error(`ingest source exceeds ${MAX_INGEST_SOURCE_HASH_BYTES} bytes: ${relativePath}`);
+    }
+    return {
+        value: relativePath,
+        type: "project-file",
+        sha256: sha256File(fullPath),
+        sizeBytes: stat.size
+    };
+}
+function readIngestRecordFile(fullPath) {
+    const record = readJson(fullPath, {
+        maxBytes: MAX_INGEST_RECORD_BYTES,
+        label: "ingest record"
+    });
+    if (!record || record.contractVersion !== 1 || record.artifactPath === undefined) {
+        return null;
+    }
+    return record;
+}
+function parseIngestKind(value) {
+    const normalized = value?.toLowerCase();
+    if (normalized === "prd" || normalized === "openapi" || normalized === "ui-package") {
+        return normalized;
+    }
+    throw new Error("ingest --kind must be one of: prd, openapi, ui-package");
+}
+function parseIngestId(value) {
+    const id = value?.trim();
+    if (!id || !/^[a-z0-9][a-z0-9._-]{1,80}$/i.test(id)) {
+        throw new Error("ingest record requires --id with letters, numbers, dots, underscores, or dashes");
+    }
+    return id;
+}
+function parseIngestRef(value) {
+    const match = /^ingest:\/\/(prd|openapi|ui-package)\/([a-z0-9][a-z0-9._-]{1,80})$/i.exec(value);
+    if (!match?.[1] || !match[2]) {
+        throw new Error("ingest --ref must look like ingest://<kind>/source-id where kind is prd, openapi, or ui-package");
+    }
+    return {
+        kind: parseIngestKind(match[1]),
+        id: parseIngestId(match[2])
+    };
+}
+function splitList(value) {
+    return value
+        ? [...new Set(value.split(",").map((item) => item.trim()).filter(Boolean))]
+        : [];
+}
+function isExternalReference(value) {
+    if (/^[A-Za-z]:/.test(value)) {
+        return false;
+    }
+    return /^https?:\/\//i.test(value);
+}
+function sha256File(filePath) {
+    const hash = createHash("sha256");
+    hash.update(fs.readFileSync(filePath));
+    return hash.digest("hex");
+}
+//# sourceMappingURL=ingest.js.map

package/dist/runtime/ingest.js.map

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

package/dist/runtime/knowledge/constants.js

@@ -1,5 +1,6 @@
 export const knowledgeTypes = new Set([
     "prd_semantics",
+    "api_contract",
     "module_summary",
     "project_convention",
     "decision_record",

package/dist/runtime/knowledge/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/runtime/knowledge/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAgB;IACnD,eAAe;IACf,gBAAgB;IAChB,oBAAoB;IACpB,iBAAiB;IACjB,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAqB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;AACtI,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAyC;IAC/D,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,eAAe;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,oBAAoB;CACjC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/runtime/knowledge/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAgB;IACnD,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,oBAAoB;IACpB,iBAAiB;IACjB,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAqB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;AACtI,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAyC;IAC/D,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,eAAe;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,oBAAoB;CACjC,CAAC"}

package/dist/runtime/knowledge/core.d.ts

@@ -1,7 +1,16 @@
-import type { AddKnowledgeInput, KnowledgeCard, KnowledgeCheckResult, KnowledgeCoverageResult, KnowledgeIndexResult, KnowledgeListResult, KnowledgeSearchResult, KnowledgeShowResult, ModuleKnowledgeInput, PromotedKnowledge, PromoteKnowledgeInput, UpdateKnowledgeInput } from "./types.js";
+import type { AddKnowledgeInput, KnowledgeCard, KnowledgeCheckResult, KnowledgeCoverageResult, KnowledgeDraftInput, KnowledgeDraftResult, KnowledgeIndexResult, KnowledgeListResult, KnowledgeOutlineInput, KnowledgeOutlineResult, KnowledgeSearchResult, KnowledgeShowResult, ModuleKnowledgeInput, PromotedKnowledge, PromoteKnowledgeInput, UpdateKnowledgeInput } from "./types.js";
+export declare const MAX_KNOWLEDGE_LIST_CARDS = 20;
+export declare const MAX_KNOWLEDGE_SEARCH_RESULTS = 8;
+export declare const MAX_KNOWLEDGE_DRAFT_UPDATE_CANDIDATES = 8;
+export declare const MAX_KNOWLEDGE_OUTLINE_HEADINGS = 80;
+export declare const MAX_KNOWLEDGE_DRAFT_EXTRACTION_ITEMS = 40;
+export declare const MAX_KNOWLEDGE_INDEX_CARDS = 20;
+export declare const MAX_KNOWLEDGE_INDEX_DETAIL_ITEMS = 20;
 export declare function promoteKnowledge(projectRoot: string, input: PromoteKnowledgeInput): PromotedKnowledge;
 export declare function createModuleKnowledge(projectRoot: string, input: ModuleKnowledgeInput): PromotedKnowledge;
 export declare function addKnowledge(projectRoot: string, input: AddKnowledgeInput): PromotedKnowledge;
+export declare function outlineKnowledgeFromIngest(projectRoot: string, input: KnowledgeOutlineInput): KnowledgeOutlineResult;
+export declare function draftKnowledgeFromIngest(projectRoot: string, input: KnowledgeDraftInput): KnowledgeDraftResult;
 export declare function updateKnowledge(projectRoot: string, input: UpdateKnowledgeInput): PromotedKnowledge;
 export declare function discoverKnowledgeCards(projectRoot: string): KnowledgeCard[];
 export declare function indexKnowledge(projectRoot: string): KnowledgeIndexResult;