wingfoil 0.2.1 → 0.3.0

package/dist/memory/index.d.ts

@@ -36,23 +36,25 @@
  * `./frontmatter-edit` (byte-preserving field edits) — plus `./submit`, the submit-specific rules.
  */
 export declare const MODULE_NAME: "memory";
-export { MemoryYaml, MemoryTypeEntry, StateMachine, TemplateConfig } from './schema';
-export { ARCHIVED_STATUSES, DEFAULT_STATE_MACHINE, DEPRECATED_STATE, E_INVALID_STATE, E_INVALID_TRANSITION, isArchivedStatus, resolveStateMachine, resolveTransitionTarget, resolveTypeTransition, SUPERSEDED_STATE, validateFrontmatterState, } from './state-machine';
+export { MemoryTemplateFrontmatter, MemoryYaml, MemoryTypeEntry, RESERVED_TYPE_NAMES, StateMachine, TemplateConfig } from './schema';
+export { ARCHIVED_STATUSES, DEFAULT_STATE_MACHINE, DEPRECATED_STATE, E_INVALID_STATE, E_INVALID_TRANSITION, isArchivedStatus, isMachineEdge, resolveStateMachine, resolveSupersedeTarget, resolveTransitionTarget, resolveTypeTransition, resolveWaitingTarget, SUPERSEDED_STATE, supersedesEdgeFrom, validateFrontmatterState, } from './state-machine';
 export type { TransitionOp } from './state-machine';
-export { computeMemoryContentRoots, E_EMPTY_SEARCH_QUERY, findMemoryDocumentById, findMemoryDocumentByTypeAndId, listMemoryDocumentPaths, listMemoryDocumentsByType, loadMemoryDocumentSummary, searchMemoryDocuments, validateSearchQuery, } from './query';
-export type { MemoryDocumentFrontmatterSummary, MemoryDocumentSummary, MemorySearchMatch, MemorySearchOptions, } from './query';
+export { computeMemoryContentRoots, E_EMPTY_SEARCH_QUERY, findMemoryDocumentById, findMemoryDocumentByIdAtRev, findMemoryDocumentByTypeAndId, findMemoryDocumentByTypeAndIdAtRev, firstLineOf, listMemoryDocumentPaths, listMemoryDocumentPathsAtRev, listMemoryDocumentsByType, loadMemoryDocuments, loadMemoryDocumentsAtRev, loadTypeDocumentCopiesAtRevs, loadMemoryDocumentSummary, loadMemoryDocumentSummaryAtRev, memoryUnreadableDiagnostic, searchMemoryDocuments, validateSearchQuery, W_MEMORY_UNREADABLE, } from './query';
+export type { TypeDocumentCopy } from './query';
+export type { MemoryDocumentFrontmatterSummary, MemoryDocumentSummary, MemoryIdLookupOptions, MemoryScanOptions, MemorySearchMatch, MemorySearchOptions, MemoryTypeScanOptions, } from './query';
 export { getMemoryHistory } from './history';
-export type { MemoryHistoryEntry } from './history';
+export type { MemoryHistoryEntry, WalkedHistoryEntry } from './history';
 export { writeMemoryEntry } from './entry';
 export type { MemoryEntryWrite } from './entry';
-export { hasNumericToken, nextSequenceNumber, parseTags, renderAddDocument, resolveTypeDirectory, slugifyTitle, } from './add';
-export type { AddDocumentFields } from './add';
-export { formatMemoryCommitMessage, normalizeReason, parseApproverTrailerLine, parseReasonBlock, reasonDefect, reasonDefectMessage, } from './commit-message';
+export { expandFieldTokens, formatIdDate, hasNumericToken, highestSequenceNumber, identDate, idOccupancy, nextSequenceNumber, parseSetOptions, parseTags, readAuthorDate, refBaselineCommits, renderAddDocument, slugifyTitle, unknownSetNames, writtenFields, } from './add';
+export type { AddDocumentFields, IdTokenSources, ParsedSetOptions } from './add';
+export { formatMemoryCommitMessage, normalizeReason, parseApproverTrailerLine, parseReasonBlock, parseVersionTrailer, reasonDefect, reasonDefectMessage, reasonRefusalMessage, } from './commit-message';
 export type { CommitApprover, MemoryCommitMessageInput, ReasonDefect } from './commit-message';
 export { describeDocumentChanges, removeFrontmatterField, setFrontmatterField, verifyDocumentEdit, verifyFrontmatterEdit, } from './frontmatter-edit';
 export type { DocumentScope } from './frontmatter-edit';
-export { missingRequiredFields, REJECTION_REASON_FIELD, renderSubmitDocument } from './submit';
+export { describeSubmitContent, LINE_ENDINGS_ITEM, missingRequiredFields, notApplicableRefusals, REJECTION_REASON_FIELD, renderSubmitDocument, withLineEndingsOf } from './submit';
+export type { NotApplicableProblem, NotApplicableRefusal } from './submit';
 export { renderRejectDocument } from './reject';
-export { auditAttribution, isValidAttribution, parseApprovalMetadata, parseCommitReason, reconstructMemoryTransitions, verifyTransitionConsistency, } from './audit';
-export type { AttributionEntry, ApprovalMetadata, MemoryTransition, ConsistencyMismatch } from './audit';
+export { auditAttribution, CONFIGURATION_SCOPES, isValidAttribution, MEMORY_OPERATIONS, parseApprovalMetadata, parseCommitReason, parseBracketHops, parseMemoryOperation, reconstructMemoryTransitions, verifyTransitionConsistency, } from './audit';
+export type { AttributionEntry, ApprovalMetadata, BracketHop, MemoryTransition, ConsistencyMismatch, IllegalHop, MemoryOperation, ReconstructOptions, TransitionFinding, UnparseableTransition, } from './audit';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,WAAW,EAAG,QAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACrF,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,gCAAgC,EAChC,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,GACb,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"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"}

