@blxzer/pactile 0.5.0

package/dist/templates/shared-hooks/spec-write-audit.py

@@ -0,0 +1,173 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Spec Write Audit Hook — machine record of writes to long-term spec knowledge.
+
+Part of the "record mandatory / flow free / verdict by human" trichotomy
+(P41 memory-s3-spec-gate). This hook ONLY records that a write to
+`.pactile/spec/`, `docs/adr/`, or Policy files was initiated. It NEVER blocks
+the write:
+
+- Always prints a preToolUse ``allow`` permission decision.
+- Every failure path is a silent no-op (exit 0) — a recording failure must
+  not block any write.
+
+The preToolUse event fires before the tool executes, so the record describes
+the *initiated* write (actor / when / target file / verification state),
+not the write result. ``verified`` is conservative: with no confirmation
+signal in the hook input it records ``false`` (unverified write, recorded
+not rejected).
+"""
+from __future__ import annotations
+
+import getpass
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+
+if sys.platform.startswith("win"):
+    import io as _io
+
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[union-attr]
+    elif hasattr(sys.stdout, "detach"):
+        sys.stdout = _io.TextIOWrapper(sys.stdout.detach(), encoding="utf-8", errors="replace")  # type: ignore[union-attr]
+
+DIR_WORKFLOW = ".pactile"
+DIR_RUNTIME = ".runtime"
+DIR_HOOKS = "hooks"
+AUDIT_FILE = "spec-write.log"
+
+# Authoritative protected roots, matching `spec-learning` contract wording:
+# ".pactile/spec/", ADR (docs/adr/), Policy. Policy files live under .pactile/spec/
+# (e.g. .pactile/spec/Pactile/...); platform rule files (.cursor/rules/*.mdc) are
+# outside this machine-record scope.
+PROTECTED_REL_PREFIXES = (
+    ".pactile/spec/",
+    "pactile/spec/",
+    "docs/adr/",
+    ".pactile/spec",
+    "docs/adr",
+)
+
+WRITE_TOOLS = frozenset({"write", "edit", "notebookedit", "applydiff", "multiplediff"})
+
+
+def find_repo_root(start_path: str) -> str | None:
+    current = Path(start_path).resolve()
+    while current != current.parent:
+        if (current / DIR_WORKFLOW).is_dir():
+            return str(current)
+        if (current / ".git").exists():
+            return str(current)
+        current = current.parent
+    return None
+
+
+def _safe_payload() -> dict:
+    raw = sys.stdin.read() if not sys.stdin.isatty() else ""
+    if not raw.strip():
+        return {}
+    try:
+        parsed = json.loads(raw)
+    except json.JSONDecodeError:
+        return {}
+    return parsed if isinstance(parsed, dict) else {}
+
+
+def _string_value(value, default: str = "") -> str:
+    if isinstance(value, str):
+        return value.strip()
+    return default
+
+
+def _extract_target_path(hook_input: dict) -> str | None:
+    tool_input = hook_input.get("tool_input")
+    if not isinstance(tool_input, dict):
+        tool_input = {}
+    for key in ("file_path", "filePath", "path", "target_path", "targetPath", "doc_path", "docPath"):
+        value = _string_value(tool_input.get(key))
+        if value:
+            return value
+    return None
+
+
+def _is_protected_target(repo_root: str, raw_path: str) -> bool:
+    target = Path(raw_path)
+    if target.is_absolute():
+        try:
+            relative = target.resolve().relative_to(Path(repo_root).resolve())
+        except ValueError:
+            return False
+        target_rel = str(relative).replace("\\", "/")
+    else:
+        target_rel = raw_path.replace("\\", "/").lstrip("./")
+    return any(target_rel == prefix or target_rel.startswith(prefix.rstrip("/") + "/") for prefix in PROTECTED_REL_PREFIXES)
+
+
+def _actor_for(hook_input: dict) -> str:
+    """Best-effort actor label. OS user is always available; enrich with the
+    session/interaction id when the hook payload carries one."""
+    user = ""
+    try:
+        user = getpass.getuser()
+    except Exception:
+        user = "unknown"
+    for key in ("session_id", "sessionId", "conversation_id", "conversationId", "interaction_id", "interactionId"):
+        if _string_value(hook_input.get(key)):
+            return f"{user}:{_string_value(hook_input.get(key))}"
+    return user
+
+
+def _record(repo_root: str, hook_input: dict, target_path: str) -> None:
+    log_dir = Path(repo_root) / DIR_WORKFLOW / DIR_RUNTIME / DIR_HOOKS
+    log_dir.mkdir(parents=True, exist_ok=True)
+    record = {
+        "event": "spec-write-initiated",
+        "ts": datetime.now(timezone.utc).replace(microsecond=0).isoformat().replace("+00:00", "Z"),
+        "actor": _actor_for(hook_input),
+        "tool": _string_value(hook_input.get("tool_name", hook_input.get("toolName"))).lower() or "unknown",
+        "file": target_path.replace("\\", "/"),
+        # No confirmation signal exists in the preToolUse payload: an
+        # unverified write is *recorded*, never blocked.
+        "verified": False,
+    }
+    with (log_dir / AUDIT_FILE).open("a", encoding="utf-8") as handle:
+        handle.write(json.dumps(record, ensure_ascii=False) + "\n")
+
+
+def main() -> int:
+    try:
+        hook_input = _safe_payload()
+        tool_name = _string_value(
+            hook_input.get("tool_name", hook_input.get("toolName"))
+        ).lower()
+        if tool_name not in WRITE_TOOLS:
+            print(json.dumps({"permission": "allow"}), flush=True)
+            return 0
+
+        target_path = _extract_target_path(hook_input)
+        if not target_path:
+            print(json.dumps({"permission": "allow"}), flush=True)
+            return 0
+
+        repo_root = find_repo_root(_string_value(hook_input.get("cwd"), os.getcwd()))
+        if not repo_root or not _is_protected_target(repo_root, target_path):
+            print(json.dumps({"permission": "allow"}), flush=True)
+            return 0
+
+        # Recording failure must never block the write: swallow and allow.
+        try:
+            _record(repo_root, hook_input, target_path)
+        except Exception:
+            pass
+    except Exception:
+        pass
+    print(json.dumps({"permission": "allow"}), flush=True)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/dist/templates/template-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared utilities for platform template modules.
+ * Eliminates boilerplate across qoder/, codebuddy/, droid/, cursor/, gemini/, kiro/ index.ts files.
+ */
+export interface AgentTemplate {
+    name: string;
+    content: string;
+}
+export interface HookTemplate {
+    targetPath: string;
+    content: string;
+}
+export interface TemplateReader {
+    readTemplate: (relativePath: string) => string;
+    listFiles: (dir: string) => string[];
+    listMdAgents: (dir?: string) => AgentTemplate[];
+    listMdCommands: (dir?: string) => AgentTemplate[];
+    listJsonAgents: (dir?: string) => AgentTemplate[];
+    listMdcRules: (dir?: string) => AgentTemplate[];
+    getSettings: (filename?: string) => HookTemplate;
+    getConfig: (filename: string) => string;
+}
+/**
+ * Create a template reader bound to the caller's directory.
+ * Usage: `const { readTemplate, listMdAgents, getSettings } = createTemplateReader(import.meta.url);`
+ */
+export declare function createTemplateReader(importMetaUrl: string): TemplateReader;
+//# sourceMappingURL=template-utils.d.ts.map

package/dist/templates/template-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-utils.d.ts","sourceRoot":"","sources":["../../src/templates/template-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACrC,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAChD,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAClD,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAClD,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAChD,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,YAAY,CAAC;IACjD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CA8E1E"}

package/dist/templates/template-utils.js

@@ -0,0 +1,83 @@
+/**
+ * Shared utilities for platform template modules.
+ * Eliminates boilerplate across qoder/, codebuddy/, droid/, cursor/, gemini/, kiro/ index.ts files.
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Create a template reader bound to the caller's directory.
+ * Usage: `const { readTemplate, listMdAgents, getSettings } = createTemplateReader(import.meta.url);`
+ */
+export function createTemplateReader(importMetaUrl) {
+    const __dirname = dirname(fileURLToPath(importMetaUrl));
+    function readTemplate(relativePath) {
+        return readFileSync(join(__dirname, relativePath), "utf-8");
+    }
+    function listFiles(dir) {
+        try {
+            return readdirSync(join(__dirname, dir)).sort();
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Read all .md agent files from a subdirectory */
+    function listMdAgents(dir = "agents") {
+        return listFiles(dir)
+            .filter((f) => f.endsWith(".md"))
+            .map((f) => ({
+            name: f.replace(".md", ""),
+            content: readTemplate(`${dir}/${f}`),
+        }));
+    }
+    /** Read all .md command files from a subdirectory (e.g. cursor/commands).
+     * Unlike listMdAgents, the name keeps no prefix transformation — callers
+     * decide the output filename (e.g. `pactile-${name}.md`). */
+    function listMdCommands(dir = "commands") {
+        return listFiles(dir)
+            .filter((f) => f.endsWith(".md"))
+            .map((f) => ({
+            name: f.replace(".md", ""),
+            content: readTemplate(`${dir}/${f}`),
+        }));
+    }
+    /** Read all .json agent files from a subdirectory (Kiro) */
+    function listJsonAgents(dir = "agents") {
+        return listFiles(dir)
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => ({
+            name: f.replace(".json", ""),
+            content: readTemplate(`${dir}/${f}`),
+        }));
+    }
+    /** Read all .mdc rule files from a subdirectory (Cursor .cursor/rules) */
+    function listMdcRules(dir = "rules") {
+        return listFiles(dir)
+            .filter((f) => f.endsWith(".mdc"))
+            .map((f) => ({
+            // Keep the .mdc extension in the name — Cursor requires it.
+            name: f,
+            content: readTemplate(`${dir}/${f}`),
+        }));
+    }
+    /** Read settings.json and return as HookTemplate */
+    function getSettings(filename = "settings.json") {
+        return { targetPath: filename, content: readTemplate(filename) };
+    }
+    /** Read a config file and return raw string */
+    function getConfig(filename) {
+        return readTemplate(filename);
+    }
+    return {
+        readTemplate,
+        listFiles,
+        listMdAgents,
+        listMdCommands,
+        listJsonAgents,
+        listMdcRules,
+        getSettings,
+        getConfig,
+    };
+}
+//# sourceMappingURL=template-utils.js.map

package/dist/templates/template-utils.js.map

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

package/dist/types/ai-tools.d.ts

@@ -0,0 +1,102 @@
+/**
+ * AI Tool Types and Registry
+ *
+ * Defines supported AI coding tools and which command templates they can use.
+ *
+ * The legacy template registry remains Cursor-scoped; the Pactile Adapter
+ * registry owns current Cursor and Codex projection.
+ */
+/**
+ * Supported AI coding tools
+ */
+export type AITool = "cursor";
+/**
+ * Template directory categories
+ */
+export type TemplateDir = "common" | "cursor";
+/**
+ * CLI flag names for platform selection (e.g., --cursor)
+ * Must match keys in InitOptions (src/commands/init.ts)
+ */
+export type CliFlag = "cursor";
+/**
+ * Platform support tier.
+ *
+ * First-class platforms are the actively targeted framework surfaces for this
+ * fork. Retained for structural compatibility; only Cursor is registered.
+ */
+export type PlatformTier = "first-class" | "legacy";
+/**
+ * Template context for placeholder resolution.
+ * Controls how common templates are rendered per platform.
+ */
+export interface TemplateContext {
+    /** Prefix for cross-referencing other commands/skills */
+    cmdRefPrefix: "/pactile:" | "/pactile-" | "$" | "/";
+    /** Description of AI executor actions shown in role tables */
+    executorAI: "Bash scripts or Task calls" | "Bash scripts or tool calls" | "Bash scripts or file reads";
+    /** Label for user-invocable actions */
+    userActionLabel: "Slash commands" | "Skills" | "Workflows" | "Prompts";
+    /** Platform supports spawning sub-agents with isolated context */
+    agentCapable: boolean;
+    /** Platform has hook system (SessionStart, PreToolUse) */
+    hasHooks: boolean;
+    /**
+     * CLI flag value for this platform (e.g. "cursor").
+     * Substituted into template commands via {{CLI_FLAG}} so rendered skill /
+     * command files can pass `--platform <flag>` to scripts that need to know
+     * the invoking platform, removing the need to re-detect at runtime.
+     * Duplicates the top-level `AIToolConfig.cliFlag` for convenience — the
+     * invariant is maintained in `AI_TOOLS` config blocks.
+     */
+    cliFlag: CliFlag;
+}
+/**
+ * Configuration for an AI tool
+ */
+export interface AIToolConfig {
+    /** Display name of the tool */
+    name: string;
+    /** Active support tier for this platform */
+    tier: PlatformTier;
+    /** Command template directory names to include */
+    templateDirs: TemplateDir[];
+    /** Config directory name in the project root (e.g., ".cursor") */
+    configDir: string;
+    /**
+     * Whether the platform supports the shared `.agents/skills/` layer
+     * (agentskills.io open standard). When true, `.agents/skills` is added
+     * to the platform's managed paths automatically.
+     */
+    supportsAgentSkills?: boolean;
+    /** Additional managed paths beyond configDir (e.g., .github/hooks for Copilot) */
+    extraManagedPaths?: string[];
+    /** CLI flag name for --flag options (e.g., "cursor" for --cursor) */
+    cliFlag: CliFlag;
+    /** Whether this tool is checked by default in interactive init prompt */
+    defaultChecked: boolean;
+    /** Whether this tool uses Python hooks (affects Windows encoding detection) */
+    hasPythonHooks: boolean;
+    /** Template context for placeholder resolution in common templates */
+    templateContext: TemplateContext;
+}
+/**
+ * Registry of all supported AI tools and their configurations.
+ * This is the single source of truth for platform data.
+ *
+ * Cursor-only fork: only the Cursor entry is registered.
+ */
+export declare const AI_TOOLS: Record<AITool, AIToolConfig>;
+/**
+ * Get the configuration for a specific AI tool
+ */
+export declare function getToolConfig(tool: AITool): AIToolConfig;
+/**
+ * Get all managed paths for a specific tool.
+ */
+export declare function getManagedPaths(tool: AITool): string[];
+/**
+ * Get template directories for a specific tool
+ */
+export declare function getTemplateDirs(tool: AITool): TemplateDir[];
+//# sourceMappingURL=ai-tools.d.ts.map

package/dist/types/ai-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tools.d.ts","sourceRoot":"","sources":["../../src/types/ai-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,YAAY,EAAE,WAAW,GAAG,WAAW,GAAG,GAAG,GAAG,GAAG,CAAC;IACpD,8DAA8D;IAC9D,UAAU,EACN,4BAA4B,GAC5B,4BAA4B,GAC5B,4BAA4B,CAAC;IACjC,uCAAuC;IACvC,eAAe,EAAE,gBAAgB,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IACvE,kEAAkE;IAClE,YAAY,EAAE,OAAO,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,kDAAkD;IAClD,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAkBjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAUtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAE3D"}

package/dist/types/ai-tools.js

@@ -0,0 +1,60 @@
+/**
+ * AI Tool Types and Registry
+ *
+ * Defines supported AI coding tools and which command templates they can use.
+ *
+ * The legacy template registry remains Cursor-scoped; the Pactile Adapter
+ * registry owns current Cursor and Codex projection.
+ */
+/**
+ * Registry of all supported AI tools and their configurations.
+ * This is the single source of truth for platform data.
+ *
+ * Cursor-only fork: only the Cursor entry is registered.
+ */
+export const AI_TOOLS = {
+    cursor: {
+        name: "Cursor",
+        tier: "first-class",
+        templateDirs: ["common", "cursor"],
+        configDir: ".cursor",
+        cliFlag: "cursor",
+        defaultChecked: true,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/pactile-",
+            executorAI: "Bash scripts or Task calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "cursor",
+        },
+    },
+};
+/**
+ * Get the configuration for a specific AI tool
+ */
+export function getToolConfig(tool) {
+    return AI_TOOLS[tool];
+}
+/**
+ * Get all managed paths for a specific tool.
+ */
+export function getManagedPaths(tool) {
+    const config = AI_TOOLS[tool];
+    const paths = [config.configDir];
+    if (config.supportsAgentSkills) {
+        paths.push(".agents/skills");
+    }
+    if (config.extraManagedPaths) {
+        paths.push(...config.extraManagedPaths);
+    }
+    return paths;
+}
+/**
+ * Get template directories for a specific tool
+ */
+export function getTemplateDirs(tool) {
+    return AI_TOOLS[tool].templateDirs;
+}
+//# sourceMappingURL=ai-tools.js.map

package/dist/types/ai-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tools.js","sourceRoot":"","sources":["../../src/types/ai-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqFH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAiC;IACpD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAClC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,QAAQ;QACjB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE;YACf,YAAY,EAAE,WAAW;YACzB,UAAU,EAAE,4BAA4B;YACxC,eAAe,EAAE,gBAAgB;YACjC,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,QAAQ;SAClB;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC;AACrC,CAAC"}

package/dist/types/migration.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Migration types for the Pactile update command
+ *
+ * These types support intelligent migration during updates,
+ * handling file renames, deletions, and user modification detection.
+ */
+/**
+ * A single migration action (rename, rename-dir, or delete)
+ */
+export interface MigrationItem {
+    /** Type of migration action */
+    type: "rename" | "rename-dir" | "delete" | "safe-file-delete";
+    /** Source path (relative to project root) */
+    from: string;
+    /** Target path for renames (relative to project root) */
+    to?: string;
+    /** Human-readable description of WHAT this migration does */
+    description?: string;
+    /**
+     * Optional context shown in the "confirm" prompt explaining WHY the user is
+     * being asked about this specific file. Use this for version-specific nuance
+     * (e.g. a known hash-tracking gap from a prior CLI version) that would
+     * otherwise have to be hardcoded in update.ts. Keep it short (1-2 sentences).
+     */
+    reason?: string;
+    /** Known template hashes for safe-file-delete (only delete if content matches) */
+    allowed_hashes?: string[];
+}
+/**
+ * A new top-level config.yaml section introduced by this release.
+ *
+ * Used by `pactile update` to append the section to existing user config files
+ * that pre-date the release, without overwriting their other customizations.
+ * Append is gated on `sentinel`: if the user file already contains the sentinel
+ * substring (live or commented), the section is treated as already present.
+ */
+export interface ConfigSectionAdded {
+    /** Target file relative to project root (e.g. `.pactile/config.yaml`). */
+    file: string;
+    /**
+     * Substring whose presence in the user file means this section already
+     * exists. Pick something stable (e.g. the new top-level YAML key like
+     * `codex:`).
+     */
+    sentinel: string;
+    /**
+     * The section heading text that appears on the `# <heading>` line inside the
+     * `#---` separator block in the bundled template. The extractor takes lines
+     * from that separator block until the next `#---` separator (or EOF).
+     */
+    sectionHeading: string;
+}
+/**
+ * Migration manifest for a specific version
+ */
+export interface MigrationManifest {
+    /** Target version this migration upgrades to */
+    version: string;
+    /** Human-readable description of changes in this version */
+    description?: string;
+    /** List of migration actions */
+    migrations: MigrationItem[];
+    /** Detailed changelog for display to users */
+    changelog?: string;
+    /** Whether this version contains breaking changes */
+    breaking?: boolean;
+    /** Whether users should run --migrate (recommended for breaking changes) */
+    recommendMigrate?: boolean;
+    /** Detailed migration guide for AI-assisted fixes (markdown format) */
+    migrationGuide?: string;
+    /** Instructions for AI assistants on how to help with migration */
+    aiInstructions?: string;
+    /**
+     * New top-level config.yaml sections introduced by this release. Applied
+     * additively to existing user files via sentinel-gated append, keeping their
+     * customizations intact while still surfacing newly-introduced knobs.
+     */
+    configSectionsAdded?: ConfigSectionAdded[];
+}
+/**
+ * Classification of how a migration should be handled
+ */
+export type MigrationClassification = "auto" | "confirm" | "conflict" | "skip";
+/**
+ * Classified migration item with its determined action
+ */
+export interface ClassifiedMigrationItem extends MigrationItem {
+    classification: MigrationClassification;
+}
+/**
+ * Result of classifying all migrations
+ */
+export interface ClassifiedMigrations {
+    /** Unmodified files - safe to auto-migrate */
+    auto: MigrationItem[];
+    /** User-modified files - need confirmation */
+    confirm: MigrationItem[];
+    /** Conflict - both old and new exist */
+    conflict: MigrationItem[];
+    /** Skip - old file doesn't exist */
+    skip: MigrationItem[];
+}
+/**
+ * Result of executing migrations
+ */
+export interface MigrationResult {
+    /** Number of files renamed */
+    renamed: number;
+    /** Number of files deleted */
+    deleted: number;
+    /** Number of files skipped (user choice or no action needed) */
+    skipped: number;
+    /** Number of conflicts encountered */
+    conflicts: number;
+}
+/**
+ * User action choice for migration confirmation
+ */
+export type MigrationAction = "rename" | "backup-rename" | "skip" | "view-diff";
+/**
+ * Template hashes storage structure
+ * Maps relative file paths to their SHA256 hashes
+ */
+export type TemplateHashes = Record<string, string>;
+//# sourceMappingURL=migration.d.ts.map

package/dist/types/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,kBAAkB,CAAC;IAC9D,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,SAAS,GACT,UAAU,GACV,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,cAAc,EAAE,uBAAuB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,8CAA8C;IAC9C,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wCAAwC;IACxC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,oCAAoC;IACpC,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,eAAe,GACf,MAAM,GACN,WAAW,CAAC;AAEhB;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/types/migration.js

@@ -0,0 +1,8 @@
+/**
+ * Migration types for the Pactile update command
+ *
+ * These types support intelligent migration during updates,
+ * handling file renames, deletions, and user modification detection.
+ */
+export {};
+//# sourceMappingURL=migration.js.map

package/dist/types/migration.js.map

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

package/dist/utils/agents-md.d.ts

@@ -0,0 +1,27 @@
+export declare const PACTILE_BLOCK_START: "<!-- PACTILE:START -->";
+export declare const PACTILE_BLOCK_END: "<!-- PACTILE:END -->";
+export declare const LEGACY_CSTL_BLOCK_START = "<!-- CSTL:START -->";
+export declare const LEGACY_CSTL_BLOCK_END = "<!-- CSTL:END -->";
+export declare const FOREIGN_TRELLIS_BLOCK_START = "<!-- TRELLIS:START -->";
+export declare const FOREIGN_TRELLIS_BLOCK_END = "<!-- TRELLIS:END -->";
+export interface InsertPactileManagedBlockOptions {
+    /**
+     * Legacy CSTL markers are not ownership proof by themselves. Set this only
+     * after the lifecycle migration plan established Pactile ownership and
+     * retained the preimage.
+     */
+    readonly migrateOwnedLegacyCstl?: boolean;
+}
+/** Ambiguous or duplicate markers are never ownership evidence. */
+export declare function extractBlock(content: string, startMarker: string, endMarker: string): string | null;
+/**
+ * Insert or replace the canonical Pactile block while preserving every byte
+ * outside it. A foreign TRELLIS block is never rewritten. An owned CSTL block
+ * is migrated only when the caller supplies explicit ownership evidence.
+ */
+export declare function insertPactileManagedBlock(existingContent: string, templateContent: string, options?: InsertPactileManagedBlockOptions): string;
+export declare function hasPactileBlock(content: string): boolean;
+export declare function hasLegacyCstlBlock(content: string): boolean;
+export declare function hasForeignTrellisBlock(content: string): boolean;
+export declare function removePactileManagedBlock(content: string): string;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/utils/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/utils/agents-md.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,mBAAmB,0BAAwB,CAAC;AACzD,eAAO,MAAM,iBAAiB,wBAAsB,CAAC;AACrD,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAWhE,MAAM,WAAW,gCAAgC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAMf;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,gCAAqC,GAC7C,MAAM,CA4CR;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGjE"}