@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/pactile/task/session-pack.js

@@ -0,0 +1,139 @@
+import fs from "node:fs";
+import path from "node:path";
+import { readKernel } from "../../core/task/index.js";
+import { resolveSelectedTask, resolveTaskDir } from "./session.js";
+const BASELINE = ["intake-basic", "define-basic", "approval-personal", "execute-agent", "verify-basic", "close-basic", "context-progressive", "observability-local"];
+const NEVER_LAYER2 = new Set(["context-progressive", "observability-local", "debug-recovery", "retention-storage", "retrieval-extended", "personal-memory"]);
+const LITE_BLOCKED = new Set(["parent-child", "vcs-integration", "personal-memory", "retention-storage", "retrieval-extended", "worker-orchestration"]);
+const PHASE_BASELINE = { open: [], define: ["define-basic"], approve: ["approval-personal"], execute: ["execute-agent"], verify: ["verify-basic"], integrate: [], close: ["close-basic"] };
+const ONDEMAND_PHASE = {
+    "define-extended": ["define"], "independent-check": ["verify"], "worker-orchestration": ["execute"],
+    "parent-child": ["define", "execute", "integrate", "verify"], "spec-learning": ["close"], "vcs-integration": ["close"],
+};
+const PHASE_ARTIFACTS = {
+    open: [], define: [["prd.md", "definition"]], approve: [["prd.md", "definition"]], execute: [["prd.md", "definition"]],
+    verify: [["prd.md", "definition"], ["verify.md", "evidence"]],
+    integrate: [["prd.md", "definition"], ["handoff.md", "integration-handoff"]], close: [["verify.md", "evidence"]],
+};
+const HUMAN = { open: "Open", define: "Define", approve: "Approve", execute: "Execute", verify: "Verify", integrate: "Integrate", close: "Close" };
+const NEXT = {
+    open: "Task exists. Move into Define: measurable Acceptance Criteria before Execute.",
+    define: "Finish Definition + measurable AC. Do not implement; do not `--approved`.",
+    approve: "Request the Execute gate. `--check` PASS is a preflight, not human approval.",
+    execute: "Implement inside the approved contract. Contract change → Return-to-Define.",
+    verify: "Map every AC to locatable evidence. Placeholder or fake-green cannot Close.",
+    integrate: "Parent integrates children. Child must not `integrate-child`.",
+    close: "Write Outcome + learning disposition. Git commit is not Close.",
+};
+const estimatedTokens = (text) => Math.max(40, Math.floor(text.length / 4) + 20);
+function readJson(file) {
+    try {
+        const data = JSON.parse(fs.readFileSync(file, "utf8"));
+        return data && typeof data === "object" && !Array.isArray(data) ? data : {};
+    }
+    catch {
+        return {};
+    }
+}
+function activeModules(extras, key, fallback = []) {
+    const block = extras[key];
+    if (!block || typeof block !== "object")
+        return fallback;
+    const active = block.active;
+    return Array.isArray(active) ? active.filter((item) => typeof item === "string") : fallback;
+}
+/** Five-layer session context; no workflow dump or unactivated contract bodies. */
+export function compileSessionPack(root, factGap = false) {
+    const selection = resolveSelectedTask(root);
+    const selected = Boolean(selection.taskPath);
+    const stale = selection.stale;
+    const dir = selection.taskPath && !stale ? resolveTaskDir(root, selection.taskPath) : null;
+    const snapshot = dir ? readKernel({ taskDir: dir, cwd: root }).kernel : null;
+    const phase = snapshot?.phase ?? "open";
+    const condition = snapshot?.condition ?? "ready";
+    const outcome = snapshot?.outcome ?? null;
+    const extras = snapshot?.projection?.extras ?? {};
+    const baselineActive = activeModules(extras, "baseline_modules", BASELINE).filter((id) => BASELINE.includes(id));
+    const ondemandActive = activeModules(extras, "ondemand_modules");
+    const rigor = (extras.required_controls?.rigor === "full") ? "full" : "lite";
+    const topologyKind = (extras.topology?.kind === "parent-child") ? "parent-child" : "single";
+    const layer2Ids = [];
+    if (!selected) {
+        if (baselineActive.includes("intake-basic"))
+            layer2Ids.push("intake-basic");
+    }
+    else {
+        for (const id of PHASE_BASELINE[phase])
+            if (baselineActive.includes(id))
+                layer2Ids.push(id);
+        for (const id of ondemandActive) {
+            if (NEVER_LAYER2.has(id) || !ONDEMAND_PHASE[id]?.includes(phase))
+                continue;
+            if (rigor === "lite" && topologyKind === "single" && LITE_BLOCKED.has(id))
+                continue;
+            if (!layer2Ids.includes(id))
+                layer2Ids.push(id);
+        }
+    }
+    const catalog = readJson(path.join(root, ".pactile", "modules", "index.json"));
+    const modules = Array.isArray(catalog.modules) ? catalog.modules : [];
+    const candidates = [];
+    for (const id of layer2Ids) {
+        const entry = modules.find((item) => item.id === id);
+        const relative = typeof entry?.contract === "string" ? entry.contract : `${id}/contract.md`;
+        const file = path.resolve(root, ".pactile", "modules", relative);
+        const modulesRoot = path.resolve(root, ".pactile", "modules");
+        if (!file.startsWith(`${modulesRoot}${path.sep}`) || !fs.existsSync(file))
+            continue;
+        const text = fs.readFileSync(file, "utf8").slice(0, 2200).trim();
+        if (text)
+            candidates.push({ id, kind: "contract", text, estimatedTokens: estimatedTokens(text) });
+    }
+    if (dir)
+        for (const [name, role] of PHASE_ARTIFACTS[phase]) {
+            const file = path.join(dir, name);
+            if (!fs.existsSync(file))
+                continue;
+            const text = fs.readFileSync(file, "utf8").slice(0, 1200).trim();
+            if (!text)
+                continue;
+            candidates.push({ id: name, kind: "artifact", path: path.relative(root, file).replaceAll("\\", "/"), role, text, freshness: fs.statSync(file).mtime.toISOString().replace(/\.\d{3}Z$/, "Z"), estimatedTokens: estimatedTokens(text) });
+        }
+    const kept = [];
+    const omitted = [];
+    let tokens = 0;
+    for (const item of candidates) {
+        if (kept.length >= 8 || tokens + item.estimatedTokens > 4000)
+            omitted.push({ id: item.id, reason: "outside session pack budget" });
+        else {
+            kept.push(item);
+            tokens += item.estimatedTokens;
+        }
+    }
+    const contracts = kept.filter((item) => item.kind === "contract");
+    const artifacts = kept.filter((item) => item.kind === "artifact");
+    const stuck = stale || condition === "blocked";
+    const next = stale ? "Clear the stale selection with `pactile task exit`, then ask what to work on next." : !selected ? "Intake: answer directly, clarify whether there is work, or draft an Open Proposal. Do not create a task without Open approval." : stuck ? "Stop. Classify the stall before retrying the same hypothesis." : NEXT[phase];
+    const constraints = ["Do not treat `.pactile/workflow.md` or AGENTS longform as runtime SSOT.", "Modules absent from this pack are not installed.", `Rigor=${rigor}; topology=${topologyKind}.`, selected ? "Stay inside the selected task contract." : "No selected task: no task-directory dump; no Parent/Worker/VCS teaching."];
+    if (condition === "blocked")
+        constraints.push("Condition=blocked: do not silently retry.");
+    const layer1 = [`Phase: ${HUMAN[phase]} (${phase})`, `Condition: ${condition}`, `Outcome: ${outcome ?? "(none)"}`, "Constraints:", ...constraints, `Next: ${next}`].join("\n");
+    const layer4 = factGap ? "Fact gap: route with intents exact / semantic / structural / external. Do not bind Agent tool names. Ranking and retrieval-pack stay with `retrieval-extended`." : "";
+    const layer5 = stuck ? "Deep diagnosis pointer only (not a layer-2 contract): `debug-recovery`. Stop homogeneous retries. Classify implementation / contract / environment / platform / process-loop. First failure is not break-loop." : "";
+    return {
+        version: 1, source: "context-progressive",
+        activationSource: { kind: "profile-runtime", filter: "phase-intersect-active", baselineActive, ondemandActive, note: "Layer 2 is phase-needed intersect still-active. Unactivated modules are not installed." },
+        kernel: { phase, condition, outcome, humanPhase: HUMAN[phase], selected }, rigor, topologyKind,
+        layers: [
+            { n: 1, name: "resident-min", text: layer1 },
+            { n: 2, name: "activated-contracts", moduleIds: contracts.map((item) => item.id), text: contracts.map((item) => `### \`${item.id}\`\n${item.text}`).join("\n\n") },
+            { n: 3, name: "artifact-snippets", items: artifacts.map((item) => ({ path: item.path, role: item.role, freshness: item.freshness, excerpt: item.text })), text: artifacts.map((item) => `${item.path}\n${item.text}`).join("\n\n") },
+            { n: 4, name: "retrieval-pointer", present: factGap, intents: factGap ? ["exact", "semantic", "structural", "external"] : [], text: layer4 },
+            { n: 5, name: "deep-diagnosis", present: stuck, moduleIds: stuck ? ["debug-recovery"] : [], text: layer5 },
+        ],
+        budget: { maxItems: 8, maxEstimatedTokens: 4000, estimatedTokens: tokens, itemsUsed: kept.length },
+        omitted, illegalInputsRejected: ["workflow.md", "AGENTS.md", "[workflow-state:*]", "unactivated-module-bodies"],
+        catalogSize: modules.length, retrievalIntents: ["exact", "semantic", "structural", "external"],
+    };
+}
+//# sourceMappingURL=session-pack.js.map

