@agent-teams/docs-protocol 0.1.0-rc.1 → 0.1.0-rc.2

package/dist/consumer-integration/application/policies/consumer-integration-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-assets.js","sourceRoot":"","sources":["../../../../src/consumer-integration/application/policies/consumer-integration-assets.ts"],"names":[],"mappings":"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"}

package/dist/consumer-integration/application/policies/consumer-integration-authority-guards.d.ts

@@ -0,0 +1,4 @@
+import type { KnownFileTransactionOperationInput } from "@agent-teams/engineering-foundation/mutation";
+import type { ConsumerIntegrationSnapshot } from "../../domain/model.js";
+export declare function consumerIntegrationAuthorityGuards(snapshot: ConsumerIntegrationSnapshot, hasManagedChanges: boolean): readonly KnownFileTransactionOperationInput[];
+//# sourceMappingURL=consumer-integration-authority-guards.d.ts.map

package/dist/consumer-integration/application/policies/consumer-integration-authority-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-authority-guards.d.ts","sourceRoot":"","sources":["../../../../src/consumer-integration/application/policies/consumer-integration-authority-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,8CAA8C,CAAC;AAEvG,OAAO,KAAK,EAEV,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAmB/B,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,2BAA2B,EACrC,iBAAiB,EAAE,OAAO,GACzB,SAAS,kCAAkC,EAAE,CAS/C"}

package/dist/consumer-integration/application/policies/consumer-integration-authority-guards.js

@@ -0,0 +1,23 @@
+function guardOperation(path, observation) {
+    if (observation.state !== "file") {
+        throw new TypeError(`Required consumer authority observation is absent: ${path}.`);
+    }
+    return {
+        path,
+        precondition: {
+            state: "known-file",
+            acceptedPreimages: [{ bytes: observation.bytes, mode: observation.mode }]
+        },
+        postimage: { bytes: observation.bytes, mode: observation.mode }
+    };
+}
+export function consumerIntegrationAuthorityGuards(snapshot, hasManagedChanges) {
+    if (!hasManagedChanges) {
+        return [];
+    }
+    return [
+        guardOperation("architecture/foundation/docs-consumer-integration.json", snapshot.integrationProfile),
+        guardOperation("pnpm-lock.yaml", snapshot.lockfile)
+    ];
+}
+//# sourceMappingURL=consumer-integration-authority-guards.js.map

package/dist/consumer-integration/application/policies/consumer-integration-authority-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-authority-guards.js","sourceRoot":"","sources":["../../../../src/consumer-integration/application/policies/consumer-integration-authority-guards.ts"],"names":[],"mappings":"AAOA,SAAS,cAAc,CACrB,IAAY,EACZ,WAA+C;IAE/C,IAAI,WAAW,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,sDAAsD,IAAI,GAAG,CAAC,CAAC;IACrF,CAAC;IACD,OAAO;QACL,IAAI;QACJ,YAAY,EAAE;YACZ,KAAK,EAAE,YAAY;YACnB,iBAAiB,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;SAC1E;QACD,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,QAAqC,EACrC,iBAA0B;IAE1B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAAA,OAAO,EAAE,CAAC;IAAA,CAAC;IACpC,OAAO;QACL,cAAc,CACZ,wDAAwD,EACxD,QAAQ,CAAC,kBAAkB,CAC5B;QACD,cAAc,CAAC,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/consumer-integration/application/policies/consumer-integration-desired-state.d.ts

@@ -0,0 +1,4 @@
+import type { ConsumerIntegrationDesiredStateV1, QualifiedDocsCohortBindingV1 } from "../../domain/model.js";
+export declare function assertQualifiedDocsCohortBindingV1(cohort: QualifiedDocsCohortBindingV1): void;
+export declare function assertConsumerIntegrationDesiredStateV1(desired: ConsumerIntegrationDesiredStateV1): void;
+//# sourceMappingURL=consumer-integration-desired-state.d.ts.map

