wingfoil 0.2.1 → 0.3.0

package/dist/storage/git-read.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GIT_READ_MAX_BUFFER = void 0;
+exports.runGitRead = runGitRead;
+exports.runGitReadBytes = runGitReadBytes;
+exports.requireCommitName = requireCommitName;
+/**
+ * The one helper every **read-only** `git` invocation of the Memory pillar goes through
+ * (`task-142-run-memory-git-read-through-helper-captures-stderr`).
+ *
+ * Three defects of the same class led here, each written by a different task because nothing said
+ * how a Memory git read must be made:
+ *
+ * - **No `maxBuffer`** (`bug-072`): Node's 1 MiB default applied, a larger `git log` threw `ENOBUFS`,
+ *   and a `catch` folded it into "this document has no history".
+ * - **Inherited stderr** (`bug-071`, `bug-093`): without `stdio`, the child writes git's own
+ *   `fatal:` straight to the operator's terminal, beside the message WingFoil meant to print.
+ * - **Failures swallowed**: "git could not answer" read as an empty answer.
+ *
+ * {@link runGitRead} settles all three in one place: stderr is piped (never inherited) and carried
+ * inside the error, the buffer is {@link GIT_READ_MAX_BUFFER}, and any exit status the caller did not
+ * declare as an answer throws {@link StorageError} `E_GIT_READ_FAILED`. A caller that expects a
+ * failure — a path absent at a commit — names that exit status in `accepted` and decides what it
+ * means; nothing else is absorbed. `test/memory/git-read.test.ts` pins that no `src/memory` module
+ * spawns git any other way.
+ */
+const child_process_1 = require("child_process");
+const errors_1 = require("./errors");
+/**
+ * Large enough for any answer a Memory read asks of git — a whole tree's path list, a full history
+ * walk; an answer past it fails loudly ({@link runGitRead}), it is never truncated.
+ */
+exports.GIT_READ_MAX_BUFFER = 256 * 1024 * 1024;
+function spawnGit(root, args, options, encoding) {
+    return (0, child_process_1.spawnSync)('git', ['-C', root, ...args], {
+        // `undefined` returns Buffers; Node rejects the literal 'buffer' once `input` is given.
+        encoding: encoding === 'buffer' ? undefined : encoding,
+        env: options.env ? { ...process.env, ...options.env } : process.env,
+        maxBuffer: exports.GIT_READ_MAX_BUFFER,
+        input: options.input,
+        stdio: [options.input === undefined ? 'ignore' : 'pipe', 'pipe', 'pipe'],
+    });
+}
+function failure(root, args, detail) {
+    return new errors_1.StorageError(errors_1.E_GIT_READ_FAILED, `git ${args.join(' ')} failed in ${root}: ${detail}`);
+}
+/**
+ * Run `git -C <root> <args>` for its answer, with stdout decoded as UTF-8.
+ *
+ * @param root - The repository to read.
+ * @param args - git's arguments, passed verbatim (never through a shell).
+ * @param options - {@link GitReadOptions}.
+ * @returns The exit status, stdout and the captured stderr.
+ * @throws {@link StorageError} `E_GIT_READ_FAILED` — carrying git's stderr, or the spawn error — when
+ *   git cannot be spawned, its output exceeds {@link GIT_READ_MAX_BUFFER}, it is killed, or it exits
+ *   with a status outside `accepted`.
+ */
+function runGitRead(root, args, options = {}) {
+    const run = spawnGit(root, args, options, 'utf-8');
+    const accepted = options.accepted ?? [0];
+    if (run.error !== undefined || run.status === null || !accepted.includes(run.status)) {
+        throw failure(root, args, run.error !== undefined ? run.error.message : run.stderr.trim());
+    }
+    return { status: run.status, stdout: run.stdout, stderr: run.stderr };
+}
+/**
+ * {@link runGitRead} for an answer that is bytes, not text — `git cat-file --batch`, whose object
+ * sizes are byte counts and whose tree objects are binary.
+ *
+ * @throws {@link StorageError} `E_GIT_READ_FAILED` on the same conditions as {@link runGitRead}.
+ */
+function runGitReadBytes(root, args, options = {}) {
+    const run = spawnGit(root, args, options, 'buffer');
+    const accepted = options.accepted ?? [0];
+    const stderr = run.stderr?.toString('utf-8') ?? '';
+    if (run.error !== undefined || run.status === null || !accepted.includes(run.status)) {
+        throw failure(root, args, run.error !== undefined ? run.error.message : stderr.trim());
+    }
+    return { status: run.status, stdout: run.stdout, stderr };
+}
+/** A full commit name: 40 hexadecimal digits (SHA-1), or 64 (SHA-256). */
+const FULL_COMMIT_NAME_RE = /^[0-9a-f]{40}([0-9a-f]{24})?$/;
+/**
+ * `name`, checked to be a full commit name, as a reader of `git log --format=%H` output takes it
+ * (`task-268`, `bug-291`).
+ *
+ * Every `git log` reader passes `--no-show-signature`, so a `log.showSignature` configuration cannot
+ * print signature text ("No signature", "Good … signature for …") among the formatted lines. This is
+ * the second half: whatever still arrives where a name was expected is refused, never used — a
+ * garbled name used as a sha silently drops the commit it should have named (a phase record left
+ * uncounted) or surfaces as an unrelated error ("creation commit No signature is not present …").
+ * `agent show` makes the same check on its own reader (`task-220` review F1).
+ *
+ * @param name - The text the reader parsed as a commit name.
+ * @param command - The git command that printed it, for the message (e.g. `git log --follow`).
+ * @returns `name`, unchanged.
+ * @throws {@link StorageError} `E_GIT_READ_FAILED` — `IO` at the core boundary — when `name` is not a
+ *   full commit name: `<command> printed "<name>" where a commit name was expected`, `name` quoted as a
+ *   JSON string so a line break in it stays visible.
+ */
+function requireCommitName(name, command) {
+    if (!FULL_COMMIT_NAME_RE.test(name)) {
+        throw new errors_1.StorageError(errors_1.E_GIT_READ_FAILED, `${command} printed ${JSON.stringify(name)} where a commit name was expected`);
+    }
+    return name;
+}
+//# sourceMappingURL=git-read.js.map

package/dist/storage/git-read.js.map

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

package/dist/storage/index.d.ts

@@ -6,24 +6,32 @@
  * computing the whole-project state snapshot the REQ-SYS-01 fit criterion is stated in terms of.
  */
 export declare const MODULE_NAME: "storage";
-export { StorageError, E_NO_GIT_ROOT, E_NOT_AT_GIT_ROOT, E_MISSING_PATH_VALUE } from './errors';
+export { StorageError, E_COMMIT_FAILED, E_GIT_READ_FAILED, E_INVALID_REVISION, E_NO_GIT_ROOT, E_NOT_AT_GIT_ROOT, E_MISSING_PATH_VALUE } from './errors';
 export { findGitRoot, resolveProjectRoot } from './git-root';
 export { detectInitState } from './init-state';
 export type { InitState } from './init-state';
