@blxzer/pactile 0.5.0

package/dist/utils/p36-upgrade.d.ts

@@ -0,0 +1,62 @@
+/**
+ * P36 official-surface A planner and vernacular summary for `pactile update`.
+ *
+ * Wave A refreshes unmodified shipped files (already owned by update hash
+ * analysis) and retires leftover extra always-on rules. User-modified
+ * official files are listed and kept. Wave C stop-read is confirm-gated
+ * on the same `pactile update` plus one confirmation.
+ */
+import { type ArtifactMigratePlan, type WaveCPlan } from "@blxzer/pactile-core/task";
+import type { TemplateHashes } from "../types/migration.js";
+export declare const RETIRED_ALWAYS_ON_RULES: readonly [".cursor/rules/cstl-triage.mdc", ".cursor/rules/trellis-triage.mdc", ".cursor/rules/cstl-subagent-dispatch.mdc", ".cursor/rules/trellis-subagent-dispatch.mdc", ".cursor/rules/retrieval-routing.mdc", ".cursor/rules/cstl-retrieval-routing.mdc", ".cursor/rules/trellis-retrieval-routing.mdc"];
+export declare const KEEP_ALWAYS_ON_RULES: readonly [".cursor/rules/pactile-bootstrap.mdc"];
+export type OfficialRetireAction = "retire" | "preserve";
+export interface OfficialSurfaceItem {
+    path: string;
+    action: OfficialRetireAction;
+    reason: string;
+}
+export interface OfficialSurfacePlan {
+    refresh: string[];
+    preserved: string[];
+    added: string[];
+    retire: OfficialSurfaceItem[];
+    preserve: OfficialSurfaceItem[];
+}
+export interface P36UpgradePlan {
+    official: OfficialSurfacePlan;
+    artifacts: ArtifactMigratePlan;
+    writeArtifacts: boolean;
+    waveC: WaveCPlan;
+    vernacular: string[];
+}
+export declare function planOfficialSurfaceA(options: {
+    cwd: string;
+    hashes: TemplateHashes;
+    refresh: string[];
+    preserved: string[];
+    added?: string[];
+}): OfficialSurfacePlan;
+export declare function applyOfficialRetire(cwd: string, plan: OfficialSurfacePlan): number;
+export declare function composeP36Plan(options: {
+    official: OfficialSurfacePlan;
+    artifacts: ArtifactMigratePlan;
+    writeArtifacts: boolean;
+    waveC: WaveCPlan;
+}): P36UpgradePlan;
+export declare function printP36Vernacular(plan: P36UpgradePlan): void;
+export declare function officialWorkPending(plan: OfficialSurfacePlan): boolean;
+export declare function waveCWorkPending(plan: P36UpgradePlan): boolean;
+export declare function p36SummaryForRollout(plan: P36UpgradePlan): {
+    officialRefresh: number;
+    officialPreserved: number;
+    officialRetire: number;
+    artifactDualRead: number;
+    artifactWritable: number;
+    degraded: string[];
+    writeArtifacts: boolean;
+    waveCConfirmed: boolean;
+    leftoverCloseout: number;
+    alreadyNewShape: number;
+};
+//# sourceMappingURL=p36-upgrade.d.ts.map

package/dist/utils/p36-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p36-upgrade.d.ts","sourceRoot":"","sources":["../../src/utils/p36-upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,eAAO,MAAM,uBAAuB,6SAQ1B,CAAC;AAEX,eAAO,MAAM,oBAAoB,kDAAmD,CAAC;AAErF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,mBAAmB,CA8CtB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,mBAAmB,GACxB,MAAM,CAkBR;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;CAClB,GAAG,cAAc,CAoBjB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAkB7D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAMtE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,CAiBA"}

package/dist/utils/p36-upgrade.js

