@smartergpt/lexrunner 2.0.2 → 2.2.0

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.
Files changed (41) hide show
  1. package/BRAND.md +14 -0
  2. package/CHANGELOG.md +49 -0
  3. package/GOVERNANCE.md +18 -0
  4. package/LICENSE.md +201 -110
  5. package/NOTICE.md +12 -1
  6. package/README.mcp.md +5 -1
  7. package/README.md +48 -35
  8. package/dist/{api-QBPBKYOC.js → api-UIWVFU7M.js} +1 -1
  9. package/dist/{audit-SKMMC2U4.js → audit-HVB2HJPU.js} +2 -2
  10. package/dist/{autopilot-3OHEUTHD.js → autopilot-7PX6YG55.js} +2 -2
  11. package/dist/{chunk-6PZDSWCG.js → chunk-37UC53OG.js} +2 -2
  12. package/dist/{chunk-ARDKZW7F.js → chunk-M6AAYMHH.js} +363 -293
  13. package/dist/{chunk-V3BU2VDU.js → chunk-PDDULIDL.js} +13 -1
  14. package/dist/cli.cjs +3672 -2774
  15. package/dist/cli.d.ts +201 -24
  16. package/dist/cli.js +1073 -275
  17. package/dist/{commandValidator-LVEMJTZP.js → commandValidator-XFVNCZXX.js} +1 -1
  18. package/dist/{constraints-2ZK5FJFA.js → constraints-LE2MW5NS.js} +1 -1
  19. package/dist/errors/index.js +1 -1
  20. package/dist/frames/index.js +1 -1
  21. package/dist/{gateMapping-R3RJYKMS.js → gateMapping-V4DTL5WD.js} +1 -1
  22. package/dist/hooks/events.js +1 -1
  23. package/dist/{jsonEnvelope-K2U5CWKU.js → jsonEnvelope-MXJM5ZQH.js} +1 -1
  24. package/dist/{mergeTreeSimulator-QCFSOU25.js → mergeTreeSimulator-GWZ77NF2.js} +1 -1
  25. package/dist/package-schemas/behavior-rule.js +1 -1
  26. package/dist/package-schemas/execution-plan-v1.js +1 -1
  27. package/dist/package-schemas/gates.js +1 -1
  28. package/dist/package-schemas/runner-scope.js +1 -1
  29. package/dist/package-schemas/runner-stack.js +1 -1
  30. package/dist/{planDiff-IHLFNZUT.js → planDiff-4D3AERAW.js} +1 -1
  31. package/dist/{planHistory-GLRI356L.js → planHistory-VPV4WDPW.js} +1 -1
  32. package/dist/{planReview-UUMCGZJ6.js → planReview-FV6INFLQ.js} +1 -1
  33. package/dist/{planViewer-TRSQVMH4.js → planViewer-WOV6A2HZ.js} +1 -1
  34. package/dist/{sarif-2C6RKOUX.js → sarif-QXVE3LYD.js} +1 -1
  35. package/dist/sdk/index.d.ts +5 -5
  36. package/dist/sdk/index.js +1 -1
  37. package/dist/{security-OE4VLUFK.js → security-W7TOUXSB.js} +1 -1
  38. package/dist/{signing-KLZYZZMP.js → signing-WGVPHJGG.js} +1 -1
  39. package/dist/{verify-3UVMA62I.js → verify-Y34CJAKB.js} +1 -1
  40. package/package.json +8 -6
  41. package/schemas/plan.schema.json +203 -73
package/dist/cli.d.ts CHANGED
@@ -226,6 +226,24 @@ declare const Plan: z.ZodObject<{
226
226
  mismatch: z.ZodOptional<z.ZodBoolean>;
227
227
  }, z.core.$strip>>;
228
228
  }, z.core.$strict>>>;
229
+ gitInputs: z.ZodOptional<z.ZodObject<{
230
+ schemaVersion: z.ZodLiteral<"1.0.0">;
231
+ repository: z.ZodString;
232
+ checkoutRemote: z.ZodString;
233
+ acquisition: z.ZodEnum<{
234
+ "local-only": "local-only";
235
+ fetch: "fetch";
236
+ }>;
237
+ target: z.ZodObject<{
238
+ ref: z.ZodString;
239
+ commit: z.ZodString;
240
+ }, z.core.$strict>;
241
+ sources: z.ZodArray<z.ZodObject<{
242
+ ref: z.ZodString;
243
+ commit: z.ZodString;
244
+ item: z.ZodString;
245
+ }, z.core.$strict>>;
246
+ }, z.core.$strict>>;
229
247
  }, z.core.$strict>;
230
248
  type Plan = z.infer<typeof Plan>;
231
249
  /**
@@ -2506,6 +2524,12 @@ type AgentWorkFanInDecision_v1 = z.infer<typeof AgentWorkFanInDecision_v1>;
2506
2524
  declare function computeFanInEvidenceSetHash(candidates: AgentWorkFanInDecision_v1["candidates"]): string;
2507
2525
  /** Portable packet content before LexRunner derives and verifies packet_hash. */
