@cleocode/contracts 2026.4.144 → 2026.4.146

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -48,16 +48,20 @@ export type { NexusCteAlias, NexusCteMarkdownTable, NexusCteParams, NexusCtePlac
48
48
  export type { RouteMapEntry, RouteMapResult, ShapeCheckCaller, ShapeCheckResult, ShapeCheckStatus, } from './nexus-route-ops.js';
49
49
  export type { GitLogLinkerResult, LinkTaskResult, SymbolReference, TaskReference, } from './nexus-tasks-bridge-ops.js';
50
50
  export type { CommunityWikiStats, GenerateNexusWikiOptions, NexusWikiResult, WikiDbHandle, WikiStateFile, WikiSymbolRow, } from './nexus-wiki-ops.js';
51
- export type { AdminAdrFindParams, AdminAdrShowParams, AdminAdrSyncParams, AdminBackupListParams, AdminBackupMutateParams, AdminCleanupParams, AdminConfigPresetsParams, AdminConfigSetParams, AdminConfigSetPresetParams, AdminConfigShowParams, AdminContextInjectParams, AdminContextParams, AdminContextPullParams, AdminDashParams, AdminDetectParams, AdminExportParams, AdminHandlerOps, AdminHealthMutateParams, AdminHealthQueryParams, AdminHelpParams, AdminHooksMatrixParams, AdminImportParams, AdminInitParams, AdminInjectGenerateParams, AdminInstallGlobalParams, AdminJobCancelParams, AdminJobStatusParams, AdminLogParams, AdminMapMutateParams, AdminMapQueryParams, AdminMigrateParams, AdminPathsParams, AdminRoadmapParams, AdminSafestopParams, AdminScaffoldHubParams, AdminSequenceParams, AdminSmokeParams, AdminSmokeProviderParams, AdminStatsParams, AdminTokenMutateParams, AdminTokenQueryParams, AdminVersionParams, } from './operations/admin.js';
51
+ export type { AdminAdrFindParams, AdminAdrShowParams, AdminAdrSyncParams, AdminBackupListParams, AdminBackupMutateParams, AdminCleanupParams, AdminConfigPresetsParams, AdminConfigSetParams, AdminConfigSetPresetParams, AdminConfigShowParams, AdminContextInjectParams, AdminContextParams, AdminContextPullParams, AdminDashParams, AdminDetectParams, AdminExportParams, AdminHandlerOps, AdminHealthMutateParams, AdminHealthQueryParams, AdminHelpParams, AdminHooksMatrixParams, AdminImportParams, AdminInitParams, AdminInjectGenerateParams, AdminInstallGlobalParams, AdminJobCancelParams, AdminJobStatusParams, AdminLogParams, AdminMapMutateParams, AdminMapQueryParams, AdminMigrateParams, AdminPathsParams, AdminRoadmapParams, AdminRuntimeParams, AdminRuntimeResult, AdminSafestopParams, AdminScaffoldHubParams, AdminSequenceParams, AdminSmokeParams, AdminSmokeProviderParams, AdminStatsParams, AdminTokenMutateParams, AdminTokenQueryParams, AdminVersionParams, } from './operations/admin.js';
52
+ export type { ConduitInboxMessage, ConduitListenParams, ConduitListenResult, ConduitOps, ConduitPeekParams, ConduitPeekResult, ConduitPublishParams, ConduitPublishResult, ConduitSendParams, ConduitStartParams, ConduitStartResult, ConduitStatusParams, ConduitStatusResult, ConduitStopParams, ConduitStopResult, ConduitSubscribeParams, ConduitSubscribeResult, ConduitTransportKind, } from './operations/conduit.js';
52
53
  export type { ApplyInsightsParams, ApplyInsightsResult, DialecticInsights, DialecticTurn, EvaluateDialecticParams, EvaluateDialecticResult, } from './operations/dialectic.js';
53
54
  export * as ops from './operations/index.js';
54
55
  export type { PassMask, RetrievalActiveTask, RetrievalBundle, RetrievalDecision, RetrievalLearning, RetrievalObservation, RetrievalPattern, RetrievalRequest, RetrievalTokenCounts, SigilCard, } from './operations/memory.js';
56
+ export type { BrainPageNodeEntry, NexusAugmentParams, NexusAugmentResult, NexusBlockersShowParams, NexusBlockersShowResult, NexusBrainAnchorsParams, NexusBrainAnchorsResult, NexusConduitScanParams, NexusConduitScanResult, NexusContractsLinkTasksParams, NexusContractsLinkTasksResult, NexusContractsShowParams, NexusContractsShowResult, NexusContractsSyncParams, NexusContractsSyncResult, NexusDepsEntry, NexusDepsParams, NexusDepsResult, NexusDiscoverHit, NexusDiscoverParams, NexusDiscoverResult, NexusFullContextParams, NexusFullContextResult, NexusGraphEdge, NexusGraphNode, NexusGraphParams, NexusGraphResult, NexusHealthStatus, NexusImpactAffectedNode, NexusImpactFullParams, NexusImpactFullResult, NexusImpactParams, NexusImpactResult, NexusInitParams, NexusInitResult, NexusListParams, NexusListResult, NexusOps, NexusOrphanEntry, NexusOrphansListParams, NexusOrphansListResult, NexusPathShowParams, NexusPathShowResult, NexusPermissionLevel, NexusPermissionSetParams, NexusPermissionSetResult, NexusProjectRecord, NexusProjectStats, NexusReconcileParams, NexusReconcileResult, NexusRegisterParams, NexusRegisterResult, NexusResolveParams, NexusResolveResult, NexusRouteMapParams, NexusRouteMapResult, NexusSearchCodeParams, NexusSearchCodeResult, NexusSearchHit, NexusSearchParams, NexusSearchResult, NexusShapeCheckParams, NexusShapeCheckResult, NexusShareSnapshotExportParams, NexusShareSnapshotExportResult, NexusShareSnapshotImportParams, NexusShareSnapshotImportResult, NexusShareStatusParams, NexusShareStatusResult, NexusSharingStatus, NexusShowParams, NexusShowResult, NexusSigilListParams, NexusSigilListResult, NexusSigilSyncParams, NexusSigilSyncResult, NexusStatusParams, NexusStatusResult, NexusSyncParams, NexusSyncResult, NexusTaskFootprintParams, NexusTaskFootprintResult, NexusTaskRef, NexusTaskSymbolsParams, NexusTaskSymbolsResult, NexusTopEntriesParams, NexusTopEntriesResult, NexusTopEntry, NexusTransferManifest, NexusTransferManifestEntry, NexusTransferMode, NexusTransferOnConflict, NexusTransferOnMissingDep, NexusTransferParams, NexusTransferPreviewParams, NexusTransferPreviewResult, NexusTransferResult, NexusTransferScope, NexusUnregisterParams, NexusUnregisterResult, NexusWhyParams, NexusWhyResult, NexusWikiParams, } from './operations/nexus.js';
55
57
  export type { NexusProfileExportParams, NexusProfileExportResult, NexusProfileGetParams, NexusProfileGetResult, NexusProfileImportParams, NexusProfileImportResult, NexusProfileReinforceParams, NexusProfileReinforceResult, NexusProfileSupersedeParams, NexusProfileSupersedeResult, NexusProfileUpsertParams, NexusProfileUpsertResult, NexusProfileViewParams, NexusProfileViewResult, UserProfileTrait, } from './operations/nexus-user-profile.js';
56
58
  export type { BrainState } from './operations/orchestrate.js';
57
59
  export type { CittyArgDef, OperationParams, ParamCliDef, ParamDef, ParamType, } from './operations/params.js';
58
60
  export { paramsToCittyArgs } from './operations/params.js';
61
+ export type { AllowlistAddParams, AllowlistAddResult, AllowlistListParams, AllowlistListResult, AllowlistRemoveParams, AllowlistRemoveResult, Proposal, ProposeAcceptParams, ProposeAcceptResult, ProposeDiffParams, ProposeDiffResult, ProposeDisableParams, ProposeDisableResult, ProposeEnableParams, ProposeEnableResult, ProposeListParams, ProposeListResult, ProposeRejectParams, ProposeRejectResult, ProposeRunParams, ProposeRunResult, SentientOps, } from './operations/sentient.js';
59
62
  export type { DecisionRecord, SessionBriefingShowParams, SessionBriefingShowResult, SessionContextDriftParams, SessionContextDriftResult, SessionDecisionLogParams, SessionDecisionLogResult, SessionEndParams, SessionEndResult, SessionFindParams, SessionFindResult, SessionGcParams, SessionGcResult, SessionHandoffShowParams, SessionHandoffShowResult, SessionListParams, SessionListResult, SessionOps, SessionRecordAssumptionParams, SessionRecordAssumptionResult, SessionRecordDecisionParams, SessionRecordDecisionResult, SessionResumeParams, SessionResumeResult, SessionShowParams, SessionShowResult, SessionStartParams, SessionStatusParams, SessionStatusResult, SessionSuspendParams, SessionSuspendResult, } from './operations/session.js';
60
63
  export type { TasksAddParams, TasksAddResult, TasksAnalyzeQueryParams, TasksAnalyzeQueryResult, TasksArchiveQueryParams, TasksArchiveQueryResult, TasksBlockersQueryParams, TasksBlockersQueryResult, TasksCancelParams, TasksCancelResult, TasksClaimParams, TasksClaimResult, TasksCompleteQueryParams, TasksCompleteQueryResult, TasksComplexityEstimateParams, TasksComplexityEstimateResult, TasksCurrentParams, TasksCurrentResult, TasksDeleteQueryParams, TasksDeleteQueryResult, TasksDependsParams, TasksDependsResult, TasksFindParams, TasksFindResult, TasksHistoryParams, TasksHistoryResult, TasksImpactParams, TasksImpactResult, TasksLabelListParams, TasksLabelListResult, TasksListParams, TasksListResult, TasksNextQueryParams, TasksNextQueryResult, TasksOps, TasksPlanParams, TasksPlanResult, TasksRelatesAddParams, TasksRelatesAddResult, TasksRelatesParams, TasksRelatesResult, TasksReorderDispatchResult, TasksReorderQueryParams, TasksReparentDispatchResult, TasksReparentQueryParams, TasksRestoreParams, TasksRestoreResult, TasksShowParams, TasksShowResult, TasksStartQueryParams, TasksStartQueryResult, TasksStopQueryParams, TasksStopQueryResult, TasksSyncLinksParams, TasksSyncLinksRemoveParams, TasksSyncLinksRemoveResult, TasksSyncLinksResult, TasksSyncReconcileParams, TasksSyncReconcileResult, TasksTreeDispatchParams, TasksTreeDispatchResult, TasksUnclaimParams, TasksUnclaimResult, TasksUpdateQueryParams, TasksUpdateQueryResult, } from './operations/tasks.js';
64
+ export type { CheckOps, ComplianceMetrics, ValidateArchiveStatsParams, ValidateArchiveStatsResult, ValidateCanonParams, ValidateCanonResult, ValidateChainParams, ValidateChainResult, ValidateCoherenceParams, ValidateCoherenceResult, ValidateComplianceRecordParams, ValidateComplianceRecordResult, ValidateComplianceSummaryParams, ValidateComplianceSummaryResult, ValidateComplianceSyncParams, ValidateComplianceSyncResult, ValidateComplianceViolationsParams, ValidateComplianceViolationsResult, ValidateGateParams, ValidateGateResult, ValidateGradeListParams, ValidateGradeListResult, ValidateGradeParams, ValidateGradeResult, ValidateManifestParams, ValidateManifestResult, ValidateOutputParams, ValidateOutputResult, ValidateProtocolBaseParams, ValidateProtocolParams, ValidateProtocolResult, ValidateSchemaParams, ValidateSchemaResult, ValidateTaskParams, ValidateTaskResult, ValidateTestCoverageParams, ValidateTestCoverageResult, ValidateTestRunParams, ValidateTestRunResult, ValidateTestStatusParams, ValidateTestStatusResult, ValidateVerifyExplainParams, ValidateVerifyExplainResult, ValidateWorkflowComplianceParams, ValidateWorkflowComplianceResult, ValidationSeverity, ValidationViolation, } from './operations/validate.js';
61
65
  export type { ResolvedVariable, SubstitutionContext, SubstitutionOptions, SubstitutionResult, SubstitutionSource, VariableResolver, } from './operations/variable-substitution.js';
62
66
  export type { CreateWorktreeOptions, CreateWorktreeResult, DestroyWorktreeOptions, DestroyWorktreeResult, ListWorktreesOptions, PruneWorktreesOptions, PruneWorktreesResult, WorktreeHook, WorktreeHookResult, WorktreeIncludePattern, WorktreeListEntry, } from './operations/worktree.js';
63
67
  export { assertPeerIdentity, filterPeerIdentities, isPeerIdentity, type PeerIdentity, type PeerKind, } from './peer.js';
@@ -77,6 +81,8 @@ export type { CommandOutputEvidence, FileEvidence, LogEvidence, ScreenshotEviden
77
81
  export { commandOutputEvidenceSchema, fileEvidenceSchema, logEvidenceSchema, screenshotEvidenceSchema, taskEvidenceSchema, testOutputEvidenceSchema, } from './task-evidence.js';
78
82
  export type { MinimalTaskRecord, TaskRecord, TaskRecordRelation, ValidationHistoryEntry, } from './task-record.js';
79
83
  export type { ConflictPolicy, ExternalLinkType, ExternalTask, ExternalTaskLink, ExternalTaskProvider, ExternalTaskStatus, ReconcileAction, ReconcileActionType, ReconcileOptions, ReconcileResult, SyncDirection, } from './task-sync.js';
84
+ export type { ArchiveReasonValue } from './tasks/archive.js';
85
+ export { ARCHIVE_REASON_TOMBSTONE, ARCHIVE_REASON_TOMBSTONE_ENV, ARCHIVE_REASON_VALUES, ArchiveReason, ArchiveReasonSchema, ArchiveReasonTombstoneError, assertArchiveReason, isArchiveTombstoneAllowed, } from './tasks/archive.js';
80
86
  export type { TesseraInstantiationInput, TesseraTemplate, TesseraVariable, } from './tessera.js';
81
87
  export type { AdapterTransportProvider, Transport, TransportConnectConfig, } from './transport.js';
82
88
  export type { ChainShape, ChainValidation, GateCheck, GateContract, GateName, GateResult, ProtocolType, WarpChain, WarpChainExecution, WarpChainInstance, WarpLink, WarpStage, } from './warp-chain.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -38,5 +38,7 @@ TASK_STATUSES, TERMINAL_PIPELINE_STATUSES, TERMINAL_STAGE_STATUSES,
38
38
  // Terminal state sets
39
39
  TERMINAL_TASK_STATUSES, } from './status-registry.js';
40
40
  export { commandOutputEvidenceSchema, fileEvidenceSchema, logEvidenceSchema, screenshotEvidenceSchema, taskEvidenceSchema, testOutputEvidenceSchema, } from './task-evidence.js';
41
+ // === Archive Reason Enum (T1409 — typed z.enum + tombstone guard) ===
42
+ export { ARCHIVE_REASON_TOMBSTONE, ARCHIVE_REASON_TOMBSTONE_ENV, ARCHIVE_REASON_VALUES, ArchiveReason, ArchiveReasonSchema, ArchiveReasonTombstoneError, assertArchiveReason, isArchiveTombstoneAllowed, } from './tasks/archive.js';
41
43
  // === WASM SDK (Rust crate bindings) ===
42
44
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,2DAA2D;AAC3D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AA0DrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAoDhC,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AA0E3D,0BAA0B;AAC1B,OAAO,EACL,gCAAgC,EAChC,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,yBAAyB,EACzB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAmBrB,2DAA2D;AAC3D,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAgCzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAmInB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AA4C7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAkI3D,kEAAkE;AAClE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GAGf,MAAM,WAAW,CAAC;AA6DnB,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAM3C,kDAAkD;AAClD,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,EAClC,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAa9B,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA8C9B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAiD5B,yCAAyC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,2DAA2D;AAC3D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AA0DrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAoDhC,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AA0E3D,0BAA0B;AAC1B,OAAO,EACL,gCAAgC,EAChC,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,yBAAyB,EACzB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAmBrB,2DAA2D;AAC3D,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAgCzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AA+JnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAuJ7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA+M3D,kEAAkE;AAClE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GAGf,MAAM,WAAW,CAAC;AA6DnB,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAM3C,kDAAkD;AAClD,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,EAClC,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAa9B,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA8C9B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAuB5B,uEAAuE;AACvE,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AA4B5B,yCAAyC"}
@@ -61,6 +61,13 @@ export interface UserProfileTrait {
61
61
  export interface NexusProfileViewParams {
62
62
  /** Only return traits with confidence >= this value. Default: 0.0 (all). */
63
63
  minConfidence?: number;
64
+ /**
65
+ * When true, include traits whose `validUntil` has elapsed (superseded entries).
66
+ * Default `false` — view returns only currently-valid traits.
67
+ *
68
+ * @task T1080
69
+ */
70
+ includeSuperseded?: boolean;
64
71
  }
65
72
  /** Result of `nexus.profile.view`. */
66
73
  export interface NexusProfileViewResult {
@@ -1 +1 @@
1
- {"version":3,"file":"nexus-user-profile.d.ts","sourceRoot":"","sources":["../../src/operations/nexus-user-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAMD,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qCAAqC;AACrC,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAChC;AAMD,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,2BAA2B;IAC1C,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,KAAK,EAAE,IAAI,CACT,gBAAgB,EAChB,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,sBAAsB,CAC7E,CAAC;CACH;AAED,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,2BAA2B;IAC1C,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB"}
1
+ {"version":3,"file":"nexus-user-profile.d.ts","sourceRoot":"","sources":["../../src/operations/nexus-user-profile.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,165 @@
1
+ /**
2
+ * Typed archive-reason enum for task archival writes (contracts SSoT).
3
+ *
4
+ * Promotes the `archiveReason` literal-string type into a Zod-validated
5
+ * `z.enum` so every package — core/store, cleo CLI, dispatch, migration
6
+ * tooling — references a single canonical truth. The DB CHECK constraint
7
+ * (T1408 migration `20260424000000_t1408-archive-reason-enum`) enforces
8
+ * the same six values at the SQLite layer; this contract enforces them
9
+ * at the TypeScript and runtime-validation layer.
10
+ *
11
+ * Values (CANONICAL — must match the migration):
12
+ * - `verified` — task reached `status='done'` AND verification
13
+ * gates passed. Trustworthy completion.
14
+ * - `reconciled` — closure was reconciled by an audit/repair pass
15
+ * (BRAIN reconciliation, audit lineage, etc.).
16
+ * - `superseded` — closed because a newer task replaces it
17
+ * (typed merge / dedup outcome).
18
+ * - `shadowed` — closed because a duplicate or shadow record
19
+ * exists; this row is no longer authoritative.
20
+ * - `cancelled` — task reached `status='cancelled'` (verification
21
+ * irrelevant for cancellations).
22
+ * - `completed-unverified` — TOMBSTONE. Closure happened but verification
23
+ * was never run, was incomplete, or failed.
24
+ * ONLY migration backfill paths are permitted to
25
+ * write this value; new code that attempts to
26
+ * stamp it MUST throw {@link ArchiveReasonTombstoneError}.
27
+ *
28
+ * @epic T1407
29
+ * @task T1409
30
+ * @see packages/core/src/store/tasks-schema.ts — DB CHECK constraint
31
+ * @see packages/core/src/tasks/archive.ts — derivation logic
32
+ */
33
+ import { z } from 'zod';
34
+ /**
35
+ * Canonical Zod enum for the six valid `archiveReason` values.
36
+ *
37
+ * Use `ArchiveReason.enum.<value>` to reference a literal in code, or
38
+ * `ArchiveReason.parse(x)` to validate at a trust boundary.
39
+ *
40
+ * @example
41
+ * ```ts
42
+ * import { ArchiveReason } from '@cleocode/contracts';
43
+ *
44
+ * // Reference a literal:
45
+ * const reason = ArchiveReason.enum.verified;
46
+ *
47
+ * // Validate untrusted input:
48
+ * const safe = ArchiveReason.parse(externalInput);
49
+ * ```
50
+ */
51
+ export declare const ArchiveReason: z.ZodEnum<{
52
+ cancelled: "cancelled";
53
+ superseded: "superseded";
54
+ verified: "verified";
55
+ reconciled: "reconciled";
56
+ shadowed: "shadowed";
57
+ "completed-unverified": "completed-unverified";
58
+ }>;
59
+ /**
60
+ * Alias preserved for symmetry with other contracts that suffix with
61
+ * `Schema` (e.g. {@link acceptanceGateSchema}).
62
+ *
63
+ * Identical to {@link ArchiveReason}. Prefer `ArchiveReason` for direct
64
+ * literal access; prefer `ArchiveReasonSchema` when passing the schema
65
+ * object into a generic helper (e.g. `createInsertSchema`).
66
+ */
67
+ export declare const ArchiveReasonSchema: z.ZodEnum<{
68
+ cancelled: "cancelled";
69
+ superseded: "superseded";
70
+ verified: "verified";
71
+ reconciled: "reconciled";
72
+ shadowed: "shadowed";
73
+ "completed-unverified": "completed-unverified";
74
+ }>;
75
+ /**
76
+ * Inferred TypeScript union type for {@link ArchiveReason}.
77
+ *
78
+ * Equivalent to:
79
+ * ```ts
80
+ * type ArchiveReasonValue =
81
+ * | 'verified'
82
+ * | 'reconciled'
83
+ * | 'superseded'
84
+ * | 'shadowed'
85
+ * | 'cancelled'
86
+ * | 'completed-unverified';
87
+ * ```
88
+ */
89
+ export type ArchiveReasonValue = z.infer<typeof ArchiveReason>;
90
+ /**
91
+ * Readonly tuple of all valid archive-reason values, in canonical order.
92
+ *
93
+ * Useful when a Drizzle column or a discriminated union needs the raw
94
+ * tuple form (e.g. `text('archive_reason', { enum: ARCHIVE_REASON_VALUES })`).
95
+ */
96
+ export declare const ARCHIVE_REASON_VALUES: ("cancelled" | "superseded" | "verified" | "reconciled" | "shadowed" | "completed-unverified")[];
97
+ /**
98
+ * The single tombstone value within {@link ArchiveReason}.
99
+ *
100
+ * Writing this value from non-migration code paths MUST throw
101
+ * {@link ArchiveReasonTombstoneError}. The value exists in the enum so the
102
+ * DB CHECK constraint accepts rows backfilled by the migration ingest, but
103
+ * application code (CLI, archive bulk path, single-task archive) must
104
+ * derive a more specific reason (`verified`, `reconciled`, `cancelled`,
105
+ * etc.) before writing.
106
+ */
107
+ export declare const ARCHIVE_REASON_TOMBSTONE: "completed-unverified";
108
+ /**
109
+ * Error thrown when application code attempts to write the tombstone
110
+ * value `'completed-unverified'` outside the permitted migration-backfill
111
+ * path.
112
+ *
113
+ * Acceptance criteria T1407: "Writing 'completed-unverified' from new
114
+ * code throws E_ARCHIVE_REASON_TOMBSTONE; only migration backfill may
115
+ * write it."
116
+ *
117
+ * @example
118
+ * ```ts
119
+ * if (reason === ARCHIVE_REASON_TOMBSTONE && !allowMigrationBackfill) {
120
+ * throw new ArchiveReasonTombstoneError(taskId);
121
+ * }
122
+ * ```
123
+ */
124
+ export declare class ArchiveReasonTombstoneError extends Error {
125
+ readonly code = "E_ARCHIVE_REASON_TOMBSTONE";
126
+ readonly taskId?: string;
127
+ constructor(taskId?: string);
128
+ }
129
+ /**
130
+ * Environment / context flag that callers MUST set to `true` (or to the
131
+ * env var `CLEO_ARCHIVE_ALLOW_TOMBSTONE=1`) before writing the tombstone.
132
+ *
133
+ * Centralized here so every write path uses the same gate constant.
134
+ */
135
+ export declare const ARCHIVE_REASON_TOMBSTONE_ENV = "CLEO_ARCHIVE_ALLOW_TOMBSTONE";
136
+ /**
137
+ * Returns true iff the current process is permitted to write the
138
+ * tombstone value (migration backfill path or owner-override).
139
+ *
140
+ * @internal Used by core/store archive write paths to gate tombstone
141
+ * writes; not part of the public contracts API surface.
142
+ *
143
+ * @remarks
144
+ * The contracts package is a zero-runtime-dependency leaf, so it does
145
+ * not pull in `@types/node`. Accessing `process.env` via
146
+ * `globalThis` keeps the package portable (works in Node, browsers,
147
+ * Deno, Bun, edge runtimes — `process` is undefined off-Node and the
148
+ * function returns `false` there).
149
+ */
150
+ export declare function isArchiveTombstoneAllowed(): boolean;
151
+ /**
152
+ * Validates a candidate archive reason and enforces the tombstone gate.
153
+ *
154
+ * - Rejects values outside the 6-value enum with a Zod error.
155
+ * - Rejects `'completed-unverified'` unless {@link isArchiveTombstoneAllowed}
156
+ * returns `true`.
157
+ *
158
+ * @param reason - candidate archive-reason string
159
+ * @param taskId - optional task id, used in the error message
160
+ * @returns the validated, narrowed {@link ArchiveReasonValue}
161
+ * @throws {@link ArchiveReasonTombstoneError} when reason is the tombstone
162
+ * and the migration-backfill gate is not enabled
163
+ */
164
+ export declare function assertArchiveReason(reason: string, taskId?: string): ArchiveReasonValue;
165
+ //# sourceMappingURL=archive.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/tasks/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa;;;;;;;EAOxB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;EAAgB,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,kGAAwB,CAAC;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,EAAG,sBAA+B,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,gCAAgC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,CAAC,EAAE,MAAM;CAS5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAInD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAMvF"}
@@ -0,0 +1,159 @@
1
+ /**
2
+ * Typed archive-reason enum for task archival writes (contracts SSoT).
3
+ *
4
+ * Promotes the `archiveReason` literal-string type into a Zod-validated
5
+ * `z.enum` so every package — core/store, cleo CLI, dispatch, migration
6
+ * tooling — references a single canonical truth. The DB CHECK constraint
7
+ * (T1408 migration `20260424000000_t1408-archive-reason-enum`) enforces
8
+ * the same six values at the SQLite layer; this contract enforces them
9
+ * at the TypeScript and runtime-validation layer.
10
+ *
11
+ * Values (CANONICAL — must match the migration):
12
+ * - `verified` — task reached `status='done'` AND verification
13
+ * gates passed. Trustworthy completion.
14
+ * - `reconciled` — closure was reconciled by an audit/repair pass
15
+ * (BRAIN reconciliation, audit lineage, etc.).
16
+ * - `superseded` — closed because a newer task replaces it
17
+ * (typed merge / dedup outcome).
18
+ * - `shadowed` — closed because a duplicate or shadow record
19
+ * exists; this row is no longer authoritative.
20
+ * - `cancelled` — task reached `status='cancelled'` (verification
21
+ * irrelevant for cancellations).
22
+ * - `completed-unverified` — TOMBSTONE. Closure happened but verification
23
+ * was never run, was incomplete, or failed.
24
+ * ONLY migration backfill paths are permitted to
25
+ * write this value; new code that attempts to
26
+ * stamp it MUST throw {@link ArchiveReasonTombstoneError}.
27
+ *
28
+ * @epic T1407
29
+ * @task T1409
30
+ * @see packages/core/src/store/tasks-schema.ts — DB CHECK constraint
31
+ * @see packages/core/src/tasks/archive.ts — derivation logic
32
+ */
33
+ import { z } from 'zod';
34
+ /**
35
+ * Canonical Zod enum for the six valid `archiveReason` values.
36
+ *
37
+ * Use `ArchiveReason.enum.<value>` to reference a literal in code, or
38
+ * `ArchiveReason.parse(x)` to validate at a trust boundary.
39
+ *
40
+ * @example
41
+ * ```ts
42
+ * import { ArchiveReason } from '@cleocode/contracts';
43
+ *
44
+ * // Reference a literal:
45
+ * const reason = ArchiveReason.enum.verified;
46
+ *
47
+ * // Validate untrusted input:
48
+ * const safe = ArchiveReason.parse(externalInput);
49
+ * ```
50
+ */
51
+ export const ArchiveReason = z.enum([
52
+ 'verified',
53
+ 'reconciled',
54
+ 'superseded',
55
+ 'shadowed',
56
+ 'cancelled',
57
+ 'completed-unverified',
58
+ ]);
59
+ /**
60
+ * Alias preserved for symmetry with other contracts that suffix with
61
+ * `Schema` (e.g. {@link acceptanceGateSchema}).
62
+ *
63
+ * Identical to {@link ArchiveReason}. Prefer `ArchiveReason` for direct
64
+ * literal access; prefer `ArchiveReasonSchema` when passing the schema
65
+ * object into a generic helper (e.g. `createInsertSchema`).
66
+ */
67
+ export const ArchiveReasonSchema = ArchiveReason;
68
+ /**
69
+ * Readonly tuple of all valid archive-reason values, in canonical order.
70
+ *
71
+ * Useful when a Drizzle column or a discriminated union needs the raw
72
+ * tuple form (e.g. `text('archive_reason', { enum: ARCHIVE_REASON_VALUES })`).
73
+ */
74
+ export const ARCHIVE_REASON_VALUES = ArchiveReason.options;
75
+ /**
76
+ * The single tombstone value within {@link ArchiveReason}.
77
+ *
78
+ * Writing this value from non-migration code paths MUST throw
79
+ * {@link ArchiveReasonTombstoneError}. The value exists in the enum so the
80
+ * DB CHECK constraint accepts rows backfilled by the migration ingest, but
81
+ * application code (CLI, archive bulk path, single-task archive) must
82
+ * derive a more specific reason (`verified`, `reconciled`, `cancelled`,
83
+ * etc.) before writing.
84
+ */
85
+ export const ARCHIVE_REASON_TOMBSTONE = 'completed-unverified';
86
+ /**
87
+ * Error thrown when application code attempts to write the tombstone
88
+ * value `'completed-unverified'` outside the permitted migration-backfill
89
+ * path.
90
+ *
91
+ * Acceptance criteria T1407: "Writing 'completed-unverified' from new
92
+ * code throws E_ARCHIVE_REASON_TOMBSTONE; only migration backfill may
93
+ * write it."
94
+ *
95
+ * @example
96
+ * ```ts
97
+ * if (reason === ARCHIVE_REASON_TOMBSTONE && !allowMigrationBackfill) {
98
+ * throw new ArchiveReasonTombstoneError(taskId);
99
+ * }
100
+ * ```
101
+ */
102
+ export class ArchiveReasonTombstoneError extends Error {
103
+ code = 'E_ARCHIVE_REASON_TOMBSTONE';
104
+ taskId;
105
+ constructor(taskId) {
106
+ super(taskId
107
+ ? `archiveReason='completed-unverified' is a tombstone — only migration backfill may write it (taskId=${taskId})`
108
+ : "archiveReason='completed-unverified' is a tombstone — only migration backfill may write it");
109
+ this.name = 'ArchiveReasonTombstoneError';
110
+ this.taskId = taskId;
111
+ }
112
+ }
113
+ /**
114
+ * Environment / context flag that callers MUST set to `true` (or to the
115
+ * env var `CLEO_ARCHIVE_ALLOW_TOMBSTONE=1`) before writing the tombstone.
116
+ *
117
+ * Centralized here so every write path uses the same gate constant.
118
+ */
119
+ export const ARCHIVE_REASON_TOMBSTONE_ENV = 'CLEO_ARCHIVE_ALLOW_TOMBSTONE';
120
+ /**
121
+ * Returns true iff the current process is permitted to write the
122
+ * tombstone value (migration backfill path or owner-override).
123
+ *
124
+ * @internal Used by core/store archive write paths to gate tombstone
125
+ * writes; not part of the public contracts API surface.
126
+ *
127
+ * @remarks
128
+ * The contracts package is a zero-runtime-dependency leaf, so it does
129
+ * not pull in `@types/node`. Accessing `process.env` via
130
+ * `globalThis` keeps the package portable (works in Node, browsers,
131
+ * Deno, Bun, edge runtimes — `process` is undefined off-Node and the
132
+ * function returns `false` there).
133
+ */
134
+ export function isArchiveTombstoneAllowed() {
135
+ // biome-ignore lint/suspicious/noExplicitAny: globalThis.process is intentionally untyped — see remarks above.
136
+ const env = globalThis?.process?.env;
137
+ return env?.[ARCHIVE_REASON_TOMBSTONE_ENV] === '1';
138
+ }
139
+ /**
140
+ * Validates a candidate archive reason and enforces the tombstone gate.
141
+ *
142
+ * - Rejects values outside the 6-value enum with a Zod error.
143
+ * - Rejects `'completed-unverified'` unless {@link isArchiveTombstoneAllowed}
144
+ * returns `true`.
145
+ *
146
+ * @param reason - candidate archive-reason string
147
+ * @param taskId - optional task id, used in the error message
148
+ * @returns the validated, narrowed {@link ArchiveReasonValue}
149
+ * @throws {@link ArchiveReasonTombstoneError} when reason is the tombstone
150
+ * and the migration-backfill gate is not enabled
151
+ */
152
+ export function assertArchiveReason(reason, taskId) {
153
+ const parsed = ArchiveReason.parse(reason);
154
+ if (parsed === ARCHIVE_REASON_TOMBSTONE && !isArchiveTombstoneAllowed()) {
155
+ throw new ArchiveReasonTombstoneError(taskId);
156
+ }
157
+ return parsed;
158
+ }
159
+ //# sourceMappingURL=archive.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/tasks/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC;IAClC,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,WAAW;IACX,sBAAsB;CACvB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAkBjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC,OAAO,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAA+B,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,GAAG,4BAA4B,CAAC;IACpC,MAAM,CAAU;IAEzB,YAAY,MAAe;QACzB,KAAK,CACH,MAAM;YACJ,CAAC,CAAC,sGAAsG,MAAM,GAAG;YACjH,CAAC,CAAC,4FAA4F,CACjG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,8BAA8B,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB;IACvC,+GAA+G;IAC/G,MAAM,GAAG,GAAI,UAAkB,EAAE,OAAO,EAAE,GAAqD,CAAC;IAChG,OAAO,GAAG,EAAE,CAAC,4BAA4B,CAAC,KAAK,GAAG,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,MAAe;IACjE,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,wBAAwB,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACxE,MAAM,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cleocode/contracts",
3
- "version": "2026.4.144",
3
+ "version": "2026.4.146",
4
4
  "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
package/src/index.ts CHANGED
@@ -479,6 +479,8 @@ export type {
479
479
  AdminMigrateParams,
480
480
  AdminPathsParams,
481
481
  AdminRoadmapParams,
482
+ AdminRuntimeParams,
483
+ AdminRuntimeResult,
482
484
  AdminSafestopParams,
483
485
  AdminScaffoldHubParams,
484
486
  AdminSequenceParams,
@@ -489,6 +491,32 @@ export type {
489
491
  AdminTokenQueryParams,
490
492
  AdminVersionParams,
491
493
  } from './operations/admin.js';
494
+ // === Conduit Operation Types (T1422 — typed-dispatch migration) ===
495
+ // Re-exported at top level so CLI dispatch can import without the `ops.` namespace hop.
496
+ // Note: ConduitSendResult from operations/conduit.ts is intentionally NOT re-exported
497
+ // here because conduit.ts (transport-layer) already exports a ConduitSendResult of a
498
+ // different shape. Consumers needing the operation-result variant should import via
499
+ // `import type { ConduitOps } from '@cleocode/contracts'` and reference `ConduitOps['send'][1]`.
500
+ export type {
501
+ ConduitInboxMessage,
502
+ ConduitListenParams,
503
+ ConduitListenResult,
504
+ ConduitOps,
505
+ ConduitPeekParams,
506
+ ConduitPeekResult,
507
+ ConduitPublishParams,
508
+ ConduitPublishResult,
509
+ ConduitSendParams,
510
+ ConduitStartParams,
511
+ ConduitStartResult,
512
+ ConduitStatusParams,
513
+ ConduitStatusResult,
514
+ ConduitStopParams,
515
+ ConduitStopResult,
516
+ ConduitSubscribeParams,
517
+ ConduitSubscribeResult,
518
+ ConduitTransportKind,
519
+ } from './operations/conduit.js';
492
520
  // Dialectic Evaluator operation types (T1087 Wave 3)
493
521
  export type {
494
522
  ApplyInsightsParams,
@@ -513,6 +541,113 @@ export type {
513
541
  RetrievalTokenCounts,
514
542
  SigilCard,
515
543
  } from './operations/memory.js';
544
+ // === NEXUS Operation Types (T1424 — typed-dispatch migration, Wave D) ===
545
+ // Re-exported at top level so CLI dispatch can import without the `ops.` namespace hop.
546
+ export type {
547
+ BrainPageNodeEntry,
548
+ NexusAugmentParams,
549
+ NexusAugmentResult,
550
+ NexusBlockersShowParams,
551
+ NexusBlockersShowResult,
552
+ NexusBrainAnchorsParams,
553
+ NexusBrainAnchorsResult,
554
+ NexusConduitScanParams,
555
+ NexusConduitScanResult,
556
+ NexusContractsLinkTasksParams,
557
+ NexusContractsLinkTasksResult,
558
+ NexusContractsShowParams,
559
+ NexusContractsShowResult,
560
+ NexusContractsSyncParams,
561
+ NexusContractsSyncResult,
562
+ NexusDepsEntry,
563
+ NexusDepsParams,
564
+ NexusDepsResult,
565
+ NexusDiscoverHit,
566
+ NexusDiscoverParams,
567
+ NexusDiscoverResult,
568
+ NexusFullContextParams,
569
+ NexusFullContextResult,
570
+ NexusGraphEdge,
571
+ NexusGraphNode,
572
+ NexusGraphParams,
573
+ NexusGraphResult,
574
+ NexusHealthStatus,
575
+ NexusImpactAffectedNode,
576
+ NexusImpactFullParams,
577
+ NexusImpactFullResult,
578
+ NexusImpactParams,
579
+ NexusImpactResult,
580
+ NexusInitParams,
581
+ NexusInitResult,
582
+ NexusListParams,
583
+ NexusListResult,
584
+ NexusOps,
585
+ NexusOrphanEntry,
586
+ NexusOrphansListParams,
587
+ NexusOrphansListResult,
588
+ NexusPathShowParams,
589
+ NexusPathShowResult,
590
+ NexusPermissionLevel,
591
+ NexusPermissionSetParams,
592
+ NexusPermissionSetResult,
593
+ NexusProjectRecord,
594
+ NexusProjectStats,
595
+ NexusReconcileParams,
596
+ NexusReconcileResult,
597
+ NexusRegisterParams,
598
+ NexusRegisterResult,
599
+ NexusResolveParams,
600
+ NexusResolveResult,
601
+ NexusRouteMapParams,
602
+ NexusRouteMapResult,
603
+ NexusSearchCodeParams,
604
+ NexusSearchCodeResult,
605
+ NexusSearchHit,
606
+ NexusSearchParams,
607
+ NexusSearchResult,
608
+ NexusShapeCheckParams,
609
+ NexusShapeCheckResult,
610
+ NexusShareSnapshotExportParams,
611
+ NexusShareSnapshotExportResult,
612
+ NexusShareSnapshotImportParams,
613
+ NexusShareSnapshotImportResult,
614
+ NexusShareStatusParams,
615
+ NexusShareStatusResult,
616
+ NexusSharingStatus,
617
+ NexusShowParams,
618
+ NexusShowResult,
619
+ NexusSigilListParams,
620
+ NexusSigilListResult,
621
+ NexusSigilSyncParams,
622
+ NexusSigilSyncResult,
623
+ NexusStatusParams,
624
+ NexusStatusResult,
625
+ NexusSyncParams,
626
+ NexusSyncResult,
627
+ NexusTaskFootprintParams,
628
+ NexusTaskFootprintResult,
629
+ NexusTaskRef,
630
+ NexusTaskSymbolsParams,
631
+ NexusTaskSymbolsResult,
632
+ NexusTopEntriesParams,
633
+ NexusTopEntriesResult,
634
+ NexusTopEntry,
635
+ NexusTransferManifest,
636
+ NexusTransferManifestEntry,
637
+ NexusTransferMode,
638
+ NexusTransferOnConflict,
639
+ NexusTransferOnMissingDep,
640
+ NexusTransferParams,
641
+ NexusTransferPreviewParams,
642
+ NexusTransferPreviewResult,
643
+ NexusTransferResult,
644
+ NexusTransferScope,
645
+ NexusUnregisterParams,
646
+ NexusUnregisterResult,
647
+ NexusWhyParams,
648
+ NexusWhyResult,
649
+ NexusWikiParams,
650
+ } from './operations/nexus.js';
516
651
  // === NEXUS User Profile Types (T1076 PSYCHE Wave 1) ===
517
652
  // Re-exported at top level so @cleocode/core/nexus and CLI dispatch can
518
653
  // import without the `ops.` namespace hop.
@@ -544,6 +679,32 @@ export type {
544
679
  ParamType,
545
680
  } from './operations/params.js';
546
681
  export { paramsToCittyArgs } from './operations/params.js';
682
+ // === Sentient Operation Types (T1421 — typed-dispatch migration, Wave D) ===
683
+ // Re-exported at top level so CLI dispatch can import without the `ops.` namespace hop.
684
+ export type {
685
+ AllowlistAddParams,
686
+ AllowlistAddResult,
687
+ AllowlistListParams,
688
+ AllowlistListResult,
689
+ AllowlistRemoveParams,
690
+ AllowlistRemoveResult,
691
+ Proposal,
692
+ ProposeAcceptParams,
693
+ ProposeAcceptResult,
694
+ ProposeDiffParams,
695
+ ProposeDiffResult,
696
+ ProposeDisableParams,
697
+ ProposeDisableResult,
698
+ ProposeEnableParams,
699
+ ProposeEnableResult,
700
+ ProposeListParams,
701
+ ProposeListResult,
702
+ ProposeRejectParams,
703
+ ProposeRejectResult,
704
+ ProposeRunParams,
705
+ ProposeRunResult,
706
+ SentientOps,
707
+ } from './operations/sentient.js';
547
708
  // Session operation param/result types — re-exported at top level for typed-dispatch consumers
548
709
  // (T975 Wave D · ADR-051 migration)
549
710
  export type {
@@ -647,6 +808,57 @@ export type {
647
808
  TasksUpdateQueryParams,
648
809
  TasksUpdateQueryResult,
649
810
  } from './operations/tasks.js';
811
+ // === Validate / Check Operation Types (T982 + T1430 — typed-dispatch surface) ===
812
+ // Re-exported at top level so CLI dispatch can import without the `ops.` namespace hop.
813
+ export type {
814
+ CheckOps,
815
+ ComplianceMetrics,
816
+ ValidateArchiveStatsParams,
817
+ ValidateArchiveStatsResult,
818
+ ValidateCanonParams,
819
+ ValidateCanonResult,
820
+ ValidateChainParams,
821
+ ValidateChainResult,
822
+ ValidateCoherenceParams,
823
+ ValidateCoherenceResult,
824
+ ValidateComplianceRecordParams,
825
+ ValidateComplianceRecordResult,
826
+ ValidateComplianceSummaryParams,
827
+ ValidateComplianceSummaryResult,
828
+ ValidateComplianceSyncParams,
829
+ ValidateComplianceSyncResult,
830
+ ValidateComplianceViolationsParams,
831
+ ValidateComplianceViolationsResult,
832
+ ValidateGateParams,
833
+ ValidateGateResult,
834
+ ValidateGradeListParams,
835
+ ValidateGradeListResult,
836
+ ValidateGradeParams,
837
+ ValidateGradeResult,
838
+ ValidateManifestParams,
839
+ ValidateManifestResult,
840
+ ValidateOutputParams,
841
+ ValidateOutputResult,
842
+ ValidateProtocolBaseParams,
843
+ ValidateProtocolParams,
844
+ ValidateProtocolResult,
845
+ ValidateSchemaParams,
846
+ ValidateSchemaResult,
847
+ ValidateTaskParams,
848
+ ValidateTaskResult,
849
+ ValidateTestCoverageParams,
850
+ ValidateTestCoverageResult,
851
+ ValidateTestRunParams,
852
+ ValidateTestRunResult,
853
+ ValidateTestStatusParams,
854
+ ValidateTestStatusResult,
855
+ ValidateVerifyExplainParams,
856
+ ValidateVerifyExplainResult,
857
+ ValidateWorkflowComplianceParams,
858
+ ValidateWorkflowComplianceResult,
859
+ ValidationSeverity,
860
+ ValidationViolation,
861
+ } from './operations/validate.js';
650
862
  // T1238 Variable substitution — re-exported at top level so SDK consumers can
651
863
  // import resolver contracts without the `ops.` namespace hop.
652
864
  export type {
@@ -873,6 +1085,18 @@ export type {
873
1085
  ReconcileResult,
874
1086
  SyncDirection,
875
1087
  } from './task-sync.js';
1088
+ export type { ArchiveReasonValue } from './tasks/archive.js';
1089
+ // === Archive Reason Enum (T1409 — typed z.enum + tombstone guard) ===
1090
+ export {
1091
+ ARCHIVE_REASON_TOMBSTONE,
1092
+ ARCHIVE_REASON_TOMBSTONE_ENV,
1093
+ ARCHIVE_REASON_VALUES,
1094
+ ArchiveReason,
1095
+ ArchiveReasonSchema,
1096
+ ArchiveReasonTombstoneError,
1097
+ assertArchiveReason,
1098
+ isArchiveTombstoneAllowed,
1099
+ } from './tasks/archive.js';
876
1100
  // === Tessera Types ===
877
1101
  export type {
878
1102
  TesseraInstantiationInput,
@@ -71,6 +71,13 @@ export interface UserProfileTrait {
71
71
  export interface NexusProfileViewParams {
72
72
  /** Only return traits with confidence >= this value. Default: 0.0 (all). */
73
73
  minConfidence?: number;
74
+ /**
75
+ * When true, include traits whose `validUntil` has elapsed (superseded entries).
76
+ * Default `false` — view returns only currently-valid traits.
77
+ *
78
+ * @task T1080
79
+ */
80
+ includeSuperseded?: boolean;
74
81
  }
75
82
 
76
83
  /** Result of `nexus.profile.view`. */
@@ -0,0 +1,186 @@
1
+ /**
2
+ * Typed archive-reason enum for task archival writes (contracts SSoT).
3
+ *
4
+ * Promotes the `archiveReason` literal-string type into a Zod-validated
5
+ * `z.enum` so every package — core/store, cleo CLI, dispatch, migration
6
+ * tooling — references a single canonical truth. The DB CHECK constraint
7
+ * (T1408 migration `20260424000000_t1408-archive-reason-enum`) enforces
8
+ * the same six values at the SQLite layer; this contract enforces them
9
+ * at the TypeScript and runtime-validation layer.
10
+ *
11
+ * Values (CANONICAL — must match the migration):
12
+ * - `verified` — task reached `status='done'` AND verification
13
+ * gates passed. Trustworthy completion.
14
+ * - `reconciled` — closure was reconciled by an audit/repair pass
15
+ * (BRAIN reconciliation, audit lineage, etc.).
16
+ * - `superseded` — closed because a newer task replaces it
17
+ * (typed merge / dedup outcome).
18
+ * - `shadowed` — closed because a duplicate or shadow record
19
+ * exists; this row is no longer authoritative.
20
+ * - `cancelled` — task reached `status='cancelled'` (verification
21
+ * irrelevant for cancellations).
22
+ * - `completed-unverified` — TOMBSTONE. Closure happened but verification
23
+ * was never run, was incomplete, or failed.
24
+ * ONLY migration backfill paths are permitted to
25
+ * write this value; new code that attempts to
26
+ * stamp it MUST throw {@link ArchiveReasonTombstoneError}.
27
+ *
28
+ * @epic T1407
29
+ * @task T1409
30
+ * @see packages/core/src/store/tasks-schema.ts — DB CHECK constraint
31
+ * @see packages/core/src/tasks/archive.ts — derivation logic
32
+ */
33
+
34
+ import { z } from 'zod';
35
+
36
+ /**
37
+ * Canonical Zod enum for the six valid `archiveReason` values.
38
+ *
39
+ * Use `ArchiveReason.enum.<value>` to reference a literal in code, or
40
+ * `ArchiveReason.parse(x)` to validate at a trust boundary.
41
+ *
42
+ * @example
43
+ * ```ts
44
+ * import { ArchiveReason } from '@cleocode/contracts';
45
+ *
46
+ * // Reference a literal:
47
+ * const reason = ArchiveReason.enum.verified;
48
+ *
49
+ * // Validate untrusted input:
50
+ * const safe = ArchiveReason.parse(externalInput);
51
+ * ```
52
+ */
53
+ export const ArchiveReason = z.enum([
54
+ 'verified',
55
+ 'reconciled',
56
+ 'superseded',
57
+ 'shadowed',
58
+ 'cancelled',
59
+ 'completed-unverified',
60
+ ]);
61
+
62
+ /**
63
+ * Alias preserved for symmetry with other contracts that suffix with
64
+ * `Schema` (e.g. {@link acceptanceGateSchema}).
65
+ *
66
+ * Identical to {@link ArchiveReason}. Prefer `ArchiveReason` for direct
67
+ * literal access; prefer `ArchiveReasonSchema` when passing the schema
68
+ * object into a generic helper (e.g. `createInsertSchema`).
69
+ */
70
+ export const ArchiveReasonSchema = ArchiveReason;
71
+
72
+ /**
73
+ * Inferred TypeScript union type for {@link ArchiveReason}.
74
+ *
75
+ * Equivalent to:
76
+ * ```ts
77
+ * type ArchiveReasonValue =
78
+ * | 'verified'
79
+ * | 'reconciled'
80
+ * | 'superseded'
81
+ * | 'shadowed'
82
+ * | 'cancelled'
83
+ * | 'completed-unverified';
84
+ * ```
85
+ */
86
+ export type ArchiveReasonValue = z.infer<typeof ArchiveReason>;
87
+
88
+ /**
89
+ * Readonly tuple of all valid archive-reason values, in canonical order.
90
+ *
91
+ * Useful when a Drizzle column or a discriminated union needs the raw
92
+ * tuple form (e.g. `text('archive_reason', { enum: ARCHIVE_REASON_VALUES })`).
93
+ */
94
+ export const ARCHIVE_REASON_VALUES = ArchiveReason.options;
95
+
96
+ /**
97
+ * The single tombstone value within {@link ArchiveReason}.
98
+ *
99
+ * Writing this value from non-migration code paths MUST throw
100
+ * {@link ArchiveReasonTombstoneError}. The value exists in the enum so the
101
+ * DB CHECK constraint accepts rows backfilled by the migration ingest, but
102
+ * application code (CLI, archive bulk path, single-task archive) must
103
+ * derive a more specific reason (`verified`, `reconciled`, `cancelled`,
104
+ * etc.) before writing.
105
+ */
106
+ export const ARCHIVE_REASON_TOMBSTONE = 'completed-unverified' as const;
107
+
108
+ /**
109
+ * Error thrown when application code attempts to write the tombstone
110
+ * value `'completed-unverified'` outside the permitted migration-backfill
111
+ * path.
112
+ *
113
+ * Acceptance criteria T1407: "Writing 'completed-unverified' from new
114
+ * code throws E_ARCHIVE_REASON_TOMBSTONE; only migration backfill may
115
+ * write it."
116
+ *
117
+ * @example
118
+ * ```ts
119
+ * if (reason === ARCHIVE_REASON_TOMBSTONE && !allowMigrationBackfill) {
120
+ * throw new ArchiveReasonTombstoneError(taskId);
121
+ * }
122
+ * ```
123
+ */
124
+ export class ArchiveReasonTombstoneError extends Error {
125
+ readonly code = 'E_ARCHIVE_REASON_TOMBSTONE';
126
+ readonly taskId?: string;
127
+
128
+ constructor(taskId?: string) {
129
+ super(
130
+ taskId
131
+ ? `archiveReason='completed-unverified' is a tombstone — only migration backfill may write it (taskId=${taskId})`
132
+ : "archiveReason='completed-unverified' is a tombstone — only migration backfill may write it",
133
+ );
134
+ this.name = 'ArchiveReasonTombstoneError';
135
+ this.taskId = taskId;
136
+ }
137
+ }
138
+
139
+ /**
140
+ * Environment / context flag that callers MUST set to `true` (or to the
141
+ * env var `CLEO_ARCHIVE_ALLOW_TOMBSTONE=1`) before writing the tombstone.
142
+ *
143
+ * Centralized here so every write path uses the same gate constant.
144
+ */
145
+ export const ARCHIVE_REASON_TOMBSTONE_ENV = 'CLEO_ARCHIVE_ALLOW_TOMBSTONE';
146
+
147
+ /**
148
+ * Returns true iff the current process is permitted to write the
149
+ * tombstone value (migration backfill path or owner-override).
150
+ *
151
+ * @internal Used by core/store archive write paths to gate tombstone
152
+ * writes; not part of the public contracts API surface.
153
+ *
154
+ * @remarks
155
+ * The contracts package is a zero-runtime-dependency leaf, so it does
156
+ * not pull in `@types/node`. Accessing `process.env` via
157
+ * `globalThis` keeps the package portable (works in Node, browsers,
158
+ * Deno, Bun, edge runtimes — `process` is undefined off-Node and the
159
+ * function returns `false` there).
160
+ */
161
+ export function isArchiveTombstoneAllowed(): boolean {
162
+ // biome-ignore lint/suspicious/noExplicitAny: globalThis.process is intentionally untyped — see remarks above.
163
+ const env = (globalThis as any)?.process?.env as Record<string, string | undefined> | undefined;
164
+ return env?.[ARCHIVE_REASON_TOMBSTONE_ENV] === '1';
165
+ }
166
+
167
+ /**
168
+ * Validates a candidate archive reason and enforces the tombstone gate.
169
+ *
170
+ * - Rejects values outside the 6-value enum with a Zod error.
171
+ * - Rejects `'completed-unverified'` unless {@link isArchiveTombstoneAllowed}
172
+ * returns `true`.
173
+ *
174
+ * @param reason - candidate archive-reason string
175
+ * @param taskId - optional task id, used in the error message
176
+ * @returns the validated, narrowed {@link ArchiveReasonValue}
177
+ * @throws {@link ArchiveReasonTombstoneError} when reason is the tombstone
178
+ * and the migration-backfill gate is not enabled
179
+ */
180
+ export function assertArchiveReason(reason: string, taskId?: string): ArchiveReasonValue {
181
+ const parsed = ArchiveReason.parse(reason);
182
+ if (parsed === ARCHIVE_REASON_TOMBSTONE && !isArchiveTombstoneAllowed()) {
183
+ throw new ArchiveReasonTombstoneError(taskId);
184
+ }
185
+ return parsed;
186
+ }