@@ -0,0 +1,165 @@
+/**
+ * P36 official-surface A planner and vernacular summary for `pactile update`.
+ *
+ * Wave A refreshes unmodified shipped files (already owned by update hash
+ * analysis) and retires leftover extra always-on rules. User-modified
+ * official files are listed and kept. Wave C stop-read is confirm-gated
+ * on the same `pactile update` plus one confirmation.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import { formatArtifactVernacular, formatWaveCVernacular, } from "@blxzer/pactile-core/task";
+import { computeHash, removeHash } from "./template-hash.js";
+import { toPosix } from "./posix.js";
+export const RETIRED_ALWAYS_ON_RULES = [
+    ".cursor/rules/cstl-triage.mdc",
+    ".cursor/rules/trellis-triage.mdc",
+    ".cursor/rules/cstl-subagent-dispatch.mdc",
+    ".cursor/rules/trellis-subagent-dispatch.mdc",
+    ".cursor/rules/retrieval-routing.mdc",
+    ".cursor/rules/cstl-retrieval-routing.mdc",
+    ".cursor/rules/trellis-retrieval-routing.mdc",
+];
+export const KEEP_ALWAYS_ON_RULES = [".cursor/rules/pactile-bootstrap.mdc"];
+export function planOfficialSurfaceA(options) {
+    const retire = [];
+    const preserve = [];
+    for (const relativePath of RETIRED_ALWAYS_ON_RULES) {
+        const fullPath = path.join(options.cwd, relativePath);
+        if (!fs.existsSync(fullPath))
+            continue;
+        const posix = toPosix(relativePath);
+        const stored = options.hashes[posix] ?? options.hashes[relativePath];
+        let currentHash = null;
+        try {
+            currentHash = computeHash(fs.readFileSync(fullPath, "utf-8"));
+        }
+        catch {
+            preserve.push({
+                path: posix,
+                action: "preserve",
+                reason: "unreadable leftover",
+            });
+            continue;
+        }
+        const unmodified = Boolean(stored && stored === currentHash);
+        const knownUntracked = !stored && hasAlwaysApply(fullPath);
+        if (unmodified || knownUntracked) {
+            retire.push({
+                path: posix,
+                action: "retire",
+                reason: unmodified
+                    ? "unmodified shipped always-on"
+                    : "known official always-on path",
+            });
+        }
+        else {
+            preserve.push({
+                path: posix,
+                action: "preserve",
+                reason: "you edited this official file",
+            });
+        }
+    }
+    return {
+        refresh: [...options.refresh],
+        preserved: [...options.preserved],
+        added: [...(options.added ?? [])],
+        retire,
+        preserve,
+    };
+}
+export function applyOfficialRetire(cwd, plan) {
+    let deleted = 0;
+    for (const item of plan.retire) {
+        const fullPath = path.join(cwd, item.path);
+        if (!fs.existsSync(fullPath))
+            continue;
+        // The plan is computed before canonical commit and Adapter projection.
+        // Re-check the official marker so a concurrent/user edit is preserved
+        // instead of being unlinked from a stale pre-commit observation.
+        if (!hasAlwaysApply(fullPath))
+            continue;
+        fs.unlinkSync(fullPath);
+        try {
+            removeHash(cwd, item.path);
+        }
+        catch {
+            // Hash store is optional in unit fixtures; retiring the file is enough.
+        }
+        deleted += 1;
+    }
+    return deleted;
+}
+export function composeP36Plan(options) {
+    const officialCount = options.official.refresh.length +
+        options.official.added.length +
+        options.official.retire.length;
+    const preservedCount = options.official.preserved.length + options.official.preserve.length;
+    const vernacular = [
+        `官方面：将刷新 ${officialCount} 个未改过的官方文件/规则；你改过的 ${preservedCount} 个已保留。`,
+        "--force / --skip-all / --create-new 会套官方文件，但不写 .p36-wave-c.json；只有交互确认 Proceed? 才停读。",
+        ...formatArtifactVernacular(options.artifacts, options.writeArtifacts),
+        ...formatWaveCVernacular(options.waveC),
+    ];
+    return {
+        official: options.official,
+        artifacts: options.artifacts,
+        writeArtifacts: options.writeArtifacts,
+        waveC: options.waveC,
+        vernacular,
+    };
+}
+export function printP36Vernacular(plan) {
+    console.log(chalk.cyan("升级摘要"));
+    for (const line of plan.vernacular) {
+        console.log(`  ${line}`);
+    }
+    if (plan.official.preserve.length > 0) {
+        console.log(chalk.yellow("  你改过、已保留："));
+        for (const item of plan.official.preserve) {
+            console.log(chalk.yellow(`    ? ${item.path}`));
+        }
+    }
+    if (plan.official.preserved.length > 0 && plan.official.preserve.length === 0) {
+        console.log(chalk.yellow("  你改过、已保留："));
+        for (const relativePath of plan.official.preserved.slice(0, 8)) {
+            console.log(chalk.yellow(`    ? ${relativePath}`));
+        }
+    }
+    console.log("");
+}
+export function officialWorkPending(plan) {
+    return (plan.refresh.length > 0 ||
+        plan.added.length > 0 ||
+        plan.retire.length > 0);
+}
+export function waveCWorkPending(plan) {
+    return !plan.waveC.confirmed;
+}
+export function p36SummaryForRollout(plan) {
+    return {
+        officialRefresh: plan.official.refresh.length +
+            plan.official.added.length +
+            plan.official.retire.length,
+        officialPreserved: plan.official.preserved.length + plan.official.preserve.length,
+        officialRetire: plan.official.retire.length,
+        artifactDualRead: plan.artifacts.activeDualRead,
+        artifactWritable: plan.writeArtifacts ? plan.artifacts.writable.length : 0,
+        degraded: plan.artifacts.degraded,
+        writeArtifacts: plan.writeArtifacts,
+        waveCConfirmed: plan.waveC.confirmed,
+        leftoverCloseout: plan.waveC.leftoverCloseout,
+        alreadyNewShape: plan.waveC.alreadyNewShape,
+    };
+}
+function hasAlwaysApply(fullPath) {
+    try {
+        return /alwaysApply:\s*true/.test(fs.readFileSync(fullPath, "utf-8"));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=p36-upgrade.js.map

package/dist/utils/p36-upgrade.js.map

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

package/dist/utils/posix.d.ts

@@ -0,0 +1,13 @@
+/**
+ * POSIX path normalization utility
+ *
+ * Single source of truth for converting OS-native path separators to POSIX `/`.
+ * Use ONLY for logical path strings used as cross-platform persistence keys
+ * (e.g. hash dictionary keys, JSON-stored paths). Do NOT use for paths passed
+ * to filesystem APIs — those must remain OS-native via `path.join`.
+ */
+/**
+ * Convert any path string's `\` separators to POSIX `/`.
+ */
+export declare function toPosix(p: string): string;
+//# sourceMappingURL=posix.d.ts.map

