persona-harness 0.3.0-alpha.0

package/dist/phase0/policy-overlay.js

@@ -0,0 +1,171 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const POLICY_OVERLAY_PATH = ".persona/policies/overlay.jsonc";
+const SUPPORTED_SCHEMA = "persona.policy-overlay.v1";
+const SUPPORTED_ROLE = "backend";
+const SUPPORTED_MVP = "java-spring-clean-code";
+const DEFAULT_MAX_BULLETS_PER_SOURCE = 5;
+function inactiveOverlay(diagnostics = []) {
+    return {
+        summaryLines: [],
+        metadata: {
+            enabled: false,
+            sources: [],
+            diagnostics,
+        },
+    };
+}
+function stripJsonComments(input) {
+    let output = "";
+    let index = 0;
+    let inString = false;
+    let escaped = false;
+    while (index < input.length) {
+        const current = input[index];
+        const next = input[index + 1];
+        if (inString) {
+            output += current;
+            if (escaped) {
+                escaped = false;
+            }
+            else if (current === "\\") {
+                escaped = true;
+            }
+            else if (current === "\"") {
+                inString = false;
+            }
+            index += 1;
+            continue;
+        }
+        if (current === "\"") {
+            inString = true;
+            output += current;
+            index += 1;
+            continue;
+        }
+        if (current === "/" && next === "/") {
+            while (index < input.length && input[index] !== "\n") {
+                index += 1;
+            }
+            continue;
+        }
+        if (current === "/" && next === "*") {
+            index += 2;
+            while (index < input.length && !(input[index] === "*" && input[index + 1] === "/")) {
+                index += 1;
+            }
+            index += 2;
+            continue;
+        }
+        output += current;
+        index += 1;
+    }
+    return output;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function maxBulletsPerSource(value) {
+    if (!isRecord(value) || !isRecord(value.limits)) {
+        return DEFAULT_MAX_BULLETS_PER_SOURCE;
+    }
+    const maxBullets = value.limits.maxBulletsPerSource;
+    return typeof maxBullets === "number" && Number.isInteger(maxBullets) && maxBullets > 0
+        ? maxBullets
+        : DEFAULT_MAX_BULLETS_PER_SOURCE;
+}
+function isSupportedOverlay(value) {
+    if (!isRecord(value) || value.schema !== SUPPORTED_SCHEMA || !isRecord(value.scope)) {
+        return false;
+    }
+    return value.scope.role === SUPPORTED_ROLE && value.scope.mvp === SUPPORTED_MVP && value.scope.productized === false;
+}
+function readSourcePath(value, sourceName) {
+    if (!isRecord(value) || !isRecord(value.sources)) {
+        return undefined;
+    }
+    const sourcePath = value.sources[sourceName];
+    return typeof sourcePath === "string" && sourcePath.trim().length > 0 ? sourcePath.trim() : undefined;
+}
+function extractBullets(markdown, maxBullets) {
+    const bullets = [];
+    for (const line of markdown.split(/\r?\n/)) {
+        const match = line.match(/^\s*-\s+(.+?)\s*$/);
+        const bullet = match?.[1]?.trim();
+        if (bullet === undefined || bullet.length === 0) {
+            continue;
+        }
+        bullets.push(`- ${bullet}`);
+        if (bullets.length >= maxBullets) {
+            break;
+        }
+    }
+    return bullets;
+}
+function readPolicySource(projectDir, overlay, name, heading, maxBullets) {
+    const sourcePath = readSourcePath(overlay, name);
+    if (sourcePath === undefined) {
+        return { diagnostics: [`missing ${name} policy source`] };
+    }
+    const absolutePath = join(projectDir, sourcePath);
+    if (!existsSync(absolutePath)) {
+        return { diagnostics: [`missing ${name} policy file: ${sourcePath}`] };
+    }
+    const bullets = extractBullets(readFileSync(absolutePath, "utf8"), maxBullets);
+    return bullets.length > 0
+        ? { source: { name, heading, path: sourcePath, bullets }, diagnostics: [] }
+        : { diagnostics: [`empty ${name} policy file: ${sourcePath}`] };
+}
+function formatSummary(sources) {
+    return [
+        "정책/철학 오버레이:",
+        "우선순위: company > personal > Clean Code baseline",
+        "",
+        ...sources.flatMap((source) => [source.heading, ...source.bullets, ""]),
+        "오버레이 사용 원칙:",
+        "- README, 현재 사용자 지시, accepted plan의 기능 요구사항이 우선한다.",
+        "- company policy는 personal philosophy보다 우선한다.",
+        "- 이 오버레이는 rule enforcement나 product-quality 보증이 아니다.",
+    ];
+}
+export function loadBackendPolicyOverlay(projectDir) {
+    const overlayPath = join(projectDir, POLICY_OVERLAY_PATH);
+    if (!existsSync(overlayPath)) {
+        return inactiveOverlay();
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(stripJsonComments(readFileSync(overlayPath, "utf8")));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            return inactiveOverlay(["malformed overlay.jsonc"]);
+        }
+        throw error;
+    }
+    if (!isRecord(parsed)) {
+        return inactiveOverlay(["overlay.jsonc must contain an object"]);
+    }
+    if (parsed.enabled === false) {
+        return inactiveOverlay();
+    }
+    if (!isSupportedOverlay(parsed)) {
+        return inactiveOverlay(["unsupported policy overlay scope"]);
+    }
+    const maxBullets = maxBulletsPerSource(parsed);
+    const company = readPolicySource(projectDir, parsed, "company", "Company policy:", maxBullets);
+    const personal = readPolicySource(projectDir, parsed, "personal", "Personal philosophy:", maxBullets);
+    const sources = [company.source, personal.source].filter((source) => source !== undefined);
+    const diagnostics = [...company.diagnostics, ...personal.diagnostics];
+    return sources.length > 0
+        ? {
+            summaryLines: formatSummary(sources),
+            metadata: {
+                enabled: true,
+                sources: sources.map((source) => source.name),
+                diagnostics,
+            },
+        }
+        : inactiveOverlay(diagnostics);
+}
+//# sourceMappingURL=policy-overlay.js.map