-export { renderMemoryPath, resolveMemoryPath } from './memory-path';
+export { renderMemoryPath } from './memory-path';
 export { escapesRoot, resolveRealPathInRoot } from './confinement';
 export type { RealPathResolution } from './confinement';
 export { extractFrontmatter, splitFrontmatter } from './frontmatter';
 export type { FrontmatterSplit } from './frontmatter';
 export { readDocument, documentExists, removeDocument, writeDocument } from './document';
-export { changedPathsBetween, commitParent, commitPaths, EMPTY_TREE_SHA, listPathsAtRev, pathPorcelainStatus, readPathAtRev } from './commit';
-export type { CommitOptions } from './commit';
+export { changedPathsBetween, CommitFailure, commitFailureSummary, commitEmpty, commitParent, commitPaths, committedBlobMatches, stagedPaths, writeAndCommit, EMPTY_TREE_SHA, listBlobEntriesAtRev, listBlobsAtRevs, listPathsAtRev, listPathsAtRevs, mergeBasesWith, pathPorcelainStatus, readBlobs, readPathAtRev, readPathsAtRev, readRevisionPaths, resolveCommitAtRev, storesAsBlob } from './commit';
+export type { BlobAtRev, BlobEntry, RevisionPath } from './commit';
+export type { CommitOptions, PathChange } from './commit';
+export { captureDryRun, isDryRunActive, planDiff } from './dry-run';
+export type { DryRunOutcome, DryRunPlan } from './dry-run';
+export { formatVersionTrailer, readBuildStamp, WINGFOIL_VERSION_TRAILER_KEY } from './build-stamp';
+export { GIT_READ_MAX_BUFFER, requireCommitName, runGitRead, runGitReadBytes } from './git-read';
+export type { GitReadOptions, GitReadResult } from './git-read';
 export { initStorage, scaffoldFiles, WINGFOIL_DIR, INIT_COMMIT_MESSAGE } from './layout';
 export type { ScaffoldFile } from './layout';
-export { TEMPLATES, TEMPLATE_NAMES, DEFAULT_TEMPLATE, resolveTemplate, templateScaffold, initProjectCommitMessage, builtinTemplateSources, BUILTIN_DIRECTIVES_DIR, BUILTIN_WORKFLOWS_DIR, } from './templates';
+export { TEMPLATES, TEMPLATE_NAMES, DEFAULT_TEMPLATE, resolveTemplate, templateScaffold, initProjectCommitMessage, builtinTemplateSources, BUILTIN_DIRECTIVES_DIR, BUILTIN_WORKFLOWS_DIR, BUILTIN_ADAPTERS_DIR, CUSTOM_ADAPTERS_DIR, } from './templates';
 export type { TemplateDefinition, BuiltinTemplateKind, BuiltinTemplateSource } from './templates';
 export { BUILTIN_DIRECTIVE_TEMPLATES, BUILTIN_DIRECTIVE_IDS, builtinDirectiveMd } from './builtin-directives';
 export type { BuiltinDirectiveTemplate } from './builtin-directives';