package/dist/utils/posix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix.d.ts","sourceRoot":"","sources":["../../src/utils/posix.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC"}

package/dist/utils/posix.js

@@ -0,0 +1,15 @@
+/**
+ * POSIX path normalization utility
+ *
+ * Single source of truth for converting OS-native path separators to POSIX `/`.
+ * Use ONLY for logical path strings used as cross-platform persistence keys
+ * (e.g. hash dictionary keys, JSON-stored paths). Do NOT use for paths passed
+ * to filesystem APIs — those must remain OS-native via `path.join`.
+ */
+/**
+ * Convert any path string's `\` separators to POSIX `/`.
+ */
+export function toPosix(p) {
+    return p.replace(/\\/g, "/");
+}
+//# sourceMappingURL=posix.js.map

package/dist/utils/posix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix.js","sourceRoot":"","sources":["../../src/utils/posix.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/utils/post-update-smoke.d.ts

@@ -0,0 +1,7 @@
+import type { UpdateSmokeCheckResult } from "./update-rollout-report.js";
+/**
+ * Repeatable, non-destructive checks after a successful `pactile update` apply.
+ * Verifies generated Pactile Python entrypoints compile and respond to --help.
+ */
+export declare function runPostUpdateSmoke(cwd: string): UpdateSmokeCheckResult[];
+//# sourceMappingURL=post-update-smoke.d.ts.map