package/dist/phase0/policy-overlay.js.map

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

package/dist/phase0/project-profile.d.ts

@@ -0,0 +1 @@
+export declare function loadBackendProjectProfileSummary(projectDir: string): readonly string[];

package/dist/phase0/project-profile.js

@@ -0,0 +1,148 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const PROFILE_PATH = ".persona/project-profile.jsonc";
+const SUPPORTED_SCHEMA = "persona.project-profile.v1";
+const SUPPORTED_ROLE = "backend";
+const SUPPORTED_MVP = "java-spring-clean-code";
+const SUMMARY_ORDER = [
+    "project-context",
+    "project-goal",
+    "project-scale",
+    "application-type",
+    "storage",
+    "persistence-technology",
+    "migration-style",
+    "package-style",
+    "architecture-style",
+    "boundary-strictness",
+];
+function stripJsonComments(input) {
+    let output = "";
+    let index = 0;
+    let inString = false;
+    let escaped = false;
+    while (index < input.length) {
+        const current = input[index];
+        const next = input[index + 1];
+        if (inString) {
+            output += current;
+            if (escaped) {
+                escaped = false;
+            }
+            else if (current === "\\") {
+                escaped = true;
+            }
+            else if (current === "\"") {
+                inString = false;
+            }
+            index += 1;
+            continue;
+        }
+        if (current === "\"") {
+            inString = true;
+            output += current;
+            index += 1;
+            continue;
+        }
+        if (current === "/" && next === "/") {
+            while (index < input.length && input[index] !== "\n") {
+                index += 1;
+            }
+            continue;
+        }
+        if (current === "/" && next === "*") {
+            index += 2;
+            while (index < input.length && !(input[index] === "*" && input[index + 1] === "/")) {
+                index += 1;
+            }
+            index += 2;
+            continue;
+        }
+        output += current;
+        index += 1;
+    }
+    return output;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readQuestion(value) {
+    if (!isRecord(value) || typeof value.id !== "string") {
+        return undefined;
+    }
+    if (typeof value.answer === "string" && value.answer.trim() !== "") {
+        return { id: value.id, answer: value.answer.trim() };
+    }
+    if (value.answer === null) {
+        return { id: value.id, answer: null };
+    }
+    return undefined;
+}
+function readQuestions(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.flatMap((item) => {
+        const question = readQuestion(item);
+        return question === undefined ? [] : [question];
+    });
+}
+function isSupportedBackendProfile(value) {
+    if (!isRecord(value) || value.schema !== SUPPORTED_SCHEMA || !isRecord(value.scope)) {
+        return false;
+    }
+    return value.scope.role === SUPPORTED_ROLE && value.scope.mvp === SUPPORTED_MVP;
+}
+function answeredQuestionMap(questions) {
+    const answers = new Map();
+    for (const question of questions) {
+        if (question.answer !== null) {
+            answers.set(question.id, question.answer);
+        }
+    }
+    return answers;
+}
+function readProjectNote(value) {
+    if (!isRecord(value) || !isRecord(value.notes) || typeof value.notes.project !== "string") {
+        return undefined;
+    }
+    const note = value.notes.project.trim();
+    return note.length > 0 ? note : undefined;
+}
+function formatSummaryLines(answers, projectNote) {
+    const answerLines = SUMMARY_ORDER.flatMap((id) => {
+        const answer = answers.get(id);
+        return answer === undefined ? [] : [`- ${id}: ${answer}`];
+    });
+    const noteLines = projectNote === undefined ? [] : [`- notes.project: ${projectNote}`];
+    return [
+        "프로젝트 프로필 요약:",
+        ...(answerLines.length > 0 || noteLines.length > 0 ? [...answerLines, ...noteLines] : ["- 응답된 항목 없음"]),
+        "",
+        "프로필 사용 원칙:",
+        "- 이 요약은 구현 전 architecture/technology plan 참고용이다.",
+        "- 사용자의 README/요구사항과 명시 지시가 우선한다.",
+        "- 이 요약은 rule enforcement나 product-quality 보증이 아니다.",
+    ];
+}
+export function loadBackendProjectProfileSummary(projectDir) {
+    const profilePath = join(projectDir, PROFILE_PATH);
+    if (!existsSync(profilePath)) {
+        return [];
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(stripJsonComments(readFileSync(profilePath, "utf8")));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            return [];
+        }
+        throw error;
+    }
+    if (!isSupportedBackendProfile(parsed)) {
+        return [];
+    }
+    return formatSummaryLines(answeredQuestionMap(readQuestions(parsed.questions)), readProjectNote(parsed));
+}
+//# sourceMappingURL=project-profile.js.map