package/dist/pactile/task/session-pack.js.map

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

package/dist/pactile/task/session.d.ts

@@ -0,0 +1,13 @@
+export interface SelectedTask {
+    taskPath: string | null;
+    source: string;
+    contextKey: string | null;
+    stale: boolean;
+}
+/** A shell without a stable session key never inherits another task's selection. */
+export declare function resolveContextKey(env?: NodeJS.ProcessEnv): string | null;
+export declare function resolveTaskDir(root: string, taskRef: string): string;
+export declare function resolveSelectedTask(root: string, env?: NodeJS.ProcessEnv): SelectedTask;
+export declare function selectTask(root: string, taskRef: string, env?: NodeJS.ProcessEnv): SelectedTask;
+export declare function exitTask(root: string, env?: NodeJS.ProcessEnv): SelectedTask;
+//# sourceMappingURL=session.d.ts.map

package/dist/pactile/task/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/pactile/task/session.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAOD,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAGrF;AAiBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA8BpE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAapG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAoB5G;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAMzF"}

package/dist/pactile/task/session.js

@@ -0,0 +1,105 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+function safeContextKey(raw) {
+    const value = raw.trim().replace(/[^A-Za-z0-9._-]+/g, "_").replace(/^[._-]+|[._-]+$/g, "").slice(0, 160);
+    return value || createHash("sha256").update(raw).digest("hex").slice(0, 24);
+}
+/** A shell without a stable session key never inherits another task's selection. */
+export function resolveContextKey(env = process.env) {
+    const value = env.PACTILE_CONTEXT_ID?.trim();
+    return value ? safeContextKey(value) : null;
+}
+function contextFile(root, key) {
+    return path.join(root, ".pactile", ".runtime", "sessions", `${key}.json`);
+}
+function readContext(file) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+        return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function resolveTaskDir(root, taskRef) {
+    const normalized = taskRef.trim().replaceAll("\\", "/").replace(/^\.\//, "");
+    const tasks = path.resolve(root, ".pactile", "tasks");
+    const insideTasks = (candidate) => {
+        const resolved = path.resolve(candidate);
+        const relative = path.relative(tasks, resolved);
+        if (!relative || relative.startsWith("..") || path.isAbsolute(relative) || relative.split(path.sep).includes("archive")) {
+            throw new Error(`Task reference must name an active task under .pactile/tasks: ${taskRef}`);
+        }
+        if (fs.existsSync(resolved) && fs.existsSync(tasks)) {
+            const realRoot = fs.realpathSync(tasks);
+            const realTask = fs.realpathSync(resolved);
+            const realRelative = path.relative(realRoot, realTask);
+            if (!realRelative || realRelative.startsWith("..") || path.isAbsolute(realRelative)) {
+                throw new Error(`Task reference resolves outside .pactile/tasks: ${taskRef}`);
+            }
+        }
+        return resolved;
+    };
+    if (path.isAbsolute(taskRef))
+        return insideTasks(taskRef);
+    if (normalized.includes("/") || normalized.startsWith(".pactile")) {
+        return insideTasks(path.resolve(root, normalized));
+    }
+    if (fs.existsSync(path.join(tasks, normalized)))
+        return insideTasks(path.join(tasks, normalized));
+    if (fs.existsSync(tasks)) {
+        const match = fs.readdirSync(tasks, { withFileTypes: true })
+            .find((item) => item.isDirectory() && item.name.endsWith(`-${normalized}`));
+        if (match)
+            return insideTasks(path.join(tasks, match.name));
+    }
+    return insideTasks(path.join(tasks, normalized));
+}
+export function resolveSelectedTask(root, env = process.env) {
+    const key = resolveContextKey(env);
+    if (!key)
+        return { taskPath: null, source: "none", contextKey: null, stale: false };
+    const value = readContext(contextFile(root, key)).selected_task;
+    if (typeof value !== "string" || !value.trim()) {
+        return { taskPath: null, source: "none", contextKey: key, stale: false };
+    }
+    return {
+        taskPath: value,
+        source: `session:${key}`,
+        contextKey: key,
+        stale: !fs.statSync(resolveTaskDir(root, value), { throwIfNoEntry: false })?.isDirectory(),
+    };
+}
+export function selectTask(root, taskRef, env = process.env) {
+    const dir = resolveTaskDir(root, taskRef);
+    if (!fs.statSync(dir, { throwIfNoEntry: false })?.isDirectory()) {
+        throw new Error(`Task not found: ${taskRef}`);
+    }
+    const key = resolveContextKey(env);
+    if (!key)
+        throw new Error("session identity not available; set PACTILE_CONTEXT_ID before selecting a task");
+    const file = contextFile(root, key);
+    const prior = readContext(file);
+    const selected = path.relative(root, dir).replaceAll("\\", "/");
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    delete prior.current_task;
+    fs.writeFileSync(file, `${JSON.stringify({
+        ...prior,
+        platform: key.startsWith("codex_") ? "codex" : "session",
+        last_seen_at: new Date().toISOString(),
+        selected_task: selected,
+        current_run: prior.current_run ?? null,
+    }, null, 2)}\n`, "utf8");
+    return { taskPath: selected, source: `session:${key}`, contextKey: key, stale: false };
+}
+export function exitTask(root, env = process.env) {
+    const selected = resolveSelectedTask(root, env);
+    if (selected.contextKey) {
+        fs.rmSync(contextFile(root, selected.contextKey), { force: true });
+    }
+    return selected;
+}
+//# sourceMappingURL=session.js.map

package/dist/pactile/task/session.js.map

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

package/dist/pactile/task/strategy.d.ts

@@ -0,0 +1,24 @@
+import type { PactileTaskRecord } from "../../core/task/index.js";
+export interface StrategyContract {
+    execution_mode: string;
+    isolation: string;
+    verification_profile: string;
+    retrieval_profile: string;
+    optional_capabilities: string[];
+    quality_gates: {
+        mode: string;
+        profile?: string;
+        enabled?: string[];
+    };
+}
+/** Parse only the documented Development Strategy Contract block of implement.md. */
+export declare function readStrategyContract(dir: string): {
+    contract: StrategyContract | null;
+    errors: string[];
+};
+export declare function requiredGates(transition: "start-execution" | "full-task-complete" | "child-review" | "parent-integrated", contract: StrategyContract | null): string[];
+export declare function gateFingerprint(value: unknown): string;
+export declare function contractFingerprint(dir: string, record: PactileTaskRecord, contract: StrategyContract | null): string;
+export declare function artifactFingerprint(dir: string, record: PactileTaskRecord, transition: string, gate: string): string;
+export declare function currentGateErrors(dir: string, record: PactileTaskRecord, transition: string, gates: string[], contract: StrategyContract | null, records: Record<string, unknown>): string[];
+//# sourceMappingURL=strategy.d.ts.map

package/dist/pactile/task/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/pactile/task/strategy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACvE;AAcD,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA8CzG;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,oBAAoB,GAAG,cAAc,GAAG,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,MAAM,EAAE,CAQtK;AAQD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAID,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,MAAM,CAGrH;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpH;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAc5L"}

package/dist/pactile/task/strategy.js

@@ -0,0 +1,136 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+const MODES = new Set(["inline", "worker", "child-task"]);
+const ISOLATION = new Set(["main-worktree", "git-worktree"]);
+const VERIFICATION = new Set(["standard", "strict", "architecture"]);
+const RETRIEVAL = new Set(["exact-only", "semantic", "structure", "architecture-memory"]);
+const GATES = new Set(["requirements-review", "code-review", "architecture-review", "architecture-deep-review", "integration-review"]);
+const TOP_LEVEL = new Set(["execution_mode", "isolation", "verification_profile", "retrieval_profile", "optional_capabilities", "quality_gates"]);
+function inlineList(value) {
+    const cleaned = value.trim().replace(/^\[/, "").replace(/\]$/, "");
+    return cleaned ? cleaned.split(",").map((item) => item.trim().replace(/^['"]|['"]$/g, "")).filter(Boolean) : [];
+}
+/** Parse only the documented Development Strategy Contract block of implement.md. */
+export function readStrategyContract(dir) {
+    const file = path.join(dir, "implement.md");
+    if (!fs.existsSync(file))
+        return { contract: null, errors: ["implement.md"] };
+    const values = {};
+    let section = "";
+    let listKey = "";
+    for (const line of fs.readFileSync(file, "utf8").split(/\r?\n/)) {
+        const stripped = line.trim();
+        if (!stripped || stripped.startsWith("#") || stripped.startsWith("```"))
+            continue;
+        const top = stripped.match(/^([A-Za-z_][A-Za-z0-9_]*):\s*(.*)$/);
+        if (top && TOP_LEVEL.has(top[1])) {
+            const [, key, raw] = top;
+            section = key === "quality_gates" ? key : "";
+            listKey = key === "optional_capabilities" && !raw ? key : "";
+            if (key === "quality_gates")
+                values[key] = {};
+            else if (key === "optional_capabilities")
+                values[key] = raw ? inlineList(raw) : [];
+            else
+                values[key] = raw.trim();
+            continue;
+        }
+        const nested = line.match(/^\s+([A-Za-z_][A-Za-z0-9_]*):\s*(.*)$/);
+        if (nested && section === "quality_gates") {
+            const gateConfig = values.quality_gates;
+            const key = nested[1];
+            const raw = nested[2].trim();
+            gateConfig[key] = key === "enabled" ? inlineList(raw) : raw;
+            listKey = key === "enabled" && !raw ? "quality_gates.enabled" : "";
+            continue;
+        }
+        const item = line.match(/^\s*-\s+(.+)$/);
+        if (item && listKey === "optional_capabilities")
+            values.optional_capabilities.push(item[1].trim());
+        else if (item && listKey === "quality_gates.enabled")
+            values.quality_gates.enabled.push(item[1].trim());
+    }
+    const errors = [];
+    for (const key of TOP_LEVEL)
+        if (!(key in values))
+            errors.push(`Development Strategy Contract missing ${key}`);
+    if (values.execution_mode && !MODES.has(String(values.execution_mode)))
+        errors.push(`invalid execution_mode: ${values.execution_mode}`);
+    if (values.isolation && !ISOLATION.has(String(values.isolation)))
+        errors.push(`invalid isolation: ${values.isolation}`);
+    if (values.verification_profile && !VERIFICATION.has(String(values.verification_profile)))
+        errors.push(`invalid verification_profile: ${values.verification_profile}`);
+    if (values.retrieval_profile && !RETRIEVAL.has(String(values.retrieval_profile)))
+        errors.push(`invalid retrieval_profile: ${values.retrieval_profile}`);
+    const quality = values.quality_gates;
+    if (quality) {
+        if (quality.mode !== "profile" && quality.mode !== "explicit")
+            errors.push("quality_gates.mode must be profile or explicit");
+        if (quality.profile && !VERIFICATION.has(String(quality.profile)))
+            errors.push(`invalid quality_gates.profile: ${quality.profile}`);
+        if (quality.mode === "explicit" && !Array.isArray(quality.enabled))
+            errors.push("quality_gates.enabled is required in explicit mode");
+        if (Array.isArray(quality.enabled))
+            for (const gate of quality.enabled)
+                if (!GATES.has(String(gate)))
+                    errors.push(`invalid quality gate: ${gate}`);
+    }
+    return { contract: errors.length ? null : values, errors };
+}
+export function requiredGates(transition, contract) {
+    if (transition === "parent-integrated")
+        return ["integration-review"];
+    const quality = contract?.quality_gates;
+    const profile = quality?.profile ?? contract?.verification_profile ?? "standard";
+    const enabled = quality?.mode === "explicit" ? quality.enabled ?? [] :
+        profile === "architecture" ? ["requirements-review", "architecture-review", "code-review"] : ["requirements-review", "code-review"];
+    if (transition === "start-execution")
+        return ["requirements-review", ...(enabled.includes("architecture-review") ? ["architecture-review"] : [])];
+    return ["code-review", ...["architecture-review", "architecture-deep-review"].filter((gate) => enabled.includes(gate))];
+}
+function sorted(value) {
+    if (Array.isArray(value))
+        return value.map(sorted);
+    if (value && typeof value === "object")
+        return Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => [key, sorted(item)]));
+    return value;
+}
+export function gateFingerprint(value) {
+    return `sha256:${createHash("sha256").update(JSON.stringify(sorted(value))).digest("hex")}`;
+}
+const STABLE_KEYS = ["id", "name", "title", "description", "status", "dev_type", "scope", "package", "priority", "creator", "assignee", "parent", "children", "subtasks", "relatedFiles", "notes", "meta", "branch", "base_branch"];
+export function contractFingerprint(dir, record, contract) {
+    const stable = Object.fromEntries(STABLE_KEYS.map((key) => [key, record[key]]));
+    return gateFingerprint({ schema_version: 1, task_dir: path.basename(dir), stable_task: stable, strategy_contract: contract ?? {} });
+}
+export function artifactFingerprint(dir, record, transition, gate) {
+    const files = transition === "start-execution" ? ["prd.md", "design.md", "implement.md"] :
+        transition === "full-task-complete" ? ["prd.md", "design.md", "implement.md", "verify.md"] :
+            transition === "child-review" ? ["prd.md", "design.md", "implement.md", "verify.md", "handoff.md"] :
+                transition === "parent-integrated" ? ["task-map.md", "verify.md"] : ["prd.md", "verify.md"];
+    return gateFingerprint({ schema_version: 1, transition, gate, task_dir: path.basename(dir), record_id: record.id,
+        files: files.map((name) => ({ path: name, content: fs.existsSync(path.join(dir, name)) ? fs.readFileSync(path.join(dir, name), "utf8") : null })) });
+}
+export function currentGateErrors(dir, record, transition, gates, contract, records) {
+    const errors = [];
+    const expectedContract = contractFingerprint(dir, record, contract);
+    const transitions = records.transitions && typeof records.transitions === "object" ? records.transitions : {};
+    const transitionRecords = transitions[transition] && typeof transitions[transition] === "object" ? transitions[transition] : {};
+    for (const gate of gates) {
+        const raw = transitionRecords[gate];
+        if (!raw || typeof raw !== "object") {
+            errors.push(`missing gate record: ${transition}/${gate}`);
+            continue;
+        }
+        const entry = raw;
+        if (entry.result !== "PASS" && !(entry.result === "SKIPPED" && entry.approved_skip?.approved_by === "user"))
+            errors.push(`gate not passed: ${transition}/${gate}`);
+        if (entry.contract_fingerprint !== expectedContract)
+            errors.push(`stale gate contract: ${transition}/${gate}`);
+        if (entry.artifact_fingerprint !== artifactFingerprint(dir, record, transition, gate))
+            errors.push(`stale gate artifact: ${transition}/${gate}`);
+    }
+    return errors;
+}
+//# sourceMappingURL=strategy.js.map

package/dist/pactile/task/strategy.js.map

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

package/dist/pactile/task/task-map.d.ts

@@ -0,0 +1,35 @@
+import { type PactileTaskRecord } from "../../core/task/index.js";
+export declare const CHILD_STATES: readonly ["open", "working", "blocked", "review", "changes", "accepted", "integrating", "integrated", "cancelled"];
+export type ChildState = typeof CHILD_STATES[number];
+export interface ChildEntry {
+    id: string;
+    state: ChildState;
+    depends_on: string[];
+    touches: string[];
+    isolation: string;
+    ref: string | null;
+    [key: string]: unknown;
+}
+export interface TaskMap {
+    parent_id: string;
+    contract_epoch: number;
+    execution_topology: string;
+    merge_limit: number;
+    parallel_limit?: number;
+    children: ChildEntry[];
+    stages: Record<string, unknown>[];
+    integration_queue: string[];
+    [key: string]: unknown;
+}
+export declare function readTaskMap(parentDir: string): {
+    data: TaskMap | null;
+    body: string;
+};
+export declare function writeTaskMap(parentDir: string, data: TaskMap, body: string, event?: string): void;
+export declare function ensureTaskMap(parentDir: string, parent: PactileTaskRecord, event?: string): TaskMap;
+export declare function childStateErrors(parentDir: string, parent: PactileTaskRecord, childDir: string, state: ChildState, evidence: string, options?: {
+    ref?: string;
+    reason?: string;
+}): string[];
+export declare function parentArchiveErrors(parentDir: string, parent: PactileTaskRecord): string[];
+//# sourceMappingURL=task-map.d.ts.map

package/dist/pactile/task/task-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-map.d.ts","sourceRoot":"","sources":["../../../src/pactile/task/task-map.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,eAAO,MAAM,YAAY,oHAAqH,CAAC;AAC/I,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiDD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgBrF;AA+BD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAGjG;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CASnG;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,EAAE,CAiC/L;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAwB1F"}