package/dist/consumer-integration/application/policies/consumer-integration-desired-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-desired-state.d.ts","sourceRoot":"","sources":["../../../../src/consumer-integration/application/policies/consumer-integration-desired-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iCAAiC,EACjC,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAoG/B,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,4BAA4B,GACnC,IAAI,CAgCN;AAED,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,iCAAiC,GACzC,IAAI,CAwBN"}

package/dist/consumer-integration/application/policies/consumer-integration-desired-state.js

@@ -0,0 +1,153 @@
+const COHORT_ID = /^[a-z0-9]+(?:[._-][a-z0-9]+)*$/u;
+const INTEGRITY = /^sha512-[A-Za-z0-9+/]{86}==$/u;
+const NONZERO_SHA = /^(?!0{40}$)[0-9a-f]{40}$/u;
+const NONZERO_SHA256 = /^sha256:(?!0{64}$)[0-9a-f]{64}$/u;
+const REPOSITORY = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/u;
+const REPOSITORY_ID = /^[1-9][0-9]*$/u;
+const SEMVER = /^[0-9]+\.[0-9]+\.[0-9]+(?:-[0-9A-Za-z.-]+)?$/u;
+const REPOSITORY_PATH = /^(?!.*(?:^|\/)\.{1,2}(?:\/|$))[A-Za-z0-9._@-]{1,255}(?:\/[A-Za-z0-9._@-]{1,255})*$/u;
+const PROFILE_PATH = "architecture/foundation/docs-protocol.yaml";
+const SKILL_PATH = ".agents/skills/docs-authoring/SKILL.md";
+const CALLER_WORKFLOW_PATH = ".github/workflows/docs-protocol.yml";
+const MANAGED_STATE_PATH = "architecture/foundation/docs-protocol-managed-state.json";
+const WORKFLOW_REPOSITORY = "agent-teams-ai/.github";
+const WORKFLOW_PATH = ".github/workflows/docs-protocol-check.yml";
+function hasUniqueEntries(entries) {
+    return new Set(entries).size === entries.length;
+}
+function hasExactKeys(value, keys) {
+    return Object.keys(value).toSorted().join("\u0000") === [...keys].toSorted().join("\u0000");
+}
+function hasValidGovernedRoots(roots) {
+    return roots === undefined || (roots.length > 0 && roots.length <= 32 &&
+        hasUniqueEntries(roots) && roots.every((root) => REPOSITORY_PATH.test(root)));
+}
+function isCanonicalUtcSeconds(value) {
+    const milliseconds = Date.parse(value);
+    return Number.isFinite(milliseconds) &&
+        new Date(milliseconds).toISOString().replace(".000", "") === value;
+}
+function assertPlainBoundedJson(value) {
+    let remaining = 2048;
+    const seen = new Set();
+    // oxlint-disable-next-line complexity -- this rejects every non-JSON runtime category.
+    const visit = (candidate, depth) => {
+        if (--remaining < 0 || depth > 16) {
+            throw new TypeError("Consumer input exceeds bounded JSON limits.");
+        }
+        if (candidate === null || typeof candidate === "boolean" ||
+            (typeof candidate === "number" && Number.isSafeInteger(candidate))) {
+            return;
+        }
+        if (typeof candidate === "string") {
+            if (candidate.length > 4096 || candidate.includes("\u0000")) {
+                throw new TypeError("Consumer input contains an invalid or overlong string.");
+            }
+            return;
+        }
+        if (typeof candidate !== "object" || seen.has(candidate)) {
+            throw new TypeError("Consumer input must be acyclic plain JSON data.");
+        }
+        seen.add(candidate);
+        const prototype = Object.getPrototypeOf(candidate);
+        if (prototype !== Object.prototype && prototype !== Array.prototype && prototype !== null) {
+            throw new TypeError("Consumer input must use plain JSON objects and arrays.");
+        }
+        if (Object.getOwnPropertySymbols(candidate).length > 0) {
+            throw new TypeError("Consumer input must not contain symbol properties.");
+        }
+        for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(candidate))) {
+            if (Array.isArray(candidate) && key === "length") {
+                continue;
+            }
+            if (descriptor.get !== undefined || descriptor.set !== undefined || descriptor.enumerable !== true) {
+                throw new TypeError("Consumer input must not contain accessors or hidden properties.");
+            }
+            visit(descriptor.value, depth + 1);
+        }
+    };
+    visit(value, 0);
+}
+function hasValidCohortAuthority(cohort) {
+    return COHORT_ID.test(cohort.cohortId) &&
+        NONZERO_SHA256.test(cohort.recordDigest) &&
+        NONZERO_SHA256.test(cohort.qualificationEventDigest) &&
+        isCanonicalUtcSeconds(cohort.eligibleAfter) &&
+        hasUniqueEntries(cohort.upgradeFrom) &&
+        hasUniqueEntries(cohort.rollbackTo) &&
+        cohort.upgradeFrom.every((entry) => COHORT_ID.test(entry)) &&
+        cohort.rollbackTo.every((entry) => COHORT_ID.test(entry));
+}
+function hasValidPackages(cohort) {
+    const packages = cohort.packages;
+    return SEMVER.test(packages.docsProtocol.version) &&
+        SEMVER.test(packages.engineeringFoundation.version) &&
+        INTEGRITY.test(packages.docsProtocol.integrity) &&
+        INTEGRITY.test(packages.engineeringFoundation.integrity);
+}
+function hasValidWorkflow(cohort) {
+    const workflow = cohort.workflow;
+    return workflow.repository === WORKFLOW_REPOSITORY &&
+        workflow.path === WORKFLOW_PATH &&
+        NONZERO_SHA.test(workflow.revision) &&
+        NONZERO_SHA.test(workflow.blobSha);
+}
+export function assertQualifiedDocsCohortBindingV1(cohort) {
+    assertPlainBoundedJson(cohort);
+    const valid = hasExactKeys(cohort, [
+        "schemaVersion", "cohortId", "channel", "recordDigest", "qualificationEventDigest",
+        "eligibleAfter", "upgradeFrom", "rollbackTo", "packages", "workflow", "assets",
+        "schemas", "runtime"
+    ]) &&
+        hasExactKeys(cohort.packages, ["docsProtocol", "engineeringFoundation"]) &&
+        hasExactKeys(cohort.packages.docsProtocol, ["version", "integrity"]) &&
+        hasExactKeys(cohort.packages.engineeringFoundation, ["version", "integrity"]) &&
+        hasExactKeys(cohort.workflow, ["repository", "path", "revision", "blobSha"]) &&
+        hasExactKeys(cohort.assets, [
+            "skillDigest", "callerWorkflowDigest", "assetCatalogDigest", "transitionCatalogDigest"
+        ]) &&
+        hasExactKeys(cohort.schemas, [
+            "consumerIntegration", "managedState", "docsProtocol"
+        ]) &&
+        hasExactKeys(cohort.runtime, ["node", "pnpm", "runtimeClosureDigest"]) &&
+        cohort.schemaVersion === 1 &&
+        hasValidCohortAuthority(cohort) &&
+        hasValidPackages(cohort) &&
+        hasValidWorkflow(cohort) &&
+        NONZERO_SHA256.test(cohort.assets.skillDigest) &&
+        NONZERO_SHA256.test(cohort.assets.callerWorkflowDigest) &&
+        NONZERO_SHA256.test(cohort.assets.assetCatalogDigest) &&
+        NONZERO_SHA256.test(cohort.assets.transitionCatalogDigest) &&
+        cohort.runtime.node === ">=24.18.0 <25" &&
+        cohort.runtime.pnpm === ">=11.17.0 <12" &&
+        NONZERO_SHA256.test(cohort.runtime.runtimeClosureDigest);
+    if (!valid) {
+        throw new TypeError("Qualified Docs Cohort binding is invalid or unsupported.");
+    }
+}
+export function assertConsumerIntegrationDesiredStateV1(desired) {
+    assertPlainBoundedJson(desired);
+    assertQualifiedDocsCohortBindingV1(desired.cohort);
+    const valid = hasExactKeys(desired, [
+        "schemaVersion", "repository", "integrationRoot", "packageManager", "profilePath",
+        "skillPath", "callerWorkflowPath", "managedStatePath", "cohort",
+        ...(desired.governedDocsRoots === undefined ? [] : ["governedDocsRoots"])
+    ]) &&
+        hasExactKeys(desired.repository, ["provider", "id", "nameWithOwner"]) &&
+        desired.schemaVersion === 1 &&
+        desired.integrationRoot === "." &&
+        desired.packageManager === "pnpm" &&
+        desired.profilePath === PROFILE_PATH &&
+        desired.skillPath === SKILL_PATH &&
+        desired.callerWorkflowPath === CALLER_WORKFLOW_PATH &&
+        desired.managedStatePath === MANAGED_STATE_PATH &&
+        desired.repository.provider === "github" &&
+        REPOSITORY_ID.test(desired.repository.id) &&
+        REPOSITORY.test(desired.repository.nameWithOwner) &&
+        hasValidGovernedRoots(desired.governedDocsRoots) &&
+        desired.cohort.schemaVersion === 1;
+    if (!valid) {
+        throw new TypeError("Consumer integration desired state is invalid or unsupported.");
+    }
+}
+//# sourceMappingURL=consumer-integration-desired-state.js.map