package/dist/phase0/project-profile.js.map

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

package/dist/phase0/rule-catalog.d.ts

@@ -0,0 +1,14 @@
+import type { FileRole } from "./types.js";
+import { type Phase0Scenario, type RuleMetadata } from "./rule-frontmatter.js";
+import type { RuleFrontmatterDiagnostic } from "./rule-frontmatter-diagnostics.js";
+export type { Phase0Scenario } from "./rule-frontmatter.js";
+export type RuleCatalogEntry = {
+    readonly path: string;
+    readonly absolutePath: string;
+    readonly metadata: RuleMetadata;
+    readonly diagnostics: readonly RuleFrontmatterDiagnostic[];
+    readonly policies: readonly string[];
+};
+export declare function loadRuleCatalog(projectDir: string): RuleCatalogEntry[];
+export declare function targetPathForMatching(projectDir: string, fileRole: FileRole, targetFile?: string): string;
+export declare function isRuleEligibleForTarget(entry: RuleCatalogEntry, fileRole: FileRole, scenario: Phase0Scenario, targetPath: string): boolean;

package/dist/phase0/rule-catalog.js

@@ -0,0 +1,77 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { isAbsolute, join, relative, sep } from "node:path";
+import { loadHarnessConfig, resolveConfiguredPath } from "./harness-config.js";
+import { matchesAnyGlob, normalizePath } from "./rule-glob.js";
+import { extractBulletPolicies, parseRuleFrontmatter, } from "./rule-frontmatter.js";
+function listMarkdownFiles(directory) {
+    return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+        const path = join(directory, entry.name);
+        if (entry.isDirectory()) {
+            return listMarkdownFiles(path);
+        }
+        return entry.isFile() && entry.name.endsWith(".md") ? [path] : [];
+    });
+}
+export function loadRuleCatalog(projectDir) {
+    const config = loadHarnessConfig(projectDir);
+    const rulesDir = resolveConfiguredPath(projectDir, config.rulesDir);
+    if (!existsSync(rulesDir)) {
+        return [];
+    }
+    return listMarkdownFiles(rulesDir)
+        .sort()
+        .map((absolutePath) => {
+        const rulePath = normalizePath(relative(rulesDir, absolutePath).split(sep).join("/"));
+        const markdown = readFileSync(absolutePath, "utf8");
+        const frontmatter = parseRuleFrontmatter(rulePath, markdown);
+        return {
+            path: rulePath,
+            absolutePath,
+            metadata: frontmatter.metadata,
+            diagnostics: frontmatter.diagnostics,
+            policies: extractBulletPolicies(markdown),
+        };
+    });
+}
+function syntheticTargetForRole(fileRole) {
+    if (fileRole === "controller")
+        return "src/main/java/com/example/ReservationController.java";
+    if (fileRole === "service")
+        return "src/main/java/com/example/ReservationService.java";
+    if (fileRole === "repository")
+        return "src/main/java/com/example/ReservationRepository.java";
+    if (fileRole === "entity")
+        return "src/main/java/com/example/ReservationEntity.java";
+    if (fileRole === "domain")
+        return "src/main/java/com/example/domain/Reservation.java";
+    if (fileRole === "request-dto")
+        return "src/main/java/com/example/ReservationRequest.java";
+    if (fileRole === "response-dto")
+        return "src/main/java/com/example/ReservationResponse.java";
+    if (fileRole === "exception")
+        return "src/main/java/com/example/ReservationException.java";
+    if (fileRole === "test")
+        return "src/test/java/com/example/ReservationTest.java";
+    return "src/main/java/com/example/Reservation.java";
+}
+export function targetPathForMatching(projectDir, fileRole, targetFile) {
+    if (targetFile === undefined) {
+        return syntheticTargetForRole(fileRole);
+    }
+    const normalizedTarget = normalizePath(targetFile);
+    if (!isAbsolute(targetFile)) {
+        return normalizedTarget;
+    }
+    const relativeTarget = normalizePath(relative(projectDir, targetFile));
+    return relativeTarget.startsWith("..") ? normalizedTarget : relativeTarget;
+}
+function matchesRuleGlob(entry, targetPath) {
+    return matchesAnyGlob(entry.metadata.globs, targetPath);
+}
+function matchesRuleScenario(entry, scenario) {
+    return entry.metadata.scenario === "all" || entry.metadata.scenario === scenario;
+}
+export function isRuleEligibleForTarget(entry, fileRole, scenario, targetPath) {
+    return matchesRuleGlob(entry, targetPath) && matchesRuleScenario(entry, scenario);
+}
+//# sourceMappingURL=rule-catalog.js.map