+export { BUILTIN_ADAPTERS } from './builtin-adapters';
+export type { BuiltinAdapterManifest } from './builtin-adapters';
 export { computeStateSnapshot, serializeSnapshot } from './snapshot';
 export type { SnapshotEntry } from './snapshot';
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAG,SAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9I,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACzF,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9G,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAG,SAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACxJ,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3Y,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACzF,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9G,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/storage/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeSnapshot = exports.computeStateSnapshot = exports.builtinDirectiveMd = exports.BUILTIN_DIRECTIVE_IDS = exports.BUILTIN_DIRECTIVE_TEMPLATES = exports.BUILTIN_WORKFLOWS_DIR = exports.BUILTIN_DIRECTIVES_DIR = exports.builtinTemplateSources = exports.initProjectCommitMessage = exports.templateScaffold = exports.resolveTemplate = exports.DEFAULT_TEMPLATE = exports.TEMPLATE_NAMES = exports.TEMPLATES = exports.INIT_COMMIT_MESSAGE = exports.WINGFOIL_DIR = exports.scaffoldFiles = exports.initStorage = exports.readPathAtRev = exports.pathPorcelainStatus = exports.listPathsAtRev = exports.EMPTY_TREE_SHA = exports.commitPaths = exports.commitParent = exports.changedPathsBetween = exports.writeDocument = exports.removeDocument = exports.documentExists = exports.readDocument = exports.splitFrontmatter = exports.extractFrontmatter = exports.resolveRealPathInRoot = exports.escapesRoot = exports.resolveMemoryPath = exports.renderMemoryPath = exports.detectInitState = exports.resolveProjectRoot = exports.findGitRoot = exports.E_MISSING_PATH_VALUE = exports.E_NOT_AT_GIT_ROOT = exports.E_NO_GIT_ROOT = exports.StorageError = exports.MODULE_NAME = void 0;
+exports.requireCommitName = exports.GIT_READ_MAX_BUFFER = exports.WINGFOIL_VERSION_TRAILER_KEY = exports.readBuildStamp = exports.formatVersionTrailer = exports.planDiff = exports.isDryRunActive = exports.captureDryRun = exports.storesAsBlob = exports.resolveCommitAtRev = exports.readRevisionPaths = exports.readPathsAtRev = exports.readPathAtRev = exports.readBlobs = exports.pathPorcelainStatus = exports.mergeBasesWith = exports.listPathsAtRevs = exports.listPathsAtRev = exports.listBlobsAtRevs = exports.listBlobEntriesAtRev = exports.EMPTY_TREE_SHA = exports.writeAndCommit = exports.stagedPaths = exports.committedBlobMatches = exports.commitPaths = exports.commitParent = exports.commitEmpty = exports.commitFailureSummary = exports.CommitFailure = exports.changedPathsBetween = exports.writeDocument = exports.removeDocument = exports.documentExists = exports.readDocument = exports.splitFrontmatter = exports.extractFrontmatter = exports.resolveRealPathInRoot = exports.escapesRoot = exports.renderMemoryPath = exports.detectInitState = exports.resolveProjectRoot = exports.findGitRoot = exports.E_MISSING_PATH_VALUE = exports.E_NOT_AT_GIT_ROOT = exports.E_NO_GIT_ROOT = exports.E_INVALID_REVISION = exports.E_GIT_READ_FAILED = exports.E_COMMIT_FAILED = exports.StorageError = exports.MODULE_NAME = void 0;
+exports.serializeSnapshot = exports.computeStateSnapshot = exports.BUILTIN_ADAPTERS = exports.builtinDirectiveMd = exports.BUILTIN_DIRECTIVE_IDS = exports.BUILTIN_DIRECTIVE_TEMPLATES = exports.CUSTOM_ADAPTERS_DIR = exports.BUILTIN_ADAPTERS_DIR = exports.BUILTIN_WORKFLOWS_DIR = exports.BUILTIN_DIRECTIVES_DIR = exports.builtinTemplateSources = exports.initProjectCommitMessage = exports.templateScaffold = exports.resolveTemplate = exports.DEFAULT_TEMPLATE = exports.TEMPLATE_NAMES = exports.TEMPLATES = exports.INIT_COMMIT_MESSAGE = exports.WINGFOIL_DIR = exports.scaffoldFiles = exports.initStorage = exports.runGitReadBytes = exports.runGitRead = void 0;
 /**
  * `storage` module — git-backed file storage (YAML + Markdown); single source of truth
  * (REQ-SYS-01, task-003-git-backed-sot). Single entry point for: resolving the WingFoil project
@@ -11,6 +12,9 @@ exports.serializeSnapshot = exports.computeStateSnapshot = exports.builtinDirect
 exports.MODULE_NAME = 'storage';
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "StorageError", { enumerable: true, get: function () { return errors_1.StorageError; } });
+Object.defineProperty(exports, "E_COMMIT_FAILED", { enumerable: true, get: function () { return errors_1.E_COMMIT_FAILED; } });
+Object.defineProperty(exports, "E_GIT_READ_FAILED", { enumerable: true, get: function () { return errors_1.E_GIT_READ_FAILED; } });
+Object.defineProperty(exports, "E_INVALID_REVISION", { enumerable: true, get: function () { return errors_1.E_INVALID_REVISION; } });
 Object.defineProperty(exports, "E_NO_GIT_ROOT", { enumerable: true, get: function () { return errors_1.E_NO_GIT_ROOT; } });
 Object.defineProperty(exports, "E_NOT_AT_GIT_ROOT", { enumerable: true, get: function () { return errors_1.E_NOT_AT_GIT_ROOT; } });
 Object.defineProperty(exports, "E_MISSING_PATH_VALUE", { enumerable: true, get: function () { return errors_1.E_MISSING_PATH_VALUE; } });
@@ -19,9 +23,10 @@ Object.defineProperty(exports, "findGitRoot", { enumerable: true, get: function
 Object.defineProperty(exports, "resolveProjectRoot", { enumerable: true, get: function () { return git_root_1.resolveProjectRoot; } });
 var init_state_1 = require("./init-state");
 Object.defineProperty(exports, "detectInitState", { enumerable: true, get: function () { return init_state_1.detectInitState; } });
+// `resolveMemoryPath` (the unconfined resolver) is deliberately NOT re-exported (task-131, `bug-122`);
+// the guarded `resolveConfinedMemoryPath` is imported from `./memory-path` by its callers.
 var memory_path_1 = require("./memory-path");
 Object.defineProperty(exports, "renderMemoryPath", { enumerable: true, get: function () { return memory_path_1.renderMemoryPath; } });
-Object.defineProperty(exports, "resolveMemoryPath", { enumerable: true, get: function () { return memory_path_1.resolveMemoryPath; } });
 var confinement_1 = require("./confinement");
 Object.defineProperty(exports, "escapesRoot", { enumerable: true, get: function () { return confinement_1.escapesRoot; } });
 Object.defineProperty(exports, "resolveRealPathInRoot", { enumerable: true, get: function () { return confinement_1.resolveRealPathInRoot; } });
@@ -35,12 +40,40 @@ Object.defineProperty(exports, "removeDocument", { enumerable: true, get: functi
 Object.defineProperty(exports, "writeDocument", { enumerable: true, get: function () { return document_1.writeDocument; } });
 var commit_1 = require("./commit");
 Object.defineProperty(exports, "changedPathsBetween", { enumerable: true, get: function () { return commit_1.changedPathsBetween; } });
+Object.defineProperty(exports, "CommitFailure", { enumerable: true, get: function () { return commit_1.CommitFailure; } });
+Object.defineProperty(exports, "commitFailureSummary", { enumerable: true, get: function () { return commit_1.commitFailureSummary; } });
+Object.defineProperty(exports, "commitEmpty", { enumerable: true, get: function () { return commit_1.commitEmpty; } });
 Object.defineProperty(exports, "commitParent", { enumerable: true, get: function () { return commit_1.commitParent; } });
 Object.defineProperty(exports, "commitPaths", { enumerable: true, get: function () { return commit_1.commitPaths; } });
+Object.defineProperty(exports, "committedBlobMatches", { enumerable: true, get: function () { return commit_1.committedBlobMatches; } });
+Object.defineProperty(exports, "stagedPaths", { enumerable: true, get: function () { return commit_1.stagedPaths; } });
+Object.defineProperty(exports, "writeAndCommit", { enumerable: true, get: function () { return commit_1.writeAndCommit; } });
 Object.defineProperty(exports, "EMPTY_TREE_SHA", { enumerable: true, get: function () { return commit_1.EMPTY_TREE_SHA; } });
+Object.defineProperty(exports, "listBlobEntriesAtRev", { enumerable: true, get: function () { return commit_1.listBlobEntriesAtRev; } });
+Object.defineProperty(exports, "listBlobsAtRevs", { enumerable: true, get: function () { return commit_1.listBlobsAtRevs; } });
 Object.defineProperty(exports, "listPathsAtRev", { enumerable: true, get: function () { return commit_1.listPathsAtRev; } });
+Object.defineProperty(exports, "listPathsAtRevs", { enumerable: true, get: function () { return commit_1.listPathsAtRevs; } });
+Object.defineProperty(exports, "mergeBasesWith", { enumerable: true, get: function () { return commit_1.mergeBasesWith; } });
 Object.defineProperty(exports, "pathPorcelainStatus", { enumerable: true, get: function () { return commit_1.pathPorcelainStatus; } });
+Object.defineProperty(exports, "readBlobs", { enumerable: true, get: function () { return commit_1.readBlobs; } });
 Object.defineProperty(exports, "readPathAtRev", { enumerable: true, get: function () { return commit_1.readPathAtRev; } });
+Object.defineProperty(exports, "readPathsAtRev", { enumerable: true, get: function () { return commit_1.readPathsAtRev; } });
+Object.defineProperty(exports, "readRevisionPaths", { enumerable: true, get: function () { return commit_1.readRevisionPaths; } });
+Object.defineProperty(exports, "resolveCommitAtRev", { enumerable: true, get: function () { return commit_1.resolveCommitAtRev; } });
+Object.defineProperty(exports, "storesAsBlob", { enumerable: true, get: function () { return commit_1.storesAsBlob; } });
+var dry_run_1 = require("./dry-run");
+Object.defineProperty(exports, "captureDryRun", { enumerable: true, get: function () { return dry_run_1.captureDryRun; } });
+Object.defineProperty(exports, "isDryRunActive", { enumerable: true, get: function () { return dry_run_1.isDryRunActive; } });
+Object.defineProperty(exports, "planDiff", { enumerable: true, get: function () { return dry_run_1.planDiff; } });
+var build_stamp_1 = require("./build-stamp");
+Object.defineProperty(exports, "formatVersionTrailer", { enumerable: true, get: function () { return build_stamp_1.formatVersionTrailer; } });
+Object.defineProperty(exports, "readBuildStamp", { enumerable: true, get: function () { return build_stamp_1.readBuildStamp; } });
+Object.defineProperty(exports, "WINGFOIL_VERSION_TRAILER_KEY", { enumerable: true, get: function () { return build_stamp_1.WINGFOIL_VERSION_TRAILER_KEY; } });
+var git_read_1 = require("./git-read");
+Object.defineProperty(exports, "GIT_READ_MAX_BUFFER", { enumerable: true, get: function () { return git_read_1.GIT_READ_MAX_BUFFER; } });
+Object.defineProperty(exports, "requireCommitName", { enumerable: true, get: function () { return git_read_1.requireCommitName; } });
+Object.defineProperty(exports, "runGitRead", { enumerable: true, get: function () { return git_read_1.runGitRead; } });
+Object.defineProperty(exports, "runGitReadBytes", { enumerable: true, get: function () { return git_read_1.runGitReadBytes; } });
 var layout_1 = require("./layout");
 Object.defineProperty(exports, "initStorage", { enumerable: true, get: function () { return layout_1.initStorage; } });
 Object.defineProperty(exports, "scaffoldFiles", { enumerable: true, get: function () { return layout_1.scaffoldFiles; } });
@@ -56,10 +89,14 @@ Object.defineProperty(exports, "initProjectCommitMessage", { enumerable: true, g
 Object.defineProperty(exports, "builtinTemplateSources", { enumerable: true, get: function () { return templates_1.builtinTemplateSources; } });
 Object.defineProperty(exports, "BUILTIN_DIRECTIVES_DIR", { enumerable: true, get: function () { return templates_1.BUILTIN_DIRECTIVES_DIR; } });
 Object.defineProperty(exports, "BUILTIN_WORKFLOWS_DIR", { enumerable: true, get: function () { return templates_1.BUILTIN_WORKFLOWS_DIR; } });
+Object.defineProperty(exports, "BUILTIN_ADAPTERS_DIR", { enumerable: true, get: function () { return templates_1.BUILTIN_ADAPTERS_DIR; } });
+Object.defineProperty(exports, "CUSTOM_ADAPTERS_DIR", { enumerable: true, get: function () { return templates_1.CUSTOM_ADAPTERS_DIR; } });
 var builtin_directives_1 = require("./builtin-directives");
 Object.defineProperty(exports, "BUILTIN_DIRECTIVE_TEMPLATES", { enumerable: true, get: function () { return builtin_directives_1.BUILTIN_DIRECTIVE_TEMPLATES; } });
 Object.defineProperty(exports, "BUILTIN_DIRECTIVE_IDS", { enumerable: true, get: function () { return builtin_directives_1.BUILTIN_DIRECTIVE_IDS; } });
 Object.defineProperty(exports, "builtinDirectiveMd", { enumerable: true, get: function () { return builtin_directives_1.builtinDirectiveMd; } });
+var builtin_adapters_1 = require("./builtin-adapters");
+Object.defineProperty(exports, "BUILTIN_ADAPTERS", { enumerable: true, get: function () { return builtin_adapters_1.BUILTIN_ADAPTERS; } });
 var snapshot_1 = require("./snapshot");
 Object.defineProperty(exports, "computeStateSnapshot", { enumerable: true, get: function () { return snapshot_1.computeStateSnapshot; } });
 Object.defineProperty(exports, "serializeSnapshot", { enumerable: true, get: function () { return snapshot_1.serializeSnapshot; } });

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACU,QAAA,WAAW,GAAG,SAAkB,CAAC;AAE9C,mCAAgG;AAAvF,sGAAA,YAAY,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAC7E,uCAA6D;AAApD,uGAAA,WAAW,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AACxC,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AAExB,6CAAoE;AAA3D,+GAAA,gBAAgB,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAC5C,6CAAmE;AAA1D,0GAAA,WAAW,OAAA;AAAE,oHAAA,qBAAqB,OAAA;AAE3C,6CAAqE;AAA5D,iHAAA,kBAAkB,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAE7C,uCAAyF;AAAhF,wGAAA,YAAY,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA;AACpE,mCAA8I;AAArI,6GAAA,mBAAmB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAAE,uGAAA,aAAa,OAAA;AAE3H,mCAAyF;AAAhF,qGAAA,WAAW,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAEtE,yCAUqB;AATnB,sGAAA,SAAS,OAAA;AACT,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,4GAAA,eAAe,OAAA;AACf,6GAAA,gBAAgB,OAAA;AAChB,qHAAA,wBAAwB,OAAA;AACxB,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AACtB,kHAAA,qBAAqB,OAAA;AAGvB,2DAA8G;AAArG,iIAAA,2BAA2B,OAAA;AAAE,2HAAA,qBAAqB,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAE/E,uCAAqE;AAA5D,gHAAA,oBAAoB,OAAA;AAAE,6GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;;AAAA;;;;;;GAMG;AACU,QAAA,WAAW,GAAG,SAAkB,CAAC;AAE9C,mCAAwJ;AAA/I,sGAAA,YAAY,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AACrI,uCAA6D;AAApD,uGAAA,WAAW,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AACxC,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AAExB,uGAAuG;AACvG,2FAA2F;AAC3F,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AACzB,6CAAmE;AAA1D,0GAAA,WAAW,OAAA;AAAE,oHAAA,qBAAqB,OAAA;AAE3C,6CAAqE;AAA5D,iHAAA,kBAAkB,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAE7C,uCAAyF;AAAhF,wGAAA,YAAY,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA;AACpE,mCAA2Y;AAAlY,6GAAA,mBAAmB,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAGxX,qCAAoE;AAA3D,wGAAA,aAAa,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAEhD,6CAAmG;AAA1F,mHAAA,oBAAoB,OAAA;AAAE,6GAAA,cAAc,OAAA;AAAE,2HAAA,4BAA4B,OAAA;AAC3E,uCAAiG;AAAxF,+GAAA,mBAAmB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,sGAAA,UAAU,OAAA;AAAE,2GAAA,eAAe,OAAA;AAE5E,mCAAyF;AAAhF,qGAAA,WAAW,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAEtE,yCAYqB;AAXnB,sGAAA,SAAS,OAAA;AACT,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,4GAAA,eAAe,OAAA;AACf,6GAAA,gBAAgB,OAAA;AAChB,qHAAA,wBAAwB,OAAA;AACxB,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AACtB,kHAAA,qBAAqB,OAAA;AACrB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA;AAGrB,2DAA8G;AAArG,iIAAA,2BAA2B,OAAA;AAAE,2HAAA,qBAAqB,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAE/E,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,uCAAqE;AAA5D,gHAAA,oBAAoB,OAAA;AAAE,6GAAA,iBAAiB,OAAA"}

package/dist/storage/layout.d.ts

@@ -6,7 +6,7 @@ export declare const INIT_COMMIT_MESSAGE = "chore(wingfoil): initialize .wingfoi
 export interface ScaffoldFile {
     /** Path relative to the project root, always under `.wingfoil/`, POSIX-separated. */
     readonly path: string;
