@blxzer/pactile 0.6.0-beta.2 → 0.6.0-beta.4

package/dist/pactile/artifacts/schema.js

@@ -0,0 +1,217 @@
+import { decodeLogicalIdV1, decodeOpaqueReferenceV1, decodeTimestampV1, definePactileContractSchemaV1, } from "../../core/pactile/validation.js";
+import { TASK_ARTIFACT_FACT_KINDS_V1, TASK_ARTIFACT_FACT_STATUSES_V1, TASK_ARTIFACT_PROVENANCE_METHODS_V1, TASK_ARTIFACT_SOURCE_KINDS_V1, TASK_ARTIFACT_STAGES_V1, } from "./types.js";
+const SOURCE_SCHEMES = [
+    "user",
+    "plane",
+    "source",
+    "git",
+    "agent",
+    "tool",
+    "test",
+    "artifact",
+    "runtime",
+];
+const FRESHNESS_EVIDENCE_SCHEMES = [
+    "source",
+    "git",
+    "test",
+    "tool",
+    "artifact",
+];
+const FACT_FIELDS = [
+    "id",
+    "kind",
+    "status",
+    "title",
+    "summary",
+    "source",
+    "provenance",
+    "ref",
+    "candidateFreshness",
+];
+const SOURCE_SCHEME_BY_KIND = {
+    user: ["user"],
+    plane: ["plane"],
+    repository: ["source", "git"],
+    agent: ["agent"],
+    tool: ["tool"],
+    test: ["test"],
+    artifact: ["artifact"],
+    runtime: ["runtime"],
+};
+function decodeOneLine(decoder, value, path, maxLength) {
+    const result = decoder.string(value, path, { nonEmpty: true });
+    if (result.length > maxLength) {
+        decoder.issue("invalid-value", path, `must be at most ${maxLength} characters`);
+    }
+    if (/[\r\n]/u.test(result)) {
+        decoder.issue("invalid-value", path, "must be a single line");
+    }
+    return result;
+}
+function hasOwn(record, key) {
+    return Object.prototype.hasOwnProperty.call(record, key);
+}
+function decodeSource(value, decoder, path) {
+    const record = decoder.object(value, path, ["kind", "ref"]);
+    const kind = decoder.enumValue(decoder.required(record, "kind", path), TASK_ARTIFACT_SOURCE_KINDS_V1, `${path}.kind`);
+    const ref = decodeOpaqueReferenceV1(decoder.required(record, "ref", path), decoder, `${path}.ref`, SOURCE_SCHEMES);
+    const scheme = ref.slice(0, ref.indexOf("://"));
+    if (!SOURCE_SCHEME_BY_KIND[kind].includes(scheme)) {
+        decoder.issue("invalid-value", `${path}.ref`, `scheme must match source kind '${kind}'`);
+    }
+    return { kind, ref };
+}
+function decodeProvenance(value, decoder, path) {
+    const record = decoder.object(value, path, [
+        "recordedAt",
+        "actor",
+        "method",
+        "basedOn",
+    ]);
+    const recordedAt = decodeTimestampV1(decoder.required(record, "recordedAt", path), decoder, `${path}.recordedAt`);
+    const actor = decodeOneLine(decoder, decoder.required(record, "actor", path), `${path}.actor`, 120);
+    const method = decoder.enumValue(decoder.required(record, "method", path), TASK_ARTIFACT_PROVENANCE_METHODS_V1, `${path}.method`);
+    const rawBasedOn = decoder.optional(record, "basedOn");
+    let basedOn;
+    if (rawBasedOn !== undefined) {
+        basedOn = decoder.stringArray(rawBasedOn, `${path}.basedOn`, {
+            nonEmptyItems: true,
+            unique: true,
+            pattern: /^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$/u,
+            patternDescription: "stable lowercase fact IDs",
+        });
+    }
+    if (method === "derived" && (!basedOn || basedOn.length === 0)) {
+        decoder.issue("required", `${path}.basedOn`, "is required and non-empty when method is 'derived'");
+    }
+    return {
+        recordedAt,
+        actor,
+        method,
+        ...(basedOn === undefined ? {} : { basedOn }),
+    };
+}
+function decodeLocator(value, decoder, path) {
+    const record = decoder.object(value, path, ["uri", "selector"]);
+    const uri = decodeOpaqueReferenceV1(decoder.required(record, "uri", path), decoder, `${path}.uri`, ["artifact"]);
+    const selector = decodeOneLine(decoder, decoder.required(record, "selector", path), `${path}.selector`, 256);
+    return { uri, selector };
+}
+function decodeCandidateFreshness(value, decoder, path) {
+    const record = decoder.object(value, path, [
+        "freshness",
+        "checkedAt",
+        "evidenceRef",
+    ]);
+    const freshness = decoder.enumValue(decoder.required(record, "freshness", path), ["fresh", "stale", "unknown"], `${path}.freshness`);
+    const hasCheckedAt = hasOwn(record, "checkedAt");
+    const hasEvidenceRef = hasOwn(record, "evidenceRef");
+    if (freshness === "unknown") {
+        if (hasCheckedAt || hasEvidenceRef) {
+            decoder.issue("policy-violation", path, "unknown freshness must not claim a check time or evidence reference");
+        }
+        return { freshness };
+    }
+    if (!hasCheckedAt) {
+        decoder.issue("required", `${path}.checkedAt`, "is required for a freshness claim");
+    }
+    if (!hasEvidenceRef) {
+        decoder.issue("required", `${path}.evidenceRef`, "is required for a freshness claim");
+    }
+    const checkedAt = decodeTimestampV1(decoder.required(record, "checkedAt", path), decoder, `${path}.checkedAt`);
+    const evidenceRef = decodeOpaqueReferenceV1(decoder.required(record, "evidenceRef", path), decoder, `${path}.evidenceRef`, FRESHNESS_EVIDENCE_SCHEMES);
+    return { freshness, checkedAt, evidenceRef };
+}
+function decodeFact(value, decoder, path) {
+    const record = decoder.object(value, path, FACT_FIELDS);
+    const id = decodeLogicalIdV1(decoder.required(record, "id", path), decoder, `${path}.id`);
+    const kind = decoder.enumValue(decoder.required(record, "kind", path), TASK_ARTIFACT_FACT_KINDS_V1, `${path}.kind`);
+    const status = decoder.enumValue(decoder.required(record, "status", path), TASK_ARTIFACT_FACT_STATUSES_V1, `${path}.status`);
+    const title = decodeOneLine(decoder, decoder.required(record, "title", path), `${path}.title`, 120);
+    const summary = decodeOneLine(decoder, decoder.required(record, "summary", path), `${path}.summary`, 280);
+    const source = decodeSource(decoder.required(record, "source", path), decoder, `${path}.source`);
+    const provenance = decodeProvenance(decoder.required(record, "provenance", path), decoder, `${path}.provenance`);
+    const ref = decodeLocator(decoder.required(record, "ref", path), decoder, `${path}.ref`);
+    const hasFreshness = hasOwn(record, "candidateFreshness");
+    if (kind === "candidate") {
+        if (!hasFreshness) {
+            decoder.issue("required", `${path}.candidateFreshness`, "is required for candidate facts");
+        }
+        return {
+            id,
+            kind,
+            status,
+            title,
+            summary,
+            source,
+            provenance,
+            ref,
+            candidateFreshness: decodeCandidateFreshness(decoder.required(record, "candidateFreshness", path), decoder, `${path}.candidateFreshness`),
+        };
+    }
+    if (hasFreshness) {
+        decoder.issue("policy-violation", `${path}.candidateFreshness`, "candidate freshness is only valid for candidate facts");
+    }
+    return { id, kind, status, title, summary, source, provenance, ref };
+}
+function decodeEnvelope(value, decoder, path) {
+    const record = decoder.object(value, path, [
+        "schemaVersion",
+        "taskId",
+        "facts",
+        "stageRefs",
+    ]);
+    const schemaVersion = decoder.literal(decoder.required(record, "schemaVersion", path), 1, `${path}.schemaVersion`);
+    const taskId = decodeLogicalIdV1(decoder.required(record, "taskId", path), decoder, `${path}.taskId`);
+    const facts = decoder.array(decoder.required(record, "facts", path), `${path}.facts`, (fact, factPath) => decodeFact(fact, decoder, factPath));
+    if (facts.length === 0) {
+        decoder.issue("invalid-value", `${path}.facts`, "must include at least one fact");
+    }
+    decoder.unique(facts, (fact) => fact.id, `${path}.facts`, "fact ID");
+    const rawStages = decoder.object(decoder.required(record, "stageRefs", path), `${path}.stageRefs`, TASK_ARTIFACT_STAGES_V1);
+    const stageRefs = {};
+    for (const stage of TASK_ARTIFACT_STAGES_V1) {
+        if (!hasOwn(rawStages, stage))
+            continue;
+        const ids = decoder.stringArray(rawStages[stage], `${path}.stageRefs.${stage}`, {
+            nonEmptyItems: true,
+            unique: true,
+            pattern: /^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$/u,
+            patternDescription: "stable lowercase fact IDs",
+        });
+        if (ids.length === 0) {
+            decoder.issue("invalid-value", `${path}.stageRefs.${stage}`, "empty stage entries must be omitted");
+        }
+        stageRefs[stage] = ids;
+    }
+    if (Object.keys(stageRefs).length === 0) {
+        decoder.issue("invalid-value", `${path}.stageRefs`, "must include at least one non-empty stage");
+    }
+    const factIds = new Set(facts.map((fact) => fact.id));
+    const reachableIds = new Set();
+    for (const stage of TASK_ARTIFACT_STAGES_V1) {
+        for (const [index, factId] of (stageRefs[stage] ?? []).entries()) {
+            if (!factIds.has(factId)) {
+                decoder.issue("invalid-value", `${path}.stageRefs.${stage}[${index}]`, `references unknown fact '${factId}'`);
+            }
+            reachableIds.add(factId);
+        }
+    }
+    for (const [index, fact] of facts.entries()) {
+        if (!reachableIds.has(fact.id)) {
+            decoder.issue("invalid-value", `${path}.facts[${index}].id`, "fact must be referenced by at least one stage");
+        }
+        for (const basedOnId of fact.provenance.basedOn ?? []) {
+            if (basedOnId === fact.id) {
+                decoder.issue("policy-violation", `${path}.facts[${index}].provenance.basedOn`, "a fact cannot derive from itself");
+            }
+            if (!factIds.has(basedOnId)) {
+                decoder.issue("invalid-value", `${path}.facts[${index}].provenance.basedOn`, `references unknown fact '${basedOnId}'`);
+            }
+        }
+    }
+    return { schemaVersion, taskId, facts, stageRefs };
+}
+export const taskArtifactEnvelopeV1Schema = definePactileContractSchemaV1("pactile.task-artifacts", decodeEnvelope);
+//# sourceMappingURL=schema.js.map