package/dist/phase0/rule-catalog.js.map

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

package/dist/phase0/rule-diagnostics-report.d.ts

@@ -0,0 +1,17 @@
+import type { RuleFrontmatterDiagnostic } from "./rule-frontmatter-diagnostics.js";
+export type RuleDiagnosticsFinding = "PASS" | "WARN";
+export type RuleDiagnosticReportItem = {
+    readonly path: string;
+    readonly diagnostic: RuleFrontmatterDiagnostic;
+};
+export type RuleDiagnosticsSummary = {
+    readonly projectDir: string;
+    readonly finding: RuleDiagnosticsFinding;
+    readonly ruleCount: number;
+    readonly diagnosticCount: number;
+    readonly diagnostics: readonly RuleDiagnosticReportItem[];
+};
+export declare function defaultRuleDiagnosticsReportPath(projectDir: string): string;
+export declare function summarizeRuleDiagnostics(projectDir: string): RuleDiagnosticsSummary;
+export declare function renderRuleDiagnosticsReport(summary: RuleDiagnosticsSummary): string;
+export declare function writeRuleDiagnosticsReport(projectDir: string, outputPath: string): RuleDiagnosticsSummary;

package/dist/phase0/rule-diagnostics-report.js

@@ -0,0 +1,51 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { loadHarnessConfig, resolveConfiguredPath } from "./harness-config.js";
+import { loadRuleCatalog } from "./rule-catalog.js";
+export function defaultRuleDiagnosticsReportPath(projectDir) {
+    const config = loadHarnessConfig(projectDir);
+    return join(resolveConfiguredPath(projectDir, config.evidenceDir), "phase-next", "rule-diagnostics-report.md");
+}
+export function summarizeRuleDiagnostics(projectDir) {
+    const catalog = loadRuleCatalog(projectDir);
+    const diagnostics = catalog.flatMap((entry) => entry.diagnostics.map((diagnostic) => ({
+        path: entry.path,
+        diagnostic,
+    })));
+    return {
+        projectDir,
+        finding: diagnostics.length === 0 ? "PASS" : "WARN",
+        ruleCount: catalog.length,
+        diagnosticCount: diagnostics.length,
+        diagnostics,
+    };
+}
+function diagnosticField(diagnostic) {
+    return diagnostic.field ?? "-";
+}
+export function renderRuleDiagnosticsReport(summary) {
+    const lines = [
+        "# PersonaHarnessRule Diagnostics Report",
+        "",
+        `Project: ${summary.projectDir}`,
+        `Finding: ${summary.finding}`,
+        `Rules: ${summary.ruleCount}`,
+        `Diagnostics: ${summary.diagnosticCount}`,
+        "",
+        "## Diagnostics",
+        "",
+    ];
+    if (summary.diagnostics.length === 0) {
+        return `${lines.concat("No rule frontmatter diagnostics found.", "").join("\n")}`;
+    }
+    return `${lines
+        .concat("| Rule | Code | Field | Message |", "| --- | --- | --- | --- |", ...summary.diagnostics.map((item) => `| ${item.path} | ${item.diagnostic.code} | ${diagnosticField(item.diagnostic)} | ${item.diagnostic.message} |`), "", "## Decision", "", "Diagnostics are report-only. They do not block rule loading, rule selection, tests, typecheck, build, or injection.", "")
+        .join("\n")}`;
+}
+export function writeRuleDiagnosticsReport(projectDir, outputPath) {
+    const summary = summarizeRuleDiagnostics(projectDir);
+    mkdirSync(dirname(outputPath), { recursive: true });
+    writeFileSync(outputPath, `${renderRuleDiagnosticsReport(summary)}\n`);
+    return summary;
+}
+//# sourceMappingURL=rule-diagnostics-report.js.map