-    /** Initial file content written verbatim (bytes-only — see {@link writeDocument}). */
+    /** Initial file content written verbatim (bytes-only, written by {@link writeAndCommit}). */
     readonly content: string;
 }
 /**
@@ -40,7 +40,7 @@ export interface ScaffoldFile {
 export declare function scaffoldFiles(): ScaffoldFile[];
 /**
  * Write every file in `files` (default: {@link scaffoldFiles}) under `root` and stage exactly those
- * paths as a **single** commit (via {@link commitPaths}), returning the new commit's sha.
+ * paths as a **single** commit (via {@link writeAndCommit}, which also puts the files back when git refuses that commit — task-210, `bug-217`), returning the new commit's sha.
  *
  * Pure mechanism: it assumes `root` is already a validated git root (the "not a git repository" guard
  * and the git-identity pre-flight live in the `CoreResult` wrapper, `src/core/init.ts`, so both the

package/dist/storage/layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/storage/layout.ts"],"names":[],"mappings":"AAkBA,sGAAsG;AACtG,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,qGAAqG;AACrG,eAAO,MAAM,mBAAmB,0DAA0D,CAAC;AAE3F,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAS9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,SAAS,YAAY,EAAoB,EAChD,OAAO,GAAE,MAA4B,GACpC,MAAM,CAKR"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/storage/layout.ts"],"names":[],"mappings":"AAeA,sGAAsG;AACtG,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,qGAAqG;AACrG,eAAO,MAAM,mBAAmB,0DAA0D,CAAC;AAE3F,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAS9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,SAAS,YAAY,EAAoB,EAChD,OAAO,GAAE,MAA4B,GACpC,MAAM,CAER"}

package/dist/storage/layout.js

@@ -16,9 +16,7 @@ exports.initStorage = initStorage;
  * task-029's wizard can pass its own richer, spec-011-complete file set (with real content) through
  * the exact same write+commit path.
  */
