@agent-teams/engineering-foundation 0.8.0 → 0.10.0

package/schemas/quality-executable-specification-catalog/v1.schema.json

@@ -0,0 +1,201 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/quality-executable-specification-catalog/v1",
+  "title": "Executable specification catalog",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "specifications"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "specifications": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "items": { "$ref": "#/$defs/specification" }
+    }
+  },
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9.-]{1,119}$"
+    },
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 300,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)[^\\u0000]+$"
+    },
+    "schemaPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 300,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)[^\\u0000]+\\.json$"
+    },
+    "packageName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 214,
+      "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
+    },
+    "scriptName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120,
+      "pattern": "^[a-zA-Z0-9:_-]+$"
+    },
+    "gateBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["packageName", "script"],
+      "properties": {
+        "packageName": { "$ref": "#/$defs/packageName" },
+        "script": { "$ref": "#/$defs/scriptName" }
+      }
+    },
+    "document": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "schemaId"],
+      "properties": {
+        "path": { "$ref": "#/$defs/schemaPath" },
+        "schemaId": { "type": "string", "minLength": 1, "maxLength": 500 }
+      }
+    },
+    "generatedType": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaId", "outputPath"],
+      "properties": {
+        "schemaId": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "outputPath": { "$ref": "#/$defs/repositoryPath" }
+      }
+    },
+    "stateModelNone": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": { "kind": { "const": "none" } }
+    },
+    "stateModelXstate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "axes",
+        "modelPath",
+        "adapterPath",
+        "tracesPath",
+        "diagramPath",
+        "gateBinding"
+      ],
+      "properties": {
+        "kind": { "const": "xstate" },
+        "axes": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/identifier" }
+        },
+        "modelPath": { "$ref": "#/$defs/repositoryPath" },
+        "adapterPath": { "$ref": "#/$defs/repositoryPath" },
+        "tracesPath": { "$ref": "#/$defs/repositoryPath" },
+        "diagramPath": { "$ref": "#/$defs/repositoryPath" },
+        "gateBinding": { "$ref": "#/$defs/gateBinding" }
+      }
+    },
+    "specification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "ownerDocs",
+        "adrRefs",
+        "schemaPaths",
+        "documents",
+        "generatedTypes",
+        "gateBindings",
+        "stateModel"
+      ],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "ownerDocs": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/repositoryPath" }
+        },
+        "adrRefs": {
+          "type": "array",
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/repositoryPath" }
+        },
+        "schemaPaths": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/schemaPath" }
+        },
+        "documents": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/document" }
+        },
+        "generatedTypes": {
+          "type": "array",
+          "minItems": 0,
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/generatedType" }
+        },
+        "gateBindings": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["property", "mutation"],
+          "properties": {
+            "typeGeneration": { "$ref": "#/$defs/gateBinding" },
+            "property": { "$ref": "#/$defs/gateBinding" },
+            "mutation": { "$ref": "#/$defs/gateBinding" }
+          }
+        },
+        "stateModel": {
+          "oneOf": [
+            { "$ref": "#/$defs/stateModelNone" },
+            { "$ref": "#/$defs/stateModelXstate" }
+          ]
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "generatedTypes": { "type": "array", "minItems": 1 }
+            }
+          },
+          "then": {
+            "properties": {
+              "gateBindings": {
+                "type": "object",
+                "properties": {
+                  "typeGeneration": { "$ref": "#/$defs/gateBinding" }
+                },
+                "required": ["typeGeneration"]
+              }
+            }
+          },
+          "else": {
+            "properties": {
+              "gateBindings": {
+                "type": "object",
+                "properties": { "typeGeneration": false }
+              }
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/quality-executable-specifications/v1.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/quality-executable-specifications/v1",
+  "title": "Executable specifications capability configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "catalogPath"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "catalogPath": { "$ref": "#/$defs/repositoryJsonPath" }
+  },
+  "$defs": {
+    "repositoryJsonPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 300,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)[^\\u0000]+\\.json$"
+    }
+  }
+}

