agentera 3.0.0-dev.20 → 3.0.0-dev.21
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/README.md +19 -0
- package/bundle/CHANGELOG.md +63 -70
- package/bundle/README.md +17 -0
- package/bundle/UPGRADE.md +38 -0
- package/bundle/references/adapters/package-surface-characterization.md +7 -0
- package/bundle/references/artifacts/artifact-registry-interface-model.yaml +3 -3
- package/bundle/references/artifacts/state-storage-authority.yaml +1446 -0
- package/bundle/references/cli/agent-ready-state-contract.yaml +11 -39
- package/bundle/references/cli/audience-namespace-cli-migration.yaml +30 -15
- package/bundle/references/meta/documentation-inventory.md +1 -0
- package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +18 -10
- package/bundle/skills/agentera/capabilities/audit/schemas/validation.yaml +10 -10
- package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +11 -6
- package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +3 -2
- package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +15 -8
- package/bundle/skills/agentera/capabilities/document/schemas/validation.yaml +13 -13
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +15 -9
- package/bundle/skills/agentera/references/contract.md +65 -23
- package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +15 -10
- package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +134 -3
- package/bundle/skills/agentera/schemas/artifacts/health.yaml +16 -10
- package/bundle/skills/agentera/schemas/artifacts/objective.yaml +18 -4
- package/bundle/skills/agentera/schemas/artifacts/plan.yaml +23 -1
- package/bundle/skills/agentera/schemas/artifacts/progress.yaml +16 -10
- package/bundle/skills/agentera/schemas/artifacts/todo.yaml +34 -0
- package/dist/capabilities/audit/instructions.js +1 -1
- package/dist/capabilities/audit/instructions.js.map +1 -1
- package/dist/capabilities/build/instructions.js +1 -1
- package/dist/capabilities/build/instructions.js.map +1 -1
- package/dist/capabilities/discuss/instructions.js +1 -1
- package/dist/capabilities/discuss/instructions.js.map +1 -1
- package/dist/capabilities/document/instructions.js +1 -1
- package/dist/capabilities/document/instructions.js.map +1 -1
- package/dist/capabilities/optimize/instructions.js +1 -1
- package/dist/capabilities/optimize/instructions.js.map +1 -1
- package/dist/capabilities/orchestrate/instructions.js +1 -1
- package/dist/capabilities/orchestrate/instructions.js.map +1 -1
- package/dist/capabilities/plan/instructions.js +1 -1
- package/dist/capabilities/plan/instructions.js.map +1 -1
- package/dist/capabilities/profile/instructions.js +1 -1
- package/dist/capabilities/profile/instructions.js.map +1 -1
- package/dist/capabilities/vision/instructions.js +1 -1
- package/dist/capabilities/vision/instructions.js.map +1 -1
- package/dist/cli/appContext.js +14 -6
- package/dist/cli/appContext.js.map +1 -1
- package/dist/cli/capabilityContext/bespoke.js +3 -1
- package/dist/cli/capabilityContext/bespoke.js.map +1 -1
- package/dist/cli/capabilityContext/build.js +5 -4
- package/dist/cli/capabilityContext/build.js.map +1 -1
- package/dist/cli/capabilityContext/closeout.js +2 -1
- package/dist/cli/capabilityContext/closeout.js.map +1 -1
- package/dist/cli/capabilityContext/contract.js +29 -0
- package/dist/cli/capabilityContext/contract.js.map +1 -1
- package/dist/cli/capabilityContext/evidence.js +21 -20
- package/dist/cli/capabilityContext/evidence.js.map +1 -1
- package/dist/cli/capabilityContext/orchestration.js +3 -2
- package/dist/cli/capabilityContext/orchestration.js.map +1 -1
- package/dist/cli/capabilityContext/progress.js +9 -4
- package/dist/cli/capabilityContext/progress.js.map +1 -1
- package/dist/cli/capabilityContext/slim.js +37 -6
- package/dist/cli/capabilityContext/slim.js.map +1 -1
- package/dist/cli/capabilityContext/startup.js +30 -6
- package/dist/cli/capabilityContext/startup.js.map +1 -1
- package/dist/cli/capabilityContext/types.js +14 -4
- package/dist/cli/capabilityContext/types.js.map +1 -1
- package/dist/cli/commands/backfill.js +194 -0
- package/dist/cli/commands/backfill.js.map +1 -0
- package/dist/cli/commands/compact.js +40 -11
- package/dist/cli/commands/compact.js.map +1 -1
- package/dist/cli/commands/durability.js +85 -0
- package/dist/cli/commands/durability.js.map +1 -0
- package/dist/cli/commands/migrate.js +677 -0
- package/dist/cli/commands/migrate.js.map +1 -0
- package/dist/cli/commands/prime/collectOrientationState.js +23 -0
- package/dist/cli/commands/prime/collectOrientationState.js.map +1 -1
- package/dist/cli/commands/prime/orientationOutput.js +4 -2
- package/dist/cli/commands/prime/orientationOutput.js.map +1 -1
- package/dist/cli/commands/query.js +20 -2
- package/dist/cli/commands/query.js.map +1 -1
- package/dist/cli/commands/schema.js +247 -69
- package/dist/cli/commands/schema.js.map +1 -1
- package/dist/cli/commands/state/decisions.js +28 -10
- package/dist/cli/commands/state/decisions.js.map +1 -1
- package/dist/cli/commands/state/experimentRecords.js +156 -0
- package/dist/cli/commands/state/experimentRecords.js.map +1 -0
- package/dist/cli/commands/state/get.js +141 -0
- package/dist/cli/commands/state/get.js.map +1 -0
- package/dist/cli/commands/state/index.js +2 -2
- package/dist/cli/commands/state/index.js.map +1 -1
- package/dist/cli/commands/state/list.js +159 -0
- package/dist/cli/commands/state/list.js.map +1 -0
- package/dist/cli/commands/state/plan.js +146 -41
- package/dist/cli/commands/state/plan.js.map +1 -1
- package/dist/cli/commands/state/planTasks.js +164 -0
- package/dist/cli/commands/state/planTasks.js.map +1 -0
- package/dist/cli/commands/state/plans.js +154 -0
- package/dist/cli/commands/state/plans.js.map +1 -0
- package/dist/cli/commands/state/write.js +8 -3
- package/dist/cli/commands/state/write.js.map +1 -1
- package/dist/cli/dispatch/check.js +71 -4
- package/dist/cli/dispatch/check.js.map +1 -1
- package/dist/cli/dispatch/index.js +48 -30
- package/dist/cli/dispatch/index.js.map +1 -1
- package/dist/cli/dispatch/lifecycle.js +4 -4
- package/dist/cli/dispatch/lifecycle.js.map +1 -1
- package/dist/cli/dispatch/state.js +23 -3
- package/dist/cli/dispatch/state.js.map +1 -1
- package/dist/cli/errors.js +13 -14
- package/dist/cli/errors.js.map +1 -1
- package/dist/cli/help.js +162 -3
- package/dist/cli/help.js.map +1 -1
- package/dist/cli/orientation.js +146 -34
- package/dist/cli/orientation.js.map +1 -1
- package/dist/cli/planArtifacts.js +31 -2
- package/dist/cli/planArtifacts.js.map +1 -1
- package/dist/cli/prime-blob.js +1 -0
- package/dist/cli/prime-blob.js.map +1 -1
- package/dist/cli/startupCompletenessContract.js +3 -2
- package/dist/cli/startupCompletenessContract.js.map +1 -1
- package/dist/cli/stateQuery.js +5 -3
- package/dist/cli/stateQuery.js.map +1 -1
- package/dist/core/text.js +11 -0
- package/dist/core/text.js.map +1 -0
- package/dist/hooks/compaction/apply.js +224 -46
- package/dist/hooks/compaction/apply.js.map +1 -1
- package/dist/hooks/compaction/dryRun.js +2 -0
- package/dist/hooks/compaction/dryRun.js.map +1 -1
- package/dist/hooks/compaction/index.js +4 -4
- package/dist/hooks/compaction/index.js.map +1 -1
- package/dist/hooks/compaction/parse.js +73 -5
- package/dist/hooks/compaction/parse.js.map +1 -1
- package/dist/hooks/compaction/retention.js +22 -21
- package/dist/hooks/compaction/retention.js.map +1 -1
- package/dist/hooks/compaction/status.js +116 -23
- package/dist/hooks/compaction/status.js.map +1 -1
- package/dist/hooks/sessionStart.js +39 -7
- package/dist/hooks/sessionStart.js.map +1 -1
- package/dist/hooks/validateArtifact/index.js +2 -2
- package/dist/hooks/validateArtifact/index.js.map +1 -1
- package/dist/hooks/validateArtifact/markdown.js +9 -9
- package/dist/hooks/validateArtifact/markdown.js.map +1 -1
- package/dist/hooks/validateArtifact/traversal.js +11 -9
- package/dist/hooks/validateArtifact/traversal.js.map +1 -1
- package/dist/registries/artifactRegistry.js +147 -44
- package/dist/registries/artifactRegistry.js.map +1 -1
- package/dist/release/releaseMetadata.js +95 -1
- package/dist/release/releaseMetadata.js.map +1 -1
- package/dist/state/archiveDiscovery.js +589 -0
- package/dist/state/archiveDiscovery.js.map +1 -0
- package/dist/state/archivePublication.js +225 -0
- package/dist/state/archivePublication.js.map +1 -0
- package/dist/state/archiveRecovery.js +238 -0
- package/dist/state/archiveRecovery.js.map +1 -0
- package/dist/state/archiveReplay.js +54 -0
- package/dist/state/archiveReplay.js.map +1 -0
- package/dist/state/decisionOverlay.js +255 -0
- package/dist/state/decisionOverlay.js.map +1 -0
- package/dist/state/directRetrieval.js +322 -0
- package/dist/state/directRetrieval.js.map +1 -0
- package/dist/state/durability.js +451 -0
- package/dist/state/durability.js.map +1 -0
- package/dist/state/experimentArchive.js +64 -0
- package/dist/state/experimentArchive.js.map +1 -0
- package/dist/state/experimentIdentity.js +191 -0
- package/dist/state/experimentIdentity.js.map +1 -0
- package/dist/state/experimentRetrieval.js +447 -0
- package/dist/state/experimentRetrieval.js.map +1 -0
- package/dist/state/gitBackfill.js +561 -0
- package/dist/state/gitBackfill.js.map +1 -0
- package/dist/state/gitBackfillAuthority.js +141 -0
- package/dist/state/gitBackfillAuthority.js.map +1 -0
- package/dist/state/gitBackfillHistory.js +278 -0
- package/dist/state/gitBackfillHistory.js.map +1 -0
- package/dist/state/gitBackfillOutput.js +209 -0
- package/dist/state/gitBackfillOutput.js.map +1 -0
- package/dist/state/healthRepair.js +70 -0
- package/dist/state/healthRepair.js.map +1 -0
- package/dist/state/legacyIdentity.js +48 -0
- package/dist/state/legacyIdentity.js.map +1 -0
- package/dist/state/legacyMigration.js +516 -0
- package/dist/state/legacyMigration.js.map +1 -0
- package/dist/state/legacyMigrationParser.js +489 -0
- package/dist/state/legacyMigrationParser.js.map +1 -0
- package/dist/state/listAccounting.js +55 -0
- package/dist/state/listAccounting.js.map +1 -0
- package/dist/state/listClassification.js +18 -0
- package/dist/state/listClassification.js.map +1 -0
- package/dist/state/listRetrieval.js +782 -0
- package/dist/state/listRetrieval.js.map +1 -0
- package/dist/state/migrationAuthority.js +413 -0
- package/dist/state/migrationAuthority.js.map +1 -0
- package/dist/state/migrationEnrichment.js +35 -0
- package/dist/state/migrationEnrichment.js.map +1 -0
- package/dist/state/planIdentity.js +45 -0
- package/dist/state/planIdentity.js.map +1 -0
- package/dist/state/planRetrieval.js +314 -0
- package/dist/state/planRetrieval.js.map +1 -0
- package/dist/state/planTaskRetrieval.js +285 -0
- package/dist/state/planTaskRetrieval.js.map +1 -0
- package/dist/state/projectionPolicy.js +184 -0
- package/dist/state/projectionPolicy.js.map +1 -0
- package/dist/state/retrievalAuthority.js +326 -0
- package/dist/state/retrievalAuthority.js.map +1 -0
- package/dist/state/startupProjection.js +498 -0
- package/dist/state/startupProjection.js.map +1 -0
- package/dist/state/write/experimentPublication.js +193 -0
- package/dist/state/write/experimentPublication.js.map +1 -0
- package/dist/state/write/explain.js +28 -14
- package/dist/state/write/explain.js.map +1 -1
- package/dist/state/write/helpers.js +8 -0
- package/dist/state/write/helpers.js.map +1 -0
- package/dist/state/write/index.js +1 -0
- package/dist/state/write/index.js.map +1 -1
- package/dist/state/write/lock.js +24 -1
- package/dist/state/write/lock.js.map +1 -1
- package/dist/state/write/mutation.js +190 -0
- package/dist/state/write/mutation.js.map +1 -0
- package/dist/state/write/operations.js +36 -2
- package/dist/state/write/operations.js.map +1 -1
- package/dist/state/write/planPublication.js +172 -0
- package/dist/state/write/planPublication.js.map +1 -0
- package/dist/state/write/transaction.js +238 -225
- package/dist/state/write/transaction.js.map +1 -1
- package/dist/upgrade/migrateArtifactsV2ToV3.js +2 -2
- package/dist/upgrade/migrateArtifactsV2ToV3.js.map +1 -1
- package/dist/validate/crossCapability.js +9 -6
- package/dist/validate/crossCapability.js.map +1 -1
- package/package.json +2 -2
|
@@ -3,13 +3,23 @@ export const CAPABILITY_NAMES = Object.keys(CAPABILITY_INSTRUCTIONS);
|
|
|
3
3
|
export const STATE_FAMILY_FALLBACK_COMMANDS = {
|
|
4
4
|
plan: "agentera state plan --format json",
|
|
5
5
|
docs: "agentera state docs --format json",
|
|
6
|
-
progress: "agentera state progress --format json",
|
|
7
|
-
health: "agentera state health --format json",
|
|
6
|
+
progress: "agentera state progress list --limit 20 --format json",
|
|
7
|
+
health: "agentera state health list --limit 20 --format json",
|
|
8
8
|
todo: "agentera state todo --format json",
|
|
9
|
-
decisions: "agentera state decisions --format json",
|
|
9
|
+
decisions: "agentera state decisions list --limit 20 --format json",
|
|
10
10
|
changelog: "agentera state query changelog --format json",
|
|
11
11
|
objective: "agentera state objective --format json",
|
|
12
|
-
experiments: "agentera state experiments --format json",
|
|
12
|
+
experiments: "agentera state experiments list --objective OBJECTIVE_ID --limit 20 --format json",
|
|
13
|
+
};
|
|
14
|
+
export const STATE_FAMILY_LIST_COMMANDS = {
|
|
15
|
+
progress: "agentera state progress list --limit 20 --format json",
|
|
16
|
+
decisions: "agentera state decisions list --limit 20 --format json",
|
|
17
|
+
health: "agentera state health list --limit 20 --format json",
|
|
18
|
+
};
|
|
19
|
+
export const STATE_FAMILY_GET_COMMANDS = {
|
|
20
|
+
progress: "agentera state progress get --number N --format json",
|
|
21
|
+
decisions: "agentera state decisions get --number N --format json",
|
|
22
|
+
health: "agentera state health get --number N --format json",
|
|
13
23
|
};
|
|
14
24
|
export const STARTUP_ENVELOPE_STATE_FAMILIES = new Set([
|
|
15
25
|
"plan", "docs", "progress", "health", "todo", "objective", "benchmark_context",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/capabilityContext/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAItE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,8BAA8B,GAA2B;IACpE,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,mCAAmC;IACzC,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/capabilityContext/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAItE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,8BAA8B,GAA2B;IACpE,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,mCAAmC;IACzC,QAAQ,EAAE,uDAAuD;IACjE,MAAM,EAAE,qDAAqD;IAC7D,IAAI,EAAE,mCAAmC;IACzC,SAAS,EAAE,wDAAwD;IACnE,SAAS,EAAE,8CAA8C;IACzD,SAAS,EAAE,wCAAwC;IACnD,WAAW,EAAE,mFAAmF;CACjG,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAA2B;IAChE,QAAQ,EAAE,uDAAuD;IACjE,SAAS,EAAE,wDAAwD;IACnE,MAAM,EAAE,qDAAqD;CAC9D,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAA2B;IAC/D,QAAQ,EAAE,sDAAsD;IAChE,SAAS,EAAE,uDAAuD;IAClE,MAAM,EAAE,oDAAoD;CAC7D,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,GAAG,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB;CAC/E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,4BAA4B,CAAC;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,wBAAwB,GACnC,kHAAkH,CAAC;AACrH,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACpD,uCAAuC;IACvC,yDAAyD;IACzD,6DAA6D;IAC7D,kDAAkD;CACnD,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,oBAAoB;IACpB,4BAA4B;IAC5B,qBAAqB;IACrB,wBAAwB;IACxB,yDAAyD;CAC1D,CAAC;AACF,MAAM,CAAC,MAAM,wCAAwC,GAAG;IACtD,sBAAsB,EACpB,0FAA0F;QAC1F,uFAAuF;IACzF,0BAA0B,EAAE,oFAAoF;IAChH,yBAAyB,EACvB,oFAAoF;QACpF,iDAAiD;CACpD,CAAC"}
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
import { emitInvalidInput } from "../errors.js";
|
|
2
|
+
import { emitStructured } from "../structured.js";
|
|
3
|
+
import { resolvePath } from "../../core/paths.js";
|
|
4
|
+
import { resolveSourceRoot } from "../../core/sourceRoot.js";
|
|
5
|
+
import { StateRetrievalFailure, } from "../../state/directRetrieval.js";
|
|
6
|
+
import { numberedArchiveArtifacts } from "../../state/archiveDiscovery.js";
|
|
7
|
+
import { stateGitBackfillContract } from "../../state/gitBackfillAuthority.js";
|
|
8
|
+
import { applyGitBackfill, inspectGitBackfill, previewGitBackfill, } from "../../state/gitBackfill.js";
|
|
9
|
+
import { renderGitBackfillText } from "../../state/gitBackfillOutput.js";
|
|
10
|
+
const BACKFILL_SYNTAX = "agentera state backfill [--project PATH] [--artifact ARTIFACT] [--number N] [--commit HASH] [--path PATH] [--limit N] [--dry-run|--apply --force] --format {text,json,yaml}";
|
|
11
|
+
const BACKFILL_DRY_RUN_EXAMPLE = "agentera state backfill --project PATH --artifact progress --number 1 --dry-run --format json";
|
|
12
|
+
const BACKFILL_APPLY_EXAMPLE = "agentera state backfill --project PATH --artifact progress --number 1 --apply --force --format json";
|
|
13
|
+
export function requestedBackfillFormat(argv) {
|
|
14
|
+
for (let index = 0; index < argv.length; index += 1) {
|
|
15
|
+
if (argv[index] === "--format") {
|
|
16
|
+
const value = argv[index + 1];
|
|
17
|
+
if (value === "json" || value === "yaml")
|
|
18
|
+
return value;
|
|
19
|
+
}
|
|
20
|
+
if (argv[index].startsWith("--format=")) {
|
|
21
|
+
const value = argv[index].slice("--format=".length);
|
|
22
|
+
if (value === "json" || value === "yaml")
|
|
23
|
+
return value;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
return "text";
|
|
27
|
+
}
|
|
28
|
+
function failure(message, format, syntax = BACKFILL_SYNTAX, validValues, example = BACKFILL_DRY_RUN_EXAMPLE) {
|
|
29
|
+
return {
|
|
30
|
+
format,
|
|
31
|
+
body: {
|
|
32
|
+
class: "invalid_request",
|
|
33
|
+
message,
|
|
34
|
+
syntax,
|
|
35
|
+
example,
|
|
36
|
+
...(validValues ? { valid_values: validValues } : {}),
|
|
37
|
+
},
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
function authorityFailure(error) {
|
|
41
|
+
const body = {
|
|
42
|
+
schemaVersion: "agentera.stateFailure.v1",
|
|
43
|
+
status: "fail",
|
|
44
|
+
error: {
|
|
45
|
+
class: "unsupported_state",
|
|
46
|
+
message: `Git backfill authority could not be loaded: ${error.message}`,
|
|
47
|
+
syntax: BACKFILL_SYNTAX,
|
|
48
|
+
example: BACKFILL_DRY_RUN_EXAMPLE,
|
|
49
|
+
recovery: "Repair references/artifacts/state-storage-authority.yaml and retry; no state was changed.",
|
|
50
|
+
details: { authority: "references/artifacts/state-storage-authority.yaml" },
|
|
51
|
+
},
|
|
52
|
+
};
|
|
53
|
+
return new StateRetrievalFailure(body, 1);
|
|
54
|
+
}
|
|
55
|
+
function emitAuthorityFailure(failure, format, io) {
|
|
56
|
+
const out = io.out ?? ((text) => process.stdout.write(text));
|
|
57
|
+
const err = io.err ?? ((text) => process.stderr.write(text));
|
|
58
|
+
if (format === "json" || format === "yaml")
|
|
59
|
+
emitStructured(failure.body, format, out);
|
|
60
|
+
else
|
|
61
|
+
err(`Error: ${failure.body.error.message}\nSyntax: ${failure.body.error.syntax}\nRecovery: ${failure.body.error.recovery}\n`);
|
|
62
|
+
return failure.exitCode;
|
|
63
|
+
}
|
|
64
|
+
export function parseBackfillArgs(argv) {
|
|
65
|
+
const args = { project: null, artifact: null, format: "text" };
|
|
66
|
+
const valueFlags = ["--project", "--artifact", "--number", "--limit", "--commit", "--path", "--format"];
|
|
67
|
+
for (let index = 0; index < argv.length; index += 1) {
|
|
68
|
+
const token = argv[index];
|
|
69
|
+
const flag = valueFlags.find((candidate) => token === candidate || token.startsWith(`${candidate}=`));
|
|
70
|
+
if (flag) {
|
|
71
|
+
const inline = token.startsWith(`${flag}=`);
|
|
72
|
+
const parsed = inline ? token.slice(flag.length + 1) : argv[++index];
|
|
73
|
+
if (parsed === undefined || parsed === "")
|
|
74
|
+
return { error: `argument ${flag}: expected a value` };
|
|
75
|
+
if (flag === "--project")
|
|
76
|
+
args.project = parsed;
|
|
77
|
+
else if (flag === "--artifact")
|
|
78
|
+
args.artifact = parsed;
|
|
79
|
+
else if (flag === "--commit")
|
|
80
|
+
args.commit = parsed;
|
|
81
|
+
else if (flag === "--path")
|
|
82
|
+
args.path = parsed;
|
|
83
|
+
else if (flag === "--format") {
|
|
84
|
+
if (parsed !== "text" && parsed !== "json" && parsed !== "yaml") {
|
|
85
|
+
return { error: `argument --format: invalid choice: '${parsed}'` };
|
|
86
|
+
}
|
|
87
|
+
args.format = parsed;
|
|
88
|
+
}
|
|
89
|
+
else {
|
|
90
|
+
if (!/^[1-9][0-9]*$/.test(parsed))
|
|
91
|
+
return { error: `argument ${flag}: invalid int value: '${parsed}'` };
|
|
92
|
+
const number = Number(parsed);
|
|
93
|
+
if (!Number.isSafeInteger(number))
|
|
94
|
+
return { error: `argument ${flag}: invalid int value: '${parsed}'` };
|
|
95
|
+
if (flag === "--number")
|
|
96
|
+
args.number = number;
|
|
97
|
+
else
|
|
98
|
+
args.limit = number;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
else if (token === "--dry-run")
|
|
102
|
+
args.dryRun = true;
|
|
103
|
+
else if (token === "--apply")
|
|
104
|
+
args.apply = true;
|
|
105
|
+
else if (token === "--force")
|
|
106
|
+
args.force = true;
|
|
107
|
+
else
|
|
108
|
+
return { error: `unrecognized arguments: ${token}` };
|
|
109
|
+
}
|
|
110
|
+
return args;
|
|
111
|
+
}
|
|
112
|
+
function validateBackfillArgs(args, sourceRoot) {
|
|
113
|
+
const contract = stateGitBackfillContract(sourceRoot);
|
|
114
|
+
const artifacts = numberedArchiveArtifacts(sourceRoot);
|
|
115
|
+
if (args.artifact && !artifacts.includes(args.artifact)) {
|
|
116
|
+
return `unsupported artifact '${args.artifact}'`;
|
|
117
|
+
}
|
|
118
|
+
if (args.number !== undefined && !args.artifact)
|
|
119
|
+
return "argument --number requires --artifact";
|
|
120
|
+
if (args.commit && (!args.artifact || args.number === undefined)) {
|
|
121
|
+
return "argument --commit requires --artifact and --number";
|
|
122
|
+
}
|
|
123
|
+
if (args.path && (!args.artifact || args.number === undefined)) {
|
|
124
|
+
return "argument --path requires --artifact and --number";
|
|
125
|
+
}
|
|
126
|
+
if (args.limit !== undefined && (args.limit < 1 || args.limit > contract.maximumLimit)) {
|
|
127
|
+
return `argument --limit must be between 1 and ${contract.maximumLimit}`;
|
|
128
|
+
}
|
|
129
|
+
if (args.apply && args.dryRun)
|
|
130
|
+
return "--apply and --dry-run are mutually exclusive";
|
|
131
|
+
if (args.apply && !args.force)
|
|
132
|
+
return "--apply requires explicit --force intent";
|
|
133
|
+
if (args.force && !args.apply)
|
|
134
|
+
return "--force requires --apply";
|
|
135
|
+
if (args.apply && contract.applyRequires.includes("--project PATH") && !args.project) {
|
|
136
|
+
return "--apply requires explicit --project PATH";
|
|
137
|
+
}
|
|
138
|
+
if (args.apply && (!args.artifact || args.number === undefined)) {
|
|
139
|
+
return "--apply requires exactly one --artifact and --number selector";
|
|
140
|
+
}
|
|
141
|
+
return null;
|
|
142
|
+
}
|
|
143
|
+
export function runBackfill(argv, io, sourceRootOverride) {
|
|
144
|
+
const format = requestedBackfillFormat(argv);
|
|
145
|
+
const sourceRoot = sourceRootOverride ?? resolveSourceRoot();
|
|
146
|
+
let contract;
|
|
147
|
+
try {
|
|
148
|
+
contract = stateGitBackfillContract(sourceRoot);
|
|
149
|
+
}
|
|
150
|
+
catch (error) {
|
|
151
|
+
return emitAuthorityFailure(authorityFailure(error), format, io);
|
|
152
|
+
}
|
|
153
|
+
const parsed = parseBackfillArgs(argv);
|
|
154
|
+
if ("error" in parsed) {
|
|
155
|
+
const invalid = failure(parsed.error, format === "yaml" ? "text" : format, contract.command);
|
|
156
|
+
return emitInvalidInput(io, invalid);
|
|
157
|
+
}
|
|
158
|
+
let validation;
|
|
159
|
+
try {
|
|
160
|
+
validation = validateBackfillArgs(parsed, sourceRoot);
|
|
161
|
+
}
|
|
162
|
+
catch (error) {
|
|
163
|
+
return emitAuthorityFailure(authorityFailure(error), format, io);
|
|
164
|
+
}
|
|
165
|
+
if (validation) {
|
|
166
|
+
const invalid = failure(validation, format === "yaml" ? "text" : format, contract.command, numberedArchiveArtifacts(sourceRoot), parsed.apply ? BACKFILL_APPLY_EXAMPLE : undefined);
|
|
167
|
+
return emitInvalidInput(io, invalid);
|
|
168
|
+
}
|
|
169
|
+
const mode = parsed.apply ? "apply" : parsed.dryRun ? "preview" : "inventory";
|
|
170
|
+
let response;
|
|
171
|
+
try {
|
|
172
|
+
const project = resolvePath(parsed.project ?? process.cwd());
|
|
173
|
+
const options = { sourceRoot };
|
|
174
|
+
if (mode === "apply")
|
|
175
|
+
response = applyGitBackfill(project, parsed, options);
|
|
176
|
+
else if (mode === "preview")
|
|
177
|
+
response = previewGitBackfill(project, parsed, options);
|
|
178
|
+
else
|
|
179
|
+
response = inspectGitBackfill(project, parsed, options);
|
|
180
|
+
}
|
|
181
|
+
catch (error) {
|
|
182
|
+
if (error instanceof StateRetrievalFailure)
|
|
183
|
+
return emitAuthorityFailure(error, format, io);
|
|
184
|
+
const invalid = failure(error.message, format === "yaml" ? "text" : format, contract.command, undefined, parsed.apply ? BACKFILL_APPLY_EXAMPLE : undefined);
|
|
185
|
+
return emitInvalidInput(io, invalid);
|
|
186
|
+
}
|
|
187
|
+
const out = io.out ?? ((text) => process.stdout.write(text));
|
|
188
|
+
if (format === "json" || format === "yaml")
|
|
189
|
+
emitStructured(response, format, out);
|
|
190
|
+
else
|
|
191
|
+
renderGitBackfillText(response, out);
|
|
192
|
+
return mode === "apply" && response.status !== "complete" ? 1 : 0;
|
|
193
|
+
}
|
|
194
|
+
//# sourceMappingURL=backfill.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../../src/cli/commands/backfill.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { resolvePath } from "../../core/paths.js";
|
|
2
2
|
import { runCompaction } from "../../hooks/compaction/index.js";
|
|
3
3
|
import { emitStructured } from "../structured.js";
|
|
4
|
+
import { boundStructuredProjection } from "../../state/projectionPolicy.js";
|
|
4
5
|
function pyStr(value) {
|
|
5
6
|
if (value === null || value === undefined)
|
|
6
7
|
return "None";
|
|
@@ -21,34 +22,49 @@ function compactionOperationPayload(op) {
|
|
|
21
22
|
archive_count: status.archive_count,
|
|
22
23
|
total_count: status.total_count,
|
|
23
24
|
over_limit_count: status.over_limit_count,
|
|
25
|
+
...(status.pending_summarization_count !== undefined
|
|
26
|
+
? { pending_summarization_count: status.pending_summarization_count }
|
|
27
|
+
: {}),
|
|
28
|
+
...(status.projection_state ? { projection_state: status.projection_state } : {}),
|
|
24
29
|
protected_overflow_count: status.protected_overflow_count ?? 0,
|
|
25
30
|
mode: op.mode,
|
|
26
31
|
action: op.action,
|
|
27
32
|
changed: op.changed,
|
|
28
33
|
message: op.message,
|
|
29
34
|
reason: status.reason,
|
|
35
|
+
...(status.projection_recovery ? { recovery: status.projection_recovery } : {}),
|
|
30
36
|
};
|
|
31
37
|
if (op.result !== null) {
|
|
38
|
+
const recovery = op.result.recovery;
|
|
32
39
|
payload.result = {
|
|
33
40
|
active_before: op.result.full_before,
|
|
34
41
|
archive_before: op.result.oneline_before,
|
|
35
42
|
active_after: op.result.full_after,
|
|
36
43
|
archive_after: op.result.oneline_after,
|
|
37
44
|
dropped: op.result.dropped,
|
|
45
|
+
omitted_count: op.result.omitted_count ?? 0,
|
|
46
|
+
...(op.result.omission_reason ? { omission_reason: op.result.omission_reason } : {}),
|
|
38
47
|
changed: op.result.changed,
|
|
48
|
+
...(recovery ? { recovery } : {}),
|
|
39
49
|
};
|
|
40
50
|
}
|
|
41
51
|
return payload;
|
|
42
52
|
}
|
|
43
53
|
function compactionGuidance(mode, operations) {
|
|
44
54
|
const over = operations.filter((op) => op.action === "over_limit" || op.action === "pending_fix");
|
|
55
|
+
const projections = operations.filter((op) => op.action === "projection" || op.action === "pending_projection");
|
|
56
|
+
const formatting = operations.filter((op) => op.action === "formatting" || op.action === "pending_formatting");
|
|
45
57
|
const protectedOps = operations.filter((op) => op.action === "protected_overflow");
|
|
46
58
|
const errors = operations.filter((op) => op.action === "error");
|
|
47
|
-
const
|
|
48
|
-
const
|
|
59
|
+
const refused = operations.filter((op) => op.action === "refused");
|
|
60
|
+
const checkCommand = "npx -y agentera check compact --mode check --format json";
|
|
61
|
+
const fixCommand = "npx -y agentera check compact --mode fix --format json";
|
|
49
62
|
if (errors.length > 0) {
|
|
50
63
|
return `Inspect the reported errors, repair invalid artifacts, then rerun \`${checkCommand}\`.`;
|
|
51
64
|
}
|
|
65
|
+
if (refused.length > 0) {
|
|
66
|
+
return "Projection changes were safely refused until each full entry has a verified numbered archive; inspect recovery metadata and retry after recovery.";
|
|
67
|
+
}
|
|
52
68
|
if (protectedOps.length > 0) {
|
|
53
69
|
const artifacts = protectedOps.map((op) => op.status.artifact).join(", ");
|
|
54
70
|
return (`Protected-overflow review pressure blocks compaction for: ${artifacts}. ` +
|
|
@@ -61,23 +77,36 @@ function compactionGuidance(mode, operations) {
|
|
|
61
77
|
if (mode === "fix" && over.length > 0) {
|
|
62
78
|
return "Some artifacts remain over limit; inspect skipped or unsupported artifacts before manual remediation.";
|
|
63
79
|
}
|
|
64
|
-
|
|
80
|
+
if (formatting.length > 0) {
|
|
81
|
+
const artifacts = formatting.map((op) => op.status.artifact).join(", ");
|
|
82
|
+
return mode === "check"
|
|
83
|
+
? `Summary formatting is pending for: ${artifacts}. Safe fix: \`${fixCommand}\`.`
|
|
84
|
+
: `Summary formatting remains pending for: ${artifacts}; inspect the artifact diagnostics.`;
|
|
85
|
+
}
|
|
86
|
+
if (projections.length > 0) {
|
|
87
|
+
return "Projection defaults are bounded; numbered archive records remain complete and authoritative.";
|
|
88
|
+
}
|
|
89
|
+
return "No repair needed. Compactable artifacts are within the configured projection defaults.";
|
|
65
90
|
}
|
|
66
91
|
function compactionSummary(mode, operations) {
|
|
67
92
|
const counts = {};
|
|
68
93
|
for (const op of operations)
|
|
69
94
|
counts[op.action] = (counts[op.action] ?? 0) + 1;
|
|
70
95
|
const overLimit = operations.filter((op) => op.action === "over_limit" || op.action === "pending_fix").length;
|
|
96
|
+
const projections = operations.filter((op) => op.action === "projection" || op.action === "pending_projection").length;
|
|
97
|
+
const formatting = operations.filter((op) => op.action === "formatting" || op.action === "pending_formatting").length;
|
|
71
98
|
const protectedOverflow = operations.filter((op) => op.action === "protected_overflow").length;
|
|
72
99
|
const errors = operations.filter((op) => op.action === "error").length;
|
|
73
100
|
const changed = operations.filter((op) => op.changed).length;
|
|
74
|
-
const status = errors ||
|
|
101
|
+
const status = errors || (mode === "check" && (overLimit || formatting)) ? "fail" : "pass";
|
|
75
102
|
return {
|
|
76
103
|
status,
|
|
77
104
|
mode,
|
|
78
105
|
artifact_count: operations.length,
|
|
79
106
|
over_limit_count: overLimit,
|
|
107
|
+
formatting_count: formatting,
|
|
80
108
|
protected_overflow_count: protectedOverflow,
|
|
109
|
+
projection_count: projections,
|
|
81
110
|
error_count: errors,
|
|
82
111
|
changed_count: changed,
|
|
83
112
|
action_counts: counts,
|
|
@@ -87,9 +116,8 @@ function compactionSummary(mode, operations) {
|
|
|
87
116
|
function compactionExitCode(mode, operations) {
|
|
88
117
|
if (operations.some((op) => op.action === "error"))
|
|
89
118
|
return 2;
|
|
90
|
-
if (
|
|
91
|
-
|
|
92
|
-
if (mode === "check" && operations.some((op) => op.action === "over_limit"))
|
|
119
|
+
if (mode === "check" &&
|
|
120
|
+
operations.some((op) => op.action === "over_limit" || op.action === "formatting"))
|
|
93
121
|
return 1;
|
|
94
122
|
return 0;
|
|
95
123
|
}
|
|
@@ -107,13 +135,14 @@ function emitCompactionPayload(payload, mode, format, out) {
|
|
|
107
135
|
const summary = payload.summary;
|
|
108
136
|
const project = payload.project;
|
|
109
137
|
if (format === "json") {
|
|
110
|
-
emitStructured(payload, "json", out);
|
|
138
|
+
emitStructured(boundStructuredProjection(payload, "compact", "json"), "json", out);
|
|
111
139
|
return;
|
|
112
140
|
}
|
|
113
141
|
out(`status=${summary.status} | mode=${mode} | project=${project}\n`);
|
|
114
142
|
out("counts=" +
|
|
115
143
|
`artifacts:${summary.artifact_count} ` +
|
|
116
144
|
`over_limit:${summary.over_limit_count} ` +
|
|
145
|
+
`formatting:${summary.formatting_count} ` +
|
|
117
146
|
`protected_overflow:${summary.protected_overflow_count} ` +
|
|
118
147
|
`errors:${summary.error_count} ` +
|
|
119
148
|
`changed:${summary.changed_count}\n`);
|
|
@@ -122,6 +151,7 @@ function emitCompactionPayload(payload, mode, format, out) {
|
|
|
122
151
|
`classification=${item.classification} | path=${item.path} | ` +
|
|
123
152
|
`active=${pyStr(item.active_count)} | archive=${pyStr(item.archive_count)} | ` +
|
|
124
153
|
`total=${pyStr(item.total_count)} | over=${pyStr(item.over_limit_count)} | ` +
|
|
154
|
+
`pending_summarization=${pyStr(item.pending_summarization_count)} | ` +
|
|
125
155
|
`protected_overflow=${item.protected_overflow_count} | ` +
|
|
126
156
|
`message=${item.message}\n`);
|
|
127
157
|
}
|
|
@@ -132,7 +162,7 @@ export function cmdCompact(args, io = {}) {
|
|
|
132
162
|
const mode = args.mode ?? "check";
|
|
133
163
|
const project = resolvePath(args.project ?? process.cwd());
|
|
134
164
|
const operations = runCompaction(project, mode);
|
|
135
|
-
const payload = compactionPayload("compact", project, mode, operations);
|
|
165
|
+
const payload = compactionPayload("check compact", project, mode, operations);
|
|
136
166
|
emitCompactionPayload(payload, mode, args.format ?? "text", out);
|
|
137
167
|
return compactionExitCode(mode, operations);
|
|
138
168
|
}
|
|
@@ -140,8 +170,7 @@ export function cmdGate(args, io = {}) {
|
|
|
140
170
|
const out = io.out ?? ((t) => process.stdout.write(t));
|
|
141
171
|
const project = resolvePath(args.project ?? process.cwd());
|
|
142
172
|
const operations = runCompaction(project, "check");
|
|
143
|
-
const payload = compactionPayload("
|
|
144
|
-
payload.gate = "compaction";
|
|
173
|
+
const payload = compactionPayload("check compact", project, "check", operations);
|
|
145
174
|
emitCompactionPayload(payload, "check", args.format ?? "text", out);
|
|
146
175
|
return compactionExitCode("check", operations);
|
|
147
176
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"compact.js","sourceRoot":"","sources":["../../../src/cli/commands/compact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAuB,MAAM,iCAAiC,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"compact.js","sourceRoot":"","sources":["../../../src/cli/commands/compact.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { resolvePath } from "../../core/paths.js";
|
|
2
|
+
import { resolveSourceRoot } from "../../core/sourceRoot.js";
|
|
3
|
+
import { emitStructured } from "../structured.js";
|
|
4
|
+
import { numberedArchiveArtifacts, stateDurabilityContract, } from "../../state/archiveDiscovery.js";
|
|
5
|
+
import { StateRetrievalFailure, } from "../../state/directRetrieval.js";
|
|
6
|
+
import { inspectDurability, renderDurabilityText, } from "../../state/durability.js";
|
|
7
|
+
export function requestedDurabilityFormat(argv) {
|
|
8
|
+
for (let index = 0; index < argv.length; index += 1) {
|
|
9
|
+
if (argv[index] === "--format") {
|
|
10
|
+
const value = argv[index + 1];
|
|
11
|
+
if (value === "json" || value === "yaml")
|
|
12
|
+
return value;
|
|
13
|
+
}
|
|
14
|
+
if (argv[index].startsWith("--format=")) {
|
|
15
|
+
const value = argv[index].slice("--format=".length);
|
|
16
|
+
if (value === "json" || value === "yaml")
|
|
17
|
+
return value;
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
return "text";
|
|
21
|
+
}
|
|
22
|
+
export function durabilityFailure(className, message, sourceRoot, artifact, entryNumber, validValues) {
|
|
23
|
+
const contract = stateDurabilityContract(sourceRoot);
|
|
24
|
+
const exampleArtifact = artifact && validValues?.includes(artifact) ? artifact : "progress";
|
|
25
|
+
const exampleNumber = entryNumber ?? 1;
|
|
26
|
+
const example = `agentera check durability --artifact ${exampleArtifact} --number ${exampleNumber} --format json`;
|
|
27
|
+
const body = {
|
|
28
|
+
schemaVersion: "agentera.stateFailure.v1",
|
|
29
|
+
status: "fail",
|
|
30
|
+
error: {
|
|
31
|
+
class: className,
|
|
32
|
+
message,
|
|
33
|
+
syntax: contract.command,
|
|
34
|
+
example,
|
|
35
|
+
recovery: "Correct the command using the valid syntax and retry; no state was changed.",
|
|
36
|
+
...(artifact ? { artifact_id: artifact } : {}),
|
|
37
|
+
...(entryNumber !== undefined
|
|
38
|
+
? { entry_number: entryNumber, stable_id: `${artifact ?? exampleArtifact}:${entryNumber}` }
|
|
39
|
+
: {}),
|
|
40
|
+
...(validValues ? { valid_values: validValues } : {}),
|
|
41
|
+
},
|
|
42
|
+
};
|
|
43
|
+
return new StateRetrievalFailure(body, 2);
|
|
44
|
+
}
|
|
45
|
+
export function validateDurabilityArgs(args, sourceRoot) {
|
|
46
|
+
const contract = stateDurabilityContract(sourceRoot);
|
|
47
|
+
const validArtifacts = numberedArchiveArtifacts(sourceRoot);
|
|
48
|
+
if (args.artifact && !validArtifacts.includes(args.artifact)) {
|
|
49
|
+
throw durabilityFailure("unsupported_artifact", `unsupported durability artifact '${args.artifact}'`, sourceRoot, args.artifact, undefined, validArtifacts);
|
|
50
|
+
}
|
|
51
|
+
if (args.number !== undefined && !args.artifact) {
|
|
52
|
+
throw durabilityFailure("invalid_request", "argument --number requires --artifact", sourceRoot, undefined, args.number, validArtifacts);
|
|
53
|
+
}
|
|
54
|
+
if (args.limit !== undefined && (args.limit < 1 || args.limit > contract.maximumLimit)) {
|
|
55
|
+
throw durabilityFailure("invalid_request", `argument --limit must be between 1 and ${contract.maximumLimit}`, sourceRoot, args.artifact, undefined, validArtifacts);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
export function emitDurabilityFailure(failure, format, io) {
|
|
59
|
+
const out = io.out ?? ((text) => process.stdout.write(text));
|
|
60
|
+
if (format === "json" || format === "yaml")
|
|
61
|
+
emitStructured(failure.body, format, out);
|
|
62
|
+
else {
|
|
63
|
+
const details = failure.body.error;
|
|
64
|
+
out([
|
|
65
|
+
`Error: ${details.message}`,
|
|
66
|
+
`Class: ${details.class}`,
|
|
67
|
+
`Syntax: ${details.syntax}`,
|
|
68
|
+
`Example: ${details.example}`,
|
|
69
|
+
`Recovery: ${details.recovery}`,
|
|
70
|
+
].join("\n") + "\n");
|
|
71
|
+
}
|
|
72
|
+
return failure.exitCode;
|
|
73
|
+
}
|
|
74
|
+
export function cmdDurability(args, io = {}) {
|
|
75
|
+
const output = io.out ?? ((text) => process.stdout.write(text));
|
|
76
|
+
const response = inspectDurability(resolvePath(args.project ?? process.cwd()), args, { sourceRoot: resolveSourceRoot() });
|
|
77
|
+
if (args.format === "json" || args.format === "yaml") {
|
|
78
|
+
emitStructured(response, args.format, output);
|
|
79
|
+
}
|
|
80
|
+
else {
|
|
81
|
+
renderDurabilityText(response, output);
|
|
82
|
+
}
|
|
83
|
+
return 0;
|
|
84
|
+
}
|
|
85
|
+
//# sourceMappingURL=durability.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"durability.js","sourceRoot":"","sources":["../../../src/cli/commands/durability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,qBAAqB,GAGtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,UAAU,yBAAyB,CAAC,IAAc;IACtD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM;gBAAE,OAAO,KAAK,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM;gBAAE,OAAO,KAAK,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAA4B,EAC5B,OAAe,EACf,UAAkB,EAClB,QAAwB,EACxB,WAAoB,EACpB,WAAsB;IAEtB,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,QAAQ,IAAI,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IAC5F,MAAM,aAAa,GAAG,WAAW,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,wCAAwC,eAAe,aAAa,aAAa,gBAAgB,CAAC;IAClH,MAAM,IAAI,GAAqB;QAC7B,aAAa,EAAE,0BAA0B;QACzC,MAAM,EAAE,MAAM;QACd,KAAK,EAAE;YACL,KAAK,EAAE,SAAS;YAChB,OAAO;YACP,MAAM,EAAE,QAAQ,CAAC,OAAO;YACxB,OAAO;YACP,QAAQ,EAAE,6EAA6E;YACvF,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,WAAW,KAAK,SAAS;gBAC3B,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,QAAQ,IAAI,eAAe,IAAI,WAAW,EAAE,EAAE;gBAC3F,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD;KACF,CAAC;IACF,OAAO,IAAI,qBAAqB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAoB,EAAE,UAAkB;IAC7E,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7D,MAAM,iBAAiB,CACrB,sBAAsB,EACtB,oCAAoC,IAAI,CAAC,QAAQ,GAAG,EACpD,UAAU,EACV,IAAI,CAAC,QAAQ,EACb,SAAS,EACT,cAAc,CACf,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,iBAAiB,CACrB,iBAAiB,EACjB,uCAAuC,EACvC,UAAU,EACV,SAAS,EACT,IAAI,CAAC,MAAM,EACX,cAAc,CACf,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACvF,MAAM,iBAAiB,CACrB,iBAAiB,EACjB,0CAA0C,QAAQ,CAAC,YAAY,EAAE,EACjE,UAAU,EACV,IAAI,CAAC,QAAQ,EACb,SAAS,EACT,cAAc,CACf,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA8B,EAC9B,MAAgC,EAChC,EAAM;IAEN,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM;QAAE,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;SACjF,CAAC;QACJ,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QACnC,GAAG,CACD;YACE,UAAU,OAAO,CAAC,OAAO,EAAE;YAC3B,UAAU,OAAO,CAAC,KAAK,EAAE;YACzB,WAAW,OAAO,CAAC,MAAM,EAAE;YAC3B,YAAY,OAAO,CAAC,OAAO,EAAE;YAC7B,aAAa,OAAO,CAAC,QAAQ,EAAE;SAChC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CACpB,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAoB,EAAE,KAAS,EAAE;IAC7D,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,iBAAiB,CAChC,WAAW,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,EAC1C,IAAI,EACJ,EAAE,UAAU,EAAE,iBAAiB,EAAE,EAAE,CACpC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACrD,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}
|