package/dist/consumer-integration/application/policies/consumer-integration-desired-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-integration-desired-state.js","sourceRoot":"","sources":["../../../../src/consumer-integration/application/policies/consumer-integration-desired-state.ts"],"names":[],"mappings":"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"}

package/dist/consumer-integration/application/use-cases/plan-consumer-integration.d.ts

@@ -0,0 +1,18 @@
+import { compileKnownFileTransactionPlan } from "@agent-teams/engineering-foundation/mutation";
+import type { ConsumerIntegrationDesiredStateV1, ConsumerIntegrationPlanV1, ConsumerIntegrationSnapshot } from "../../domain/model.js";
+import { type ConsumerAssetCatalogV1, type KnownPriorCohortCatalogEntryV1 } from "../policies/consumer-integration-assets.js";
+export declare function compileConsumerIntegration(input: {
+    readonly desired: ConsumerIntegrationDesiredStateV1;
+    readonly snapshot: ConsumerIntegrationSnapshot;
+    readonly assetCatalog?: ConsumerAssetCatalogV1;
+    /** Unit-level compatibility input; production composition loads package assets. */
+    readonly knownPriorCohorts?: readonly KnownPriorCohortCatalogEntryV1[];
+}): {
+    readonly plan: ConsumerIntegrationPlanV1;
+    readonly mutationPlan?: ReturnType<typeof compileKnownFileTransactionPlan>;
+};
+export declare function planConsumerIntegration(input: {
+    readonly desired: ConsumerIntegrationDesiredStateV1;
+    readonly snapshot: ConsumerIntegrationSnapshot;
+}): ConsumerIntegrationPlanV1;
+//# sourceMappingURL=plan-consumer-integration.d.ts.map

package/dist/consumer-integration/application/use-cases/plan-consumer-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-consumer-integration.d.ts","sourceRoot":"","sources":["../../../../src/consumer-integration/application/use-cases/plan-consumer-integration.ts"],"names":[],"mappings":"AACA,OAAO,EACL,+BAA+B,EAEhC,MAAM,8CAA8C,CAAC;AAItD,OAAO,KAAK,EAEV,iCAAiC,EAIjC,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAWL,KAAK,sBAAsB,EAK3B,KAAK,8BAA8B,EACpC,MAAM,4CAA4C,CAAC;AAygBpD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IAC/C,mFAAmF;IACnF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAC;CACxE,GAAG;IACF,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;CAC5E,CAoHA;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD,GAAG,yBAAyB,CAE5B"}