2508
2526
  declare const AgentTaskPacketHashInput_v1: z.ZodObject<{
2527
+ repository: z.ZodObject<{
2528
+ id: z.ZodString;
2529
+ remote_url: z.ZodOptional<z.ZodString>;
2530
+ default_branch: z.ZodOptional<z.ZodString>;
2531
+ base_sha: z.ZodString;
2532
+ }, z.core.$strict>;
2509
2533
  objective: z.ZodString;
2510
2534
  run_id: z.ZodString;
2511
2535
  scope: z.ZodObject<{
@@ -2528,12 +2552,6 @@ declare const AgentTaskPacketHashInput_v1: z.ZodObject<{
2528
2552
  }, z.core.$strict>;
2529
2553
  schema_version: z.ZodLiteral<"1.0.0">;
2530
2554
  created_at: z.ZodString;
2531
- repository: z.ZodObject<{
2532
- id: z.ZodString;
2533
- remote_url: z.ZodOptional<z.ZodString>;
2534
- default_branch: z.ZodOptional<z.ZodString>;
2535
- base_sha: z.ZodString;
2536
- }, z.core.$strict>;
2537
2555
  acceptance_criteria: z.ZodArray<z.ZodObject<{
2538
2556
  id: z.ZodString;
2539
2557
  text: z.ZodString;
@@ -4919,8 +4937,8 @@ declare const SourceObservationShape: {
4919
4937
  readonly source_head_sha: z.ZodString;
4920
4938
  readonly requested_object_sha: z.ZodString;
4921
4939
  readonly requested_object_type: z.ZodEnum<{
4922
- missing: "missing";
4923
4940
  commit: "commit";
4941
+ missing: "missing";
4924
4942
  other: "other";
4925
4943
  }>;
4926
4944
  readonly cleanliness: z.ZodEnum<{
@@ -4939,8 +4957,8 @@ declare const NativeWslSourceObservation_v1: z.ZodPreprocess<z.ZodObject<{
4939
4957
  source_head_sha: z.ZodString;
4940
4958
  requested_object_sha: z.ZodString;
4941
4959
  requested_object_type: z.ZodEnum<{
4942
- missing: "missing";
4943
4960
  commit: "commit";
4961
+ missing: "missing";
4944
4962
  other: "other";
4945
4963
  }>;
4946
4964
  cleanliness: z.ZodEnum<{
@@ -5046,8 +5064,8 @@ declare const ProjectionManifestShape: {
5046
5064
  source_head_sha: z.ZodString;
5047
5065
  requested_object_sha: z.ZodString;
5048
5066
  requested_object_type: z.ZodEnum<{
5049
- missing: "missing";
5050
5067
  commit: "commit";
5068
+ missing: "missing";
5051
5069
  other: "other";
5052
5070
  }>;
5053
5071
  cleanliness: z.ZodEnum<{
@@ -5134,8 +5152,8 @@ declare const NativeWslProjectionManifest_v1: z.ZodPreprocess<z.ZodObject<{
5134
5152
  source_head_sha: z.ZodString;
5135
5153
  requested_object_sha: z.ZodString;
5136
5154
  requested_object_type: z.ZodEnum<{
5137
- missing: "missing";
5138
5155
  commit: "commit";
5156
+ missing: "missing";
5139
5157
  other: "other";
5140
5158
  }>;
5141
5159
  cleanliness: z.ZodEnum<{
@@ -5637,8 +5655,8 @@ declare const ProjectionSelectionShape: {
5637
5655
  source_head_sha: z.ZodString;
5638
5656
  requested_object_sha: z.ZodString;
5639
5657
  requested_object_type: z.ZodEnum<{
5640
- missing: "missing";
5641
5658
  commit: "commit";
5659
+ missing: "missing";
5642
5660
  other: "other";
5643
5661
  }>;
5644
5662
  cleanliness: z.ZodEnum<{
@@ -5701,8 +5719,8 @@ declare const NativeWslProjectionSelection_v1: z.ZodPreprocess<z.ZodObject<{
5701
5719
  source_head_sha: z.ZodString;
5702
5720
  requested_object_sha: z.ZodString;
5703
5721
  requested_object_type: z.ZodEnum<{
5704
- missing: "missing";
5705
5722
  commit: "commit";
5723
+ missing: "missing";
5706
5724
  other: "other";
5707
5725
  }>;
5708
5726
  cleanliness: z.ZodEnum<{
@@ -5768,8 +5786,8 @@ declare const NativeWslProjectionInventoryObservation_v1: z.ZodUnion<readonly [z
5768
5786
  source_head_sha: z.ZodString;
5769
5787
  requested_object_sha: z.ZodString;
5770
5788
  requested_object_type: z.ZodEnum<{
5771
- missing: "missing";
5772
5789
  commit: "commit";
5790
+ missing: "missing";
5773
5791
  other: "other";
5774
5792
  }>;
5775
5793
  cleanliness: z.ZodEnum<{
@@ -7134,9 +7152,9 @@ declare const AxfExternalAwaitResult_v1: z.ZodObject<{
7134
7152
  name: z.ZodString;
7135
7153
  appSlug: z.ZodNullable<z.ZodString>;
7136
7154
  state: z.ZodEnum<{
7155
+ error: "error";
7137
7156
  success: "success";
7138
7157
  failure: "failure";
7139
- error: "error";
7140
7158
  completed: "completed";
7141
7159
  pending: "pending";
7142
7160
  missing: "missing";
@@ -7231,9 +7249,9 @@ declare const AttemptAwaitableTerminalResult_v1: z.ZodObject<{
7231
7249
  name: z.ZodString;
7232
7250
  appSlug: z.ZodNullable<z.ZodString>;
7233
7251
  state: z.ZodEnum<{
7252
+ error: "error";
7234
7253
  success: "success";
7235
7254
  failure: "failure";
7236
- error: "error";
7237
7255
  completed: "completed";
7238
7256
  pending: "pending";
7239
7257
  missing: "missing";
@@ -7372,9 +7390,9 @@ declare const AttemptAwaitableRecord_v1: z.ZodObject<{
7372
7390
  name: z.ZodString;
7373
7391
  appSlug: z.ZodNullable<z.ZodString>;
7374
7392
  state: z.ZodEnum<{
7393
+ error: "error";
7375
7394
  success: "success";
7376
7395
  failure: "failure";
7377
- error: "error";
7378
7396
  completed: "completed";
7379
7397
  pending: "pending";
7380
7398
  missing: "missing";
@@ -7478,9 +7496,9 @@ declare const AttemptAwaitableCompletion_v1: z.ZodObject<{
7478
7496
  name: z.ZodString;
7479
7497
  appSlug: z.ZodNullable<z.ZodString>;
7480
7498
  state: z.ZodEnum<{
7499
+ error: "error";
7481
7500
  success: "success";
7482
7501
  failure: "failure";
7483
- error: "error";
7484
7502
  completed: "completed";
7485
7503
  pending: "pending";
7486
7504
  missing: "missing";
@@ -8631,6 +8649,7 @@ interface GitHubClient {
8631
8649
  getPRDetails(number: number): Promise<PullRequestDetails>;
8632
8650
  getPRDependencies(pr: PullRequest): Promise<string[]>;
8633
8651
  validateRepository(): Promise<RepositoryInfo>;
8652
+ getBranchHead(branch: string): Promise<string>;
8634
8653
  listIssues(options?: IssueQueryOptions): Promise<GitHubIssue[]>;
8635
8654
  getOctokit(): any;
8636
8655
  getOwner(): string;
@@ -8921,6 +8940,7 @@ interface GitHubPlanOptions$1 {
8921
8940
  excludePRs?: number[];
8922
8941
  includeDrafts?: boolean;
8923
8942
  target?: string;
8943
+ gitAcquisition?: "local-only" | "fetch";
8924
8944
  policy?: {
8925
8945
  requiredGates?: string[];
8926
8946
  maxWorkers?: number;
@@ -8998,6 +9018,7 @@ interface MergeOperation {
8998
9018
  item: PlanItem;
8999
9019
  targetBranch: string;
9000
9020
  strategy: "rebase-weave" | "merge-weave" | "squash-weave";
9021
+ sourceCommit?: string;
9001
9022
  }
9002
9023
  interface WeaveResult {
9003
9024
  success: boolean;
@@ -9240,6 +9261,7 @@ interface BoundedIntegrationStatus {
9240
9261
  schemaVersion: string;
9241
9262
  target: string;
9242
9263
  itemCount: number;
9264
+ gitInputBinding: "frozen" | "legacy-unbound";
9243
9265
  policy?: Plan["policy"];
9244
9266
  };
9245
9267
  mergeSummary: ReturnType<MergeEligibilityEvaluator["getMergeSummary"]>;
@@ -9320,6 +9342,7 @@ interface BoundedMergeApplicationResult {
9320
9342
  ok: boolean;
9321
9343
  status: "preview" | "completed" | "paused" | "failed";
9322
9344
  totalItems: number;
9345
+ gitInputBinding: "frozen" | "legacy-unbound";
9323
9346
  levels?: string[][];
9324
9347
  maxParallelism?: number;
9325
9348
  runId?: string;
@@ -9367,7 +9390,96 @@ declare class MergeApplicationService {
9367
9390
  }>;
9368
9391
  }
9369
9392
 
9393
+ declare const EXECUTION_PLAN_ARTIFACT_CONTRACT: "lexrunner.execution-plan-artifact.v1";
9394
+ declare const PLAN_ARTIFACT_REFERENCE_CONTRACT: "lexrunner.plan-artifact-reference.v1";
9395
+ declare const EXECUTION_PLAN_CANONICALIZATION_PROFILE: "lexrunner.execution-plan.canonical-json.v1";
9396
+ declare const EXECUTION_PLAN_HASH_PROFILE: "lexrunner.execution-plan-artifact.sha256.v1";
9397
+ declare const EXECUTION_PLAN_HASH_DOMAIN: "lexrunner:execution-plan-artifact:v1\0";
9398
+ declare const PlanArtifactScope_v1Schema: z.ZodObject<{
9399
+ tenant: z.ZodString;
9400
+ workspace: z.ZodString;
9401
+ repository: z.ZodString;
9402
+ refNamespace: z.ZodString;
9403
+ policy: z.ZodString;
9404
+ }, z.core.$strict>;
9405
+ type PlanArtifactScope_v1 = z.infer<typeof PlanArtifactScope_v1Schema>;
9406
+ declare const ExecutionPlanArtifactIdentity_v1Schema: z.ZodObject<{
9407
+ contract: z.ZodLiteral<"lexrunner.execution-plan-artifact.v1">;
9408
+ kind: z.ZodLiteral<"execution-plan">;
9409
+ planSchema: z.ZodLiteral<"lexrunner.execution-plan">;
9410
+ planSchemaVersion: z.ZodString;
9411
+ canonicalizationProfile: z.ZodLiteral<"lexrunner.execution-plan.canonical-json.v1">;
9412
+ hashProfile: z.ZodLiteral<"lexrunner.execution-plan-artifact.sha256.v1">;
9413
+ digestAlgorithm: z.ZodLiteral<"sha256">;
9414
+ digest: z.ZodString;
9415
+ canonicalByteLength: z.ZodNumber;
9416
+ target: z.ZodString;
9417
+ summary: z.ZodObject<{
9418
+ itemCount: z.ZodNumber;
9419
+ gateCount: z.ZodNumber;
9420
+ }, z.core.$strict>;
9421
+ }, z.core.$strict>;
9422
+ type ExecutionPlanArtifactIdentity_v1 = z.infer<typeof ExecutionPlanArtifactIdentity_v1Schema>;
9423
+ declare const ExecutionPlanArtifact_v1Schema: z.ZodObject<{
9424
+ identity: z.ZodObject<{
9425
+ contract: z.ZodLiteral<"lexrunner.execution-plan-artifact.v1">;
9426
+ kind: z.ZodLiteral<"execution-plan">;
9427
+ planSchema: z.ZodLiteral<"lexrunner.execution-plan">;
9428
+ planSchemaVersion: z.ZodString;
9429
+ canonicalizationProfile: z.ZodLiteral<"lexrunner.execution-plan.canonical-json.v1">;
9430
+ hashProfile: z.ZodLiteral<"lexrunner.execution-plan-artifact.sha256.v1">;
9431
+ digestAlgorithm: z.ZodLiteral<"sha256">;
9432
+ digest: z.ZodString;
9433
+ canonicalByteLength: z.ZodNumber;
9434
+ target: z.ZodString;
9435
+ summary: z.ZodObject<{
9436
+ itemCount: z.ZodNumber;
9437
+ gateCount: z.ZodNumber;
9438
+ }, z.core.$strict>;
9439
+ }, z.core.$strict>;
9440
+ canonicalBytes: z.ZodString;
9441
+ }, z.core.$strict>;
9442
+ type ExecutionPlanArtifact_v1 = z.infer<typeof ExecutionPlanArtifact_v1Schema>;
9443
+ declare const PlanArtifactReference_v1Schema: z.ZodObject<{
9444
+ contract: z.ZodLiteral<"lexrunner.plan-artifact-reference.v1">;
9445
+ artifact: z.ZodObject<{
9446
+ contract: z.ZodLiteral<"lexrunner.execution-plan-artifact.v1">;
9447
+ kind: z.ZodLiteral<"execution-plan">;
9448
+ planSchema: z.ZodLiteral<"lexrunner.execution-plan">;
9449
+ planSchemaVersion: z.ZodString;
9450
+ canonicalizationProfile: z.ZodLiteral<"lexrunner.execution-plan.canonical-json.v1">;
9451
+ hashProfile: z.ZodLiteral<"lexrunner.execution-plan-artifact.sha256.v1">;
9452
+ digestAlgorithm: z.ZodLiteral<"sha256">;
9453
+ digest: z.ZodString;
9454
+ canonicalByteLength: z.ZodNumber;
9455
+ target: z.ZodString;
9456
+ summary: z.ZodObject<{
9457
+ itemCount: z.ZodNumber;
9458
+ gateCount: z.ZodNumber;
9459
+ }, z.core.$strict>;
9460
+ }, z.core.$strict>;
9461
+ expectedDigest: z.ZodString;
9462
+ expectedCanonicalByteLength: z.ZodNumber;
9463
+ retrieval: z.ZodObject<{
9464
+ kind: z.ZodEnum<{
9465
+ file: "file";
9466
+ registered: "registered";
9467
+ }>;
9468
+ reference: z.ZodString;
9469
+ }, z.core.$strict>;
9470
+ scope: z.ZodOptional<z.ZodObject<{
9471
+ tenant: z.ZodString;
9472
+ workspace: z.ZodString;
9473
+ repository: z.ZodString;
9474
+ refNamespace: z.ZodString;
9475
+ policy: z.ZodString;
9476
+ }, z.core.$strict>>;
9477
+ }, z.core.$strict>;
9478
+ type PlanArtifactReference_v1 = z.infer<typeof PlanArtifactReference_v1Schema>;
9479
+ declare function computeExecutionPlanArtifactDigest(canonicalBytes: string): string;
9480
+
9370
9481
  type PlanArtifactSource = "explicit" | "repository-root" | "profile-runner";
9482
+ /** Backward-compatible public projection retained while ADR-012 adapters migrate. */
9371
9483
  interface PlanArtifactIdentity {
9372
9484
  contract: "plan-artifact-identity-v1";
9373
9485
  kind: "execution-plan";
@@ -9380,32 +9492,97 @@ interface PlanArtifactIdentity {
9380
9492
  interface ResolvedPlanArtifact {
9381
9493
  plan: Plan;
9382
9494
  identity: PlanArtifactIdentity;
9495
+ artifact: ExecutionPlanArtifact_v1;
9496
+ reference: PlanArtifactReference_v1;
9497
+ acquisition: PlanArtifactAcquisition;
9383
9498
  source: PlanArtifactSource;
9384
- /** Adapter-only location. It is deliberately excluded from the public identity. */
9499
+ /** Adapter-only location. It is deliberately excluded from semantic identity and diagnostics. */
9385
9500
  filePath: string;
9386
9501
  }
9387
- type PlanArtifactFailureCode = "PLAN_REFERENCE_INVALID" | "PLAN_NOT_FOUND" | "PLAN_UNREADABLE" | "PLAN_ARTIFACT_LIMIT_EXCEEDED";
9502
+ /**
9503
+ * Portable Node acquisition is integrity evidence, not filesystem authority.
9504
+ * A future native stable-handle reader must use a distinct assurance value.
9505
+ */
9506
+ interface PlanArtifactAcquisition {
9507
+ contract: "lexrunner.plan-artifact-acquisition.v1";
9508
+ assurance: "portable-race-detection";
9509
+ authority: "unverified";
9510
+ }
9511
+ type PlanArtifactFailureCode = "PLAN_REFERENCE_INVALID" | "PLAN_REFERENCE_MISMATCH" | "PLAN_NOT_FOUND" | "PLAN_UNREADABLE" | "PLAN_FILESYSTEM_UNSAFE" | "PLAN_ARTIFACT_LIMIT_EXCEEDED";
9388
9512
  declare class PlanArtifactServiceError extends Error {
9389
9513
  readonly code: PlanArtifactFailureCode;
9390
9514
  readonly source?: PlanArtifactSource | undefined;
9391
9515
  constructor(code: PlanArtifactFailureCode, message: string, source?: PlanArtifactSource | undefined);
9392
9516
  }
9517
+ /** @internal Deterministic source-test seams. Not exported by the package entrypoint. */
9518
+ interface PlanArtifactImportHooks {
9519
+ /** Deterministic hostile-test seams; production callers should not provide hooks. */
9520
+ afterInitialPathSnapshot?(): void;
9521
+ afterOpen?(): void;
9522
+ afterRead?(): void;
9523
+ beforeFinalPathSnapshot?(): void;
9524
+ }
9525
+ /** @internal */
9526
+ interface PlanArtifactServiceOptions {
9527
+ importHooks?: PlanArtifactImportHooks;
9528
+ }
9393
9529
  interface ResolvePlanArtifactInput {
9394
9530
  planFile?: string;
9531
+ planReference?: PlanArtifactReference_v1;
9395
9532
  workingDir?: string;
9396
9533
  profileDir?: string;
9534
+ scope?: PlanArtifactScope_v1;
9397
9535
  }
9398
9536
  /**
9399
- * Resolve one immutable integration plan without creating mutable "active plan" state.
9537
+ * Resolve one exact content-addressed plan snapshot without creating mutable
9538
+ * "active plan" state. The portable reader detects observed races but does not
9539
+ * provide native stable-handle filesystem authority.
9400
9540
  *
9401
- * Precedence is explicit reference, repository-root plan.json, then the legacy
9402
- * profile runner plan. An explicit reference is authoritative: a bad explicit
9403
- * path never falls through to another plan.
9541
+ * Precedence is an expected-identity reference, an explicit path, repository-root
9542
+ * plan.json, then the legacy profile runner plan. Explicit inputs are authoritative:
9543
+ * a bad reference never falls through to another plan.
9404
9544
  */
9405
9545
  declare class PlanArtifactService {
9546
+ #private;
9547
+ constructor(options?: PlanArtifactServiceOptions);
9406
9548
  resolve(input?: ResolvePlanArtifactInput): ResolvedPlanArtifact;
9407
9549
  }
9408
9550
 
9551
+ type PlanArtifactRegistrationFailureCode = "PLAN_REGISTRATION_INVALID" | "PLAN_REGISTRATION_UNSAFE" | "PLAN_REGISTRATION_CONFLICT" | "PLAN_REGISTRATION_VERIFY_FAILED";
9552
+ declare class PlanArtifactRegistrationError extends Error {
9553
+ readonly code: PlanArtifactRegistrationFailureCode;
9554
+ constructor(code: PlanArtifactRegistrationFailureCode, message: string);
9555
+ }
9556
+ interface RegisterPlanArtifactInput {
9557
+ artifact: ExecutionPlanArtifact_v1;
9558
+ storeDirectory: string;
9559
+ scope?: PlanArtifactScope_v1;
9560
+ }
9561
+ interface RegisteredPlanArtifact {
9562
+ artifact: ExecutionPlanArtifact_v1;
9563
+ reference: PlanArtifactReference_v1;
9564
+ created: boolean;
9565
+ storage: {
9566
+ assurance: "service-no-replace-verified";
9567
+ authority: "unverified";
9568
+ };
9569
+ }
9570
+ /**
9571
+ * Minimal service-level no-replace content-addressed storage for ADR-012 plan
9572
+ * bytes. Portable pathname checks and mode bits are not protected store
9573
+ * authority; results remain explicitly unverified until a native boundary owns
9574
+ * the store.
9575
+ *
9576
+ * This service does not select, archive, supersede, or grant authority to an
9577
+ * artifact. It also does not delete crash-left ambiguous links; durable
9578
+ * publication recovery belongs to the reference-safe retention slice. Those
9579
+ * coordination operations belong to later ADR-012 slices.
9580
+ */
9581
+ declare class PlanArtifactRegistrationService {
9582
+ #private;
9583
+ register(input: RegisterPlanArtifactInput): RegisteredPlanArtifact;
9584
+ }
9585
+
9409
9586
  /**
9410
9587
  * Environmental Hostility Scoring
9411
9588
  *
@@ -9795,4 +9972,4 @@ declare function createWorkflowGuide(phase: WorkflowPhase): WorkflowGuide;
9795
9972
  declare function inspectRegisteredCliSurface(): RegisteredCliCommand[];
9796
9973
  declare function main(argv?: string[]): Promise<void>;
9797
9974
 
9798
- export { AGENT_ENGINE_VERIFICATION_V2_VERSION, AGENT_TASK_RECEIPT_PATCH_PROFILE, AGENT_TASK_RECEIPT_V2_VERSION, AGENT_WORK_CONTRACT_VERSION, ATTEMPT_AWAITABLE_CONTRACT_VERSION, AXF_AWAITABLE_SCHEMA_VERSION, AXF_AWAIT_RESULT_SCHEMA_VERSION, type AcknowledgeAttemptAwaitableDeliveryInput, AgentEngineVerification_v1, AgentEngineVerification_v2, type AgentExecutionPathBindingContext, type AgentExecutionPathBindingValidation, AgentExecutionPathMapping_v1, type AgentTaskPacketHashInput, AgentTaskPacketHashInput_v1, AgentTaskPacket_v1, type AgentTaskReceiptBindingContext, AgentTaskReceiptOutcome, type AgentTaskReceiptV2BindingContext, AgentTaskReceipt_v1, AgentTaskReceipt_v2, AgentWorkContainmentPreflightRequestJsonSchema, AgentWorkFanInDecision_v1, type AgentWorkFanInResult, AgentWorkFanoutPlan_v1, AgentWorkFanoutService, type AgentWorkPreparationCommandResult, type AgentWorkPreparationCommandRunner, AgentWorkPreparationReceipt_v1, type AgentWorkPreparationResult, AttemptAcceptanceApplyRequestJsonSchema, AttemptAcceptanceStatusRequestJsonSchema, type AttemptAwaitableAttachmentResult, AttemptAwaitableCompletion_v1, AttemptAwaitableDelivery_v1, AttemptAwaitableEventType_v1, AttemptAwaitableEvent_v1, type AttemptAwaitableLeaseCredential, type AttemptAwaitableMutationFailureReason, type AttemptAwaitableNotifier, type AttemptAwaitableObservationRequest, type AttemptAwaitableObserver, AttemptAwaitableObserverLease_v1, AttemptAwaitableRecord_v1, AttemptAwaitableStatus_v1, type AttemptAwaitableStore, AttemptAwaitableSupervisor, type AttemptAwaitableSupervisorNotice, type AttemptAwaitableSupervisorOptions, AttemptAwaitableTerminalResult_v1, AttemptPrepareRequestJsonSchema, AttemptReceiptStatusRequestJsonSchema, AttemptReceiptSubmitRequestJsonSchema, AttemptRetryDeltaDimension_v1, AttemptRetryDelta_v1, AttemptStartRequestJsonSchema, AttemptStatus, AttemptStatusInputJsonSchema, AttemptVerificationRunRequestJsonSchema, AttemptVerificationStatusRequestJsonSchema, AttemptWorkerAttachRequestJsonSchema, AttemptWorkerEndRequestJsonSchema, AttemptWorkerHeartbeatRequestJsonSchema, AttemptWorkerStatusRequestJsonSchema, Attempt_v1, AuthorityEnvelope, AxfCliAttemptAwaitableObserver, type AxfCliAttemptAwaitableObserverOptions, AxfExternalAwaitResult_v1, type BeginAttemptAwaitableDeliveryInput, type BoundedDiscoveryResult, type BoundedGateRunResult, type BoundedIntegrationStatus, type BoundedMergeApplicationResult, type BoundedMergeOrderResult, type CancelAttemptAwaitableInput, type ClaimAttemptAwaitableObservationInput, type ClaimAttemptAwaitableObservationResult, ClaimedCheckOutcome, type CompleteAttemptAwaitableInput, ConfigurationQueryService, ControllerLease_v1, type CreateAgentWorkFanoutInput, type DecideAgentWorkFanInInput, DiscoveryQueryService, EngineVerificationCheckSource_v2, EngineVerificationDeterminism_v2, EngineVerificationTrustGapReason_v2, type ExecuteAgentWorkPreparationInput, ExecutionEnvelope_v1, ExecutionEnvironmentOS, ExecutionState, ExternalAwaitOutcome_v1, ExternalAwaitableDescriptor_v1, FanInCandidateConclusion_v1, FanoutAttemptBinding_v1, FanoutPremise_v1, FanoutRationale_v1, FanoutSelectionCriterion_v1, GATE_IMPACT_MODEL, GateExecutionService, GateExecutionServiceError, type GateExecutionServiceInput, type GateExecutionServiceResult, GateImpactService, GateImpactServiceError, GitHubAPI, GitObjectId, HumanActionPreconditions, HumanActionReceipt_v1, HumanActionRequest_v1, INTEGRATION_RECORD_REMOVAL_VERSION, INTEGRATION_RECORD_REPLACEMENTS, InMemoryAttemptAwaitableStore, IntegrationQueryServiceError, IntegrationRecordCompatibilityError, IntegrationRecordCompatibilityService, IntegrationStatusQueryService, MAX_ATTEMPT_AWAITABLE_DURATION_MS, MIN_ATTEMPT_AWAITABLE_DURATION_MS, type MergeApplicationExecution, type MergeApplicationFailureCode, type MergeApplicationRuntime, MergeApplicationService, MergeApplicationServiceError, MergeEligibilityEvaluator, MergeOrderQueryService, type MultiRepoPlanOptions$1 as MultiRepoPlanOptions, type MutateAttemptAwaitableResult, NATIVE_WSL_PROJECTION_CONTRACT_VERSION, NATIVE_WSL_PROJECTION_HASH_PROFILE, NativeDirectoryIdentityClaim_v1, NativeExecutionPathMapping_v1, NativeWslExecutionPathMapping_v1, NativeWslProjectionCleanupRequestJsonSchema, NativeWslProjectionInventoryObservation_v1, NativeWslProjectionInventoryState, NativeWslProjectionManifest_v1, NativeWslProjectionNextAction, NativeWslProjectionOutcome, NativeWslProjectionPathMapping_v1, NativeWslProjectionPlanAction, NativeWslProjectionPlanReason, NativeWslProjectionPlan_v1, NativeWslProjectionPrepareRequestJsonSchema, NativeWslProjectionQuarantineRequestJsonSchema, NativeWslProjectionReasonCode, NativeWslProjectionReceipt_v1, NativeWslProjectionRequestJsonSchema, NativeWslProjectionRequest_v1, NativeWslProjectionSelection_v1, NativeWslProjectionStatusRequestJsonSchema, NativeWslSourceObservation_v1, type PlanArtifactFailureCode, type PlanArtifactIdentity, PlanArtifactService, PlanArtifactServiceError, type PlanArtifactSource, PlanCreationService, type RegisterAttemptAwaitableInput, type RegisterAttemptAwaitableResult, type RegisterDurableAttemptAwaitableInput, type RegisterDurableAttemptAwaitableResult, type ReleaseAttemptAwaitableObservationInput, type RepoTarget, type ResolvePlanArtifactInput, type ResolvedPlanArtifact, RunStatus, Run_v1, STRICT_FANOUT_SELECTION_CRITERIA, SqliteAttemptAwaitableStore, VerificationOutcome, WorkItem_v1, WorkerSessionBackend, WorkerSessionStatus, WorkerSession_v1, WorkspaceAllocationStatus, WorkspaceAllocation_v1, WorkspaceCleanupDisposition, WorkspaceConfigServiceError, WorkspaceDiagnosticsService, WorkspaceInitializationService, WorkspaceLeaseStatus, WorkspaceLease_v1, applyGateImpactSelection, asPlanValidationFailure, attemptStatusRequiresReceipt, attemptStatusRequiresVerification, bootstrapWorkspace, canonicalJSONStringify, completionForAttemptAwaitable, computeAgentEngineVerificationV2Hash, computeAgentTaskPacketHash, computeFanInEvidenceSetHash, computeMergeOrder, containsAttemptAwaitableCredentialValue, createAgentTaskPacket, createAgentWorkContainmentPreflightHandler, createAttemptLifecycleHandlers, createAttemptReceiptHandlers, createAttemptVerificationHandlers, createAttemptWorkerHandlers, createFileAnalyzer, createGitHubAPI, createGitHubClient, createGitOperations, createNativeExecutionPathMapping, createNativeWslExecutionPathMapping, createNativeWslProjectionLifecycleHandlers, createNativeWslProjectionManifest, createNativeWslProjectionPathMapping, createNativeWslProjectionReceipt, createNativeWslProjectionRequest, createNativeWslProjectionSelection, createNativeWslSourceObservation, createRunManager, createWorkflowGuide, deliveryIdForAttemptAwaitable, detectProjectType, executeAgentWorkPreparation, executeGatesWithPolicy, formatPlanValidationFailure, formatPlanValidationFailureText, generateGitHubSnapshot, generateMultiRepoPlan, generatePlan, generatePlanFromGitHub, generateSnapshot, getEnvironmentSuggestions, healthChecker, initLocalOverlay, inspectRegisteredCliSurface, isTerminalAttemptStatus, loadInputs, loadPlan, main, nativeWslProjectionId, orderAgentWorkPreparationSteps, parseAgentEngineVerification, parseAgentEngineVerificationV2, parseAgentTaskPacket, parseAgentTaskReceipt, parseAgentTaskReceiptV2, parseAttempt, parseAttemptAwaitableDescriptor, parseAttemptAwaitableRecord, parseAttemptAwaitableTerminalResult, parseControllerLease, parseExecutionEnvelope, parseExternalAwaitableDescriptor, parseHumanActionReceipt, parseHumanActionRequest, parseRun, parseWorkItem, parseWorkerSession, parseWorkspaceAllocation, parseWorkspaceLease, planNativeWslProjection, resolveProfile, statusForAwaitableOutcome, validateAgentEngineVerificationV2PacketReferences, validateAgentExecutionPathBinding, validateAgentTaskReceiptBinding, validateAgentTaskReceiptV2Binding, validateAgentTaskReceiptV2PacketReferences, validateHumanActionReceiptBinding, writeGateImpactReceipt };
9975
+ export { AGENT_ENGINE_VERIFICATION_V2_VERSION, AGENT_TASK_RECEIPT_PATCH_PROFILE, AGENT_TASK_RECEIPT_V2_VERSION, AGENT_WORK_CONTRACT_VERSION, ATTEMPT_AWAITABLE_CONTRACT_VERSION, AXF_AWAITABLE_SCHEMA_VERSION, AXF_AWAIT_RESULT_SCHEMA_VERSION, type AcknowledgeAttemptAwaitableDeliveryInput, AgentEngineVerification_v1, AgentEngineVerification_v2, type AgentExecutionPathBindingContext, type AgentExecutionPathBindingValidation, AgentExecutionPathMapping_v1, type AgentTaskPacketHashInput, AgentTaskPacketHashInput_v1, AgentTaskPacket_v1, type AgentTaskReceiptBindingContext, AgentTaskReceiptOutcome, type AgentTaskReceiptV2BindingContext, AgentTaskReceipt_v1, AgentTaskReceipt_v2, AgentWorkContainmentPreflightRequestJsonSchema, AgentWorkFanInDecision_v1, type AgentWorkFanInResult, AgentWorkFanoutPlan_v1, AgentWorkFanoutService, type AgentWorkPreparationCommandResult, type AgentWorkPreparationCommandRunner, AgentWorkPreparationReceipt_v1, type AgentWorkPreparationResult, AttemptAcceptanceApplyRequestJsonSchema, AttemptAcceptanceStatusRequestJsonSchema, type AttemptAwaitableAttachmentResult, AttemptAwaitableCompletion_v1, AttemptAwaitableDelivery_v1, AttemptAwaitableEventType_v1, AttemptAwaitableEvent_v1, type AttemptAwaitableLeaseCredential, type AttemptAwaitableMutationFailureReason, type AttemptAwaitableNotifier, type AttemptAwaitableObservationRequest, type AttemptAwaitableObserver, AttemptAwaitableObserverLease_v1, AttemptAwaitableRecord_v1, AttemptAwaitableStatus_v1, type AttemptAwaitableStore, AttemptAwaitableSupervisor, type AttemptAwaitableSupervisorNotice, type AttemptAwaitableSupervisorOptions, AttemptAwaitableTerminalResult_v1, AttemptPrepareRequestJsonSchema, AttemptReceiptStatusRequestJsonSchema, AttemptReceiptSubmitRequestJsonSchema, AttemptRetryDeltaDimension_v1, AttemptRetryDelta_v1, AttemptStartRequestJsonSchema, AttemptStatus, AttemptStatusInputJsonSchema, AttemptVerificationRunRequestJsonSchema, AttemptVerificationStatusRequestJsonSchema, AttemptWorkerAttachRequestJsonSchema, AttemptWorkerEndRequestJsonSchema, AttemptWorkerHeartbeatRequestJsonSchema, AttemptWorkerStatusRequestJsonSchema, Attempt_v1, AuthorityEnvelope, AxfCliAttemptAwaitableObserver, type AxfCliAttemptAwaitableObserverOptions, AxfExternalAwaitResult_v1, type BeginAttemptAwaitableDeliveryInput, type BoundedDiscoveryResult, type BoundedGateRunResult, type BoundedIntegrationStatus, type BoundedMergeApplicationResult, type BoundedMergeOrderResult, type CancelAttemptAwaitableInput, type ClaimAttemptAwaitableObservationInput, type ClaimAttemptAwaitableObservationResult, ClaimedCheckOutcome, type CompleteAttemptAwaitableInput, ConfigurationQueryService, ControllerLease_v1, type CreateAgentWorkFanoutInput, type DecideAgentWorkFanInInput, DiscoveryQueryService, EXECUTION_PLAN_ARTIFACT_CONTRACT, EXECUTION_PLAN_CANONICALIZATION_PROFILE, EXECUTION_PLAN_HASH_DOMAIN, EXECUTION_PLAN_HASH_PROFILE, EngineVerificationCheckSource_v2, EngineVerificationDeterminism_v2, EngineVerificationTrustGapReason_v2, type ExecuteAgentWorkPreparationInput, ExecutionEnvelope_v1, ExecutionEnvironmentOS, type ExecutionPlanArtifactIdentity_v1, ExecutionPlanArtifactIdentity_v1Schema, type ExecutionPlanArtifact_v1, ExecutionPlanArtifact_v1Schema, ExecutionState, ExternalAwaitOutcome_v1, ExternalAwaitableDescriptor_v1, FanInCandidateConclusion_v1, FanoutAttemptBinding_v1, FanoutPremise_v1, FanoutRationale_v1, FanoutSelectionCriterion_v1, GATE_IMPACT_MODEL, GateExecutionService, GateExecutionServiceError, type GateExecutionServiceInput, type GateExecutionServiceResult, GateImpactService, GateImpactServiceError, GitHubAPI, GitObjectId, HumanActionPreconditions, HumanActionReceipt_v1, HumanActionRequest_v1, INTEGRATION_RECORD_REMOVAL_VERSION, INTEGRATION_RECORD_REPLACEMENTS, InMemoryAttemptAwaitableStore, IntegrationQueryServiceError, IntegrationRecordCompatibilityError, IntegrationRecordCompatibilityService, IntegrationStatusQueryService, MAX_ATTEMPT_AWAITABLE_DURATION_MS, MIN_ATTEMPT_AWAITABLE_DURATION_MS, type MergeApplicationExecution, type MergeApplicationFailureCode, type MergeApplicationRuntime, MergeApplicationService, MergeApplicationServiceError, MergeEligibilityEvaluator, MergeOrderQueryService, type MultiRepoPlanOptions$1 as MultiRepoPlanOptions, type MutateAttemptAwaitableResult, NATIVE_WSL_PROJECTION_CONTRACT_VERSION, NATIVE_WSL_PROJECTION_HASH_PROFILE, NativeDirectoryIdentityClaim_v1, NativeExecutionPathMapping_v1, NativeWslExecutionPathMapping_v1, NativeWslProjectionCleanupRequestJsonSchema, NativeWslProjectionInventoryObservation_v1, NativeWslProjectionInventoryState, NativeWslProjectionManifest_v1, NativeWslProjectionNextAction, NativeWslProjectionOutcome, NativeWslProjectionPathMapping_v1, NativeWslProjectionPlanAction, NativeWslProjectionPlanReason, NativeWslProjectionPlan_v1, NativeWslProjectionPrepareRequestJsonSchema, NativeWslProjectionQuarantineRequestJsonSchema, NativeWslProjectionReasonCode, NativeWslProjectionReceipt_v1, NativeWslProjectionRequestJsonSchema, NativeWslProjectionRequest_v1, NativeWslProjectionSelection_v1, NativeWslProjectionStatusRequestJsonSchema, NativeWslSourceObservation_v1, PLAN_ARTIFACT_REFERENCE_CONTRACT, type PlanArtifactAcquisition, type PlanArtifactFailureCode, type PlanArtifactIdentity, type PlanArtifactReference_v1, PlanArtifactReference_v1Schema, PlanArtifactRegistrationError, type PlanArtifactRegistrationFailureCode, PlanArtifactRegistrationService, type PlanArtifactScope_v1, PlanArtifactScope_v1Schema, PlanArtifactService, PlanArtifactServiceError, type PlanArtifactSource, PlanCreationService, type RegisterAttemptAwaitableInput, type RegisterAttemptAwaitableResult, type RegisterDurableAttemptAwaitableInput, type RegisterDurableAttemptAwaitableResult, type RegisterPlanArtifactInput, type RegisteredPlanArtifact, type ReleaseAttemptAwaitableObservationInput, type RepoTarget, type ResolvePlanArtifactInput, type ResolvedPlanArtifact, RunStatus, Run_v1, STRICT_FANOUT_SELECTION_CRITERIA, SqliteAttemptAwaitableStore, VerificationOutcome, WorkItem_v1, WorkerSessionBackend, WorkerSessionStatus, WorkerSession_v1, WorkspaceAllocationStatus, WorkspaceAllocation_v1, WorkspaceCleanupDisposition, WorkspaceConfigServiceError, WorkspaceDiagnosticsService, WorkspaceInitializationService, WorkspaceLeaseStatus, WorkspaceLease_v1, applyGateImpactSelection, asPlanValidationFailure, attemptStatusRequiresReceipt, attemptStatusRequiresVerification, bootstrapWorkspace, canonicalJSONStringify, completionForAttemptAwaitable, computeAgentEngineVerificationV2Hash, computeAgentTaskPacketHash, computeExecutionPlanArtifactDigest, computeFanInEvidenceSetHash, computeMergeOrder, containsAttemptAwaitableCredentialValue, createAgentTaskPacket, createAgentWorkContainmentPreflightHandler, createAttemptLifecycleHandlers, createAttemptReceiptHandlers, createAttemptVerificationHandlers, createAttemptWorkerHandlers, createFileAnalyzer, createGitHubAPI, createGitHubClient, createGitOperations, createNativeExecutionPathMapping, createNativeWslExecutionPathMapping, createNativeWslProjectionLifecycleHandlers, createNativeWslProjectionManifest, createNativeWslProjectionPathMapping, createNativeWslProjectionReceipt, createNativeWslProjectionRequest, createNativeWslProjectionSelection, createNativeWslSourceObservation, createRunManager, createWorkflowGuide, deliveryIdForAttemptAwaitable, detectProjectType, executeAgentWorkPreparation, executeGatesWithPolicy, formatPlanValidationFailure, formatPlanValidationFailureText, generateGitHubSnapshot, generateMultiRepoPlan, generatePlan, generatePlanFromGitHub, generateSnapshot, getEnvironmentSuggestions, healthChecker, initLocalOverlay, inspectRegisteredCliSurface, isTerminalAttemptStatus, loadInputs, loadPlan, main, nativeWslProjectionId, orderAgentWorkPreparationSteps, parseAgentEngineVerification, parseAgentEngineVerificationV2, parseAgentTaskPacket, parseAgentTaskReceipt, parseAgentTaskReceiptV2, parseAttempt, parseAttemptAwaitableDescriptor, parseAttemptAwaitableRecord, parseAttemptAwaitableTerminalResult, parseControllerLease, parseExecutionEnvelope, parseExternalAwaitableDescriptor, parseHumanActionReceipt, parseHumanActionRequest, parseRun, parseWorkItem, parseWorkerSession, parseWorkspaceAllocation, parseWorkspaceLease, planNativeWslProjection, resolveProfile, statusForAwaitableOutcome, validateAgentEngineVerificationV2PacketReferences, validateAgentExecutionPathBinding, validateAgentTaskReceiptBinding, validateAgentTaskReceiptV2Binding, validateAgentTaskReceiptV2PacketReferences, validateHumanActionReceiptBinding, writeGateImpactReceipt };