package/dist/utils/post-update-smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-update-smoke.d.ts","sourceRoot":"","sources":["../../src/utils/post-update-smoke.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAkBzE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAsBxE"}

package/dist/utils/post-update-smoke.js

@@ -0,0 +1,40 @@
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { PATHS } from "../constants/paths.js";
+import { replacePythonCommandLiterals } from "../configurators/shared.js";
+function runCheck(command, cwd) {
+    try {
+        execSync(command, {
+            cwd,
+            encoding: "utf-8",
+            stdio: "pipe",
+            timeout: 120_000,
+        });
+        return { command, ok: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "command failed";
+        return { command, ok: false, detail: message.replace(/\s+/g, " ").trim() };
+    }
+}
+/**
+ * Repeatable, non-destructive checks after a successful `pactile update` apply.
+ * Verifies generated Pactile Python entrypoints compile and respond to --help.
+ */
+export function runPostUpdateSmoke(cwd) {
+    const results = [];
+    const pyScript = path.join(cwd, PATHS.SCRIPTS, "get_context.py");
+    const taskScript = path.join(cwd, PATHS.SCRIPTS, "task.py");
+    const py = process.platform === "win32" ? "python" : "python3";
+    if (fs.existsSync(pyScript)) {
+        const cmd = replacePythonCommandLiterals(`${py} ./${PATHS.SCRIPTS}/get_context.py --help`);
+        results.push(runCheck(cmd, cwd));
+    }
+    if (fs.existsSync(taskScript)) {
+        const cmd = replacePythonCommandLiterals(`${py} ./${PATHS.SCRIPTS}/task.py --help`);
+        results.push(runCheck(cmd, cwd));
+    }
+    return results;
+}
+//# sourceMappingURL=post-update-smoke.js.map

package/dist/utils/post-update-smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-update-smoke.js","sourceRoot":"","sources":["../../src/utils/post-update-smoke.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAG1E,SAAS,QAAQ,CAAC,OAAe,EAAE,GAAW;IAC5C,IAAI,CAAC;QACH,QAAQ,CAAC,OAAO,EAAE;YAChB,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE5D,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,4BAA4B,CACtC,GAAG,EAAE,MAAM,KAAK,CAAC,OAAO,wBAAwB,CACjD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,4BAA4B,CACtC,GAAG,EAAE,MAAM,KAAK,CAAC,OAAO,iBAAiB,CAC1C,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/project-capabilities.d.ts

@@ -0,0 +1,82 @@
+import type { AITool } from "../types/ai-tools.js";
+export type { ProviderManifestLoadDiagnosticCodeV1, ProviderManifestLoadDiagnosticV1, ProviderManifestLoadResultV1, } from "../pactile/middleware/manifest-loader.js";
+export { PROVIDER_MANIFEST_LOAD_DIAGNOSTIC_CODES_V1, loadProviderManifestsV1, } from "../pactile/middleware/manifest-loader.js";
+export declare const PROJECT_CAPABILITY_IDS: readonly ["codebase-retrieval", "github-mcp", "playwright-mcp"];
+export type ProjectCapabilityId = (typeof PROJECT_CAPABILITY_IDS)[number];
+export interface McpServerTemplate {
+    name: string;
+    command: string;
+    args: string[];
+    startupTimeoutSec?: number;
+}
+export interface McpQueryGuidance {
+    tool: string;
+    use: string;
+}
+export interface CliAutomationGuidance {
+    command: string;
+    use: string;
+}
+export interface ProjectCapabilityAdapter {
+    provider: string;
+    required: boolean;
+    purpose: string;
+    readiness: string;
+    evidenceStatus: string;
+    mcpServer?: string;
+}
+export interface ProjectCapability {
+    id: ProjectCapabilityId;
+    aliases: string[];
+    title: string;
+    description: string;
+    routing: string;
+    readiness: string;
+    fallback: string[];
+    adapters?: Record<string, ProjectCapabilityAdapter>;
+    cliAutomationGuidance?: CliAutomationGuidance[];
+    mcpQueryGuidance?: McpQueryGuidance[];
+    mcpServers: McpServerTemplate[];
+}
+export declare const PROJECT_CAPABILITY_READINESS_STATUSES: readonly ["pending", "ready", "failed"];
+export type ProjectCapabilityReadinessStatus = (typeof PROJECT_CAPABILITY_READINESS_STATUSES)[number];
+interface StoredCapabilityState {
+    selected: boolean;
+    readiness_status?: ProjectCapabilityReadinessStatus;
+    readiness_status_updated_at?: string;
+    readiness_status_detail?: string;
+}
+export declare const PROJECT_CAPABILITIES: readonly ProjectCapability[];
+export declare function parseProjectCapabilities(values: readonly string[] | undefined): ProjectCapabilityId[];
+export declare function getProjectCapabilityChoices(): {
+    id: ProjectCapabilityId;
+    name: string;
+}[];
+export declare function renderCapabilitiesJson(selected: readonly ProjectCapabilityId[], states?: Partial<Record<ProjectCapabilityId, StoredCapabilityState>>): string;
+export declare function getProjectCapability(id: ProjectCapabilityId): ProjectCapability;
+export declare function renderCapabilitiesMarkdown(selected: readonly ProjectCapabilityId[], states?: Partial<Record<ProjectCapabilityId, StoredCapabilityState>>): string;
+export declare function applyCodexCapabilityConfig(baseContent: string, selected: readonly ProjectCapabilityId[]): string;
+/** MCP server names declared by any registry capability (Pactile-managed keys). */
+export declare function managedMcpServerNames(): string[];
+export interface McpServerEntry {
+    command: string;
+    args: string[];
+    [key: string]: unknown;
+}
+export declare function loadExistingMcpServers(cwd: string): Record<string, McpServerEntry>;
+/**
+ * Render `.cursor/mcp.json`.
+ * When `existing` is provided, upsert Pactile-managed servers from
+ * selection, remove managed names not in selection, and preserve foreign keys.
+ */
+export declare function renderMcpJson(selected: readonly ProjectCapabilityId[], existing?: Record<string, McpServerEntry> | null): string;
+export declare function buildProjectCapabilityTemplates(selected: readonly ProjectCapabilityId[], platforms: Iterable<AITool>, states?: Partial<Record<ProjectCapabilityId, StoredCapabilityState>>, options?: {
+    cwd?: string;
+    existingMcpServers?: Record<string, McpServerEntry> | null;
+}): Map<string, string>;
+export declare function writeProjectCapabilityFiles(cwd: string, selected: readonly ProjectCapabilityId[], platforms: Iterable<AITool>): Promise<void>;
+export declare function loadStoredCapabilityStates(cwd: string): Partial<Record<ProjectCapabilityId, StoredCapabilityState>>;
+export declare function loadProjectCapabilities(cwd: string): ProjectCapabilityId[];
+export declare function collectProjectCapabilityTemplates(cwd: string, platforms: Iterable<AITool>): Map<string, string>;
+export declare function updateCapabilityReadinessStatus(cwd: string, capabilityId: ProjectCapabilityId, status: ProjectCapabilityReadinessStatus, detail?: string): void;
+//# sourceMappingURL=project-capabilities.d.ts.map

package/dist/utils/project-capabilities.d.ts.map

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