package/dist/phase0/rule-diagnostics-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-diagnostics-report.js","sourceRoot":"","sources":["../../src/phase0/rule-diagnostics-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAkBnD,MAAM,UAAU,gCAAgC,CAAC,UAAkB;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,4BAA4B,CAAC,CAAA;AAChH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,UAAkB;IACzD,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5C,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU;KACX,CAAC,CAAC,CACJ,CAAA;IAED,OAAO;QACL,UAAU;QACV,OAAO,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACnD,SAAS,EAAE,OAAO,CAAC,MAAM;QACzB,eAAe,EAAE,WAAW,CAAC,MAAM;QACnC,WAAW;KACZ,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,UAAqC;IAC5D,OAAO,UAAU,CAAC,KAAK,IAAI,GAAG,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAA+B;IACzE,MAAM,KAAK,GAAG;QACZ,yCAAyC;QACzC,EAAE;QACF,YAAY,OAAO,CAAC,UAAU,EAAE;QAChC,YAAY,OAAO,CAAC,OAAO,EAAE;QAC7B,UAAU,OAAO,CAAC,SAAS,EAAE;QAC7B,gBAAgB,OAAO,CAAC,eAAe,EAAE;QACzC,EAAE;QACF,gBAAgB;QAChB,EAAE;KACH,CAAA;IAED,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;IACnF,CAAC;IAED,OAAO,GAAG,KAAK;SACZ,MAAM,CACL,mCAAmC,EACnC,2BAA2B,EAC3B,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CACxB,CAAC,IAAI,EAAE,EAAE,CACP,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,CAClH,EACD,EAAE,EACF,aAAa,EACb,EAAE,EACF,qHAAqH,EACrH,EAAE,CACH;SACA,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,UAAkB,EAAE,UAAkB;IAC/E,MAAM,OAAO,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAA;IACpD,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,aAAa,CAAC,UAAU,EAAE,GAAG,2BAA2B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/phase0/rule-frontmatter-diagnostics.d.ts

@@ -0,0 +1,19 @@
+export type RuleFrontmatterDiagnosticCode = "missing_required_field" | "invalid_enum_value" | "malformed_frontmatter";
+export type RuleFrontmatterDiagnostic = {
+    readonly code: RuleFrontmatterDiagnosticCode;
+    readonly field?: string;
+    readonly message: string;
+};
+export type RuleFrontmatterValidationInput = {
+    readonly id?: string;
+    readonly source?: string;
+    readonly domain?: string;
+    readonly topic?: string;
+    readonly globs: readonly string[];
+    readonly scenario?: string;
+    readonly severity?: string;
+    readonly enforcement?: string;
+    readonly malformedMessages: readonly string[];
+};
+export declare function malformedFrontmatter(message: string): RuleFrontmatterDiagnostic;
+export declare function validateRuleFrontmatter(input: RuleFrontmatterValidationInput): readonly RuleFrontmatterDiagnostic[];