package/dist/memory/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidAttribution = exports.auditAttribution = exports.renderRejectDocument = exports.renderSubmitDocument = exports.REJECTION_REASON_FIELD = exports.missingRequiredFields = exports.verifyFrontmatterEdit = exports.verifyDocumentEdit = exports.setFrontmatterField = exports.removeFrontmatterField = exports.describeDocumentChanges = exports.reasonDefectMessage = exports.reasonDefect = exports.parseReasonBlock = exports.parseApproverTrailerLine = exports.normalizeReason = exports.formatMemoryCommitMessage = exports.slugifyTitle = exports.resolveTypeDirectory = exports.renderAddDocument = exports.parseTags = exports.nextSequenceNumber = exports.hasNumericToken = exports.writeMemoryEntry = exports.getMemoryHistory = exports.validateSearchQuery = exports.searchMemoryDocuments = exports.loadMemoryDocumentSummary = exports.listMemoryDocumentsByType = exports.listMemoryDocumentPaths = exports.findMemoryDocumentByTypeAndId = exports.findMemoryDocumentById = exports.E_EMPTY_SEARCH_QUERY = exports.computeMemoryContentRoots = exports.validateFrontmatterState = exports.SUPERSEDED_STATE = exports.resolveTypeTransition = exports.resolveTransitionTarget = exports.resolveStateMachine = exports.isArchivedStatus = exports.E_INVALID_TRANSITION = exports.E_INVALID_STATE = exports.DEPRECATED_STATE = exports.DEFAULT_STATE_MACHINE = exports.ARCHIVED_STATUSES = exports.TemplateConfig = exports.StateMachine = exports.MemoryTypeEntry = exports.MemoryYaml = exports.MODULE_NAME = void 0;
-exports.verifyTransitionConsistency = exports.reconstructMemoryTransitions = exports.parseCommitReason = exports.parseApprovalMetadata = void 0;
+exports.nextSequenceNumber = exports.idOccupancy = exports.identDate = exports.highestSequenceNumber = exports.hasNumericToken = exports.formatIdDate = exports.expandFieldTokens = exports.writeMemoryEntry = exports.getMemoryHistory = exports.W_MEMORY_UNREADABLE = exports.validateSearchQuery = exports.searchMemoryDocuments = exports.memoryUnreadableDiagnostic = exports.loadMemoryDocumentSummaryAtRev = exports.loadMemoryDocumentSummary = exports.loadTypeDocumentCopiesAtRevs = exports.loadMemoryDocumentsAtRev = exports.loadMemoryDocuments = exports.listMemoryDocumentsByType = exports.listMemoryDocumentPathsAtRev = exports.listMemoryDocumentPaths = exports.firstLineOf = exports.findMemoryDocumentByTypeAndIdAtRev = exports.findMemoryDocumentByTypeAndId = exports.findMemoryDocumentByIdAtRev = exports.findMemoryDocumentById = exports.E_EMPTY_SEARCH_QUERY = exports.computeMemoryContentRoots = exports.validateFrontmatterState = exports.supersedesEdgeFrom = exports.SUPERSEDED_STATE = exports.resolveWaitingTarget = exports.resolveTypeTransition = exports.resolveTransitionTarget = exports.resolveSupersedeTarget = exports.resolveStateMachine = exports.isMachineEdge = exports.isArchivedStatus = exports.E_INVALID_TRANSITION = exports.E_INVALID_STATE = exports.DEPRECATED_STATE = exports.DEFAULT_STATE_MACHINE = exports.ARCHIVED_STATUSES = exports.TemplateConfig = exports.StateMachine = exports.RESERVED_TYPE_NAMES = exports.MemoryTypeEntry = exports.MemoryYaml = exports.MemoryTemplateFrontmatter = exports.MODULE_NAME = void 0;
+exports.verifyTransitionConsistency = exports.reconstructMemoryTransitions = exports.parseMemoryOperation = exports.parseBracketHops = exports.parseCommitReason = exports.parseApprovalMetadata = exports.MEMORY_OPERATIONS = exports.isValidAttribution = exports.CONFIGURATION_SCOPES = exports.auditAttribution = exports.renderRejectDocument = exports.withLineEndingsOf = exports.renderSubmitDocument = exports.REJECTION_REASON_FIELD = exports.notApplicableRefusals = exports.missingRequiredFields = exports.LINE_ENDINGS_ITEM = exports.describeSubmitContent = exports.verifyFrontmatterEdit = exports.verifyDocumentEdit = exports.setFrontmatterField = exports.removeFrontmatterField = exports.describeDocumentChanges = exports.reasonRefusalMessage = exports.reasonDefectMessage = exports.reasonDefect = exports.parseVersionTrailer = exports.parseReasonBlock = exports.parseApproverTrailerLine = exports.normalizeReason = exports.formatMemoryCommitMessage = exports.writtenFields = exports.unknownSetNames = exports.slugifyTitle = exports.renderAddDocument = exports.refBaselineCommits = exports.readAuthorDate = exports.parseTags = exports.parseSetOptions = void 0;
 /**
  * `memory` module — Project Memory pillar; git-backed documents with per-type state machines
  * (P1.13). `memory.yaml`'s schema (spec-001-memory-yaml-schema) lives here — the pillar owns its own
@@ -41,8 +41,10 @@ exports.verifyTransitionConsistency = exports.reconstructMemoryTransitions = exp
  */
 exports.MODULE_NAME = 'memory';
 var schema_1 = require("./schema");
+Object.defineProperty(exports, "MemoryTemplateFrontmatter", { enumerable: true, get: function () { return schema_1.MemoryTemplateFrontmatter; } });
 Object.defineProperty(exports, "MemoryYaml", { enumerable: true, get: function () { return schema_1.MemoryYaml; } });
 Object.defineProperty(exports, "MemoryTypeEntry", { enumerable: true, get: function () { return schema_1.MemoryTypeEntry; } });
