@blxzer/pactile 0.5.0

package/dist/migrations/manifests/0.3.6.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.6",
+  "description": "Goal MVP+SDK worker, locale zh/en, pack freshness, observable defaults, continue O1, injection budget",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.3.6**\n\n- feat(goal): `cstl goal` MVP + deterministic reviewer + SDK worker adapter\n- feat(locale): switchable zh/en artifact_locale + SessionStart summary line\n- feat(orchestration): auto publish-pack after integrate; nested child-id fixes\n- feat(observable): verify headers, dashboard verify summary, real jsonl seeds\n- feat(continue): search_memory step (O1)\n- feat(spec-health): S1 outcomes CLI\n- feat(context): opt-in journal snippet (default off)\n- feat(injection / verify / retrieval / modes): budget caps, graded verify guide, prefer native Grep+modes\n- docs(goal): goal-release-regression-runbook",
+  "migrations": [],
+  "notes": "Run `cstl update` to sync hooks/templates (SessionStart Artifact locale line). No `--migrate` required. BYOK short probe still deferred."
+}

package/dist/migrations/manifests/0.4.0.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0",
+  "description": "Review pool + task depends_on Plan A/B, workflow/guides alignment",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.4.0**\n\n- feat(pool): `.cstl/pool/` skeleton + `pool.py` validate/link/plan-check\n- feat(deps): `set-deps` / `set-depends-mode` / `--ignore-deps` (Plan A warn / Plan B block)\n- feat(verify): ship `verify_evidence_probe.py`\n- docs: workflow pool boundary + depends; guides (locale/debug/prototype/test/runbook)\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Run `cstl update` to sync scripts/workflow/pool skeleton. No `--migrate` required. Pool items remain user data."
+}

package/dist/migrations/manifests/0.4.1.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.1",
+  "description": "Approved-surface backfill: cstl-handoff + session boundary, cstl-check dual-axis, grilling frontier, PRD grain, CONTEXT/ADR stub",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.4.1**\n\n- feat(skills): ship `cstl-handoff` bundled skill + Cursor `/cstl-handoff` command\n- feat(workflow): session boundary line; task `handoff.md` ≠ session handoff\n- feat(skills): `cstl-check` dual-axis (Standards/Spec) + Fowler 12 smells asset\n- feat(skills): grilling frontier in brainstorm + micro-grill\n- feat(templates): PRD grain (User Stories / Implementation Decisions) in default-prd en/zh\n- feat(templates): minimal CONTEXT.md stub + docs/adr README\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Run `cstl update` to sync workflow/skills/templates. No `--migrate` required."
+}