package/dist/phase0/rule-frontmatter-diagnostics.js

@@ -0,0 +1,65 @@
+const SOURCE_VALUES = ["clean-code", "backend-policy"];
+const DOMAIN_VALUES = ["common", "backend"];
+const SCENARIO_VALUES = ["step1", "step2-3", "all"];
+const SEVERITY_VALUES = ["must", "should", "prefer"];
+const ENFORCEMENT_VALUES = ["inject_only"];
+export function malformedFrontmatter(message) {
+    return {
+        code: "malformed_frontmatter",
+        message,
+    };
+}
+function missingRequiredField(field) {
+    return {
+        code: "missing_required_field",
+        field,
+        message: `Required frontmatter field '${field}' is missing.`,
+    };
+}
+function invalidEnumValue(field, value) {
+    return {
+        code: "invalid_enum_value",
+        field,
+        message: `Unsupported frontmatter value for '${field}': ${value}.`,
+    };
+}
+function hasValue(value) {
+    return value !== undefined && value !== "";
+}
+function isKnownValue(value, values) {
+    return value !== undefined && values.includes(value);
+}
+export function validateRuleFrontmatter(input) {
+    const diagnostics = input.malformedMessages.map(malformedFrontmatter);
+    if (!hasValue(input.id))
+        diagnostics.push(missingRequiredField("id"));
+    if (!hasValue(input.source))
+        diagnostics.push(missingRequiredField("source"));
+    if (!hasValue(input.domain))
+        diagnostics.push(missingRequiredField("domain"));
+    if (!hasValue(input.topic))
+        diagnostics.push(missingRequiredField("topic"));
+    if (input.globs.length === 0)
+        diagnostics.push(missingRequiredField("globs"));
+    if (!hasValue(input.severity))
+        diagnostics.push(missingRequiredField("severity"));
+    if (!hasValue(input.enforcement))
+        diagnostics.push(missingRequiredField("enforcement"));
+    if (hasValue(input.source) && !isKnownValue(input.source, SOURCE_VALUES)) {
+        diagnostics.push(invalidEnumValue("source", input.source));
+    }
+    if (hasValue(input.domain) && !isKnownValue(input.domain, DOMAIN_VALUES)) {
+        diagnostics.push(invalidEnumValue("domain", input.domain));
+    }
+    if (hasValue(input.scenario) && !isKnownValue(input.scenario, SCENARIO_VALUES)) {
+        diagnostics.push(invalidEnumValue("scenario", input.scenario));
+    }
+    if (hasValue(input.severity) && !isKnownValue(input.severity, SEVERITY_VALUES)) {
+        diagnostics.push(invalidEnumValue("severity", input.severity));
+    }
+    if (hasValue(input.enforcement) && !isKnownValue(input.enforcement, ENFORCEMENT_VALUES)) {
+        diagnostics.push(invalidEnumValue("enforcement", input.enforcement));
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=rule-frontmatter-diagnostics.js.map

package/dist/phase0/rule-frontmatter-diagnostics.js.map

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

package/dist/phase0/rule-frontmatter.d.ts

@@ -0,0 +1,23 @@
+import { type RuleFrontmatterDiagnostic } from "./rule-frontmatter-diagnostics.js";
+export type Phase0Scenario = "step1" | "step2-3";
+export type RuleScenario = Phase0Scenario | "all";
+export type RuleSeverity = "must" | "should" | "prefer";
+export type RuleMetadata = {
+    readonly id: string;
+    readonly source?: string;
+    readonly domain?: string;
+    readonly topic?: string;
+    readonly globs: readonly string[];
+    readonly scenario: RuleScenario;
+    readonly severity?: RuleSeverity;
+    readonly maxBullets?: number;
+    readonly enforcement?: string;
+};
+export type RuleFrontmatterParseResult = {
+    readonly metadata: RuleMetadata;
+    readonly diagnostics: readonly RuleFrontmatterDiagnostic[];
+};
+export declare function extractBulletPolicies(markdown: string): string[];
+export declare function fallbackRuleMetadata(rulePath: string): RuleMetadata;
+export declare function parseRuleFrontmatter(rulePath: string, markdown: string): RuleFrontmatterParseResult;
+export declare function parseRuleMetadata(rulePath: string, markdown: string): RuleMetadata;