-const path_1 = require("path");
 const commit_1 = require("./commit");
-const document_1 = require("./document");
 /** The WingFoil root directory name, relative to the project (git) root (spec-011-storage-layout). */
 exports.WINGFOIL_DIR = '.wingfoil';
 /** Default git subject for the one commit `initStorage` produces (overridable via `initStorage`). */
@@ -72,7 +70,7 @@ function scaffoldFiles() {
 }
 /**
  * Write every file in `files` (default: {@link scaffoldFiles}) under `root` and stage exactly those
- * paths as a **single** commit (via {@link commitPaths}), returning the new commit's sha.
+ * paths as a **single** commit (via {@link writeAndCommit}, which also puts the files back when git refuses that commit — task-210, `bug-217`), returning the new commit's sha.
  *
  * Pure mechanism: it assumes `root` is already a validated git root (the "not a git repository" guard
  * and the git-identity pre-flight live in the `CoreResult` wrapper, `src/core/init.ts`, so both the
@@ -80,9 +78,6 @@ function scaffoldFiles() {
  * `git add -A`, so no unrelated working-tree change is swept into the init commit.
  */
 function initStorage(root, files = scaffoldFiles(), message = exports.INIT_COMMIT_MESSAGE) {
-    for (const file of files) {
-        (0, document_1.writeDocument)((0, path_1.join)(root, file.path), file.content);
-    }
-    return (0, commit_1.commitPaths)(root, files.map((file) => file.path), message);
+    return (0, commit_1.writeAndCommit)(root, files.map((file) => ({ path: file.path, content: file.content })), message);
 }
 //# sourceMappingURL=layout.js.map

package/dist/storage/layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/storage/layout.ts"],"names":[],"mappings":";;;AAsEA,sCASC;AAWD,kCASC;AAnGD;;;;;;;;;;;;GAYG;AACH,+BAA4B;AAE5B,qCAAuC;AACvC,yCAA2C;AAE3C,sGAAsG;AACzF,QAAA,YAAY,GAAG,WAAW,CAAC;AAExC,qGAAqG;AACxF,QAAA,mBAAmB,GAAG,uDAAuD,CAAC;AAU3F,qGAAqG;AACrG,oGAAoG;AACpG,MAAM,QAAQ,GAAG,+EAA+E,CAAC;AACjG,MAAM,WAAW,GAAG,6EAA6E,CAAC;AAClG,MAAM,cAAc,GAAG,+EAA+E,CAAC;AACvG,qGAAqG;AACrG,oGAAoG;AACpG,4FAA4F;AAC5F,MAAM,OAAO,GAAG,EAAE,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,aAAa;IAC3B,OAAO;QACL,EAAE,IAAI,EAAE,GAAG,oBAAY,+BAA+B,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1E,EAAE,IAAI,EAAE,GAAG,oBAAY,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE;QACxE,EAAE,IAAI,EAAE,GAAG,oBAAY,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE;QACvD,EAAE,IAAI,EAAE,GAAG,oBAAY,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE;QAC7D,EAAE,IAAI,EAAE,GAAG,oBAAY,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE;QAC7D,EAAE,IAAI,EAAE,GAAG,oBAAY,iBAAiB,EAAE,OAAO,EAAE,cAAc,EAAE;KACpE,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,WAAW,CACzB,IAAY,EACZ,QAAiC,aAAa,EAAE,EAChD,UAAkB,2BAAmB;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAA,wBAAa,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAA,oBAAW,EAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/storage/layout.ts"],"names":[],"mappings":";;;AAmEA,sCASC;AAWD,kCAMC;AA7FD;;;;;;;;;;;;GAYG;AACH,qCAA0C;AAE1C,sGAAsG;AACzF,QAAA,YAAY,GAAG,WAAW,CAAC;AAExC,qGAAqG;AACxF,QAAA,mBAAmB,GAAG,uDAAuD,CAAC;AAU3F,qGAAqG;AACrG,oGAAoG;AACpG,MAAM,QAAQ,GAAG,+EAA+E,CAAC;AACjG,MAAM,WAAW,GAAG,6EAA6E,CAAC;AAClG,MAAM,cAAc,GAAG,+EAA+E,CAAC;AACvG,qGAAqG;AACrG,oGAAoG;AACpG,4FAA4F;AAC5F,MAAM,OAAO,GAAG,EAAE,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,aAAa;IAC3B,OAAO;QACL,EAAE,IAAI,EAAE,GAAG,oBAAY,+BAA+B,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1E,EAAE,IAAI,EAAE,GAAG,oBAAY,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE;QACxE,EAAE,IAAI,EAAE,GAAG,oBAAY,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE;QACvD,EAAE,IAAI,EAAE,GAAG,oBAAY,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE;QAC7D,EAAE,IAAI,EAAE,GAAG,oBAAY,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE;QAC7D,EAAE,IAAI,EAAE,GAAG,oBAAY,iBAAiB,EAAE,OAAO,EAAE,cAAc,EAAE;KACpE,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,WAAW,CACzB,IAAY,EACZ,QAAiC,aAAa,EAAE,EAChD,UAAkB,2BAAmB;IAErC,OAAO,IAAA,uBAAc,EAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1G,CAAC"}