package/schemas/{scaffold-authority-evidence.schema.json → scaffold-authority-evidence/v1.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffold-authority-evidence",
+  "$id": "https://agent-teams.ai/schemas/scaffold-authority-evidence/v1",
   "title": "Scaffold Authority Evidence",
   "type": "object",
   "additionalProperties": false,

package/schemas/{scaffold-intent.schema.json → scaffold-intent/v1.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffold-intent",
+  "$id": "https://agent-teams.ai/schemas/scaffold-intent/v1",
   "title": "Scaffold Intent",
   "type": "object",
   "additionalProperties": false,

package/schemas/{scaffold-plan.schema.json → scaffold-plan/v1.schema.json}

@@ -1,13 +1,13 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffold-plan",
+  "$id": "https://agent-teams.ai/schemas/scaffold-plan/v1",
   "title": "Scaffold Plan",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "protocolVersion", "compiler", "projectId", "authority", "authorityEvidence", "intent", "intentDigest", "authoritySnapshotDigest", "composition", "definitions", "resolved", "target", "readSet", "requiredAdapterCapabilities", "operations", "diagnostics", "planDigest"],
   "properties": {
-    "schemaVersion": { "const": 2 },
-    "protocolVersion": { "const": 2 },
+    "schemaVersion": { "const": 1 },
+    "protocolVersion": { "const": 1 },
     "compiler": {
       "type": "object",
       "additionalProperties": false,

package/schemas/{scaffold-receipt.schema.json → scaffold-receipt/v1.schema.json}

@@ -1,13 +1,13 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffold-receipt",
+  "$id": "https://agent-teams.ai/schemas/scaffold-receipt/v1",
   "title": "Scaffold Receipt",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "protocolVersion", "planDigest", "adapter", "outcome", "commit", "operations", "diagnostics", "receiptDigest"],
   "properties": {
-    "schemaVersion": { "const": 2 },
-    "protocolVersion": { "const": 2 },
+    "schemaVersion": { "const": 1 },
+    "protocolVersion": { "const": 1 },
     "planDigest": { "$ref": "#/$defs/digest" },
     "adapter": { "$ref": "#/$defs/filesystemAdapter" },
     "outcome": { "enum": ["already-applied", "applied", "authority-stale", "failed-recovered", "recovery-required", "rejected"] },

package/schemas/{scaffold-recovery-journal.schema.json → scaffold-recovery-journal/v1.schema.json}

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffold-recovery-journal",
+  "$id": "https://agent-teams.ai/schemas/scaffold-recovery-journal/v1",
   "title": "Scaffold Recovery Journal",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "state", "plan", "operations"],
   "properties": {
-    "schemaVersion": { "const": 2 },
+    "schemaVersion": { "const": 1 },
     "state": { "const": "PREPARED" },
-    "plan": { "$ref": "https://agent-teams.ai/schemas/scaffold-plan" },
+    "plan": { "$ref": "https://agent-teams.ai/schemas/scaffold-plan/v1" },
     "operations": {
       "type": "array",
       "minItems": 1,

package/schemas/{scaffold-target-catalog.schema.json → scaffold-target-catalog/v1.schema.json}

@@ -1,12 +1,12 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffold-target-catalog",
+  "$id": "https://agent-teams.ai/schemas/scaffold-target-catalog/v1",
   "title": "Scaffold Target Catalog",
   "type": "object",
   "additionalProperties": false,
   "required": ["version", "packages"],
   "properties": {
-    "version": { "const": 2 },
+    "version": { "const": 1 },
     "packages": {
       "type": "array",
       "maxItems": 4096,

package/schemas/{scaffolding-config.schema.json → scaffolding-config/v1.schema.json}

@@ -1,12 +1,12 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffolding-config",
+  "$id": "https://agent-teams.ai/schemas/scaffolding-config/v1",
   "title": "Scaffolding Configuration",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "projectId", "targetCatalogPath", "compositions"],
   "properties": {
-    "schemaVersion": { "const": 2 },
+    "schemaVersion": { "const": 1 },
     "projectId": { "$ref": "#/$defs/id" },
     "targetCatalogPath": { "$ref": "#/$defs/repositoryPath" },
     "compositions": {

package/dist/scaffolding/adapters/memory/memory-workspace.d.ts

@@ -1,9 +0,0 @@
-import type { ScaffoldPlanV1, ScaffoldReceiptV1 } from "../../contract/types.js";
-export declare class MemoryScaffoldWorkspace {
-    #private;
-    constructor(files?: Readonly<Record<string, string | Uint8Array>>);
-    read(path: string): Uint8Array | undefined;
-    entries(): Readonly<Record<string, Uint8Array>>;
-    apply(plan: ScaffoldPlanV1): Promise<ScaffoldReceiptV1>;
-}
-//# sourceMappingURL=memory-workspace.d.ts.map

package/dist/scaffolding/adapters/memory/memory-workspace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-workspace.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/memory/memory-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,cAAc,EACd,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAMjC,qBAAa,uBAAuB;;IAGlC,YAAY,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAM,EASpE;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAGzC;IAED,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAM9C;IAEK,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0E5D;CACF"}

package/dist/scaffolding/adapters/memory/memory-workspace.js

@@ -1,93 +0,0 @@
-import { sha256Bytes } from "../../kernel/canonical-json.js";
-import { assertScaffoldPlanDigest } from "../../kernel/rendering-plan-validation.js";
-import { createScaffoldReceipt } from "../../kernel/receipt.js";
-import { assertSchema } from "../../../schema-catalog.js";
-export class MemoryScaffoldWorkspace {
-    #files;
-    constructor(files = {}) {
-        this.#files = new Map(Object.entries(files).map(([path, content]) => [
-            path,
-            typeof content === "string"
-                ? Buffer.from(content, "utf8")
-                : Uint8Array.from(content)
-        ]));
-    }
-    read(path) {
-        const value = this.#files.get(path);
-        return value === undefined ? undefined : Uint8Array.from(value);
-    }
-    entries() {
-        return Object.fromEntries([...this.#files.entries()]
-            .toSorted(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
-            .map(([path, content]) => [path, Uint8Array.from(content)]));
-    }
-    async apply(plan) {
-        await assertSchema("scaffold-plan/v1", plan, "scaffold-memory-apply-plan");
-        assertScaffoldPlanDigest(plan);
-        const diagnostics = [];
-        const classifications = plan.operations.map((operation) => {
-            const current = this.#files.get(operation.path);
-            if (current === undefined) {
-                return { operation, state: "absent" };
-            }
-            if (sha256Bytes(current) === operation.after.digest) {
-                return { operation, state: "after" };
-            }
-            diagnostics.push({
-                ruleId: "scaffolding.apply.precondition-conflict",
-                severity: "error",
-                phase: "apply",
-                subject: operation.path,
-                message: "Workspace content matches neither the Plan precondition nor its desired result.",
-                remediation: "Create a new Intent and Plan from the current workspace state."
-            });
-            return { operation, state: "conflict" };
-        });
-        if (classifications.some(({ state }) => state === "conflict")) {
-            return createScaffoldReceipt({
-                plan,
-                adapterId: "foundation.memory/v1",
-                outcome: "rejected",
-                commitState: "rejected",
-                atomicity: "memory-atomic",
-                operations: classifications.map(({ operation, state }) => ({
-                    operationId: operation.id,
-                    path: operation.path,
-                    outcome: state === "conflict"
-                        ? "conflict"
-                        : state === "after"
-                            ? "already-satisfied"
-                            : "not-applied",
-                    ...(state === "after" ? { resultDigest: operation.after.digest } : {})
-                })),
-                diagnostics
-            });
-        }
-        const next = new Map(this.#files);
-        const receipts = classifications.map(({ operation, state }) => {
-            if (state === "absent") {
-                next.set(operation.path, Buffer.from(operation.after.contentBase64, "base64"));
-            }
-            return {
-                operationId: operation.id,
-                path: operation.path,
-                outcome: state === "absent" ? "applied" : "already-satisfied",
-                resultDigest: operation.after.digest
-            };
-        });
-        this.#files.clear();
-        for (const [path, content] of next) {
-            this.#files.set(path, content);
-        }
-        const changed = classifications.some(({ state }) => state === "absent");
-        return createScaffoldReceipt({
-            plan,
-            adapterId: "foundation.memory/v1",
-            outcome: changed ? "applied" : "already-applied",
-            commitState: "committed",
-            atomicity: "memory-atomic",
-            operations: receipts
-        });
-    }
-}
-//# sourceMappingURL=memory-workspace.js.map

package/dist/scaffolding/adapters/memory/memory-workspace.js.map

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

package/dist/scaffolding/adapters/node/filesystem-rendering-journal.d.ts

@@ -1,6 +0,0 @@
-import type { ScaffoldPlanV1 } from "../../contract/types.js";
-export declare const SCAFFOLD_JOURNAL_FILE = "scaffolding-transaction.json";
-export declare function writeScaffoldJournal(path: string, plan: ScaffoldPlanV1): Promise<void>;
-export declare function readScaffoldJournal(path: string): Promise<ScaffoldPlanV1 | undefined>;
-export declare function removeScaffoldJournal(path: string, faultInjector?: () => Promise<void> | void): Promise<void>;
-//# sourceMappingURL=filesystem-rendering-journal.d.ts.map

package/dist/scaffolding/adapters/node/filesystem-rendering-journal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"filesystem-rendering-journal.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-rendering-journal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAS9D,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAUpE,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAiDrC;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACzC,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/scaffolding/adapters/node/filesystem-rendering-journal.js

@@ -1,80 +0,0 @@
-import { mkdir, open, rename, rm } from "node:fs/promises";
-import { dirname } from "node:path";
-import { assertScaffoldPlanDigest } from "../../kernel/rendering-plan-validation.js";
-import { ScaffoldError } from "../../scaffold-error.js";
-import { assertSchema } from "../../../schema-catalog.js";
-import { parseStrictYamlSource } from "../../../strict-yaml.js";
-import { readBoundedRegularFile } from "./filesystem-file-identity.js";
-import { syncDirectory } from "./filesystem-path-guard.js";
-import { MAX_SCAFFOLD_PLAN_BYTES } from "./node-scaffold-limits.js";
-export const SCAFFOLD_JOURNAL_FILE = "scaffolding-transaction.json";
-function isMissing(error) {
-    return (error instanceof Error &&
-        "code" in error &&
-        error.code === "ENOENT");
-}
-export async function writeScaffoldJournal(path, plan) {
-    const parent = dirname(path);
-    await mkdir(parent, { recursive: true });
-    const temporary = `${path}.tmp`;
-    await rm(temporary, { force: true });
-    let renamed = false;
-    try {
-        const handle = await open(temporary, "wx", 0o600);
-        try {
-            const journal = { schemaVersion: 1, state: "PREPARED", plan };
-            await handle.writeFile(`${JSON.stringify(journal, null, 2)}\n`, "utf8");
-            await handle.sync();
-        }
-        finally {
-            await handle.close();
-        }
-        await rename(temporary, path);
-        renamed = true;
-        await syncDirectory(parent);
-    }
-    finally {
-        if (!renamed) {
-            await rm(temporary, { force: true });
-        }
-    }
-}
-export async function readScaffoldJournal(path) {
-    try {
-        const result = await readBoundedRegularFile(path, MAX_SCAFFOLD_PLAN_BYTES);
-        if (result.outcome === "invalid") {
-            throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal is not a bounded regular file.");
-        }
-        if (result.outcome === "changed") {
-            throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "Scaffolding recovery journal changed while it was being read.");
-        }
-        const value = parseStrictYamlSource(result.bytes.toString("utf8"), "rendering-regression-journal");
-        if (typeof value !== "object" ||
-            value === null ||
-            Array.isArray(value) ||
-            Object.keys(value).length !== 3 ||
-            !("schemaVersion" in value) ||
-            value.schemaVersion !== 1 ||
-            !("state" in value) ||
-            value.state !== "PREPARED" ||
-            !("plan" in value)) {
-            throw new ScaffoldError("SCAFFOLD_RECOVERY_REQUIRED", "The 0.5 regression adapter cannot recover this scaffolding journal.");
-        }
-        await assertSchema("scaffold-plan/v1", value.plan, "rendering-regression-journal");
-        const plan = value.plan;
-        assertScaffoldPlanDigest(plan);
-        return plan;
-    }
-    catch (error) {
-        if (isMissing(error)) {
-            return undefined;
-        }
-        throw error;
-    }
-}
-export async function removeScaffoldJournal(path, faultInjector) {
-    await rm(path, { force: true });
-    await faultInjector?.();
-    await syncDirectory(dirname(path));
-}
-//# sourceMappingURL=filesystem-rendering-journal.js.map

package/dist/scaffolding/adapters/node/filesystem-rendering-journal.js.map

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

package/dist/scaffolding/adapters/node/filesystem-workspace.d.ts

@@ -1,14 +0,0 @@
-import type { ScaffoldPlanV1, ScaffoldReceiptV1 } from "../../contract/types.js";
-/** Retains the released 0.5 recovery contract for regression evidence only. */
-export declare function recoverFilesystemScaffold(consumerRoot: string): Promise<ScaffoldReceiptV1 | undefined>;
-export declare function applyFilesystemScaffold(consumerRoot: string, plan: ScaffoldPlanV1): Promise<ScaffoldReceiptV1>;
-interface ScaffoldFilesystemFaultPoint {
-    readonly phase: "after-journal-prepared" | "after-hard-link" | "after-operation-published" | "after-temporary-synced" | "after-temporary-written" | "before-journal-removed";
-    readonly operationIndex?: number;
-    readonly operationPath?: string;
-}
-type ScaffoldFilesystemFaultInjector = (point: ScaffoldFilesystemFaultPoint) => Promise<void> | void;
-/** Internal conformance seam. It is intentionally absent from package exports. */
-export declare function applyFilesystemScaffoldWithFaultInjection(consumerRoot: string, plan: ScaffoldPlanV1, faultInjector?: ScaffoldFilesystemFaultInjector): Promise<ScaffoldReceiptV1>;
-export {};
-//# sourceMappingURL=filesystem-workspace.d.ts.map

package/dist/scaffolding/adapters/node/filesystem-workspace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"filesystem-workspace.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/filesystem-workspace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,cAAc,EACd,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAoLjC,+EAA+E;AAC/E,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAExC;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAGD,UAAU,4BAA4B;IACpC,QAAQ,CAAC,KAAK,EACV,wBAAwB,GACxB,iBAAiB,GACjB,2BAA2B,GAC3B,wBAAwB,GACxB,yBAAyB,GACzB,wBAAwB,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,KAAK,+BAA+B,GAAG,CACrC,KAAK,EAAE,4BAA4B,KAChC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,kFAAkF;AAClF,wBAAsB,yCAAyC,CAC7D,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,cAAc,EACpB,aAAa,CAAC,EAAE,+BAA+B,GAC9C,OAAO,CAAC,iBAAiB,CAAC,CAiG5B"}