package/dist/migrations/manifests/0.4.2.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.2",
+  "description": "Cursor reachability index + framework-owned .cstl/framework/ docs relocation",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.4.2**\n\n- feat(framework): `.cstl/framework/` update-managed docs\n- feat(guides): PRD grill frontier, internal-skills reachability, dogfood-only surfaces\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Backfilled so npm 0.4.2 has a local manifest. Run `cstl update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.4.3.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.3",
+  "description": "Stage 0–7 Kernel writer, Wave C stop-read after confirm, Native Cursor docs",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.4.3**\n\n- feat(kernel): Stage 0–7 Kernel writer, Lite/Full, Topology, Event Bridge\n- feat(p36): Wave C stop-read only after interactive Proceed\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Backfilled so npm 0.4.3 has a local manifest. Run `cstl update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.5.0-beta.0.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.5.0-beta.0",
+  "description": "Modular runtime preview: P29 modules, session pack, pool delivery axis",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.5.0-beta.0**\n\n- feat(modules): ship P29 short contracts into `.cstl/modules/`\n- feat(context): compiled Session pack; SessionStart no longer dumps Phase Index\n- feat(pool): delivery axis + `pool_refs`\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Prerelease. Install `@blxzer/cursor-trellis@0.5.0-beta.0` or `@beta`. Run `cstl update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.5.0-beta.1.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.5.0-beta.1",
+  "description": "P38 parallel declaration Check + P39 Cursor Adapter host nouns out of core contracts",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.5.0-beta.1**\n\n- feat(runtime): Full/Parent must declare parallel_groups or serial_reason; Check helper fails when missing\n- feat(adapter): visible parallel on Execute; Integrate? stays serial integrate-child\n- fix(modules): worker-orchestration / intake-basic drop Cursor host nouns\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Prerelease. Install `@blxzer/cursor-trellis@0.5.0-beta.1` or `@beta`. Run `cstl update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.5.0-beta.2.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.5.0-beta.2",
+  "description": "P40 pool split at Open + default-script init hole. Not @latest — install with @beta or the exact version.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.5.0-beta.2**\n\n- feat(pool): when the user starts implementing an accepted pool item, write `## 切片` on that item and Open isolatable Fulls (or a Parent only if integration authority is required). Check helper `evaluate_pool_slice` fails Full/Parent missing `touches`, unrelated module pairs without `serial_reason` / `oversized_accepted`, and multi-link tasks whose PRD lacks per-item pool obligations. `pool.py validate` does **not** fail when `## 切片` is missing.\n- fix(init): ship `common/artifact_search.py` and `common/injection_budget.py` in the default `getAllScripts()` set. 0.5.0-beta.1 omitted them even though `pool_store` / `pool_refs` / `subagent_dispatch` / `task_context` import them at top level.\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Prerelease. Install `@blxzer/cursor-trellis@0.5.0-beta.2` or `@beta`. Run `cstl update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.5.0-beta.3.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.5.0-beta.3",
+  "description": "P41 memory cut: notes_projection slot + spec-write audit + Lite archive relaxation. Not @latest — install with @beta or the exact version.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.5.0-beta.3**\n\n- feat(memory): `kernel.json` extras gains `notes_projection` — at archive, `cmd_archive` summarizes reusable points from `ac_evidence_ledger` / `independent_check` / `verify.md` (<=150 tokens via `session_memory`) plus artifact pointers. Notes track of the 双轨记忆 (Notes + History) design: machine-recorded at Close, searchable later, never full-text injected.\n- feat(memory): `spec-write-audit.py` preToolUse hook records spec writes — for `.cstl/spec/`, `docs/adr/`, or Policy targets it logs actor / timestamp / target / verification state to `.cstl/.runtime/hooks/spec-write.log`. Only records, always allows (never blocks a write). `spec-learning` contract updated; Event Bridge subscription registered; shipped in `shared-hooks`.\n- feat(contracts): `personal-memory` gains a Close Notes index-projection clause (<=N-token summary + path pointer, `context-progressive` layer-4 retrieval, not resident); `close-basic` disposition gains `note-projection` (missing slot only leaves a trace, never blocks Close).\n- fix(templates): `_resolve_seed_spec_paths` scans `.cstl/spec/guides/` for real guide files; `start-execution --ignore-deps` writes refs into `dependency_satisfied` so Kernel start allows the override; `spec-write-audit` moved to second in `preToolUse` so `Task|Subagent` stays first; Lite tasks no longer require a substantive `durable-learning` decision (explicit N/A or missing line archives cleanly).\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Prerelease. Install `@blxzer/cursor-trellis@0.5.0-beta.3` or `@beta`. Run `cstl update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.5.0-beta.4.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.5.0-beta.4",
+  "description": "Version bump only (rebuild of the beta-3 publish). No functional changes vs 0.5.0-beta.3. Not @latest — install with @beta or the exact version.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.5.0-beta.4**\n\n- chore: version bump / republish of 0.5.0-beta.3 (P41 memory-cut). Empty migrations list (template sync via `cstl update`).",
+  "migrations": [],
+  "notes": "Prerelease. Install `@blxzer/cursor-trellis@0.5.0-beta.4` or `@beta`. Run `cstl update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.5.0-beta.5.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.5.0-beta.5",
+  "description": "P42/P43 Freestyle product mirrors + P44 E2E guide init registry. Not @latest — install with @beta or the exact version.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.5.0-beta.5**\n\n- feat(templates): product workflow.md is the interface card (no Request Triage / [Triage: / MANDATORY TRIAGE); pointer AGENTS.md; thin cstl-implement / cstl-check / cstl-research agents; grill frontier optional-brick + AC 歧义面=0; test-discipline testing brick; E2E walkthrough guide template asset.\n- feat(memory): product task_gates.py template writes notes_projection.points[] with source / confidence.\n- feat(docs): framework injection / budget / reachability guides (and .md.txt mirrors) no longer describe Request Triage as a live hard gate; prohibition sentences stay.\n- feat(init): cstl init installs .cstl/spec/guides/e2e-walkthrough-guide.md next to test-discipline (init-only seed; cstl update still does not overwrite user spec/guides).\n- chore: empty migrations list (template sync via `cstl update`)",
+  "migrations": [],
+  "notes": "Prerelease. Install `@blxzer/cursor-trellis@0.5.0-beta.5` or `@beta`. Run `cstl update`. Existing spec/guides stay user-owned. No `--migrate` required."
+}