package/dist/storage/memory-path.d.ts

@@ -6,6 +6,15 @@
  *   the first).
  */
 export declare function renderMemoryPath(pattern: string, values: Record<string, string>): string;
+/**
+ * The folder a type's `path` pattern confines its documents to — its **static prefix** (task-281, `bug-325`):
+ * the pattern up to and including the last `/` before its first `{`; the directory part of the pattern when
+ * it holds no `{`; `''` when the first `{` lies in the first segment (no folder narrower than the root).
+ *
+ * `docs/05_plans/{scope}/{id}.md` → `docs/05_plans/`; `docs/04_memory/planning/rl-{release-line}/{id}.md` →
+ * `docs/04_memory/planning/`; `{scope}/{id}.md` → `''`; `docs/fixed.md` → `docs/`.
+ */
+export declare function pathPatternFolder(pattern: string): string;
 /** Render `pattern` (see {@link renderMemoryPath}) and resolve it to an absolute path under `root`. */
 export declare function resolveMemoryPath(root: string, pattern: string, values: Record<string, string>): string;
 /**
@@ -38,11 +47,11 @@ export declare function resolveMemoryPath(root: string, pattern: string, values:
  *    yet created: `resolveRealPathInRoot` resolves as far as the filesystem goes and keeps the
  *    missing tail verbatim, which is exactly this case — the document is about to be created.
  *
- * The second read resolves against the **working tree** rather than `HEAD`, deliberately and against
- * `command-baseline`'s general rule for a gating read. The argument is `task-102`'s, recorded in
- * `dl-086-a-guard-over-a-filesystem-effect-resolves-on-the-filesystem` (`in-discussion`) and not
- * re-derived here: what this predicts is where `writeFileSync` will land, and it follows the symlinks
- * that are on disk, not the ones a commit records.
+ * The second read resolves against the **working tree** rather than `HEAD`, deliberately: it is the
+ * filesystem-effect read `command-baseline` and `spec-006-core-domain-api` §6 declare, ratified in
+ * `dl-086-a-guard-over-a-filesystem-effect-resolves-on-the-filesystem` from `task-102`'s argument,
+ * which is not re-derived here: what this predicts is where `writeFileSync` will land, and it follows
+ * the symlinks that are on disk, not the ones a commit records.
  *
  * **The target's parent is resolved; its own name is not** — the asymmetry is
  * {@link resolveRealPathInRoot}'s contract (see that function), and it is the reason this returns a
@@ -64,6 +73,10 @@ export declare function resolveMemoryPath(root: string, pattern: string, values:
  * @throws {@link StorageError} `E_PATH_ESCAPES_ROOT` (message: {@link CONFINEMENT_MESSAGE} plus the
  *   two spellings of the path, since the two differing is the finding) when the resolved path is the
  *   root itself, escapes it textually, or lands outside it on the filesystem.
+ * @throws {@link StorageError} `E_PATH_OUTSIDE_TYPE_FOLDER` when the path, normalized, stays inside the root but
+ *   not under {@link pathPatternFolder} of `pattern` — the type's folder (task-281, `bug-325`). Checked after
+ *   the two root checks, so a root escape keeps `E_PATH_ESCAPES_ROOT`; the message names every token of the
+ *   pattern with its value.
  * @throws {@link StorageError} `E_TARGET_IS_SYMLINK` (message: `symlinkTargetRefusal`, shared with
  *   the transition verbs' `CoreResult` refusal) when the target itself is a symbolic link —
  *   including a **dangling** one, which `existsSync` cannot see.

package/dist/storage/memory-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-path.d.ts","sourceRoot":"","sources":["../../src/storage/memory-path.ts"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiBxF;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAsBR"}
+{"version":3,"file":"memory-path.d.ts","sourceRoot":"","sources":["../../src/storage/memory-path.ts"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiBxF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIzD;AAaD,uGAAuG;AACvG,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAgCR"}

package/dist/storage/memory-path.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderMemoryPath = renderMemoryPath;
+exports.pathPatternFolder = pathPatternFolder;
 exports.resolveMemoryPath = resolveMemoryPath;
 exports.resolveConfinedMemoryPath = resolveConfinedMemoryPath;
 /**
@@ -43,6 +44,30 @@ function renderMemoryPath(pattern, values) {
     }
     return rendered;
 }
+/**
+ * The folder a type's `path` pattern confines its documents to — its **static prefix** (task-281, `bug-325`):
+ * the pattern up to and including the last `/` before its first `{`; the directory part of the pattern when
+ * it holds no `{`; `''` when the first `{` lies in the first segment (no folder narrower than the root).
+ *
+ * `docs/05_plans/{scope}/{id}.md` → `docs/05_plans/`; `docs/04_memory/planning/rl-{release-line}/{id}.md` →
+ * `docs/04_memory/planning/`; `{scope}/{id}.md` → `''`; `docs/fixed.md` → `docs/`.
+ */
+function pathPatternFolder(pattern) {
+    const brace = pattern.indexOf('{');
+    const end = brace === -1 ? pattern.length : brace;
+    return pattern.slice(0, pattern.lastIndexOf('/', end - 1) + 1);
+}
+/**
+ * Whether the normalized root-relative `path` lies strictly under `folder`. An empty folder confines nothing
+ * beyond the root: a path that climbs out of it or is absolute was already refused by the root checks, which
+ * run first.
+ */
+function liesUnder(path, folder) {
+    if (folder === '')
+        return true;
+    const prefix = path_1.posix.normalize(folder);
+    return path.startsWith(prefix) && path.length > prefix.length;
+}
 /** Render `pattern` (see {@link renderMemoryPath}) and resolve it to an absolute path under `root`. */
 function resolveMemoryPath(root, pattern, values) {
     return (0, path_1.join)(root, renderMemoryPath(pattern, values));
@@ -77,11 +102,11 @@ function resolveMemoryPath(root, pattern, values) {
  *    yet created: `resolveRealPathInRoot` resolves as far as the filesystem goes and keeps the
  *    missing tail verbatim, which is exactly this case — the document is about to be created.
  *
- * The second read resolves against the **working tree** rather than `HEAD`, deliberately and against
- * `command-baseline`'s general rule for a gating read. The argument is `task-102`'s, recorded in
- * `dl-086-a-guard-over-a-filesystem-effect-resolves-on-the-filesystem` (`in-discussion`) and not
- * re-derived here: what this predicts is where `writeFileSync` will land, and it follows the symlinks
- * that are on disk, not the ones a commit records.
+ * The second read resolves against the **working tree** rather than `HEAD`, deliberately: it is the
+ * filesystem-effect read `command-baseline` and `spec-006-core-domain-api` §6 declare, ratified in
+ * `dl-086-a-guard-over-a-filesystem-effect-resolves-on-the-filesystem` from `task-102`'s argument,
+ * which is not re-derived here: what this predicts is where `writeFileSync` will land, and it follows
+ * the symlinks that are on disk, not the ones a commit records.
  *
  * **The target's parent is resolved; its own name is not** — the asymmetry is
  * {@link resolveRealPathInRoot}'s contract (see that function), and it is the reason this returns a
@@ -103,6 +128,10 @@ function resolveMemoryPath(root, pattern, values) {
  * @throws {@link StorageError} `E_PATH_ESCAPES_ROOT` (message: {@link CONFINEMENT_MESSAGE} plus the
  *   two spellings of the path, since the two differing is the finding) when the resolved path is the
  *   root itself, escapes it textually, or lands outside it on the filesystem.
+ * @throws {@link StorageError} `E_PATH_OUTSIDE_TYPE_FOLDER` when the path, normalized, stays inside the root but
+ *   not under {@link pathPatternFolder} of `pattern` — the type's folder (task-281, `bug-325`). Checked after
+ *   the two root checks, so a root escape keeps `E_PATH_ESCAPES_ROOT`; the message names every token of the
+ *   pattern with its value.
  * @throws {@link StorageError} `E_TARGET_IS_SYMLINK` (message: `symlinkTargetRefusal`, shared with
  *   the transition verbs' `CoreResult` refusal) when the target itself is a symbolic link —
  *   including a **dangling** one, which `existsSync` cannot see.
@@ -119,6 +148,13 @@ function resolveConfinedMemoryPath(root, pattern, values) {
         throw new errors_1.StorageError(errors_1.E_PATH_ESCAPES_ROOT, `${CONFINEMENT_MESSAGE}: '${rendered}' resolves to '${onDisk.real}', outside the project root — ` +
             'a directory on the way to it is a symlink leaving the project.');
     }
+    const normalized = path_1.posix.normalize(rendered);
+    const folder = pathPatternFolder(pattern);
+    if (!liesUnder(normalized, folder)) {
+        const tokens = [...new Set([...pattern.matchAll(PLACEHOLDER_RE)].map((match) => match[1]))];
+        const listed = tokens.map((token) => `{${token}}=${JSON.stringify(values[token])}`).join(', ');
+        throw new errors_1.StorageError(errors_1.E_PATH_OUTSIDE_TYPE_FOLDER, `Memory entries must reside in their type's folder: '${rendered}' resolves to '${normalized}', outside '${folder}' (path '${pattern}': ${listed})`);
+    }
     if ((0, confinement_1.targetIsSymlink)(target)) {
         throw new errors_1.StorageError(errors_1.E_TARGET_IS_SYMLINK, (0, confinement_1.symlinkTargetRefusal)('create', rendered));
     }

package/dist/storage/memory-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-path.js","sourceRoot":"","sources":["../../src/storage/memory-path.ts"],"names":[],"mappings":";;AA6BA,4CAiBC;AAGD,8CAMC;AA8DD,8DA0BC;AA/ID;;;;;;;;;;;GAWG;AACH,+BAAqC;AAErC,+CAA0G;AAC1G,qCAAwG;AAExG,kGAAkG;AAClG,MAAM,mBAAmB,GAAG,oDAAoD,CAAC;AAEjF,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,OAAe,EAAE,MAA8B;IAC9E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE;QACzE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,qBAAY,CACpB,6BAAoB,EACpB,iBAAiB,OAAO,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3E,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,uGAAuG;AACvG,SAAgB,iBAAiB,CAC/B,IAAY,EACZ,OAAe,EACf,MAA8B;IAE9B,OAAO,IAAA,WAAI,EAAC,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,SAAgB,yBAAyB,CACvC,IAAY,EACZ,OAAe,EACf,MAA8B;IAE9B,MAAM,YAAY,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,IAAA,yBAAW,EAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,qBAAY,CACpB,4BAAmB,EACnB,GAAG,mBAAmB,MAAM,QAAQ,kBAAkB,MAAM,8BAA8B,CAC3F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,mCAAqB,EAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,qBAAY,CACpB,4BAAmB,EACnB,GAAG,mBAAmB,MAAM,QAAQ,kBAAkB,MAAM,CAAC,IAAI,gCAAgC;YAC/F,gEAAgE,CACnE,CAAC;IACJ,CAAC;IACD,IAAI,IAAA,6BAAe,EAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,qBAAY,CAAC,4BAAmB,EAAE,IAAA,kCAAoB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"memory-path.js","sourceRoot":"","sources":["../../src/storage/memory-path.ts"],"names":[],"mappings":"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"}

package/dist/storage/snapshot.js

@@ -12,7 +12,7 @@ exports.serializeSnapshot = serializeSnapshot;
  * `computeStateSnapshot` is a pure function of what's on disk under `root`: every file under
  * `.wingfoil/` in full (DNA/Directives/Workflow config, per spec-011-storage-layout's directory
  * layout) plus every `docs/04_memory/**\/*.md` document's frontmatter only (Memory content — state
- * lives in frontmatter, CLAUDE.md §5 / REQ-STATE-01/-02, so the body text isn't part of "state").
+ * lives in frontmatter, AGENTS.md §5 / REQ-STATE-01/-02, so the body text isn't part of "state").
  * It holds no module-level cache and consults nothing outside `root`, so recomputing it — from the
  * original working copy, from a fresh clone, or from a freshly re-imported module — always yields
  * the same result for the same on-disk bytes.

package/dist/storage/templates.d.ts

@@ -1,3 +1,21 @@
+/**
+ * Methodology templates for `wingfoil init` (task-029-implement-wingfoil-init, P5.1.1,
+ * spec-011-storage-layout). task-018 delivered only the minimal committed skeleton
+ * (`scaffoldFiles()` in ./layout) and EXPLICITLY deferred the complete spec-011 layout — `roles.yaml`,
+ * the `workflows/{built-in,custom}` split, `memory/templates/`, and real starter content — to this
+ * module. `templateScaffold(def)` returns that complete layout as a `ScaffoldFile[]` the same
+ * `initStorage(root, files, message)` write+commit path consumes. (The `directives/{built-in,custom}`
+ * split was deferred here too, until `task-054-project-directives` pulled it back into the minimal
+ * skeleton as well: P3.5 requires it after init, on whichever path ran.)
+ *
+ * A "template" (Scrum, Kanban — the names the P5.1.1 BDD uses as examples) is an AUTHORING starter:
+ * it selects the project's methodologies (written into `dna.yaml` `stacks.methodologies`) and a
+ * methodology-flavoured delivery sub-workflow; it is not a spec-mandated schema. All generated content
+ * is a pure function of the `TemplateDefinition` — no wall-clock, no randomness, no environment read —
+ * so `wingfoil init --template X` is byte-identical run to run (REQ-SYS-07), and the returned list is
+ * sorted by path so callers may diff the set safely.
+ */
+import { type BuiltinAdapterManifest } from './builtin-adapters';
 import { type ScaffoldFile } from './layout';
 /** A methodology starter template: the methodologies it seeds and the delivery sub-workflow it adds. */
 export interface TemplateDefinition {
@@ -24,11 +42,12 @@ export declare function resolveTemplate(name: string): TemplateDefinition | null
 export declare function initProjectCommitMessage(def: TemplateDefinition): string;
 /**
  * Which pillar a {@link BuiltinTemplateSource} belongs to — `directive` for a P3.8 built-in directive
- * `.md` file, `workflow` for a P4.17 built-in workflow `.yaml` file. Drives which pillar schema
- * `core/builtin-integrity.ts`'s `verifyBuiltinTemplates` checks the source against, and which of
- * REQ-SEC-10's two exact abort-message shapes a failure produces.
+ * `.md` file, `workflow` for a P4.17 built-in workflow `.yaml` file, `adapter` for a built-in agent
+ * adapter manifest (`spec-016` §2.1, task-196). Drives which schema `core/builtin-integrity.ts`'s
+ * `verifyBuiltinTemplates` checks the source against, and which REQ-SEC-10 abort message a failure
+ * produces.
  */
-export type BuiltinTemplateKind = 'directive' | 'workflow';
+export type BuiltinTemplateKind = 'directive' | 'workflow' | 'adapter';
 /**
  * One shipped built-in template asset, as raw content — a directive's full `.md` text (frontmatter +
  * body) or a workflow's full `.yaml` text, exactly as it would be written under `.wingfoil/directives/
@@ -46,6 +65,10 @@ export interface BuiltinTemplateSource {
 export declare const BUILTIN_DIRECTIVES_DIR = ".wingfoil/directives/built-in";
 /** Scaffold directory holding the P4.17 built-in workflow templates (spec-011 storage layout). */
 export declare const BUILTIN_WORKFLOWS_DIR = ".wingfoil/workflows/built-in";
+/** Scaffold directory holding the built-in agent adapter manifests (`spec-016` §2.1, task-196). */
+export declare const BUILTIN_ADAPTERS_DIR = ".wingfoil/agents/built-in";
+/** Scaffold directory for the project's own adapter manifests, scaffolded empty (`spec-016` §2.1). */
+export declare const CUSTOM_ADAPTERS_DIR = ".wingfoil/agents/custom";
 /**
  * Derive the built-in template assets to schema-check (REQ-SEC-10) from the very `ScaffoldFile[]`
  * that `initStorage` is about to write — so the CHECKED set and the INSTALLED set are the same set by
@@ -73,7 +96,8 @@ export declare const BUILTIN_WORKFLOWS_DIR = ".wingfoil/workflows/built-in";
  *
  * What it returns is a fact about the scaffold CONTENT, not a property of this function: for
  * {@link templateScaffold} it is the six P3.8 built-in directives `task-057-builtin-directive-templates`
- * ships (`./builtin-directives`, rendered by `builtinDirectiveMd`), for `scaffoldFiles` it is `[]` (a
+ * ships (`./builtin-directives`, rendered by `builtinDirectiveMd`) plus one `adapter` source per shipped
+ * built-in adapter manifest (`./builtin-adapters`: `claude-code` since task-236), for `scaffoldFiles` it is `[]` (a
  * `.gitkeep` only), and the workflows built-in directory still holds a `.gitkeep` only. Any asset added
  * later is checked with no edit here. Each shipped built-in must satisfy its pillar schema on its own —
  * `test/storage/builtin-directives.test.ts` runs every directive template through the real guard.
@@ -83,6 +107,9 @@ export declare function builtinTemplateSources(files: readonly ScaffoldFile[]):
  * The COMPLETE spec-011 `.wingfoil/` layout for `def`, as a `ScaffoldFile[]` sorted by path
  * (deterministic — REQ-SYS-07). Consumed by `initStorage(root, files, message)`; every path is under
  * `.wingfoil/` so init never writes outside the WingFoil root.
+ *
+ * @param adapters - the built-in adapter manifests to install; {@link BUILTIN_ADAPTERS} (the shipped
+ *   list) unless a test passes a fixture list, since no real built-in ships yet (task-196).
  */
-export declare function templateScaffold(def: TemplateDefinition): ScaffoldFile[];
+export declare function templateScaffold(def: TemplateDefinition, adapters?: readonly BuiltinAdapterManifest[]): ScaffoldFile[];
 //# sourceMappingURL=templates.d.ts.map

package/dist/storage/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/storage/templates.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE3D,wGAAwG;AACxG,MAAM,WAAW,kBAAkB;IACjC,oGAAoG;IACpG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAkBD,8FAA8F;AAC9F,eAAO,MAAM,SAAS,EAAE,SAAS,kBAAkB,EAAoB,CAAC;AAExE,kGAAkG;AAClG,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAiC,CAAC;AAE9E,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,EAAE,MAAmB,CAAC;AAEnD,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAGvE;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAExE;AAID;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,kGAAkG;AAClG,eAAO,MAAM,sBAAsB,kCAAwC,CAAC;AAE5E,kGAAkG;AAClG,eAAO,MAAM,qBAAqB,iCAAuC,CAAC;AAyB1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,qBAAqB,EAAE,CAO9F;AA8QD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,YAAY,EAAE,CA2CxE"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/storage/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAYnF,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE3D,wGAAwG;AACxG,MAAM,WAAW,kBAAkB;IACjC,oGAAoG;IACpG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAoBD,8FAA8F;AAC9F,eAAO,MAAM,SAAS,EAAE,SAAS,kBAAkB,EAAoB,CAAC;AAExE,kGAAkG;AAClG,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAiC,CAAC;AAE9E,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,EAAE,MAAmB,CAAC;AAEnD,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAGvE;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAExE;AAID;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,kGAAkG;AAClG,eAAO,MAAM,sBAAsB,kCAAwC,CAAC;AAE5E,kGAAkG;AAClG,eAAO,MAAM,qBAAqB,iCAAuC,CAAC;AAE1E,mGAAmG;AACnG,eAAO,MAAM,oBAAoB,8BAAoC,CAAC;AAEtE,sGAAsG;AACtG,eAAO,MAAM,mBAAmB,4BAAkC,CAAC;AA0BnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,qBAAqB,EAAE,CAO9F;AA0aD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,EACvB,QAAQ,GAAE,SAAS,sBAAsB,EAAqB,GAC7D,YAAY,EAAE,CA6ChB"}