persona-harness 0.3.0-alpha.0

package/dist/phase0/rule-frontmatter.js

@@ -0,0 +1,172 @@
+import { malformedFrontmatter, validateRuleFrontmatter, } from "./rule-frontmatter-diagnostics.js";
+const STEP1_API_CONTRACT_RULE = "backend/step1-api-contract.md";
+const STEP2_3_API_CONTRACT_RULE = "backend/step2-3-api-contract.md";
+export function extractBulletPolicies(markdown) {
+    const body = markdown.startsWith("---") ? markdown.split("---").slice(2).join("---") : markdown;
+    return body
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith("- "))
+        .map((line) => line.slice(2).replace(/`/g, ""));
+}
+function scenarioForRulePath(rulePath) {
+    if (rulePath === STEP1_API_CONTRACT_RULE) {
+        return "step1";
+    }
+    if (rulePath === STEP2_3_API_CONTRACT_RULE) {
+        return "step2-3";
+    }
+    return "all";
+}
+function parseSupportedField(rawKey) {
+    if (rawKey === "id")
+        return "id";
+    if (rawKey === "source")
+        return "source";
+    if (rawKey === "domain")
+        return "domain";
+    if (rawKey === "topic")
+        return "topic";
+    if (rawKey === "globs")
+        return "globs";
+    if (rawKey === "scenario")
+        return "scenario";
+    if (rawKey === "severity")
+        return "severity";
+    if (rawKey === "max_bullets")
+        return "max_bullets";
+    if (rawKey === "enforcement")
+        return "enforcement";
+    return undefined;
+}
+function cleanScalar(value) {
+    const trimmed = value.trim();
+    const first = trimmed.at(0);
+    const last = trimmed.at(-1);
+    if (trimmed.length >= 2 && ((first === '"' && last === '"') || (first === "'" && last === "'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+function isRuleScenario(value) {
+    return value === "step1" || value === "step2-3" || value === "all";
+}
+function parseScenario(value, fallback) {
+    if (isRuleScenario(value)) {
+        return value;
+    }
+    return fallback;
+}
+function parsePositiveInteger(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
+function parseSeverity(value) {
+    if (value === "must" || value === "should" || value === "prefer") {
+        return value;
+    }
+    return undefined;
+}
+function addListValue(field, value, globs) {
+    if (field === "globs") {
+        globs.push(value);
+    }
+}
+export function fallbackRuleMetadata(rulePath) {
+    return { id: rulePath, globs: [], scenario: scenarioForRulePath(rulePath) };
+}
+export function parseRuleFrontmatter(rulePath, markdown) {
+    const lines = markdown.split("\n");
+    let id;
+    let source;
+    let domain;
+    let topic;
+    const globs = [];
+    let scenarioValue;
+    let severityValue;
+    let severity;
+    let maxBullets;
+    let enforcement;
+    let listField;
+    const malformedMessages = [];
+    if (lines[0] !== "---") {
+        return {
+            metadata: fallbackRuleMetadata(rulePath),
+            diagnostics: [malformedFrontmatter("Frontmatter block is missing an opening marker.")],
+        };
+    }
+    if (!lines.slice(1).includes("---")) {
+        malformedMessages.push("Frontmatter block is missing a closing marker.");
+    }
+    for (const line of lines.slice(1)) {
+        if (line === "---") {
+            break;
+        }
+        const listMatch = line.match(/^\s*-\s+(.*)$/);
+        if (listMatch?.[1] !== undefined && listField !== undefined) {
+            addListValue(listField, cleanScalar(listMatch[1]), globs);
+            continue;
+        }
+        const fieldMatch = line.match(/^([A-Za-z_][A-Za-z0-9_-]*):\s*(.*)$/);
+        if (fieldMatch?.[1] === undefined || fieldMatch[2] === undefined) {
+            listField = undefined;
+            continue;
+        }
+        const field = parseSupportedField(fieldMatch[1]);
+        const value = cleanScalar(fieldMatch[2]);
+        listField = value === "" ? field : undefined;
+        if (field === "id" && value !== "")
+            id = value;
+        if (field === "source" && value !== "")
+            source = value;
+        if (field === "domain" && value !== "")
+            domain = value;
+        if (field === "topic" && value !== "")
+            topic = value;
+        if (field === "scenario" && value !== "")
+            scenarioValue = value;
+        if (field === "severity" && value !== "") {
+            severityValue = value;
+            severity = parseSeverity(value);
+        }
+        if (field === "max_bullets")
+            maxBullets = parsePositiveInteger(value);
+        if (field === "enforcement" && value !== "")
+            enforcement = value;
+        if (field === "globs" && value !== "") {
+            addListValue(field, value, globs);
+        }
+    }
+    const diagnostics = validateRuleFrontmatter({
+        id,
+        source,
+        domain,
+        topic,
+        globs,
+        scenario: scenarioValue,
+        severity: severityValue,
+        enforcement,
+        malformedMessages,
+    });
+    return {
+        metadata: {
+            id: id ?? rulePath,
+            source,
+            domain,
+            topic,
+            globs,
+            scenario: parseScenario(scenarioValue, scenarioForRulePath(rulePath)),
+            severity,
+            maxBullets,
+            enforcement,
+        },
+        diagnostics,
+    };
+}
+export function parseRuleMetadata(rulePath, markdown) {
+    return parseRuleFrontmatter(rulePath, markdown).metadata;
+}
+//# sourceMappingURL=rule-frontmatter.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function normalizePath(path: string): string;
+export declare function matchesAnyGlob(globs: readonly string[], targetPath: string): boolean;

package/dist/phase0/rule-glob.js

@@ -0,0 +1,38 @@
+export function normalizePath(path) {
+    return path.replace(/\\/g, "/");
+}
+function escapeRegExp(value) {
+    return value.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+}
+function globToRegExp(glob) {
+    let pattern = "^";
+    for (let index = 0; index < glob.length; index += 1) {
+        const current = glob[index];
+        const next = glob[index + 1];
+        const afterNext = glob[index + 2];
+        if (current === "*" && next === "*" && afterNext === "/") {
+            pattern += "(?:.*/)?";
+            index += 2;
+            continue;
+        }
+        if (current === "*" && next === "*") {
+            pattern += ".*";
+            index += 1;
+            continue;
+        }
+        if (current === "*") {
+            pattern += "[^/]*";
+            continue;
+        }
+        if (current === "?") {
+            pattern += "[^/]";
+            continue;
+        }
+        pattern += escapeRegExp(current ?? "");
+    }
+    return new RegExp(`${pattern}$`);
+}
+export function matchesAnyGlob(globs, targetPath) {
+    return globs.length === 0 || globs.some((glob) => globToRegExp(glob).test(targetPath));
+}
+//# sourceMappingURL=rule-glob.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rule-glob.js","sourceRoot":"","sources":["../../src/phase0/rule-glob.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,OAAO,GAAG,GAAG,CAAA;IACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QAEjC,IAAI,OAAO,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACzD,OAAO,IAAI,UAAU,CAAA;YACrB,KAAK,IAAI,CAAC,CAAA;YACV,SAAQ;QACV,CAAC;QACD,IAAI,OAAO,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACpC,OAAO,IAAI,IAAI,CAAA;YACf,KAAK,IAAI,CAAC,CAAA;YACV,SAAQ;QACV,CAAC;QACD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,OAAO,IAAI,OAAO,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,OAAO,IAAI,MAAM,CAAA;YACjB,SAAQ;QACV,CAAC;QACD,OAAO,IAAI,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAwB,EAAE,UAAkB;IACzE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;AACxF,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { FileRole } from "./types.js";
+import { type Phase0Scenario } from "./rule-catalog.js";
+import { type RuleMetadata } from "./rule-frontmatter.js";
+import type { RuleFrontmatterDiagnostic } from "./rule-frontmatter-diagnostics.js";
+export type { Phase0Scenario } from "./rule-catalog.js";
+export type LoadedRule = {
+    readonly path: string;
+    readonly metadata: RuleMetadata;
+    readonly diagnostics: readonly RuleFrontmatterDiagnostic[];
+    readonly policies: readonly string[];
+};
+export declare function selectRulePaths(fileRole: FileRole, scenario?: Phase0Scenario): string[];
+export declare function loadRulesForRole(projectDir: string, fileRole: FileRole, targetFile?: string): LoadedRule[];

package/dist/phase0/rule-loader.js

@@ -0,0 +1,143 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { loadHarnessConfig, resolveConfiguredPath } from "./harness-config.js";
+import { isRuleEligibleForTarget, loadRuleCatalog, targetPathForMatching, } from "./rule-catalog.js";
+import { extractBulletPolicies, fallbackRuleMetadata } from "./rule-frontmatter.js";
+const DEFAULT_SCENARIO = "step1";
+const STEP1_API_CONTRACT_RULE = "backend/step1-api-contract.md";
+const STEP2_3_API_CONTRACT_RULE = "backend/step2-3-api-contract.md";
+const CONTRACT_RULE_ROLES = new Set(["controller", "request-dto", "response-dto", "test"]);
+const COMMON_RULES = [
+    "clean-code/common.md",
+    "clean-code/method-design.md",
+    "backend/java-common.md",
+];
+const ROLE_RULES = {
+    controller: ["backend/spring-controller.md", "backend/spring-dto.md", STEP1_API_CONTRACT_RULE],
+    service: ["backend/spring-service.md", "backend/validation-exception.md"],
+    repository: ["backend/spring-repository.md"],
+    entity: ["clean-code/oop.md", "backend/spring-entity.md"],
+    domain: ["clean-code/oop.md", "backend/layered-architecture.md"],
+    "request-dto": ["backend/spring-dto.md", STEP1_API_CONTRACT_RULE],
+    "response-dto": ["backend/spring-dto.md", STEP1_API_CONTRACT_RULE],
+    exception: ["backend/validation-exception.md"],
+    test: ["clean-code/testability.md", "backend/spring-test.md", STEP1_API_CONTRACT_RULE],
+    "java-common": ["clean-code/abstraction.md", "backend/layered-architecture.md"],
+    "project-bootstrap": ["backend/java-backend-bootstrap.md"],
+    "requirements-bootstrap": ["backend/java-backend-bootstrap.md"],
+    "gradle-bootstrap": ["backend/gradle-bootstrap.md", "backend/java-backend-bootstrap.md"],
+};
+function isRuleFileRole(fileRole) {
+    switch (fileRole) {
+        case "controller":
+        case "service":
+        case "repository":
+        case "entity":
+        case "domain":
+        case "request-dto":
+        case "response-dto":
+        case "exception":
+        case "test":
+        case "java-common":
+        case "project-bootstrap":
+        case "requirements-bootstrap":
+        case "gradle-bootstrap":
+            return true;
+        case "typescript":
+        case "frontend":
+        case "infra":
+        case "shared-skill":
+            return false;
+    }
+}
+function takePoliciesForInjection(rulePath, policies, maxBullets) {
+    if (maxBullets !== undefined) {
+        return policies.slice(0, maxBullets);
+    }
+    if (rulePath === STEP1_API_CONTRACT_RULE || rulePath === STEP2_3_API_CONTRACT_RULE) {
+        return policies.slice(0, 3);
+    }
+    if (rulePath === "backend/layered-architecture.md") {
+        return policies.slice(0, 4);
+    }
+    if (rulePath === "backend/java-common.md") {
+        return policies.slice(0, 3);
+    }
+    if (rulePath === "backend/java-backend-bootstrap.md") {
+        return policies.slice(0, 8);
+    }
+    if (rulePath === "backend/gradle-bootstrap.md") {
+        return policies.slice(0, 4);
+    }
+    const limit = rulePath === "clean-code/method-design.md" ? 1 : 2;
+    return policies.slice(0, limit);
+}
+function contractRuleForScenario(scenario) {
+    return scenario === "step2-3" ? STEP2_3_API_CONTRACT_RULE : STEP1_API_CONTRACT_RULE;
+}
+function isStepContractRule(rulePath) {
+    return rulePath === STEP1_API_CONTRACT_RULE || rulePath === STEP2_3_API_CONTRACT_RULE;
+}
+function isRoomescapeStepFixtureTarget(targetPath) {
+    const normalizedTargetPath = targetPath.toLowerCase();
+    return normalizedTargetPath.startsWith("roomescape/") || normalizedTargetPath.includes("/roomescape/");
+}
+function isRulePathInTargetScope(rulePath, targetPath) {
+    if (!isStepContractRule(rulePath)) {
+        return true;
+    }
+    return isRoomescapeStepFixtureTarget(targetPath);
+}
+function scenarioAwareRoleRules(fileRole, scenario) {
+    if (!isRuleFileRole(fileRole)) {
+        return [];
+    }
+    const roleRules = ROLE_RULES[fileRole];
+    if (!CONTRACT_RULE_ROLES.has(fileRole)) {
+        return roleRules;
+    }
+    const contractRule = contractRuleForScenario(scenario);
+    return roleRules.map((rulePath) => (rulePath === STEP1_API_CONTRACT_RULE ? contractRule : rulePath));
+}
+export function selectRulePaths(fileRole, scenario = DEFAULT_SCENARIO) {
+    if (!isRuleFileRole(fileRole)) {
+        return [];
+    }
+    return Array.from(new Set([...COMMON_RULES, ...scenarioAwareRoleRules(fileRole, scenario)]));
+}
+export function loadRulesForRole(projectDir, fileRole, targetFile) {
+    const config = loadHarnessConfig(projectDir);
+    const scenario = config.scenario;
+    const targetPath = targetPathForMatching(projectDir, fileRole, targetFile);
+    const catalog = new Map(loadRuleCatalog(projectDir).map((entry) => [entry.path, entry]));
+    const rulesDir = resolveConfiguredPath(projectDir, config.rulesDir);
+    return selectRulePaths(fileRole, scenario).flatMap((rulePath) => {
+        if (!isRulePathInTargetScope(rulePath, targetPath)) {
+            return [];
+        }
+        const catalogEntry = catalog.get(rulePath);
+        if (catalogEntry !== undefined) {
+            if (!isRuleEligibleForTarget(catalogEntry, fileRole, scenario, targetPath)) {
+                return [];
+            }
+            return {
+                path: rulePath,
+                metadata: catalogEntry.metadata,
+                diagnostics: catalogEntry.diagnostics,
+                policies: takePoliciesForInjection(rulePath, catalogEntry.policies, catalogEntry.metadata.maxBullets),
+            };
+        }
+        const absolutePath = join(rulesDir, rulePath);
+        const metadata = fallbackRuleMetadata(rulePath);
+        if (!existsSync(absolutePath)) {
+            return { path: rulePath, metadata, diagnostics: [], policies: [] };
+        }
+        return {
+            path: rulePath,
+            metadata,
+            diagnostics: [],
+            policies: takePoliciesForInjection(rulePath, extractBulletPolicies(readFileSync(absolutePath, "utf8"))),
+        };
+    });
+}
+//# sourceMappingURL=rule-loader.js.map

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

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

package/dist/phase0/shared-skill-router.d.ts

@@ -0,0 +1,14 @@
+import type { FileRole } from "./types.js";
+export declare const ACTIVE_SHARED_SKILL_NAMES: readonly ["programming", "frontend"];
+export declare const INACTIVE_VENDORED_SHARED_SKILL_NAMES: readonly ["debugging", "visual-qa", "ast-grep", "git-master", "refactor", "review-work", "start-work", "ulw-plan", "ultraresearch", "init-deep", "remove-ai-slops", "lsp-setup"];
+export declare const REMOVED_SHARED_SKILL_NAMES: readonly ["lcx-report-bug", "lcx-contribute-bug-fix", "lcx-doctor"];
+export type SharedSkillDomain = "programming" | "frontend";
+export type SharedSkillName = (typeof ACTIVE_SHARED_SKILL_NAMES)[number];
+export type SelectedSharedSkill = {
+    readonly name: SharedSkillName;
+    readonly domain: SharedSkillDomain;
+    readonly path: string;
+    readonly reason: string;
+};
+export declare function selectSharedSkillsForTarget(targetFile: string): readonly SelectedSharedSkill[];
+export declare function resolveSharedSkillFileRole(selectedSkills: readonly SelectedSharedSkill[], targetFile?: string): FileRole;

package/dist/phase0/shared-skill-router.js

@@ -0,0 +1,85 @@
+export const ACTIVE_SHARED_SKILL_NAMES = ["programming", "frontend"];
+export const INACTIVE_VENDORED_SHARED_SKILL_NAMES = [
+    "debugging",
+    "visual-qa",
+    "ast-grep",
+    "git-master",
+    "refactor",
+    "review-work",
+    "start-work",
+    "ulw-plan",
+    "ultraresearch",
+    "init-deep",
+    "remove-ai-slops",
+    "lsp-setup",
+];
+export const REMOVED_SHARED_SKILL_NAMES = ["lcx-report-bug", "lcx-contribute-bug-fix", "lcx-doctor"];
+const TYPESCRIPT_FILE_PATTERN = /\.(ts|tsx|mts|cts)$/i;
+const JAVA_FILE_PATTERN = /\.java$/i;
+const GRADLE_BUILD_FILE_PATTERN = /(^|\/)(build|settings)\.gradle(\.kts)?$/i;
+const REACT_FILE_PATTERN = /\.tsx$/i;
+const FRONTEND_PATH_PATTERN = /(^|\/)(app|components|frontend|pages|routes|ui|web)(\/|$)/i;
+const INFRA_FILE_PATTERN = /(^|\/)(Dockerfile|docker-compose\.ya?ml|.*\.(tf|tfvars|ya?ml))$/i;
+function normalizePath(targetFile) {
+    return targetFile.replace(/\\/g, "/");
+}
+function isTypeScriptTarget(normalizedPath) {
+    return TYPESCRIPT_FILE_PATTERN.test(normalizedPath);
+}
+function isJavaProgrammingTarget(normalizedPath) {
+    return JAVA_FILE_PATTERN.test(normalizedPath) || GRADLE_BUILD_FILE_PATTERN.test(normalizedPath);
+}
+function isGradleBuildFile(normalizedPath) {
+    return GRADLE_BUILD_FILE_PATTERN.test(normalizedPath);
+}
+function isFrontendTarget(normalizedPath) {
+    return REACT_FILE_PATTERN.test(normalizedPath) || FRONTEND_PATH_PATTERN.test(normalizedPath);
+}
+function isInfraTarget(normalizedPath) {
+    return INFRA_FILE_PATTERN.test(normalizedPath);
+}
+export function selectSharedSkillsForTarget(targetFile) {
+    const normalizedPath = normalizePath(targetFile);
+    const selected = [];
+    if (isTypeScriptTarget(normalizedPath) || isJavaProgrammingTarget(normalizedPath)) {
+        selected.push({
+            name: "programming",
+            domain: "programming",
+            path: "packages/shared-skills/skills/programming/SKILL.md",
+            reason: isJavaProgrammingTarget(normalizedPath)
+                ? isGradleBuildFile(normalizedPath)
+                    ? "Gradle Java build file detected; apply shared programming discipline."
+                    : "Java target detected; apply shared programming discipline."
+                : "TypeScript target detected; apply shared programming discipline.",
+        });
+    }
+    if (isTypeScriptTarget(normalizedPath) && isFrontendTarget(normalizedPath)) {
+        selected.push({
+            name: "frontend",
+            domain: "frontend",
+            path: "packages/shared-skills/skills/frontend/SKILL.md",
+            reason: "React/frontend TypeScript target detected; apply frontend guidance as an overlay.",
+        });
+    }
+    if (isInfraTarget(normalizedPath)) {
+        return selected;
+    }
+    return selected;
+}
+export function resolveSharedSkillFileRole(selectedSkills, targetFile = "") {
+    const normalizedPath = normalizePath(targetFile);
+    if (isInfraTarget(normalizedPath)) {
+        return "infra";
+    }
+    if (selectedSkills.some((skill) => skill.domain === "frontend")) {
+        return "frontend";
+    }
+    if (isJavaProgrammingTarget(normalizedPath)) {
+        return "java-common";
+    }
+    if (selectedSkills.some((skill) => skill.domain === "programming")) {
+        return "typescript";
+    }
+    return "shared-skill";
+}
+//# sourceMappingURL=shared-skill-router.js.map

package/dist/phase0/shared-skill-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-skill-router.js","sourceRoot":"","sources":["../../src/phase0/shared-skill-router.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAU,CAAA;AAE7E,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,WAAW;IACX,WAAW;IACX,UAAU;IACV,YAAY;IACZ,UAAU;IACV,aAAa;IACb,YAAY;IACZ,UAAU;IACV,eAAe;IACf,WAAW;IACX,iBAAiB;IACjB,WAAW;CACH,CAAA;AAEV,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,gBAAgB,EAAE,wBAAwB,EAAE,YAAY,CAAU,CAAA;AAa7G,MAAM,uBAAuB,GAAG,sBAAsB,CAAA;AACtD,MAAM,iBAAiB,GAAG,UAAU,CAAA;AACpC,MAAM,yBAAyB,GAAG,0CAA0C,CAAA;AAC5E,MAAM,kBAAkB,GAAG,SAAS,CAAA;AACpC,MAAM,qBAAqB,GAAG,4DAA4D,CAAA;AAC1F,MAAM,kBAAkB,GAAG,kEAAkE,CAAA;AAE7F,SAAS,aAAa,CAAC,UAAkB;IACvC,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AACvC,CAAC;AAED,SAAS,kBAAkB,CAAC,cAAsB;IAChD,OAAO,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;AACrD,CAAC;AAED,SAAS,uBAAuB,CAAC,cAAsB;IACrD,OAAO,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;AACjG,CAAC;AAED,SAAS,iBAAiB,CAAC,cAAsB;IAC/C,OAAO,yBAAyB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;AACvD,CAAC;AAED,SAAS,gBAAgB,CAAC,cAAsB;IAC9C,OAAO,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;AAC9F,CAAC;AAED,SAAS,aAAa,CAAC,cAAsB;IAC3C,OAAO,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,UAAkB;IAC5D,MAAM,cAAc,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;IAChD,MAAM,QAAQ,GAA0B,EAAE,CAAA;IAE1C,IAAI,kBAAkB,CAAC,cAAc,CAAC,IAAI,uBAAuB,CAAC,cAAc,CAAC,EAAE,CAAC;QAClF,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,oDAAoD;YAC1D,MAAM,EAAE,uBAAuB,CAAC,cAAc,CAAC;gBAC7C,CAAC,CAAC,iBAAiB,CAAC,cAAc,CAAC;oBACjC,CAAC,CAAC,uEAAuE;oBACzE,CAAC,CAAC,4DAA4D;gBAChE,CAAC,CAAC,kEAAkE;SACvE,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,kBAAkB,CAAC,cAAc,CAAC,IAAI,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC;QAC3E,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,iDAAiD;YACvD,MAAM,EAAE,mFAAmF;SAC5F,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,cAA8C,EAAE,UAAU,GAAG,EAAE;IACxG,MAAM,cAAc,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;IAEhD,IAAI,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC;QAChE,OAAO,UAAU,CAAA;IACnB,CAAC;IACD,IAAI,uBAAuB,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5C,OAAO,aAAa,CAAA;IACtB,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC,EAAE,CAAC;QACnE,OAAO,YAAY,CAAA;IACrB,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC"}

package/dist/phase0/store.d.ts

@@ -0,0 +1,6 @@
+import type { PendingInjection } from "./types.js";
+export declare class PendingInjectionStore {
+    private readonly pendingBySession;
+    set(sessionId: string, injection: PendingInjection): void;
+    take(sessionId: string): PendingInjection | undefined;
+}

package/dist/phase0/store.js

@@ -0,0 +1,14 @@
+export class PendingInjectionStore {
+    pendingBySession = new Map();
+    set(sessionId, injection) {
+        this.pendingBySession.set(sessionId, injection);
+    }
+    take(sessionId) {
+        const injection = this.pendingBySession.get(sessionId);
+        if (injection) {
+            this.pendingBySession.delete(sessionId);
+        }
+        return injection;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/phase0/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/phase0/store.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAqB;IACf,gBAAgB,GAAG,IAAI,GAAG,EAA4B,CAAA;IAEvE,GAAG,CAAC,SAAiB,EAAE,SAA2B;QAChD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,CAAC,SAAiB;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACtD,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACzC,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;CACF"}

package/dist/phase0/target-file.d.ts

@@ -0,0 +1,2 @@
+export declare function isInstalledPersonaHarnessPackageFile(targetFile: string): boolean;
+export declare function extractTargetFile(toolName: string, args: Record<string, unknown>): string | undefined;

package/dist/phase0/target-file.js

@@ -0,0 +1,41 @@
+const TARGET_FILE_ARG_NAMES = [
+    "targetFile",
+    "filePath",
+    "filepath",
+    "file_path",
+    "path",
+    "file",
+];
+const TARGETING_TOOL_NAMES = new Set([
+    "read",
+    "edit",
+    "write",
+    "patch",
+    "multiedit",
+    "multi_edit",
+]);
+const INSTALLED_PERSONA_HARNESS_PACKAGE_PATTERN = /(^|\/)node_modules\/persona-harness\//;
+function normalizePath(targetFile) {
+    return targetFile.replace(/\\/g, "/");
+}
+export function isInstalledPersonaHarnessPackageFile(targetFile) {
+    return INSTALLED_PERSONA_HARNESS_PACKAGE_PATTERN.test(normalizePath(targetFile));
+}
+export function extractTargetFile(toolName, args) {
+    const normalizedToolName = toolName.toLowerCase();
+    const mayTargetFile = TARGETING_TOOL_NAMES.has(normalizedToolName) ||
+        normalizedToolName.includes("read") ||
+        normalizedToolName.includes("edit") ||
+        normalizedToolName.includes("write");
+    if (!mayTargetFile) {
+        return undefined;
+    }
+    for (const argName of TARGET_FILE_ARG_NAMES) {
+        const value = args[argName];
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value.trim();
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=target-file.js.map

package/dist/phase0/target-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-file.js","sourceRoot":"","sources":["../../src/phase0/target-file.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG;IAC5B,YAAY;IACZ,UAAU;IACV,UAAU;IACV,WAAW;IACX,MAAM;IACN,MAAM;CACE,CAAA;AAEV,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,WAAW;IACX,YAAY;CACb,CAAC,CAAA;AAEF,MAAM,yCAAyC,GAAG,uCAAuC,CAAA;AAEzF,SAAS,aAAa,CAAC,UAAkB;IACvC,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,UAAkB;IACrE,OAAO,yCAAyC,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAA;AAClF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAA6B;IAC/E,MAAM,kBAAkB,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;IACjD,MAAM,aAAa,GACjB,oBAAoB,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC5C,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnC,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEtC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,qBAAqB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAA;QACrB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/phase0/types.d.ts

@@ -0,0 +1,38 @@
+import type { Hooks } from "@opencode-ai/plugin";
+export type FileRole = "controller" | "service" | "repository" | "entity" | "domain" | "request-dto" | "response-dto" | "exception" | "test" | "java-common" | "project-bootstrap" | "requirements-bootstrap" | "gradle-bootstrap" | "typescript" | "frontend" | "infra" | "shared-skill";
+export type SelectedSharedSkill = {
+    readonly name: string;
+    readonly domain: string;
+    readonly path: string;
+    readonly reason: string;
+};
+export type SelectedPolicyOverlay = {
+    readonly enabled: boolean;
+    readonly sources: readonly ("company" | "personal")[];
+    readonly diagnostics: readonly string[];
+};
+export type PendingInjection = {
+    readonly targetFile: string;
+    readonly fileRole: FileRole;
+    readonly selectedRules: string[];
+    readonly selectedRuleMetadata: SelectedRuleMetadata[];
+    readonly selectedSharedSkills: readonly SelectedSharedSkill[];
+    readonly selectedPolicyOverlay: SelectedPolicyOverlay;
+    readonly policies: string[];
+    readonly block: string;
+};
+export type SelectedRuleMetadata = {
+    readonly path: string;
+    readonly id: string;
+    readonly source?: string;
+    readonly domain?: string;
+    readonly topic?: string;
+    readonly severity?: string;
+};
+type HookHandler<T> = NonNullable<T>;
+export type ToolBeforeInput = Parameters<HookHandler<Hooks["tool.execute.before"]>>[0];
+export type ToolBeforeOutput = Parameters<HookHandler<Hooks["tool.execute.before"]>>[1];
+export type ToolAfterInput = Parameters<HookHandler<Hooks["tool.execute.after"]>>[0];
+export type ToolAfterOutput = Parameters<HookHandler<Hooks["tool.execute.after"]>>[1];
+export type TransformMessagesOutput = Parameters<HookHandler<Hooks["experimental.chat.messages.transform"]>>[1];
+export {};

package/dist/phase0/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/phase0/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/phase0/types.ts"],"names":[],"mappings":""}

package/dist/phase1/observer/controller-repository-observer.d.ts

@@ -0,0 +1,17 @@
+export type ObserverFinding = "PASS" | "WARN" | "UNKNOWN";
+export type ControllerRepositoryEvidence = {
+    readonly imports: readonly string[];
+    readonly fields: readonly string[];
+    readonly constructorParameters: readonly string[];
+    readonly methodCalls: readonly string[];
+};
+export type ControllerRepositoryObservation = {
+    readonly finding: ObserverFinding;
+    readonly evidence: ControllerRepositoryEvidence;
+    readonly limitations: readonly string[];
+};
+export type ObserveControllerRepositoryDependencyInput = {
+    readonly filePath: string;
+    readonly source: string;
+};
+export declare function observeControllerRepositoryDependency(input: ObserveControllerRepositoryDependencyInput): ControllerRepositoryObservation;