+Object.defineProperty(exports, "RESERVED_TYPE_NAMES", { enumerable: true, get: function () { return schema_1.RESERVED_TYPE_NAMES; } });
 Object.defineProperty(exports, "StateMachine", { enumerable: true, get: function () { return schema_1.StateMachine; } });
 Object.defineProperty(exports, "TemplateConfig", { enumerable: true, get: function () { return schema_1.TemplateConfig; } });
 var state_machine_1 = require("./state-machine");
@@ -52,39 +54,64 @@ Object.defineProperty(exports, "DEPRECATED_STATE", { enumerable: true, get: func
 Object.defineProperty(exports, "E_INVALID_STATE", { enumerable: true, get: function () { return state_machine_1.E_INVALID_STATE; } });
 Object.defineProperty(exports, "E_INVALID_TRANSITION", { enumerable: true, get: function () { return state_machine_1.E_INVALID_TRANSITION; } });
 Object.defineProperty(exports, "isArchivedStatus", { enumerable: true, get: function () { return state_machine_1.isArchivedStatus; } });
+Object.defineProperty(exports, "isMachineEdge", { enumerable: true, get: function () { return state_machine_1.isMachineEdge; } });
 Object.defineProperty(exports, "resolveStateMachine", { enumerable: true, get: function () { return state_machine_1.resolveStateMachine; } });
+Object.defineProperty(exports, "resolveSupersedeTarget", { enumerable: true, get: function () { return state_machine_1.resolveSupersedeTarget; } });
 Object.defineProperty(exports, "resolveTransitionTarget", { enumerable: true, get: function () { return state_machine_1.resolveTransitionTarget; } });
 Object.defineProperty(exports, "resolveTypeTransition", { enumerable: true, get: function () { return state_machine_1.resolveTypeTransition; } });
+Object.defineProperty(exports, "resolveWaitingTarget", { enumerable: true, get: function () { return state_machine_1.resolveWaitingTarget; } });
 Object.defineProperty(exports, "SUPERSEDED_STATE", { enumerable: true, get: function () { return state_machine_1.SUPERSEDED_STATE; } });
+Object.defineProperty(exports, "supersedesEdgeFrom", { enumerable: true, get: function () { return state_machine_1.supersedesEdgeFrom; } });
 Object.defineProperty(exports, "validateFrontmatterState", { enumerable: true, get: function () { return state_machine_1.validateFrontmatterState; } });
 var query_1 = require("./query");
 Object.defineProperty(exports, "computeMemoryContentRoots", { enumerable: true, get: function () { return query_1.computeMemoryContentRoots; } });
 Object.defineProperty(exports, "E_EMPTY_SEARCH_QUERY", { enumerable: true, get: function () { return query_1.E_EMPTY_SEARCH_QUERY; } });
 Object.defineProperty(exports, "findMemoryDocumentById", { enumerable: true, get: function () { return query_1.findMemoryDocumentById; } });
+Object.defineProperty(exports, "findMemoryDocumentByIdAtRev", { enumerable: true, get: function () { return query_1.findMemoryDocumentByIdAtRev; } });
 Object.defineProperty(exports, "findMemoryDocumentByTypeAndId", { enumerable: true, get: function () { return query_1.findMemoryDocumentByTypeAndId; } });
+Object.defineProperty(exports, "findMemoryDocumentByTypeAndIdAtRev", { enumerable: true, get: function () { return query_1.findMemoryDocumentByTypeAndIdAtRev; } });
+Object.defineProperty(exports, "firstLineOf", { enumerable: true, get: function () { return query_1.firstLineOf; } });
 Object.defineProperty(exports, "listMemoryDocumentPaths", { enumerable: true, get: function () { return query_1.listMemoryDocumentPaths; } });
+Object.defineProperty(exports, "listMemoryDocumentPathsAtRev", { enumerable: true, get: function () { return query_1.listMemoryDocumentPathsAtRev; } });
 Object.defineProperty(exports, "listMemoryDocumentsByType", { enumerable: true, get: function () { return query_1.listMemoryDocumentsByType; } });
+Object.defineProperty(exports, "loadMemoryDocuments", { enumerable: true, get: function () { return query_1.loadMemoryDocuments; } });
+Object.defineProperty(exports, "loadMemoryDocumentsAtRev", { enumerable: true, get: function () { return query_1.loadMemoryDocumentsAtRev; } });
+Object.defineProperty(exports, "loadTypeDocumentCopiesAtRevs", { enumerable: true, get: function () { return query_1.loadTypeDocumentCopiesAtRevs; } });
 Object.defineProperty(exports, "loadMemoryDocumentSummary", { enumerable: true, get: function () { return query_1.loadMemoryDocumentSummary; } });
+Object.defineProperty(exports, "loadMemoryDocumentSummaryAtRev", { enumerable: true, get: function () { return query_1.loadMemoryDocumentSummaryAtRev; } });
+Object.defineProperty(exports, "memoryUnreadableDiagnostic", { enumerable: true, get: function () { return query_1.memoryUnreadableDiagnostic; } });
 Object.defineProperty(exports, "searchMemoryDocuments", { enumerable: true, get: function () { return query_1.searchMemoryDocuments; } });
 Object.defineProperty(exports, "validateSearchQuery", { enumerable: true, get: function () { return query_1.validateSearchQuery; } });
+Object.defineProperty(exports, "W_MEMORY_UNREADABLE", { enumerable: true, get: function () { return query_1.W_MEMORY_UNREADABLE; } });
 var history_1 = require("./history");
 Object.defineProperty(exports, "getMemoryHistory", { enumerable: true, get: function () { return history_1.getMemoryHistory; } });
 var entry_1 = require("./entry");
 Object.defineProperty(exports, "writeMemoryEntry", { enumerable: true, get: function () { return entry_1.writeMemoryEntry; } });
 var add_1 = require("./add");
+Object.defineProperty(exports, "expandFieldTokens", { enumerable: true, get: function () { return add_1.expandFieldTokens; } });
+Object.defineProperty(exports, "formatIdDate", { enumerable: true, get: function () { return add_1.formatIdDate; } });
 Object.defineProperty(exports, "hasNumericToken", { enumerable: true, get: function () { return add_1.hasNumericToken; } });
+Object.defineProperty(exports, "highestSequenceNumber", { enumerable: true, get: function () { return add_1.highestSequenceNumber; } });
+Object.defineProperty(exports, "identDate", { enumerable: true, get: function () { return add_1.identDate; } });
+Object.defineProperty(exports, "idOccupancy", { enumerable: true, get: function () { return add_1.idOccupancy; } });
 Object.defineProperty(exports, "nextSequenceNumber", { enumerable: true, get: function () { return add_1.nextSequenceNumber; } });
+Object.defineProperty(exports, "parseSetOptions", { enumerable: true, get: function () { return add_1.parseSetOptions; } });
 Object.defineProperty(exports, "parseTags", { enumerable: true, get: function () { return add_1.parseTags; } });
+Object.defineProperty(exports, "readAuthorDate", { enumerable: true, get: function () { return add_1.readAuthorDate; } });
+Object.defineProperty(exports, "refBaselineCommits", { enumerable: true, get: function () { return add_1.refBaselineCommits; } });
 Object.defineProperty(exports, "renderAddDocument", { enumerable: true, get: function () { return add_1.renderAddDocument; } });
-Object.defineProperty(exports, "resolveTypeDirectory", { enumerable: true, get: function () { return add_1.resolveTypeDirectory; } });
 Object.defineProperty(exports, "slugifyTitle", { enumerable: true, get: function () { return add_1.slugifyTitle; } });
+Object.defineProperty(exports, "unknownSetNames", { enumerable: true, get: function () { return add_1.unknownSetNames; } });
+Object.defineProperty(exports, "writtenFields", { enumerable: true, get: function () { return add_1.writtenFields; } });
 var commit_message_1 = require("./commit-message");
 Object.defineProperty(exports, "formatMemoryCommitMessage", { enumerable: true, get: function () { return commit_message_1.formatMemoryCommitMessage; } });
 Object.defineProperty(exports, "normalizeReason", { enumerable: true, get: function () { return commit_message_1.normalizeReason; } });
 Object.defineProperty(exports, "parseApproverTrailerLine", { enumerable: true, get: function () { return commit_message_1.parseApproverTrailerLine; } });
 Object.defineProperty(exports, "parseReasonBlock", { enumerable: true, get: function () { return commit_message_1.parseReasonBlock; } });
+Object.defineProperty(exports, "parseVersionTrailer", { enumerable: true, get: function () { return commit_message_1.parseVersionTrailer; } });
 Object.defineProperty(exports, "reasonDefect", { enumerable: true, get: function () { return commit_message_1.reasonDefect; } });
 Object.defineProperty(exports, "reasonDefectMessage", { enumerable: true, get: function () { return commit_message_1.reasonDefectMessage; } });
+Object.defineProperty(exports, "reasonRefusalMessage", { enumerable: true, get: function () { return commit_message_1.reasonRefusalMessage; } });
 var frontmatter_edit_1 = require("./frontmatter-edit");
 Object.defineProperty(exports, "describeDocumentChanges", { enumerable: true, get: function () { return frontmatter_edit_1.describeDocumentChanges; } });
 Object.defineProperty(exports, "removeFrontmatterField", { enumerable: true, get: function () { return frontmatter_edit_1.removeFrontmatterField; } });
@@ -92,16 +119,24 @@ Object.defineProperty(exports, "setFrontmatterField", { enumerable: true, get: f
 Object.defineProperty(exports, "verifyDocumentEdit", { enumerable: true, get: function () { return frontmatter_edit_1.verifyDocumentEdit; } });
 Object.defineProperty(exports, "verifyFrontmatterEdit", { enumerable: true, get: function () { return frontmatter_edit_1.verifyFrontmatterEdit; } });
 var submit_1 = require("./submit");
+Object.defineProperty(exports, "describeSubmitContent", { enumerable: true, get: function () { return submit_1.describeSubmitContent; } });
+Object.defineProperty(exports, "LINE_ENDINGS_ITEM", { enumerable: true, get: function () { return submit_1.LINE_ENDINGS_ITEM; } });
 Object.defineProperty(exports, "missingRequiredFields", { enumerable: true, get: function () { return submit_1.missingRequiredFields; } });
+Object.defineProperty(exports, "notApplicableRefusals", { enumerable: true, get: function () { return submit_1.notApplicableRefusals; } });
 Object.defineProperty(exports, "REJECTION_REASON_FIELD", { enumerable: true, get: function () { return submit_1.REJECTION_REASON_FIELD; } });
 Object.defineProperty(exports, "renderSubmitDocument", { enumerable: true, get: function () { return submit_1.renderSubmitDocument; } });
+Object.defineProperty(exports, "withLineEndingsOf", { enumerable: true, get: function () { return submit_1.withLineEndingsOf; } });
 var reject_1 = require("./reject");
 Object.defineProperty(exports, "renderRejectDocument", { enumerable: true, get: function () { return reject_1.renderRejectDocument; } });
 var audit_1 = require("./audit");
 Object.defineProperty(exports, "auditAttribution", { enumerable: true, get: function () { return audit_1.auditAttribution; } });
+Object.defineProperty(exports, "CONFIGURATION_SCOPES", { enumerable: true, get: function () { return audit_1.CONFIGURATION_SCOPES; } });
 Object.defineProperty(exports, "isValidAttribution", { enumerable: true, get: function () { return audit_1.isValidAttribution; } });
+Object.defineProperty(exports, "MEMORY_OPERATIONS", { enumerable: true, get: function () { return audit_1.MEMORY_OPERATIONS; } });
 Object.defineProperty(exports, "parseApprovalMetadata", { enumerable: true, get: function () { return audit_1.parseApprovalMetadata; } });
 Object.defineProperty(exports, "parseCommitReason", { enumerable: true, get: function () { return audit_1.parseCommitReason; } });
+Object.defineProperty(exports, "parseBracketHops", { enumerable: true, get: function () { return audit_1.parseBracketHops; } });
+Object.defineProperty(exports, "parseMemoryOperation", { enumerable: true, get: function () { return audit_1.parseMemoryOperation; } });
 Object.defineProperty(exports, "reconstructMemoryTransitions", { enumerable: true, get: function () { return audit_1.reconstructMemoryTransitions; } });
 Object.defineProperty(exports, "verifyTransitionConsistency", { enumerable: true, get: function () { return audit_1.verifyTransitionConsistency; } });
 //# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACU,QAAA,WAAW,GAAG,QAAiB,CAAC;AAE7C,mCAAqF;AAA5E,oGAAA,UAAU,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,wGAAA,cAAc,OAAA;AAClE,iDAYyB;AAXvB,kHAAA,iBAAiB,OAAA;AACjB,sHAAA,qBAAqB,OAAA;AACrB,iHAAA,gBAAgB,OAAA;AAChB,gHAAA,eAAe,OAAA;AACf,qHAAA,oBAAoB,OAAA;AACpB,iHAAA,gBAAgB,OAAA;AAChB,oHAAA,mBAAmB,OAAA;AACnB,wHAAA,uBAAuB,OAAA;AACvB,sHAAA,qBAAqB,OAAA;AACrB,iHAAA,gBAAgB,OAAA;AAChB,yHAAA,wBAAwB,OAAA;AAG1B,iCAUiB;AATf,kHAAA,yBAAyB,OAAA;AACzB,6GAAA,oBAAoB,OAAA;AACpB,+GAAA,sBAAsB,OAAA;AACtB,sHAAA,6BAA6B,OAAA;AAC7B,gHAAA,uBAAuB,OAAA;AACvB,kHAAA,yBAAyB,OAAA;AACzB,kHAAA,yBAAyB,OAAA;AACzB,8GAAA,qBAAqB,OAAA;AACrB,4GAAA,mBAAmB,OAAA;AAQrB,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA;AAEzB,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA;AAEzB,6BAOe;AANb,sGAAA,eAAe,OAAA;AACf,yGAAA,kBAAkB,OAAA;AAClB,gGAAA,SAAS,OAAA;AACT,wGAAA,iBAAiB,OAAA;AACjB,2GAAA,oBAAoB,OAAA;AACpB,mGAAA,YAAY,OAAA;AAGd,mDAO0B;AANxB,2HAAA,yBAAyB,OAAA;AACzB,iHAAA,eAAe,OAAA;AACf,0HAAA,wBAAwB,OAAA;AACxB,kHAAA,gBAAgB,OAAA;AAChB,8GAAA,YAAY,OAAA;AACZ,qHAAA,mBAAmB,OAAA;AAGrB,uDAM4B;AAL1B,2HAAA,uBAAuB,OAAA;AACvB,0HAAA,sBAAsB,OAAA;AACtB,uHAAA,mBAAmB,OAAA;AACnB,sHAAA,kBAAkB,OAAA;AAClB,yHAAA,qBAAqB,OAAA;AAGvB,mCAA+F;AAAtF,+GAAA,qBAAqB,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAC5E,mCAAgD;AAAvC,8GAAA,oBAAoB,OAAA;AAC7B,iCAOiB;AANf,yGAAA,gBAAgB,OAAA;AAChB,2GAAA,kBAAkB,OAAA;AAClB,8GAAA,qBAAqB,OAAA;AACrB,0GAAA,iBAAiB,OAAA;AACjB,qHAAA,4BAA4B,OAAA;AAC5B,oHAAA,2BAA2B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"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"}

package/dist/memory/query.d.ts

@@ -1,3 +1,4 @@
+import { type Diagnostic } from '../validation';
 import type { MemoryYaml } from './schema';
 /**
  * Derive the minimal set of root-relative directories a scan needs to walk to see every Memory
@@ -6,10 +7,51 @@ import type { MemoryYaml } from './schema';
  * result never contains redundant, nested roots.
  */
 export declare function computeMemoryContentRoots(memoryYaml: MemoryYaml): string[];
+/** `W_MEMORY_UNREADABLE` (`spec-017` §1.4, §2): a Memory file a scan left out because it cannot read it. */
+export declare const W_MEMORY_UNREADABLE = "W_MEMORY_UNREADABLE";
+/**
+ * The one builder of a {@link W_MEMORY_UNREADABLE} diagnostic, shared by the scan here and by
+ * `spec-017`'s deduction: `spec-003`'s shape, `file` repository-relative, `path` `''` (the whole file),
+ * and `spec-017` §1.4's message `unreadable frontmatter in <file>: <reason>`.
+ */
+export declare function memoryUnreadableDiagnostic(file: string, reason: string): Diagnostic;
+/** The first line of a parse error: js-yaml appends a multi-line excerpt a one-line warning cannot carry. */
+export declare function firstLineOf(message: string): string;
+/** What every tolerant scan takes (task-171). */
+export interface MemoryScanOptions {
+    /**
+     * Told about each file the scan left out because it cannot read it ({@link W_MEMORY_UNREADABLE}), in
+     * path order. A lookup that stops at its match reports only the files it read before it. Omitted:
+     * the files are left out silently.
+     */
+    readonly onDiagnostic?: (diagnostic: Diagnostic) => void;
+}
+/** {@link MemoryScanOptions} plus the archived opt-in of the type-scoped primitives (`dl-038` option 1). */
+export interface MemoryTypeScanOptions extends MemoryScanOptions {
+    /**
+     * Include archived documents (`deprecated`, `superseded`, `isArchivedStatus`). Defaults to `false`,
+     * so a consumer that forgets to filter fails closed (`dl-038` option 1); a consumer that must see
+     * archived content — `wingfoil://memory/{type}/{id}`, REQ-STATE-06's "remaining present" — says so.
+     */
+    readonly includeArchived?: boolean;
+}
+/** {@link MemoryScanOptions} of {@link findMemoryDocumentById}, which alone may follow links. */
+export interface MemoryIdLookupOptions extends MemoryScanOptions {
+    /**
+     * Walk the working tree the way it did before task-171: follow symbolic links and descend into a
+     * nested repository. **Explain-only**: the transition verbs use it to word a refusal already decided
+     * at `HEAD` (`command-baseline`: the working tree may explain a refusal, never decide one), so that a
+     * linked document is refused by the confinement guards by name. No read that decides anything sets
+     * it. Defaults to `false`.
+     */
+    readonly followSymlinks?: boolean;
+}
 /**
  * List every Memory document under `root`, as root-relative POSIX paths, sorted lexicographically
  * (REQ-SYS-07 — deterministic, no unordered iteration). Scans only the directories
- * {@link computeMemoryContentRoots} derives from `memoryYaml`, never the whole project tree.
+ * {@link computeMemoryContentRoots} derives from `memoryYaml`, never the whole project tree. A
+ * symbolic link is not a document and is not listed (task-171, `bug-189`), the same as
+ * {@link listMemoryDocumentPathsAtRev} at a commit.
  */
 export declare function listMemoryDocumentPaths(root: string, memoryYaml: MemoryYaml): string[];
 /** A Memory document's parsed frontmatter (loose — no Zod schema validation, see module doc) + body. */
@@ -22,8 +64,57 @@ export interface MemoryDocumentSummary {
  * Read one Memory document and split it into its parsed frontmatter and body text, without running
  * it through any type's Zod schema — `memory search`/`history` must handle documents of every type
  * and any (even structurally imperfect) state, so this is a read, never a validation.
+ *
+ * This single-file read **throws** `ValidationError` (`E_YAML_PARSE_ERROR`) when the frontmatter does
+ * not parse: its caller named the file. The scans built on it are what is tolerant (task-171,
+ * `bug-031`): each one leaves such a document out and reports it as {@link W_MEMORY_UNREADABLE} to its
+ * {@link MemoryScanOptions.onDiagnostic}, so one malformed document never fails a query about another.
  */
 export declare function loadMemoryDocumentSummary(root: string, relativePath: string): MemoryDocumentSummary;
+/**
+ * Every Memory document **in the working tree** under `root`, parsed — {@link loadMemoryDocumentsAtRev}
+ * for the live files, in {@link listMemoryDocumentPaths}'s sorted order. Archived documents are
+ * included: the caller decides what to drop. A document whose frontmatter does not parse, and a
+ * symbolic link, are left out and reported to `options.onDiagnostic` as {@link W_MEMORY_UNREADABLE}
+ * (task-171, task-253 / `bug-230`), so one malformed document never fails a read of the others.
+ */
+export declare function loadMemoryDocuments(root: string, memoryYaml: MemoryYaml, options?: MemoryScanOptions): MemoryDocumentSummary[];
+/**
+ * Every Memory document **commit `rev` holds**, as root-relative POSIX paths sorted the way
+ * {@link listMemoryDocumentPaths} sorts the working tree's (REQ-SYS-07). A document added after `rev`,
+ * or present only in the working tree, is not listed; nor is a symbolic link (task-171, `bug-189`).
+ *
+ * @throws `RevisionError` when `rev` is malformed or names no commit.
+ */
+export declare function listMemoryDocumentPathsAtRev(root: string, rev: string, memoryYaml: MemoryYaml): string[];
+/**
+ * Every Memory document **commit `rev` holds**, parsed — the paths of
+ * {@link listMemoryDocumentPathsAtRev}, in its order, each read in one batch (`storage.readPathsAtRev`)
+ * and split as {@link loadMemoryDocumentSummary} splits a working-tree file. This is the snapshot a
+ * reader pinned to one commit builds from (`spec-012` §6 relevance, `spec-017` §4 deduction). A
+ * document whose frontmatter does not parse, and a link, are left out and reported (task-171).
+ *
+ * @throws `RevisionError` when `rev` is malformed or names no commit.
+ */
+export declare function loadMemoryDocumentsAtRev(root: string, rev: string, memoryYaml: MemoryYaml, options?: MemoryScanOptions): MemoryDocumentSummary[];
+/**
+ * {@link loadMemoryDocumentsAtRev} for a `sha` already resolved to a commit (`resolveRevision`,
+ * `src/core/revision.ts`): the same scan and parse, without resolving the revision again. A reader that
+ * resolves its commit once and reads several pillars at it (the workflow deduction's snapshot, task-283,
+ * `bug-309`) uses this, so one call spends one `git rev-parse`, not one per loader.
+ *
+ * @param sha - The full sha of a commit, as `resolveRevision` returned it; labels name it.
+ */
+export declare function loadMemoryDocumentsAtCommit(root: string, sha: string, memoryYaml: MemoryYaml, options: MemoryScanOptions): MemoryDocumentSummary[];
+/**
+ * One Memory document **as commit `rev` holds it** — {@link loadMemoryDocumentSummary} at a commit.
+ * `null` when that commit does not hold `relativePath` as a file. Like its working-tree counterpart,
+ * this single-file read throws when the frontmatter does not parse.
+ *
+ * @throws `RevisionError` when `rev` is malformed or names no commit; `ValidationError` when the
+ *   frontmatter does not parse.
+ */
+export declare function loadMemoryDocumentSummaryAtRev(root: string, rev: string, relativePath: string): MemoryDocumentSummary | null;
 /**
  * Resolve a single Memory document by its `id` frontmatter value alone — REQ-PERF-04 /
  * task-009-mcp-resource-fetch-latency's Acceptance Criteria, which name a `wingfoil://memory/{id}`
@@ -32,19 +123,27 @@ export declare function loadMemoryDocumentSummary(root: string, relativePath: st
  * (single document) — there is no bare, single-segment `wingfoil://memory/{id}` form there, and this
  * `{id}` segment would collide with spec-004's `{type}` segment. task-011-mcp-resources-read-only has
  * since replaced the `wingfoil://memory/{id}` *Resource* this primitive originally backed with the
- * conformant `wingfoil://memory/{type}/{id}` form (see {@link findMemoryDocumentByTypeAndId}) — this
- * bare-id primitive itself is left in place (still covered by its own `test/memory/query.test.ts`
- * unit tests and REQ-PERF-04's ported benchmark) as a generic, type-agnostic lookup; nothing in
- * `src/mcp` calls it anymore.
+ * conformant `wingfoil://memory/{type}/{id}` form (see {@link findMemoryDocumentByTypeAndId}). This
+ * bare-id primitive is what `memory history` resolves its `<id>` with, and what the transition verbs
+ * use to explain a refusal; it is neutral about archived documents, since both act on them.
  *
- * A linear scan over every document {@link listMemoryDocumentPaths} returns, in its
- * already-deterministic sorted order, stopping at the first document whose frontmatter `id` matches
+ * A linear scan, in sorted path order, stopping at the first document whose frontmatter `id` matches
  * *exactly* (never a substring — that remains `searchMemoryDocuments`'/task-021's keyword-search
- * surface, not this primitive's). Returns `undefined` — never throws — when no document matches;
- * turning that into a protocol-level "resource not found" failure is the MCP Resource adapter's job
- * (spec-004 §2.2's general unresolvable-URI contract), not this primitive's.
+ * surface, not this primitive's). Returns `undefined` — never throws — when no document matches; a
+ * document it cannot read on the way is reported to `options.onDiagnostic` and skipped (task-171).
  */
-export declare function findMemoryDocumentById(root: string, memoryYaml: MemoryYaml, id: string): MemoryDocumentSummary | undefined;
+export declare function findMemoryDocumentById(root: string, memoryYaml: MemoryYaml, id: string, options?: MemoryIdLookupOptions): MemoryDocumentSummary | undefined;
+/**
+ * {@link findMemoryDocumentById} **at commit `rev`** (task-247, `bug-187`): the first document, in
+ * the sorted path order of {@link listMemoryDocumentPathsAtRev}, whose own frontmatter `id` matches
+ * exactly, with its frontmatter and body as `rev` holds them; `undefined` when that commit holds none.
+ * A document present only in the working tree, or added after `rev`, is never returned. This is the
+ * lookup the Memory transition verbs decide from (`spec-006-core-domain-api` §6 item 1). A document it
+ * cannot read on the way is reported to `options.onDiagnostic` and skipped (task-171).
+ *
+ * @throws `RevisionError` when `rev` is malformed or names no commit.
+ */
+export declare function findMemoryDocumentByIdAtRev(root: string, rev: string, memoryYaml: MemoryYaml, id: string, options?: MemoryScanOptions): MemoryDocumentSummary | undefined;
 /** A Memory document's frontmatter-only summary — spec-004 §2.1's collection-listing shape
  * (id, title, status, tags), deliberately omitting body content to keep listing calls cheap. */
 export interface MemoryDocumentFrontmatterSummary {
@@ -65,8 +164,11 @@ export interface MemoryDocumentFrontmatterSummary {
  * `release`/`release-line` both resolve to `docs/04_memory/planning`; `task`'s own pattern collapses
  * all the way to `docs/04_memory` itself — see {@link computeMemoryContentRoots}'s doc comment), so a
  * directory-only filter would wrongly fold sibling types' documents into this type's collection.
+ *
+ * Archived documents are left out unless `options.includeArchived` (task-171, `dl-038` option 1), and
+ * a document the scan cannot read is reported to `options.onDiagnostic` and skipped.
  */
-export declare function listMemoryDocumentsByType(root: string, memoryYaml: MemoryYaml, type: string): MemoryDocumentFrontmatterSummary[];
+export declare function listMemoryDocumentsByType(root: string, memoryYaml: MemoryYaml, type: string, options?: MemoryTypeScanOptions): MemoryDocumentFrontmatterSummary[];
 /**
  * Resolve a single Memory document by (`type`, `id`) — spec-004 §2.1's `wingfoil://memory/{type}/{id}`
  * single-document addressing (task-011-mcp-resources-read-only, REQ-INT-01), the conformant
@@ -76,10 +178,21 @@ export declare function listMemoryDocumentsByType(root: string, memoryYaml: Memo
  * because that type's path pattern happens to also resolve under the same directory. Returns
  * `undefined` — never throws — when nothing matches; surfacing that as a protocol-level "resource not
  * found" failure is the MCP Resource adapter's job (spec-004 §2.2), not this primitive's.
+ *
+ * An archived document matches only with `options.includeArchived` (task-171, `dl-038` option 1); the
+ * single-document Resource passes it, since REQ-STATE-06 keeps archived content retrievable.
  */
-export declare function findMemoryDocumentByTypeAndId(root: string, memoryYaml: MemoryYaml, type: string, id: string): MemoryDocumentSummary | undefined;
+export declare function findMemoryDocumentByTypeAndId(root: string, memoryYaml: MemoryYaml, type: string, id: string, options?: MemoryTypeScanOptions): MemoryDocumentSummary | undefined;
+/**
+ * {@link findMemoryDocumentByTypeAndId} **at commit `rev`**: the document whose own frontmatter `type`
+ * and `id` match, with its frontmatter and body as `rev` holds them; `undefined` when that commit holds
+ * none, or holds it archived without `options.includeArchived`.
+ *
+ * @throws `RevisionError` when `rev` is malformed or names no commit.
+ */
+export declare function findMemoryDocumentByTypeAndIdAtRev(root: string, rev: string, memoryYaml: MemoryYaml, type: string, id: string, options?: MemoryTypeScanOptions): MemoryDocumentSummary | undefined;
 /** Optional filters/refinements for {@link searchMemoryDocuments}. */
-export interface MemorySearchOptions {
+export interface MemorySearchOptions extends MemoryScanOptions {
     /** Only include documents whose `tags:` frontmatter contains this exact tag. */
     readonly tag?: string;
     /**
@@ -95,14 +208,16 @@ export interface MemorySearchOptions {
 /** One ranked search result — enough for a future CLI/MCP surface to render without re-reading the file. */
 export interface MemorySearchMatch {
     readonly path: string;
-    readonly id?: string;
+    /** Always present: a document with no `id` is not an element and is never a match (task-171, `bug-164`). */
+    readonly id: string;
     readonly title?: string;
     readonly tags: readonly string[];
     readonly status?: string;
     /** The document's frontmatter `type:` field (spec-010-memory-frontmatter-schema base field) —
      * projected here (task-021-implement-memory-search) alongside `status`/`tags` so `memorySearch`'s
-     * `--type` filter can narrow an already-ranked result without a second file read per match. */
-    readonly type?: string;
+     * `--type` filter can narrow an already-ranked result without a second file read per match. Always
+     * present, as `id` is (task-171, `bug-164`). */
+    readonly type: string;
     /** Query matched the title, id, or a tag (P1.12: ranks above a body-only match). */
     readonly metadataMatch: boolean;
     /** Query matched somewhere in the document body. */
@@ -135,8 +250,13 @@ export declare function validateSearchQuery(query: string): void;
  * concern, task-021's, not this primitive's).
  *
  * Ordering is a total, deterministic order (REQ-SYS-07): metadata matches before body-only matches,
- * then by `id` (falling back to `path` when a document has no `id`) ascending — so calling this
- * twice against unchanged state always returns the exact same array.
+ * then by `id`, then by `path` (two files may carry one `id`) ascending — so calling this twice
+ * against unchanged state always returns the exact same array.
+ *
+ * **Only elements, never a throw (task-171).** A match has an `id` and a `type` (`bug-164`); a file
+ * with neither is left out without a report. A document whose frontmatter does not parse, or a
+ * symbolic link, is left out and reported to `options.onDiagnostic` as {@link W_MEMORY_UNREADABLE}
+ * (`bug-031`), so one malformed file never fails a search.
  *
  * **REQ-STATE-06:** a document whose frontmatter `status` is archived — `deprecated` or `superseded`
  * (`isArchivedStatus`, `dl-028`) — is excluded by default, so it never appears in these "default
@@ -147,4 +267,26 @@ export declare function validateSearchQuery(query: string): void;
  * here — see this module's header for why the search set and the context set differ.
  */
 export declare function searchMemoryDocuments(root: string, memoryYaml: MemoryYaml, query: string, options?: MemorySearchOptions): MemorySearchMatch[];
+/** One copy of a document of a type, as one commit holds it (task-274). */
+export interface TypeDocumentCopy {
+    readonly path: string;
+    /** The blob's object name: two commits holding the same oid hold the same bytes. */
+    readonly oid: string;
+    readonly frontmatter: Readonly<Record<string, unknown>>;
+}
+/**
+ * The documents of type `type` each of `revs` holds, one sorted list per revision, in input order —
+ * the read the WIP-limit count across refs takes (`requireWipSlot`, `dl-156` Q1 (a), task-274).
+ *
+ * Narrow and batched, unlike one {@link loadMemoryDocumentsAtRev} per revision (which parses every
+ * document of every type at each commit): only the type's own static directory is listed, every
+ * revision's listing in one batched walk (`listBlobsAtRevs`), every distinct blob read in one batch and
+ * parsed **once** however many revisions hold it. A document counts when its own frontmatter `type` is
+ * `type`, as in every Memory scan. A link, an unparsable document and one written in a newer format are
+ * left out and reported through `options.onDiagnostic` as {@link W_MEMORY_UNREADABLE} (task-171,
+ * task-257), once per blob.
+ *
+ * @throws `StorageError` `E_GIT_READ_FAILED` when a revision names no commit or a batch read fails.
+ */
+export declare function loadTypeDocumentCopiesAtRevs(root: string, revs: readonly string[], memoryYaml: MemoryYaml, type: string, options?: MemoryScanOptions): TypeDocumentCopy[][];
 //# sourceMappingURL=query.d.ts.map

package/dist/memory/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/memory/query.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAkB3C;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAQ1E;AAuBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAMtF;AAED,wGAAwG;AACxG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAYnG;AAUD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,MAAM,GACT,qBAAqB,GAAG,SAAS,CAMnC;AAED;gGACgG;AAChG,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,GACX,gCAAgC,EAAE,CAkBpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,qBAAqB,GAAG,SAAS,CAMnC;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,4GAA4G;AAC5G,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;mGAE+F;IAC/F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;wDACwD;AACxD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMvD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,EAAE,CAqCrB"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/memory/query.ts"],"names":[],"mappings":"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"}