@ztothez/design-engineering 2.0.0

package/dist/src/repair/schema.d.ts

@@ -0,0 +1,264 @@
+import { z } from "zod";
+export declare const repairRelativePathSchema: z.ZodString;
+export declare const repairFindingReferenceSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodEnum<{
+        runtime: "runtime";
+        architecture: "architecture";
+    }>;
+    checkId: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    messageIncludes: z.ZodOptional<z.ZodString>;
+    viewport: z.ZodOptional<z.ZodString>;
+    journey: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    acceptanceCriterion: z.ZodString;
+    expectedEvidence: z.ZodArray<z.ZodEnum<{
+        "static-audit": "static-audit";
+        "contract-validation": "contract-validation";
+        "browser-runtime": "browser-runtime";
+        "responsive-screenshots": "responsive-screenshots";
+    }>>;
+}, z.core.$strict>;
+export declare const exactReplacementSchema: z.ZodObject<{
+    id: z.ZodString;
+    findingRef: z.ZodString;
+    kind: z.ZodLiteral<"replace-exact">;
+    file: z.ZodString;
+    expectedFileDigest: z.ZodString;
+    before: z.ZodString;
+    after: z.ZodString;
+    expectedOccurrences: z.ZodNumber;
+}, z.core.$strict>;
+export declare const repairAttemptSchema: z.ZodObject<{
+    id: z.ZodString;
+    operations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        findingRef: z.ZodString;
+        kind: z.ZodLiteral<"replace-exact">;
+        file: z.ZodString;
+        expectedFileDigest: z.ZodString;
+        before: z.ZodString;
+        after: z.ZodString;
+        expectedOccurrences: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const repairRequestSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    id: z.ZodString;
+    target: z.ZodObject<{
+        adapter: z.ZodLiteral<"react-typescript-vite">;
+        manifest: z.ZodString;
+    }, z.core.$strict>;
+    findings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodEnum<{
+            runtime: "runtime";
+            architecture: "architecture";
+        }>;
+        checkId: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        messageIncludes: z.ZodOptional<z.ZodString>;
+        viewport: z.ZodOptional<z.ZodString>;
+        journey: z.ZodOptional<z.ZodString>;
+        selector: z.ZodOptional<z.ZodString>;
+        acceptanceCriterion: z.ZodString;
+        expectedEvidence: z.ZodArray<z.ZodEnum<{
+            "static-audit": "static-audit";
+            "contract-validation": "contract-validation";
+            "browser-runtime": "browser-runtime";
+            "responsive-screenshots": "responsive-screenshots";
+        }>>;
+    }, z.core.$strict>>;
+    attempts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        operations: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            findingRef: z.ZodString;
+            kind: z.ZodLiteral<"replace-exact">;
+            file: z.ZodString;
+            expectedFileDigest: z.ZodString;
+            before: z.ZodString;
+            after: z.ZodString;
+            expectedOccurrences: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    stopping: z.ZodObject<{
+        maxAttempts: z.ZodNumber;
+        resolved: z.ZodLiteral<"all-referenced-findings-absent-and-quality-gate-passed">;
+        repeatedFinding: z.ZodLiteral<"stop-unresolved-and-restore">;
+        preconditionFailure: z.ZodLiteral<"stop-without-write">;
+        verificationFailure: z.ZodLiteral<"stop-unresolved-and-restore">;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const repairScreenshotEvidenceSchema: z.ZodObject<{
+    name: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    sha256: z.ZodString;
+}, z.core.$strict>;
+export declare const repairEvidenceSnapshotSchema: z.ZodObject<{
+    label: z.ZodString;
+    qualityGateReport: z.ZodString;
+    qualityGateDigest: z.ZodString;
+    runtimeReport: z.ZodString;
+    runtimeDigest: z.ZodString;
+    targetPlanId: z.ZodString;
+    route: z.ZodString;
+    profile: z.ZodString;
+    qualityGateVersion: z.ZodString;
+    runtimeVersion: z.ZodString;
+    browser: z.ZodString;
+    viewports: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+    journeys: z.ZodArray<z.ZodString>;
+    screenshots: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        sha256: z.ZodString;
+    }, z.core.$strict>>;
+    findingFingerprints: z.ZodArray<z.ZodString>;
+    passed: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const repairAttemptResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        "not-run": "not-run";
+        unresolved: "unresolved";
+        resolved: "resolved";
+    }>;
+    operationIds: z.ZodArray<z.ZodString>;
+    changedFiles: z.ZodArray<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        qualityGateReport: z.ZodString;
+        qualityGateDigest: z.ZodString;
+        runtimeReport: z.ZodString;
+        runtimeDigest: z.ZodString;
+        targetPlanId: z.ZodString;
+        route: z.ZodString;
+        profile: z.ZodString;
+        qualityGateVersion: z.ZodString;
+        runtimeVersion: z.ZodString;
+        browser: z.ZodString;
+        viewports: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+        journeys: z.ZodArray<z.ZodString>;
+        screenshots: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            sha256: z.ZodString;
+        }, z.core.$strict>>;
+        findingFingerprints: z.ZodArray<z.ZodString>;
+        passed: z.ZodBoolean;
+    }, z.core.$strict>>;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const repairReportSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    requestId: z.ZodString;
+    adapter: z.ZodLiteral<"react-typescript-vite">;
+    adapterVersion: z.ZodString;
+    status: z.ZodEnum<{
+        rejected: "rejected";
+        unresolved: "unresolved";
+        repaired: "repaired";
+    }>;
+    reason: z.ZodEnum<{
+        "quality-gate-passed": "quality-gate-passed";
+        "repeated-finding": "repeated-finding";
+        "attempt-limit": "attempt-limit";
+        "precondition-failed": "precondition-failed";
+        "verification-failed": "verification-failed";
+    }>;
+    target: z.ZodString;
+    generatedAt: z.ZodString;
+    before: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        qualityGateReport: z.ZodString;
+        qualityGateDigest: z.ZodString;
+        runtimeReport: z.ZodString;
+        runtimeDigest: z.ZodString;
+        targetPlanId: z.ZodString;
+        route: z.ZodString;
+        profile: z.ZodString;
+        qualityGateVersion: z.ZodString;
+        runtimeVersion: z.ZodString;
+        browser: z.ZodString;
+        viewports: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+        journeys: z.ZodArray<z.ZodString>;
+        screenshots: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            sha256: z.ZodString;
+        }, z.core.$strict>>;
+        findingFingerprints: z.ZodArray<z.ZodString>;
+        passed: z.ZodBoolean;
+    }, z.core.$strict>>;
+    attempts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            "not-run": "not-run";
+            unresolved: "unresolved";
+            resolved: "resolved";
+        }>;
+        operationIds: z.ZodArray<z.ZodString>;
+        changedFiles: z.ZodArray<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodObject<{
+            label: z.ZodString;
+            qualityGateReport: z.ZodString;
+            qualityGateDigest: z.ZodString;
+            runtimeReport: z.ZodString;
+            runtimeDigest: z.ZodString;
+            targetPlanId: z.ZodString;
+            route: z.ZodString;
+            profile: z.ZodString;
+            qualityGateVersion: z.ZodString;
+            runtimeVersion: z.ZodString;
+            browser: z.ZodString;
+            viewports: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            journeys: z.ZodArray<z.ZodString>;
+            screenshots: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                sha256: z.ZodString;
+            }, z.core.$strict>>;
+            findingFingerprints: z.ZodArray<z.ZodString>;
+            passed: z.ZodBoolean;
+        }, z.core.$strict>>;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    resolvedFindingIds: z.ZodArray<z.ZodString>;
+    unresolvedFindingIds: z.ZodArray<z.ZodString>;
+    targetRestored: z.ZodBoolean;
+    unrelatedFilesPreserved: z.ZodBoolean;
+    humanEvidence: z.ZodLiteral<"not-generated">;
+    evidenceBoundary: z.ZodObject<{
+        verifierLimitations: z.ZodArray<z.ZodString>;
+        humanReviewRequired: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type RepairFindingReference = z.infer<typeof repairFindingReferenceSchema>;
+export type ExactReplacement = z.infer<typeof exactReplacementSchema>;
+export type RepairRequest = z.infer<typeof repairRequestSchema>;
+export type RepairEvidenceSnapshot = z.infer<typeof repairEvidenceSnapshotSchema>;
+export type RepairAttemptResult = z.infer<typeof repairAttemptResultSchema>;
+export type RepairReport = z.infer<typeof repairReportSchema>;

package/dist/src/repair/schema.js

@@ -0,0 +1,202 @@
+import { z } from "zod";
+const idSchema = z.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/);
+const digestSchema = z.string().regex(/^[a-f0-9]{64}$/);
+export const repairRelativePathSchema = z
+    .string()
+    .min(1)
+    .max(1_024)
+    .refine((value) => !value.includes("\0") &&
+    !value.startsWith("/") &&
+    !/^[A-Za-z]:[\\/]/.test(value) &&
+    !value.split(/[\\/]/).includes(".."), "Repair paths must remain relative and cannot contain parent traversal.");
+export const repairFindingReferenceSchema = z
+    .object({
+    id: idSchema,
+    source: z.enum(["architecture", "runtime"]),
+    checkId: z.string().min(1).max(128),
+    file: repairRelativePathSchema.optional(),
+    messageIncludes: z.string().min(1).max(512).optional(),
+    viewport: z.string().min(1).max(128).optional(),
+    journey: z.string().min(1).max(128).optional(),
+    selector: z.string().min(1).max(1_024).optional(),
+    acceptanceCriterion: idSchema,
+    expectedEvidence: z
+        .array(z.enum([
+        "contract-validation",
+        "static-audit",
+        "browser-runtime",
+        "responsive-screenshots",
+    ]))
+        .min(1)
+        .max(4),
+})
+    .strict()
+    .superRefine((finding, context) => {
+    if (finding.source === "architecture" && !finding.file) {
+        context.addIssue({
+            code: "custom",
+            path: ["file"],
+            message: "Architecture findings require a repository-relative file.",
+        });
+    }
+    if (new Set(finding.expectedEvidence).size !== finding.expectedEvidence.length) {
+        context.addIssue({
+            code: "custom",
+            path: ["expectedEvidence"],
+            message: "Expected evidence entries must be unique.",
+        });
+    }
+});
+export const exactReplacementSchema = z
+    .object({
+    id: idSchema,
+    findingRef: idSchema,
+    kind: z.literal("replace-exact"),
+    file: repairRelativePathSchema,
+    expectedFileDigest: digestSchema,
+    before: z.string().min(1).max(100_000),
+    after: z.string().max(100_000),
+    expectedOccurrences: z.number().int().min(1).max(20),
+})
+    .strict()
+    .refine((operation) => operation.before !== operation.after, {
+    message: "A repair replacement must change the matched text.",
+    path: ["after"],
+});
+export const repairAttemptSchema = z
+    .object({
+    id: idSchema,
+    operations: z.array(exactReplacementSchema).min(1).max(20),
+})
+    .strict();
+export const repairRequestSchema = z
+    .object({
+    version: z.literal("1.0"),
+    id: idSchema,
+    target: z
+        .object({
+        adapter: z.literal("react-typescript-vite"),
+        manifest: repairRelativePathSchema,
+    })
+        .strict(),
+    findings: z.array(repairFindingReferenceSchema).min(1).max(20),
+    attempts: z.array(repairAttemptSchema).min(1).max(3),
+    stopping: z
+        .object({
+        maxAttempts: z.number().int().min(1).max(3),
+        resolved: z.literal("all-referenced-findings-absent-and-quality-gate-passed"),
+        repeatedFinding: z.literal("stop-unresolved-and-restore"),
+        preconditionFailure: z.literal("stop-without-write"),
+        verificationFailure: z.literal("stop-unresolved-and-restore"),
+    })
+        .strict(),
+})
+    .strict()
+    .superRefine((request, context) => {
+    const findingIds = request.findings.map((finding) => finding.id);
+    if (new Set(findingIds).size !== findingIds.length) {
+        context.addIssue({ code: "custom", path: ["findings"], message: "Finding IDs must be unique." });
+    }
+    const attemptIds = request.attempts.map((attempt) => attempt.id);
+    if (new Set(attemptIds).size !== attemptIds.length) {
+        context.addIssue({ code: "custom", path: ["attempts"], message: "Attempt IDs must be unique." });
+    }
+    if (request.stopping.maxAttempts !== request.attempts.length) {
+        context.addIssue({
+            code: "custom",
+            path: ["stopping", "maxAttempts"],
+            message: "maxAttempts must equal the number of declared attempts.",
+        });
+    }
+    const operationIds = request.attempts.flatMap((attempt) => attempt.operations.map((operation) => operation.id));
+    if (new Set(operationIds).size !== operationIds.length) {
+        context.addIssue({ code: "custom", path: ["attempts"], message: "Operation IDs must be unique." });
+    }
+    for (const [attemptIndex, attempt] of request.attempts.entries()) {
+        for (const [operationIndex, operation] of attempt.operations.entries()) {
+            if (!findingIds.includes(operation.findingRef)) {
+                context.addIssue({
+                    code: "custom",
+                    path: ["attempts", attemptIndex, "operations", operationIndex, "findingRef"],
+                    message: `Unknown finding reference ${operation.findingRef}.`,
+                });
+            }
+        }
+    }
+});
+export const repairScreenshotEvidenceSchema = z
+    .object({
+    name: z.string().min(1),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    sha256: digestSchema,
+})
+    .strict();
+export const repairEvidenceSnapshotSchema = z
+    .object({
+    label: z.string().min(1).max(128),
+    qualityGateReport: repairRelativePathSchema,
+    qualityGateDigest: digestSchema,
+    runtimeReport: repairRelativePathSchema,
+    runtimeDigest: digestSchema,
+    targetPlanId: z.string().min(1).max(256),
+    route: z.string().min(1).max(4_096),
+    profile: idSchema,
+    qualityGateVersion: z.string().min(1).max(64),
+    runtimeVersion: z.string().min(1).max(64),
+    browser: z.string().min(1).max(256),
+    viewports: z.array(z
+        .object({
+        name: z.string().min(1).max(128),
+        width: z.number().int().positive(),
+        height: z.number().int().positive(),
+    })
+        .strict()),
+    journeys: z.array(z.string().min(1).max(128)),
+    screenshots: z.array(repairScreenshotEvidenceSchema),
+    findingFingerprints: z.array(digestSchema),
+    passed: z.boolean(),
+})
+    .strict();
+export const repairAttemptResultSchema = z
+    .object({
+    id: idSchema,
+    status: z.enum(["resolved", "unresolved", "not-run"]),
+    operationIds: z.array(idSchema),
+    changedFiles: z.array(repairRelativePathSchema),
+    evidence: repairEvidenceSnapshotSchema.optional(),
+    message: z.string().min(1).max(2_048),
+})
+    .strict();
+export const repairReportSchema = z
+    .object({
+    version: z.literal("1.0"),
+    requestId: idSchema,
+    adapter: z.literal("react-typescript-vite"),
+    adapterVersion: z.string().regex(/^\d+\.\d+\.\d+$/),
+    status: z.enum(["repaired", "unresolved", "rejected"]),
+    reason: z.enum([
+        "quality-gate-passed",
+        "repeated-finding",
+        "attempt-limit",
+        "precondition-failed",
+        "verification-failed",
+    ]),
+    target: z.string().min(1).max(256),
+    generatedAt: z.string().datetime({ offset: true }),
+    before: repairEvidenceSnapshotSchema.optional(),
+    attempts: z.array(repairAttemptResultSchema).max(3),
+    resolvedFindingIds: z.array(idSchema),
+    unresolvedFindingIds: z.array(idSchema),
+    targetRestored: z.boolean(),
+    unrelatedFilesPreserved: z.boolean(),
+    humanEvidence: z.literal("not-generated"),
+    evidenceBoundary: z
+        .object({
+        verifierLimitations: z.array(z.string().min(1)),
+        humanReviewRequired: z.array(z.string().min(1)),
+    })
+        .strict(),
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

package/dist/src/repair/schema.js.map

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

package/dist/src/retrieval/report.d.ts

@@ -0,0 +1,2 @@
+import type { KnowledgeSearchReport } from "./schema.js";
+export declare function formatKnowledgeSearchReport(report: KnowledgeSearchReport): string;

package/dist/src/retrieval/report.js

@@ -0,0 +1,21 @@
+export function formatKnowledgeSearchReport(report) {
+    const query = report.query.replace(/\s+/g, " ").trim();
+    const lines = [
+        "# ZtotheZ Design Engineering Knowledge Search",
+        "",
+        `- Query: ${query}`,
+        `- Categories: ${report.categories.join(", ")}`,
+        `- Authority: \`${report.authorityPath}\` remains authoritative`,
+        `- Scope: ${report.stats.documentsSearched} documents and ${report.stats.chunksSearched} chunks`,
+        `- Status: ${report.status === "matches" ? "MATCHES" : "NO MATCH"}`,
+        `- Result: ${report.message}`,
+    ];
+    for (const result of report.results) {
+        lines.push("", `## ${result.rank}. ${result.title}`, "", `- Source: \`${result.path}\``, `- Category: ${result.category}`, `- Authority: ${result.authority}`, `- Section: ${result.section}`, `- Confidence: ${result.confidence}`, `- Score: ${result.score}`, `- Matched terms: ${result.matchedTerms.join(", ")}`, "", result.excerpt);
+    }
+    if (report.status === "no-match") {
+        lines.push("", "Do not fill this gap from legacy archives or unapproved local research. Refine the query, broaden the approved categories, or record a knowledge gap.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/src/retrieval/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/retrieval/report.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,2BAA2B,CAAC,MAA6B;IACvE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG;QACZ,+CAA+C;QAC/C,EAAE;QACF,YAAY,KAAK,EAAE;QACnB,iBAAiB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC/C,kBAAkB,MAAM,CAAC,aAAa,0BAA0B;QAChE,YAAY,MAAM,CAAC,KAAK,CAAC,iBAAiB,kBAAkB,MAAM,CAAC,KAAK,CAAC,cAAc,SAAS;QAChG,aAAa,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE;QACnE,aAAa,MAAM,CAAC,OAAO,EAAE;KAC9B,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,MAAM,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,EAAE,EACpC,EAAE,EACF,eAAe,MAAM,CAAC,IAAI,IAAI,EAC9B,eAAe,MAAM,CAAC,QAAQ,EAAE,EAChC,gBAAgB,MAAM,CAAC,SAAS,EAAE,EAClC,cAAc,MAAM,CAAC,OAAO,EAAE,EAC9B,iBAAiB,MAAM,CAAC,UAAU,EAAE,EACpC,YAAY,MAAM,CAAC,KAAK,EAAE,EAC1B,oBAAoB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACpD,EAAE,EACF,MAAM,CAAC,OAAO,CACf,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,uJAAuJ,CACxJ,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/src/retrieval/schema.d.ts

@@ -0,0 +1,123 @@
+import { z } from "zod";
+export declare const retrievalCategories: readonly ["skill", "architecture", "design-intelligence", "ux-patterns", "usability-evaluation"];
+export declare const retrievalCategorySchema: z.ZodEnum<{
+    architecture: "architecture";
+    skill: "skill";
+    "design-intelligence": "design-intelligence";
+    "ux-patterns": "ux-patterns";
+    "usability-evaluation": "usability-evaluation";
+}>;
+export type RetrievalCategory = z.infer<typeof retrievalCategorySchema>;
+export declare const retrievalScopeSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    authority: z.ZodLiteral<"SKILL.md">;
+    categories: z.ZodObject<{
+        skill: z.ZodObject<{
+            label: z.ZodString;
+            files: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        architecture: z.ZodObject<{
+            label: z.ZodString;
+            files: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        "design-intelligence": z.ZodObject<{
+            label: z.ZodString;
+            files: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        "ux-patterns": z.ZodObject<{
+            label: z.ZodString;
+            files: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        "usability-evaluation": z.ZodObject<{
+            label: z.ZodString;
+            files: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const knowledgeSearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    categories: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        architecture: "architecture";
+        skill: "skill";
+        "design-intelligence": "design-intelligence";
+        "ux-patterns": "ux-patterns";
+        "usability-evaluation": "usability-evaluation";
+    }>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const knowledgeSearchResultSchema: z.ZodObject<{
+    rank: z.ZodNumber;
+    path: z.ZodString;
+    category: z.ZodEnum<{
+        architecture: "architecture";
+        skill: "skill";
+        "design-intelligence": "design-intelligence";
+        "ux-patterns": "ux-patterns";
+        "usability-evaluation": "usability-evaluation";
+    }>;
+    authority: z.ZodEnum<{
+        authoritative: "authoritative";
+        approved: "approved";
+    }>;
+    title: z.ZodString;
+    section: z.ZodString;
+    excerpt: z.ZodString;
+    score: z.ZodNumber;
+    confidence: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    matchedTerms: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const knowledgeSearchReportSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    query: z.ZodString;
+    categories: z.ZodArray<z.ZodEnum<{
+        architecture: "architecture";
+        skill: "skill";
+        "design-intelligence": "design-intelligence";
+        "ux-patterns": "ux-patterns";
+        "usability-evaluation": "usability-evaluation";
+    }>>;
+    authorityPath: z.ZodLiteral<"SKILL.md">;
+    status: z.ZodEnum<{
+        matches: "matches";
+        "no-match": "no-match";
+    }>;
+    message: z.ZodString;
+    results: z.ZodArray<z.ZodObject<{
+        rank: z.ZodNumber;
+        path: z.ZodString;
+        category: z.ZodEnum<{
+            architecture: "architecture";
+            skill: "skill";
+            "design-intelligence": "design-intelligence";
+            "ux-patterns": "ux-patterns";
+            "usability-evaluation": "usability-evaluation";
+        }>;
+        authority: z.ZodEnum<{
+            authoritative: "authoritative";
+            approved: "approved";
+        }>;
+        title: z.ZodString;
+        section: z.ZodString;
+        excerpt: z.ZodString;
+        score: z.ZodNumber;
+        confidence: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        matchedTerms: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    stats: z.ZodObject<{
+        documentsSearched: z.ZodNumber;
+        chunksSearched: z.ZodNumber;
+        searchableTerms: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type RetrievalScope = z.infer<typeof retrievalScopeSchema>;
+export type KnowledgeSearchInput = z.infer<typeof knowledgeSearchInputSchema>;
+export type KnowledgeSearchReport = z.infer<typeof knowledgeSearchReportSchema>;
+export type KnowledgeSearchResult = z.infer<typeof knowledgeSearchResultSchema>;