package/dist/pactile/artifacts/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/pactile/artifacts/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,mCAAmC,EACnC,6BAA6B,EAC7B,uBAAuB,GASxB,MAAM,YAAY,CAAC;AAEpB,MAAM,cAAc,GAAG;IACrB,MAAM;IACN,OAAO;IACP,QAAQ;IACR,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;CACD,CAAC;AAEX,MAAM,0BAA0B,GAAG;IACjC,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,UAAU;CACF,CAAC;AAEX,MAAM,WAAW,GAAG;IAClB,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,KAAK;IACL,oBAAoB;CACZ,CAAC;AAEX,MAAM,qBAAqB,GAEvB;IACF,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,OAAO,CAAC;IAChB,UAAU,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;IAC7B,KAAK,EAAE,CAAC,OAAO,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,CAAC,SAAS,CAAC;CACrB,CAAC;AAEF,SAAS,aAAa,CACpB,OAA0B,EAC1B,KAAc,EACd,IAAY,EACZ,SAAiB;IAEjB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CACX,eAAe,EACf,IAAI,EACJ,mBAAmB,SAAS,aAAa,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,MAA+B,EAAE,GAAW;IAC1D,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CACnB,KAAc,EACd,OAA0B,EAC1B,IAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EACtC,6BAA6B,EAC7B,GAAG,IAAI,OAAO,CACf,CAAC;IACF,MAAM,GAAG,GAAG,uBAAuB,CACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,EACrC,OAAO,EACP,GAAG,IAAI,MAAM,EACb,cAAc,CACf,CAAC;IACF,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,KAAK,CACX,eAAe,EACf,GAAG,IAAI,MAAM,EACb,kCAAkC,IAAI,GAAG,CAC1C,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,OAA0B,EAC1B,IAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;QACzC,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,SAAS;KACV,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,iBAAiB,CAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,EAC5C,OAAO,EACP,GAAG,IAAI,aAAa,CACrB,CAAC;IACF,MAAM,KAAK,GAAG,aAAa,CACzB,OAAO,EACP,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EACvC,GAAG,IAAI,QAAQ,EACf,GAAG,CACJ,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EACxC,mCAAmC,EACnC,GAAG,IAAI,SAAS,CACjB,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,OAA6B,CAAC;IAClC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,IAAI,UAAU,EAAE;YAC3D,aAAa,EAAE,IAAI;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,uCAAuC;YAChD,kBAAkB,EAAE,2BAA2B;SAChD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,CAAC,KAAK,CACX,UAAU,EACV,GAAG,IAAI,UAAU,EACjB,oDAAoD,CACrD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU;QACV,KAAK;QACL,MAAM;QACN,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,KAAc,EACd,OAA0B,EAC1B,IAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,uBAAuB,CACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,EACrC,OAAO,EACP,GAAG,IAAI,MAAM,EACb,CAAC,UAAU,CAAC,CACb,CAAC;IACF,MAAM,QAAQ,GAAG,aAAa,CAC5B,OAAO,EACP,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAC1C,GAAG,IAAI,WAAW,EAClB,GAAG,CACJ,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAc,EACd,OAA0B,EAC1B,IAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;QACzC,WAAW;QACX,WAAW;QACX,aAAa;KACd,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAC3C,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAU,EACtC,GAAG,IAAI,YAAY,CACpB,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,YAAY,IAAI,cAAc,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CACX,kBAAkB,EAClB,IAAI,EACJ,qEAAqE,CACtE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CACX,UAAU,EACV,GAAG,IAAI,YAAY,EACnB,mCAAmC,CACpC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CACX,UAAU,EACV,GAAG,IAAI,cAAc,EACrB,mCAAmC,CACpC,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,iBAAiB,CACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAC3C,OAAO,EACP,GAAG,IAAI,YAAY,CACpB,CAAC;IACF,MAAM,WAAW,GAAG,uBAAuB,CACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAC7C,OAAO,EACP,GAAG,IAAI,cAAc,EACrB,0BAA0B,CAC3B,CAAC;IACF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,UAAU,CACjB,KAAc,EACd,OAA0B,EAC1B,IAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,iBAAiB,CAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,EACpC,OAAO,EACP,GAAG,IAAI,KAAK,CACb,CAAC;IACF,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EACtC,2BAA2B,EAC3B,GAAG,IAAI,OAAO,CACf,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EACxC,8BAA8B,EAC9B,GAAG,IAAI,SAAS,CACjB,CAAC;IACF,MAAM,KAAK,GAAG,aAAa,CACzB,OAAO,EACP,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EACvC,GAAG,IAAI,QAAQ,EACf,GAAG,CACJ,CAAC;IACF,MAAM,OAAO,GAAG,aAAa,CAC3B,OAAO,EACP,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EACzC,GAAG,IAAI,UAAU,EACjB,GAAG,CACJ,CAAC;IACF,MAAM,MAAM,GAAG,YAAY,CACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EACxC,OAAO,EACP,GAAG,IAAI,SAAS,CACjB,CAAC;IACF,MAAM,UAAU,GAAG,gBAAgB,CACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,EAC5C,OAAO,EACP,GAAG,IAAI,aAAa,CACrB,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,CACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,EACrC,OAAO,EACP,GAAG,IAAI,MAAM,CACd,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC1D,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CACX,UAAU,EACV,GAAG,IAAI,qBAAqB,EAC5B,iCAAiC,CAClC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,EAAE;YACF,IAAI;YACJ,MAAM;YACN,KAAK;YACL,OAAO;YACP,MAAM;YACN,UAAU;YACV,GAAG;YACH,kBAAkB,EAAE,wBAAwB,CAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,EAAE,IAAI,CAAC,EACpD,OAAO,EACP,GAAG,IAAI,qBAAqB,CAC7B;SACF,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CACX,kBAAkB,EAClB,GAAG,IAAI,qBAAqB,EAC5B,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,cAAc,CACrB,KAAc,EACd,OAA0B,EAC1B,IAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;QACzC,eAAe;QACf,QAAQ;QACR,OAAO;QACP,WAAW;KACZ,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAC/C,CAAC,EACD,GAAG,IAAI,gBAAgB,CACxB,CAAC;IACF,MAAM,MAAM,GAAG,iBAAiB,CAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EACxC,OAAO,EACP,GAAG,IAAI,SAAS,CACjB,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EACvC,GAAG,IAAI,QAAQ,EACf,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CACxD,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CACX,eAAe,EACf,GAAG,IAAI,QAAQ,EACf,gCAAgC,CACjC,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,QAAQ,EAAE,SAAS,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAC3C,GAAG,IAAI,YAAY,EACnB,uBAAuB,CACxB,CAAC;IACF,MAAM,SAAS,GAAmD,EAAE,CAAC;IACrE,KAAK,MAAM,KAAK,IAAI,uBAAuB,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC;YAAE,SAAS;QACxC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAC7B,SAAS,CAAC,KAAK,CAAC,EAChB,GAAG,IAAI,cAAc,KAAK,EAAE,EAC5B;YACE,aAAa,EAAE,IAAI;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,uCAAuC;YAChD,kBAAkB,EAAE,2BAA2B;SAChD,CACF,CAAC;QACF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CACX,eAAe,EACf,GAAG,IAAI,cAAc,KAAK,EAAE,EAC5B,qCAAqC,CACtC,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;IACzB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CACX,eAAe,EACf,GAAG,IAAI,YAAY,EACnB,2CAA2C,CAC5C,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,uBAAuB,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACjE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CACX,eAAe,EACf,GAAG,IAAI,cAAc,KAAK,IAAI,KAAK,GAAG,EACtC,4BAA4B,MAAM,GAAG,CACtC,CAAC;YACJ,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CACX,eAAe,EACf,GAAG,IAAI,UAAU,KAAK,MAAM,EAC5B,+CAA+C,CAChD,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACtD,IAAI,SAAS,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,CACX,kBAAkB,EAClB,GAAG,IAAI,UAAU,KAAK,sBAAsB,EAC5C,kCAAkC,CACnC,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,KAAK,CACX,eAAe,EACf,GAAG,IAAI,UAAU,KAAK,sBAAsB,EAC5C,4BAA4B,SAAS,GAAG,CACzC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,MAAM,4BAA4B,GACvC,6BAA6B,CAC3B,wBAAwB,EACxB,cAAc,CACf,CAAC"}