package/dist/pactile/adapters/codex/index.d.ts

@@ -0,0 +1,75 @@
+import { type ProjectionInputs } from "../../projection/planner.js";
+import type { TomlOwnedKey } from "../../projection/structured-merge.js";
+/** Codex project leaves; the ChatGPT desktop App is the only supported host. */
+export declare const CODEX_PROJECTION_CAPABILITIES: readonly ["project-config", "hooks", "mcp"];
+export type CodexProjectionCapability = (typeof CODEX_PROJECTION_CAPABILITIES)[number];
+export declare const CODEX_PROBE_CHANNELS: readonly ["app"];
+export type CodexProbeChannel = (typeof CODEX_PROBE_CHANNELS)[number];
+export type CodexProbeReadiness = "ready" | "degraded" | "unavailable";
+export interface CodexProjectConfigDescriptor {
+    /** A caller-validated project fragment; no Pactile pseudo-table is added. */
+    readonly content: string;
+    readonly ownedTomlKeys: readonly TomlOwnedKey[];
+}
+export interface CodexProjectHooksDescriptor {
+    /** A caller-validated official Codex hook fragment; no event is invented. */
+    readonly content: string;
+    readonly ownedJsonPointers: readonly string[];
+}
+export interface CodexNativeBindings {
+    /** Native plugin/provider ids; registration bodies remain host-owned. */
+    readonly mcp?: readonly string[];
+    /** Native hook/plugin registration ids when no project fragment is needed. */
+    readonly hooks?: readonly string[];
+}
+export interface CodexProjectionRequest {
+    readonly shared: ProjectionInputs;
+    readonly appReadiness: CodexProbeReadiness;
+    readonly supportsProjectConfig?: boolean;
+    readonly supportsHooks?: boolean;
+    readonly composition?: readonly CodexProjectionCapability[];
+    /** Compatibility spelling for callers that call the selection a leaf set. */
+    readonly selectedCapabilities?: readonly CodexProjectionCapability[];
+    readonly action?: "attach" | "detach";
+    readonly providerIds?: readonly string[];
+    readonly nativeBindings?: CodexNativeBindings;
+    readonly projectConfig?: CodexProjectConfigDescriptor;
+    readonly projectHooks?: CodexProjectHooksDescriptor;
+    readonly surfaces?: readonly {
+        readonly targetPath: string;
+        readonly content: string | null;
+    }[];
+}
+export interface CodexProbeHint {
+    readonly channel: "app";
+    readonly readiness: CodexProbeReadiness;
+    readonly code: "available" | "install-or-auth-required" | "host-degraded";
+}
+export type CodexProjectionResult = {
+    readonly status: "ready";
+    readonly inputs: ProjectionInputs;
+    readonly probeHints: readonly [CodexProbeHint];
+    readonly diagnostics: readonly [];
+} | {
+    readonly status: "degraded";
+    readonly inputs: ProjectionInputs;
+    readonly probeHints: readonly [CodexProbeHint];
+    readonly diagnostics: readonly {
+        readonly code: "native-binding-required" | "app-unavailable" | "detach-requires-native-owner";
+        readonly capability: CodexProjectionCapability | "app";
+    }[];
+} | {
+    readonly status: "unsupported" | "review";
+    readonly diagnostics: readonly {
+        readonly code: "unsupported-capability" | "invalid-input";
+        readonly capability: CodexProjectionCapability | "adapter";
+    }[];
+};
+/**
+ * Build a Codex ChatGPT desktop App project transaction. Shared Skills and
+ * AGENTS are always the first layer. Project config/hooks are conditional,
+ * and only explicit caller descriptors are projected; provider/plugin state
+ * is represented as a borrowed native binding rather than copied TOML/JSON.
+ */
+export declare function buildCodexProjectionPlan(request: CodexProjectionRequest): CodexProjectionResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/pactile/adapters/codex/index.d.ts.map

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