package/dist/pactile/artifacts/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Structured task facts shared by PRD, Design, Implement, Review, and Verify.
+ * Stage indexes point at fact IDs; they never own a second copy of a fact.
+ */
+export declare const TASK_ARTIFACT_STAGES_V1: readonly ["prd", "design", "implement", "review", "verify"];
+export type TaskArtifactStageV1 = (typeof TASK_ARTIFACT_STAGES_V1)[number];
+export declare const TASK_ARTIFACT_FACT_KINDS_V1: readonly ["requirement", "decision", "constraint", "finding", "evidence", "candidate", "context"];
+export type TaskArtifactFactKindV1 = (typeof TASK_ARTIFACT_FACT_KINDS_V1)[number];
+export declare const TASK_ARTIFACT_FACT_STATUSES_V1: readonly ["active", "accepted", "blocked", "rejected", "superseded", "verified"];
+export type TaskArtifactFactStatusV1 = (typeof TASK_ARTIFACT_FACT_STATUSES_V1)[number];
+export declare const TASK_ARTIFACT_SOURCE_KINDS_V1: readonly ["user", "plane", "repository", "agent", "tool", "test", "artifact", "runtime"];
+export type TaskArtifactSourceKindV1 = (typeof TASK_ARTIFACT_SOURCE_KINDS_V1)[number];
+export declare const TASK_ARTIFACT_PROVENANCE_METHODS_V1: readonly ["direct", "derived", "verified", "imported"];
+export type TaskArtifactProvenanceMethodV1 = (typeof TASK_ARTIFACT_PROVENANCE_METHODS_V1)[number];
+export interface TaskArtifactSourceV1 {
+    readonly kind: TaskArtifactSourceKindV1;
+    /** Safe opaque source reference, such as `plane://tasks/pactile-42`. */
+    readonly ref: string;
+}
+export interface TaskArtifactProvenanceV1 {
+    readonly recordedAt: string;
+    readonly actor: string;
+    readonly method: TaskArtifactProvenanceMethodV1;
+    /** Stable IDs of facts used to derive this fact. */
+    readonly basedOn?: readonly string[];
+}
+export interface TaskArtifactLocatorV1 {
+    /** Logical Kernel resource resolved through the active Task reader. */
+    readonly uri: string;
+    /** JSON pointer into the current Kernel snapshot returned by that reader. */
+    readonly selector: string;
+}
+export type TaskArtifactCandidateFreshnessV1 = {
+    readonly freshness: "fresh" | "stale";
+    readonly checkedAt: string;
+    readonly evidenceRef: string;
+} | {
+    readonly freshness: "unknown";
+};
+interface TaskArtifactFactBaseV1 {
+    /** Caller-assigned logical ID. Keep it when the fact changes status. */
+    readonly id: string;
+    readonly status: TaskArtifactFactStatusV1;
+    readonly title: string;
+    /** One-line index text; fuller context stays at `ref`. */
+    readonly summary: string;
+    readonly source: TaskArtifactSourceV1;
+    readonly provenance: TaskArtifactProvenanceV1;
+    readonly ref: TaskArtifactLocatorV1;
+}
+export type TaskArtifactFactV1 = (TaskArtifactFactBaseV1 & {
+    readonly kind: Exclude<TaskArtifactFactKindV1, "candidate">;
+    readonly candidateFreshness?: never;
+}) | (TaskArtifactFactBaseV1 & {
+    readonly kind: "candidate";
+    readonly candidateFreshness: TaskArtifactCandidateFreshnessV1;
+});
+export interface TaskArtifactEnvelopeV1 {
+    readonly schemaVersion: 1;
+    readonly taskId: string;
+    readonly facts: readonly TaskArtifactFactV1[];
+    /** Sparse index: only stages with facts are present; values are fact IDs. */
+    readonly stageRefs: Readonly<Partial<Record<TaskArtifactStageV1, readonly string[]>>>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/pactile/artifacts/types.d.ts.map

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

package/dist/pactile/artifacts/types.js

@@ -0,0 +1,45 @@
+/**
+ * Structured task facts shared by PRD, Design, Implement, Review, and Verify.
+ * Stage indexes point at fact IDs; they never own a second copy of a fact.
+ */
+export const TASK_ARTIFACT_STAGES_V1 = [
+    "prd",
+    "design",
+    "implement",
+    "review",
+    "verify",
+];
+export const TASK_ARTIFACT_FACT_KINDS_V1 = [
+    "requirement",
+    "decision",
+    "constraint",
+    "finding",
+    "evidence",
+    "candidate",
+    "context",
+];
+export const TASK_ARTIFACT_FACT_STATUSES_V1 = [
+    "active",
+    "accepted",
+    "blocked",
+    "rejected",
+    "superseded",
+    "verified",
+];
+export const TASK_ARTIFACT_SOURCE_KINDS_V1 = [
+    "user",
+    "plane",
+    "repository",
+    "agent",
+    "tool",
+    "test",
+    "artifact",
+    "runtime",
+];
+export const TASK_ARTIFACT_PROVENANCE_METHODS_V1 = [
+    "direct",
+    "derived",
+    "verified",
+    "imported",
+];
+//# sourceMappingURL=types.js.map

package/dist/pactile/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/pactile/artifacts/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,KAAK;IACL,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,aAAa;IACb,UAAU;IACV,YAAY;IACZ,SAAS;IACT,UAAU;IACV,WAAW;IACX,SAAS;CACD,CAAC;AAKX,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,QAAQ;IACR,UAAU;IACV,SAAS;IACT,UAAU;IACV,YAAY;IACZ,UAAU;CACF,CAAC;AAKX,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,MAAM;IACN,OAAO;IACP,YAAY;IACZ,OAAO;IACP,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;CACD,CAAC;AAKX,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,QAAQ;IACR,SAAS;IACT,UAAU;IACV,UAAU;CACF,CAAC"}

package/dist/pactile/capabilities/claim.d.ts

@@ -0,0 +1,3 @@
+import type { ReceiptClaim, ReceiptDirectory } from "./receipts.js";
+export declare function claimRequestId(root: string, directory: ReceiptDirectory, requestId: string, signal: AbortSignal): Promise<ReceiptClaim>;
+//# sourceMappingURL=claim.d.ts.map

package/dist/pactile/capabilities/claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../../src/pactile/capabilities/claim.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAepE,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAwDvB"}

package/dist/pactile/capabilities/claim.js

@@ -0,0 +1,97 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { CapabilityNodeError, RECEIPT_ROOT, isInside, mapFilesystemError, sameFileIdentity, stopReason, } from "./shared.js";
+import { inspectReceiptDirectory } from "./receipts.js";
+const MAX_PENDING_RECEIPT_CLAIMS = 32;
+function rejectStoppedClaim(signal) {
+    const reason = stopReason(signal);
+    if (reason)
+        throw new CapabilityNodeError(reason, reason === "TIMEOUT"
+            ? "The request exceeded its time limit before its receipt claim."
+            : "The request was cancelled before its receipt claim.");
+}
+export async function claimRequestId(root, directory, requestId, signal) {
+    rejectStoppedClaim(signal);
+    await inspectReceiptDirectory(root, directory);
+    rejectStoppedClaim(signal);
+    const file = path.join(directory.path, `${requestId}.json`);
+    try {
+        await fsp.lstat(file);
+        throw new CapabilityNodeError("REQUEST_ID_REUSED", "This request id is in progress or has already been used.");
+    }
+    catch (error) {
+        if (error instanceof CapabilityNodeError)
+            throw error;
+        const code = error && typeof error === "object" && "code" in error
+            ? String(error.code)
+            : "";
+        if (code !== "ENOENT")
+            throw mapFilesystemError(error);
+    }
+    await assertPendingReceiptClaimCapacity(directory, signal);
+    rejectStoppedClaim(signal);
+    await inspectReceiptDirectory(root, directory);
+    rejectStoppedClaim(signal);
+    const noFollow = process.platform === "win32" ? 0 : fs.constants.O_NOFOLLOW;
+    const handle = await fsp.open(file, fs.constants.O_CREAT |
+        fs.constants.O_EXCL |
+        fs.constants.O_WRONLY |
+        noFollow, 0o600);
+    try {
+        const handleStat = await handle.stat();
+        const fileStat = await fsp.lstat(file);
+        await inspectReceiptDirectory(root, directory);
+        const resolvedFile = await fsp.realpath(file);
+        if (!handleStat.isFile() ||
+            fileStat.isSymbolicLink() ||
+            !sameFileIdentity(handleStat, fileStat) ||
+            !isInside(root, resolvedFile)) {
+            throw new CapabilityNodeError("OUT_OF_SCOPE", "The receipt file changed while its workspace boundary was being checked.");
+        }
+        return { path: file, handle, stat: handleStat };
+    }
+    catch {
+        await handle.close().catch(() => undefined);
+        throw new CapabilityNodeError("REQUEST_CLAIM_RETAINED", `Request id ${requestId} was reserved before receipt verification failed. The capability operation did not run, and its incomplete claim was retained. Retry with a new requestId, or confirm the receipt directory still resolves inside the workspace before inspecting ${RECEIPT_ROOT}/${requestId}.json; remove it only after confirming it is an empty regular file and no request is active.`);
+    }
+}
+async function assertPendingReceiptClaimCapacity(directory, signal) {
+    let pendingClaims = 0;
+    let handle = null;
+    try {
+        handle = await fsp.opendir(directory.path);
+        for await (const entry of handle) {
+            rejectStoppedClaim(signal);
+            if (!entry.name.toLocaleLowerCase().endsWith(".json") || !entry.isFile())
+                continue;
+            try {
+                const stat = await fsp.lstat(path.join(directory.path, entry.name));
+                rejectStoppedClaim(signal);
+                if (stat.isFile() &&
+                    !stat.isSymbolicLink() &&
+                    stat.size === 0 &&
+                    ++pendingClaims >= MAX_PENDING_RECEIPT_CLAIMS) {
+                    throw new CapabilityNodeError("REQUEST_CLAIM_LIMIT", `The receipt store already contains ${MAX_PENDING_RECEIPT_CLAIMS} incomplete empty claims. Inspect and resolve stale claims before retrying.`);
+                }
+            }
+            catch (error) {
+                if (error instanceof CapabilityNodeError)
+                    throw error;
+                const mapped = mapFilesystemError(error);
+                if (mapped.code !== "NOT_FOUND")
+                    throw mapped;
+            }
+        }
+        rejectStoppedClaim(signal);
+    }
+    catch (error) {
+        if (error instanceof CapabilityNodeError)
+            throw error;
+        throw mapFilesystemError(error);
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=claim.js.map

package/dist/pactile/capabilities/claim.js.map

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

package/dist/pactile/capabilities/command.d.ts

@@ -0,0 +1,6 @@
+import type { BoundedCapabilityRequestV1 } from "../../core/index.js";
+import { type OperationResult } from "./shared.js";
+export declare function runCommand(root: string, request: Extract<BoundedCapabilityRequestV1, {
+    operation: "run";
+}>, signal: AbortSignal): Promise<OperationResult>;
+//# sourceMappingURL=command.d.ts.map

package/dist/pactile/capabilities/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/pactile/capabilities/command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EASL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AA8IrB,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,0BAA0B,EAAE;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,CAAC,EAClE,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CA4I1B"}