package/dist/pactile/adapters/codex/index.js

@@ -0,0 +1,269 @@
+import { parseProjectionPlanV1, } from "@blxzer/pactile-core";
+import { fingerprintBytes, } from "../../projection/planner.js";
+/** Codex project leaves; the ChatGPT desktop App is the only supported host. */
+export const CODEX_PROJECTION_CAPABILITIES = [
+    "project-config",
+    "hooks",
+    "mcp",
+];
+export const CODEX_PROBE_CHANNELS = ["app"];
+const encoder = new TextEncoder();
+const logicalId = /^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$/;
+const safeRelativePath = (value) => value.length > 0 &&
+    value.length <= 256 &&
+    !value.includes("\\") &&
+    !value.startsWith("/") &&
+    !value.split("/").includes("..") &&
+    ![...value].some((character) => character.charCodeAt(0) < 32);
+const unsafeDescriptor = /(?:\[\s*pactile\s*\]|provider[_-]?ids|(?:api[_-]?)?key|token|secret|password|oauth|bearer|BEGIN\s+(?:RSA\s+)?PRIVATE|(?:[A-Za-z]:[\\/]|\/(?:Users|home|private|var)\/))/iu;
+const tomlPart = /^[A-Za-z0-9_-]+$/u;
+const jsonPointer = /^\/(?:[^~]|~[01])*$/u;
+function diagnostic(status, code, capability) {
+    return { status, diagnostics: [{ code, capability }] };
+}
+function inferAction(shared) {
+    const actions = new Set(shared.operations.map((operation) => operation.action === "remove" || operation.action === "detach"
+        ? "detach"
+        : "attach"));
+    return actions.size === 1 ? [...actions][0] : "mixed";
+}
+function selectedCapabilities(request) {
+    const selected = request.composition ?? request.selectedCapabilities ?? [];
+    if (!Array.isArray(selected) ||
+        selected.length > CODEX_PROJECTION_CAPABILITIES.length)
+        return null;
+    const result = [...selected];
+    if (new Set(result).size !== result.length ||
+        result.some((value) => !CODEX_PROJECTION_CAPABILITIES.includes(value)))
+        return null;
+    return result.sort();
+}
+function validateIds(values) {
+    return (values.length <= 1024 &&
+        new Set(values).size === values.length &&
+        values.every((value) => logicalId.test(value)));
+}
+function validateTomlKeys(values) {
+    if (!Array.isArray(values) || values.length === 0 || values.length > 1024)
+        return false;
+    const identities = new Set();
+    for (const value of values) {
+        if (typeof value !== "object" ||
+            value === null ||
+            !Array.isArray(value.table) ||
+            value.table.length > 32 ||
+            typeof value.key !== "string" ||
+            !tomlPart.test(value.key) ||
+            value.table.some((part) => typeof part !== "string" || !tomlPart.test(part)))
+            return false;
+        const identity = JSON.stringify([value.table, value.key]);
+        if (identities.has(identity))
+            return false;
+        identities.add(identity);
+    }
+    return true;
+}
+function validateJsonPointers(values) {
+    return (Array.isArray(values) &&
+        values.length > 0 &&
+        values.length <= 1024 &&
+        new Set(values).size === values.length &&
+        values.every((value) => typeof value === "string" && jsonPointer.test(value)));
+}
+function hint(readiness) {
+    return {
+        channel: "app",
+        readiness,
+        code: readiness === "ready"
+            ? "available"
+            : readiness === "unavailable"
+                ? "install-or-auth-required"
+                : "host-degraded",
+    };
+}
+/**
+ * Build a Codex ChatGPT desktop App project transaction. Shared Skills and
+ * AGENTS are always the first layer. Project config/hooks are conditional,
+ * and only explicit caller descriptors are projected; provider/plugin state
+ * is represented as a borrowed native binding rather than copied TOML/JSON.
+ */
+export function buildCodexProjectionPlan(request) {
+    try {
+        const parsedShared = parseProjectionPlanV1(request.shared.plan);
+        if (!parsedShared.success ||
+            parsedShared.data.adapterId !== "adapter.codex" ||
+            !["ready", "degraded", "unavailable"].includes(request.appReadiness))
+            return diagnostic("review", "invalid-input", "adapter");
+        const selected = selectedCapabilities(request);
+        if (!selected)
+            return diagnostic("review", "invalid-input", "adapter");
+        const inferred = inferAction(parsedShared.data);
+        if (inferred === "mixed")
+            return diagnostic("review", "invalid-input", "adapter");
+        if (request.action !== undefined && request.action !== inferred)
+            return diagnostic("review", "invalid-input", "adapter");
+        const action = request.action ?? inferred;
+        if (action !== "attach" && action !== "detach")
+            return diagnostic("review", "invalid-input", "adapter");
+        if (selected.includes("project-config") &&
+            request.supportsProjectConfig !== true)
+            return diagnostic("unsupported", "unsupported-capability", "project-config");
+        if (selected.includes("hooks") && request.supportsHooks !== true)
+            return diagnostic("unsupported", "unsupported-capability", "hooks");
+        const providerIds = [...(request.providerIds ?? [])];
+        const nativeMcp = [...(request.nativeBindings?.mcp ?? [])];
+        const nativeHooks = [...(request.nativeBindings?.hooks ?? [])];
+        if (!validateIds(providerIds) ||
+            !validateIds(nativeMcp) ||
+            !validateIds(nativeHooks) ||
+            (providerIds.length > 0 && !selected.includes("mcp")))
+            return diagnostic("review", "invalid-input", "adapter");
+        const mcpBindings = providerIds.length > 0 ? providerIds : nativeMcp;
+        const missingNative = [];
+        if (selected.includes("project-config") &&
+            action === "attach" &&
+            !request.projectConfig)
+            missingNative.push("project-config");
+        if (selected.includes("hooks") &&
+            action === "attach" &&
+            !request.projectHooks &&
+            nativeHooks.length === 0)
+            missingNative.push("hooks");
+        if (selected.includes("mcp") && mcpBindings.length === 0)
+            missingNative.push("mcp");
+        if (request.projectConfig &&
+            (typeof request.projectConfig.content !== "string" ||
+                request.projectConfig.content.length > 16 * 1024 * 1024 ||
+                unsafeDescriptor.test(request.projectConfig.content) ||
+                !validateTomlKeys(request.projectConfig.ownedTomlKeys)))
+            return diagnostic("review", "invalid-input", "project-config");
+        if (request.projectHooks &&
+            (typeof request.projectHooks.content !== "string" ||
+                request.projectHooks.content.length > 16 * 1024 * 1024 ||
+                unsafeDescriptor.test(request.projectHooks.content) ||
+                !validateJsonPointers(request.projectHooks.ownedJsonPointers)))
+            return diagnostic("review", "invalid-input", "hooks");
+        const surfaces = new Map();
+        for (const surface of request.surfaces ?? []) {
+            if (typeof surface.targetPath !== "string" ||
+                !safeRelativePath(surface.targetPath) ||
+                surfaces.has(surface.targetPath) ||
+                (surface.content !== null &&
+                    (typeof surface.content !== "string" ||
+                        surface.content.length > 16 * 1024 * 1024)))
+                return diagnostic("review", "invalid-input", "adapter");
+            surfaces.set(surface.targetPath, surface.content === null ? null : encoder.encode(surface.content));
+        }
+        const content = new Map();
+        const operations = [
+            ...parsedShared.data.operations,
+        ];
+        const observe = (targetPath) => surfaces.has(targetPath)
+            ? (surfaces.get(targetPath) ?? null)
+            : request.shared.observe(targetPath);
+        const addDescriptor = (name, targetPath, format, descriptor) => {
+            const bytes = encoder.encode(descriptor.content);
+            const contentRef = `codex.${name}.${fingerprintBytes(bytes).slice(7)}`;
+            content.set(contentRef, {
+                bytes,
+                ...(name === "config"
+                    ? { ownedTomlKeys: descriptor.ownedTomlKeys }
+                    : {
+                        ownedJsonPointers: descriptor
+                            .ownedJsonPointers,
+                    }),
+            });
+            const current = observe(targetPath);
+            operations.push({
+                id: `codex.${name}`,
+                resourceId: `codex.${name}`,
+                claimantId: "adapter.codex",
+                action: action === "attach" ? "merge" : "remove",
+                control: "pactile-owned",
+                targetPath,
+                format,
+                contentRef: action === "attach" ? contentRef : null,
+                desiredFingerprint: action === "attach" ? fingerprintBytes(bytes) : null,
+                expectedCurrentFingerprint: current === null ? null : fingerprintBytes(current),
+                externalAssetId: null,
+            });
+        };
+        if (missingNative.length === 0 && action === "attach") {
+            if (selected.includes("project-config") && request.projectConfig)
+                addDescriptor("config", ".codex/config.toml", "toml", request.projectConfig);
+            if (selected.includes("hooks") && request.projectHooks)
+                addDescriptor("hooks", ".codex/hooks.json", "json", request.projectHooks);
+        }
+        if (action === "detach" && selected.includes("project-config")) {
+            // There is no safe keyed-delete operation in the M1 ABI. A native
+            // plugin/host owner must perform its own unregister, so do not emit a
+            // destructive whole-file remove for a potentially mixed user file.
+            missingNative.push("project-config");
+        }
+        if (action === "detach" &&
+            selected.includes("hooks") &&
+            (request.projectHooks !== undefined || nativeHooks.length === 0))
+            missingNative.push("hooks");
+        const addBinding = (kind, externalAssetId) => {
+            operations.push({
+                id: `codex.${kind}.${externalAssetId}.${action}`,
+                resourceId: `codex.native.${kind}.${externalAssetId}`,
+                claimantId: "adapter.codex",
+                action: action === "attach" ? "bind" : "detach",
+                control: "borrowed",
+                targetPath: null,
+                format: "external-ref",
+                contentRef: null,
+                desiredFingerprint: null,
+                expectedCurrentFingerprint: null,
+                externalAssetId,
+            });
+        };
+        if (missingNative.length === 0) {
+            if (selected.includes("hooks"))
+                for (const id of nativeHooks)
+                    addBinding("hooks", id);
+            if (selected.includes("mcp"))
+                for (const id of mcpBindings)
+                    addBinding("mcp", id);
+        }
+        const plan = {
+            ...parsedShared.data,
+            id: `codex.${parsedShared.data.generationId}`,
+            operations,
+        };
+        const inputs = {
+            ...request.shared,
+            plan,
+            observe,
+            resolveContent: (contentRef) => content.get(contentRef) ?? request.shared.resolveContent(contentRef),
+        };
+        const probeHint = hint(request.appReadiness);
+        const diagnostics = missingNative.map((capability) => ({
+            code: action === "detach" &&
+                (capability === "project-config" || capability === "hooks")
+                ? "detach-requires-native-owner"
+                : "native-binding-required",
+            capability,
+        }));
+        if (request.appReadiness !== "ready")
+            diagnostics.push({ code: "app-unavailable", capability: "app" });
+        if (diagnostics.length > 0)
+            return {
+                status: "degraded",
+                inputs,
+                probeHints: [probeHint],
+                diagnostics,
+            };
+        return {
+            status: "ready",
+            inputs,
+            probeHints: [probeHint],
+            diagnostics: [],
+        };
+    }
+    catch {
+        return diagnostic("review", "invalid-input", "adapter");
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/pactile/adapters/codex/index.js.map

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

package/dist/pactile/adapters/cursor/index.d.ts

@@ -0,0 +1,60 @@
+import { type ProjectionInputs } from "../../projection/planner.js";
+/**
+ * Cursor leaves are optional. The shared `.agents/skills` projection is the
+ * default integration surface; these names describe only a deliberately
+ * selected Cursor-native overlay.
+ */
+export declare const CURSOR_PROJECTION_CAPABILITIES: readonly ["commands", "rules", "agents", "hooks", "mcp"];
+export type CursorProjectionCapability = (typeof CURSOR_PROJECTION_CAPABILITIES)[number];
+export interface CursorNativeBindings {
+    /** Existing/native hook registration identifiers. Bodies are never copied. */
+    readonly hooks?: readonly string[];
+    /** Existing/native provider or plugin registration identifiers. */
+    readonly mcp?: readonly string[];
+}
+export interface CursorProjectionRequest {
+    readonly shared: ProjectionInputs;
+    /** Public host facts. Only selected capabilities are required to be true. */
+    readonly hostCapabilities: Readonly<Partial<Record<CursorProjectionCapability, boolean>>>;
+    /** Minimal native overlay selected by the composition compiler. */
+    readonly composition?: readonly CursorProjectionCapability[];
+    /** Compatibility spelling for callers that call the selection a leaf set. */
+    readonly selectedCapabilities?: readonly CursorProjectionCapability[];
+    /** Defaults to the action represented by the shared plan. */
+    readonly action?: "attach" | "detach";
+    /** Logical provider ids to bind through the host-native provider surface. */
+    readonly providerIds?: readonly string[];
+    readonly nativeBindings?: CursorNativeBindings;
+    /** Explicit current-file observations; absent paths are observed via shared. */
+    readonly surfaces?: readonly {
+        readonly targetPath: string;
+        readonly content: string | null;
+    }[];
+}
+export type CursorProjectionResult = {
+    readonly status: "ready";
+    readonly inputs: ProjectionInputs;
+    readonly diagnostics: readonly [];
+} | {
+    readonly status: "degraded";
+    /** A degraded result still contains the safe shared-only transaction. */
+    readonly inputs: ProjectionInputs;
+    readonly diagnostics: readonly {
+        readonly code: "native-binding-required";
+        readonly capability: "hooks" | "mcp";
+    }[];
+} | {
+    readonly status: "unsupported" | "review";
+    readonly diagnostics: readonly {
+        readonly code: "unsupported-capability" | "invalid-input";
+        readonly capability: CursorProjectionCapability | "adapter";
+    }[];
+};
+/**
+ * Build one Cursor transaction from a shared projection plus the explicitly
+ * selected native leaves. Hooks and MCP are host-native bindings: Pactile
+ * does not invent commands, copy registration files, or merge foreign native
+ * configuration. The ProjectionStore remains the only writer.
+ */
+export declare function buildCursorProjectionPlan(request: CursorProjectionRequest): CursorProjectionResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/pactile/adapters/cursor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/pactile/adapters/cursor/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,0DAMjC,CAAC;AACX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CACjC,OAAO,CAAC,MAAM,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC,CACrD,CAAC;IACF,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC7D,6EAA6E;IAC7E,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACtE,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAC/C,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,EAAE,CAAC;CACL;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS;QAC7B,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;QACzC,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,CAAC;KACtC,EAAE,CAAC;CACL,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS;QAC7B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,eAAe,CAAC;QAC1D,QAAQ,CAAC,UAAU,EAAE,0BAA0B,GAAG,SAAS,CAAC;KAC7D,EAAE,CAAC;CACL,CAAC;AA2DN;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CA0KxB"}