agentera 3.0.0-dev.6 → 3.0.0-dev.69
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/LICENSE +201 -0
- package/README.md +118 -22
- package/bundle/CHANGELOG.md +1361 -0
- package/bundle/DESIGN.md +229 -0
- package/bundle/LICENSE +201 -0
- package/bundle/README.md +143 -0
- package/bundle/UPGRADE.md +252 -0
- package/bundle/extract-corpus-parity.json +21 -0
- package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
- package/bundle/references/adapters/package-publication.json +488 -0
- package/bundle/references/adapters/package-registry.yaml +435 -188
- package/bundle/references/adapters/package-surface-characterization.md +66 -34
- package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +74 -0
- package/bundle/references/adapters/runtime-lifecycle-authority.yaml +62 -0
- package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
- package/bundle/references/adapters/runtime-retired-resources.yaml +333 -0
- package/bundle/references/analysis/evidence-tier-authority.yaml +518 -0
- package/bundle/references/analysis/verification-policy.yaml +266 -0
- package/bundle/references/artifacts/artifact-registry-interface-model.yaml +20 -10
- package/bundle/references/artifacts/glossary-entry-contract.yaml +1254 -0
- package/bundle/references/artifacts/state-storage-authority.yaml +3061 -0
- package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
- package/bundle/references/cli/app-lifecycle-vocabulary.yaml +7 -8
- package/bundle/references/cli/capability-instruction-contract.yaml +11 -14
- package/bundle/references/cli/hybrid-route-contract.yaml +438 -0
- package/bundle/references/cli/routing-model.md +155 -0
- package/bundle/references/cli/trigger-schema-enrichment.md +147 -0
- package/bundle/references/cli/update-channels.yaml +19 -2
- package/bundle/references/cli/vocabulary-index.yaml +20 -17
- package/bundle/references/cli/vocabulary.md +325 -362
- package/bundle/references/meta/retained-reference-authority.yaml +151 -0
- package/bundle/registry.json +13 -13
- package/bundle/skills/agentera/SKILL.md +226 -422
- package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +84 -0
- package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +25 -0
- package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/validation.yaml +37 -18
- package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +103 -0
- package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +8 -6
- package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +27 -0
- package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +184 -0
- package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/artifacts.yaml +12 -12
- package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/exit.yaml +5 -5
- package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +16 -0
- package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml +7 -7
- package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +51 -0
- package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +20 -0
- package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +144 -0
- package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +80 -0
- package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +16 -0
- package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml +18 -18
- package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml +18 -18
- package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +16 -0
- package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml +9 -9
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +76 -0
- package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/exit.yaml +9 -7
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +23 -0
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +121 -0
- package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +66 -0
- package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +23 -0
- package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +121 -0
- package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +23 -0
- package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/exit.yaml +6 -5
- package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +20 -0
- package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +115 -0
- package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +24 -0
- package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +16 -0
- package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/validation.yaml +2 -2
- package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +73 -0
- package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +22 -0
- package/bundle/skills/agentera/capabilities/{hej → status}/schemas/validation.yaml +5 -5
- package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/artifacts.yaml +16 -16
- package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/exit.yaml +7 -6
- package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +23 -0
- package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/validation.yaml +18 -20
- package/bundle/skills/agentera/capability_schema_contract.yaml +178 -34
- package/bundle/skills/agentera/protocol.yaml +31 -31
- package/bundle/skills/agentera/route-phrases.yaml +81 -0
- package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +5 -4
- package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +39 -21
- package/bundle/skills/agentera/schemas/artifacts/design.yaml +5 -4
- package/bundle/skills/agentera/schemas/artifacts/docs.yaml +15 -19
- package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +145 -14
- package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +82 -0
- package/bundle/skills/agentera/schemas/artifacts/health.yaml +58 -21
- package/bundle/skills/agentera/schemas/artifacts/objective.yaml +22 -8
- package/bundle/skills/agentera/schemas/artifacts/plan.yaml +461 -36
- package/bundle/skills/agentera/schemas/artifacts/progress.yaml +133 -20
- package/bundle/skills/agentera/schemas/artifacts/todo.yaml +342 -42
- package/bundle/skills/agentera/schemas/artifacts/vision.yaml +3 -3
- package/dist/analytics/extractCorpus/cli.js +101 -12
- package/dist/analytics/extractCorpus/copilotSessions.js +53 -9
- package/dist/analytics/extractCorpus/core.js +59 -24
- package/dist/analytics/extractCorpus/corpus.js +58 -23
- package/dist/analytics/extractCorpus/coverageAudit.js +260 -0
- package/dist/analytics/extractCorpus/cursorSessions.js +12 -7
- package/dist/analytics/extractCorpus/evidenceTiers.js +603 -0
- package/dist/analytics/extractCorpus/extractCorpusParity.js +105 -0
- package/dist/analytics/extractCorpus/filesystemSources.js +1 -5
- package/dist/analytics/extractCorpus/index.js +6 -1
- package/dist/analytics/extractCorpus/jsonlSessions.js +24 -5
- package/dist/analytics/extractCorpus/sqliteCaps.js +43 -0
- package/dist/analytics/extractCorpus/sqliteSessions.js +98 -6
- package/dist/analytics/extractCorpus/tierReader.js +108 -0
- package/dist/analytics/extractCorpus.js +0 -1
- package/dist/analytics/glossaryAdviceResolution.js +166 -0
- package/dist/analytics/glossaryInputAcquisition.js +319 -0
- package/dist/analytics/personalGlossaryAdmission.js +133 -0
- package/dist/analytics/personalGlossaryProfile.js +219 -0
- package/dist/analytics/profileSignals.js +211 -0
- package/dist/analytics/usageStats.js +169 -42
- package/dist/audit/terminologyDrift.js +281 -0
- package/dist/bin/agentera.js +3 -2
- package/dist/capabilities/audit/instructions.js +16 -0
- package/dist/capabilities/build/instructions.js +59 -0
- package/dist/capabilities/design/instructions.js +4 -0
- package/dist/capabilities/discuss/instructions.js +29 -0
- package/dist/capabilities/document/instructions.js +11 -0
- package/dist/capabilities/index.js +29 -27
- package/dist/capabilities/optimize/instructions.js +14 -0
- package/dist/capabilities/orchestrate/instructions.js +42 -0
- package/dist/capabilities/plan/instructions.js +33 -0
- package/dist/capabilities/profile/instructions.js +70 -0
- package/dist/capabilities/research/instructions.js +5 -0
- package/dist/capabilities/status/instructions.js +15 -0
- package/dist/capabilities/status/startupInstructions.js +34 -0
- package/dist/capabilities/vision/instructions.js +4 -0
- package/dist/cli/appContext.js +30 -24
- package/dist/cli/argvalidate.js +0 -1
- package/dist/cli/capabilityContext/benchmark.js +25 -17
- package/dist/cli/capabilityContext/bespoke.js +31 -12
- package/dist/cli/capabilityContext/build.js +251 -0
- package/dist/cli/capabilityContext/closeout.js +33 -30
- package/dist/cli/capabilityContext/contract.js +39 -46
- package/dist/cli/capabilityContext/evidence.js +90 -73
- package/dist/cli/capabilityContext/index.js +1 -2
- package/dist/cli/capabilityContext/orchestration.js +45 -21
- package/dist/cli/capabilityContext/planState.js +93 -100
- package/dist/cli/capabilityContext/progress.js +60 -14
- package/dist/cli/capabilityContext/projectVerification.js +409 -0
- package/dist/cli/capabilityContext/shared.js +9 -20
- package/dist/cli/capabilityContext/slim.js +56 -10
- package/dist/cli/capabilityContext/startup.js +57 -115
- package/dist/cli/capabilityContext/startupAggregation.js +68 -0
- package/dist/cli/capabilityContext/types.js +37 -24
- package/dist/cli/capabilityContext.js +1 -2
- package/dist/cli/commands/appHome.js +22 -0
- package/dist/cli/commands/capability.js +4 -4
- package/dist/cli/commands/compact.js +163 -13
- package/dist/cli/commands/doctor.js +122 -114
- package/dist/cli/commands/durability.js +81 -0
- package/dist/cli/commands/glossaryAdvice.js +138 -0
- package/dist/cli/commands/lint.js +22 -8
- package/dist/cli/commands/personalGlossary.js +176 -0
- package/dist/cli/commands/prime/briefOrientation.js +746 -0
- package/dist/cli/commands/prime/buildExecutionRequest.js +165 -0
- package/dist/cli/commands/prime/bundleStatus.js +190 -0
- package/dist/cli/commands/prime/collectEntityOrientation.js +326 -0
- package/dist/cli/commands/prime/collectOrientationState.js +219 -0
- package/dist/cli/commands/prime/orientationOutput.js +421 -0
- package/dist/cli/commands/prime/types.js +1 -0
- package/dist/cli/commands/prime/v1Migration.js +38 -0
- package/dist/cli/commands/prime.js +80 -558
- package/dist/cli/commands/profileGrounding.js +55 -0
- package/dist/cli/commands/query.js +77 -52
- package/dist/cli/commands/report.js +88 -26
- package/dist/cli/commands/route.js +142 -0
- package/dist/cli/commands/schema.js +266 -142
- package/dist/cli/commands/state/decisions.js +51 -61
- package/dist/cli/commands/state/docs.js +63 -86
- package/dist/cli/commands/state/experimentRecords.js +151 -0
- package/dist/cli/commands/state/experiments.js +11 -64
- package/dist/cli/commands/state/get.js +129 -0
- package/dist/cli/commands/state/health.js +11 -111
- package/dist/cli/commands/state/index.js +6 -41
- package/dist/cli/commands/state/list.js +194 -0
- package/dist/cli/commands/state/objective.js +21 -64
- package/dist/cli/commands/state/plan.js +11 -169
- package/dist/cli/commands/state/planTasks.js +154 -0
- package/dist/cli/commands/state/plans.js +154 -0
- package/dist/cli/commands/state/progress.js +11 -45
- package/dist/cli/commands/state/shared.js +0 -1
- package/dist/cli/commands/state/todo.js +29 -108
- package/dist/cli/commands/state/write.js +433 -0
- package/dist/cli/commands/upgrade.js +146 -5
- package/dist/cli/commands/upgradeVerify.js +118 -0
- package/dist/cli/commands/validate.js +246 -211
- package/dist/cli/commands/verify.js +24 -9
- package/dist/cli/contracts/bundleStatus.js +1 -0
- package/dist/cli/contracts/orientationState.js +1 -0
- package/dist/cli/dispatch/argvParser.js +32 -0
- package/dist/cli/dispatch/check.js +94 -50
- package/dist/cli/dispatch/commands.js +27 -0
- package/dist/cli/dispatch/index.js +82 -52
- package/dist/cli/dispatch/lifecycle.js +268 -108
- package/dist/cli/dispatch/prime.js +68 -29
- package/dist/cli/dispatch/projections.js +17 -0
- package/dist/cli/dispatch/shared.js +1 -2
- package/dist/cli/dispatch/state.js +68 -77
- package/dist/cli/dispatch.js +0 -1
- package/dist/cli/errors.js +16 -17
- package/dist/cli/help.js +395 -41
- package/dist/cli/migrationRequired.js +122 -0
- package/dist/cli/orientation/attention.js +61 -0
- package/dist/cli/orientation/corpusCoverage.js +102 -0
- package/dist/cli/orientation.js +438 -170
- package/dist/cli/planArtifacts.js +350 -0
- package/dist/cli/planEvidence.js +157 -0
- package/dist/cli/planLifecycleState.js +36 -0
- package/dist/cli/planTaskIndex.js +11 -0
- package/dist/cli/preCutoverCommand.js +32 -0
- package/dist/cli/prime-blob.js +71 -3
- package/dist/cli/profileAcquisition.js +167 -0
- package/dist/cli/startupCompletenessContract.js +59 -0
- package/dist/cli/stateQuery.js +56 -14
- package/dist/cli/structured.js +0 -1
- package/dist/cli/todoMarkdown.js +25 -12
- package/dist/cli/todoReadinessSelection.js +192 -0
- package/dist/cli/todoSeverity.js +18 -0
- package/dist/core/atomicWriter.js +20 -0
- package/dist/core/developmentChannel.js +1 -0
- package/dist/core/developmentInvocation.js +374 -0
- package/dist/core/difflib.js +0 -1
- package/dist/core/envPaths.js +20 -0
- package/dist/core/jsonValue.js +5 -0
- package/dist/core/paths.js +0 -1
- package/dist/core/pyjson.js +67 -3
- package/dist/core/shell.js +4 -0
- package/dist/core/skillIdentity.js +23 -0
- package/dist/core/sourceRoot.js +9 -12
- package/dist/core/text.js +10 -0
- package/dist/core/toml.js +0 -1
- package/dist/core/yaml.js +8 -1
- package/dist/eval/evalSkills.js +30 -26
- package/dist/eval/hybridRouteEvaluation.js +155 -0
- package/dist/eval/semanticEval.js +43 -20
- package/dist/eval/semanticFixtures.js +16 -5
- package/dist/hooks/common.js +3 -56
- package/dist/hooks/compaction/apply.js +252 -50
- package/dist/hooks/compaction/dryRun.js +7 -4
- package/dist/hooks/compaction/index.js +5 -6
- package/dist/hooks/compaction/parse.js +201 -5
- package/dist/hooks/compaction/retention.js +30 -25
- package/dist/hooks/compaction/status.js +149 -32
- package/dist/hooks/compaction/types.js +0 -1
- package/dist/hooks/validateArtifact/agentFacing.js +0 -1
- package/dist/hooks/validateArtifact/index.js +7 -64
- package/dist/hooks/validateArtifact/markdown.js +57 -7
- package/dist/hooks/validateArtifact/schema.js +110 -19
- package/dist/hooks/validateArtifact/traversal.js +13 -11
- package/dist/hooks/validateArtifact/violations.js +7 -5
- package/dist/migrate/v2HandoffManifest.js +127 -8
- package/dist/registries/activationContract.js +2 -0
- package/dist/registries/activationTuples.js +108 -0
- package/dist/registries/artifactProtocolIds.js +2 -1
- package/dist/registries/artifactRegistry.js +224 -63
- package/dist/registries/artifactSchemaProjection.js +45 -0
- package/dist/registries/capabilityContract.js +129 -2
- package/dist/registries/evaluatorHandoffContract.js +2 -3
- package/dist/registries/evidenceTierContract.js +371 -0
- package/dist/registries/glossaryAdviceContract.js +79 -0
- package/dist/registries/glossaryCaveatContract.js +67 -0
- package/dist/registries/glossaryConsumerContractValidation.js +787 -0
- package/dist/registries/glossaryEntryContract.js +757 -0
- package/dist/registries/glossaryTermIdentity.js +17 -0
- package/dist/registries/glossaryTermOccurrence.js +20 -0
- package/dist/registries/hybridRoute.js +274 -0
- package/dist/registries/hybridRouteReceipt.js +221 -0
- package/dist/registries/packagePublication.js +273 -0
- package/dist/registries/packageRegistry.js +187 -211
- package/dist/registries/todoReadinessContract.js +448 -0
- package/dist/registries/triggerLoader.js +174 -0
- package/dist/registries/verbosityBudgetContract.js +205 -0
- package/dist/release/releaseMetadata.js +156 -6
- package/dist/runtime/lifecycleAdapterContract.js +457 -0
- package/dist/runtime/lifecycleAdapters.js +777 -0
- package/dist/runtime/lifecycleAuthority.js +453 -0
- package/dist/runtime/lifecycleOperationContract.js +123 -0
- package/dist/runtime/lifecycleOperations.js +634 -0
- package/dist/runtime/lifecycleOwnershipJournal.js +622 -0
- package/dist/runtime/lifecyclePublication.js +415 -0
- package/dist/runtime/lifecycleSnapshot.js +438 -0
- package/dist/runtime/nativeResourceCleanup.js +502 -0
- package/dist/setup/opencode.js +20 -13
- package/dist/setup/opencodeConstants.js +1 -0
- package/dist/setup/sharedSkill.js +45 -0
- package/dist/setup/smokeChecks.js +21 -82
- package/dist/state/archiveDiscovery.js +580 -0
- package/dist/state/archivePublication.js +225 -0
- package/dist/state/archiveRecovery.js +237 -0
- package/dist/state/archiveReplay.js +53 -0
- package/dist/state/canonicalMigrationRecord.js +36 -0
- package/dist/state/changelog.js +221 -0
- package/dist/state/decisionEntities.js +367 -0
- package/dist/state/decisionLegacyValidation.js +215 -0
- package/dist/state/decisionMigrationProvenance.js +199 -0
- package/dist/state/decisionOverlay.js +254 -0
- package/dist/state/decisionRevision.js +256 -0
- package/dist/state/decisionRevisionMigration.js +89 -0
- package/dist/state/directRetrieval.js +323 -0
- package/dist/state/durability.js +324 -0
- package/dist/state/entityCutover.js +459 -0
- package/dist/state/entityCutoverGit.js +127 -0
- package/dist/state/entityGlossaryAuthority.js +13 -0
- package/dist/state/entityListProjection.js +187 -0
- package/dist/state/entityListRuntimeRegistry.js +85 -0
- package/dist/state/entityMigrationCausality.js +97 -0
- package/dist/state/entityMigrationIdentity.js +5 -0
- package/dist/state/entityMigrationPreview.js +840 -0
- package/dist/state/entityMigrationTodo.js +133 -0
- package/dist/state/entityPublicationContext.js +859 -0
- package/dist/state/entityRetrievalHelp.js +506 -0
- package/dist/state/entityStorage.js +899 -0
- package/dist/state/exactReplacementRecovery.js +18 -0
- package/dist/state/experimentArchive.js +63 -0
- package/dist/state/experimentIdentity.js +202 -0
- package/dist/state/healthEntities.js +262 -0
- package/dist/state/healthEntityValidation.js +18 -0
- package/dist/state/healthRepair.js +69 -0
- package/dist/state/installRoot.js +64 -25
- package/dist/state/legacyEntityCutoverEvidence.js +65 -0
- package/dist/state/legacyIdentity.js +47 -0
- package/dist/state/legacySummaryRecord.js +6 -0
- package/dist/state/listAccounting.js +54 -0
- package/dist/state/listClassification.js +17 -0
- package/dist/state/listCursor.js +42 -0
- package/dist/state/listRetrieval.js +781 -0
- package/dist/state/migrationSourceBinding.js +30 -0
- package/dist/state/objectiveExperimentEntities.js +322 -0
- package/dist/state/planEntities.js +1027 -0
- package/dist/state/planIdentity.js +47 -0
- package/dist/state/planLineageValidation.js +52 -0
- package/dist/state/planReplacementTransaction.js +475 -0
- package/dist/state/planRetrieval.js +313 -0
- package/dist/state/planTaskRetrieval.js +294 -0
- package/dist/state/progressEntities.js +512 -0
- package/dist/state/progressGlossaryCaveat.js +168 -0
- package/dist/state/progressPublicationOrder.js +19 -0
- package/dist/state/progressWritePolicy.js +33 -0
- package/dist/state/projectRoot.js +62 -0
- package/dist/state/projectionPolicy.js +190 -0
- package/dist/state/retrievalAuthority.js +156 -0
- package/dist/state/safeProjectFile.js +155 -0
- package/dist/state/startupAnalysis/benchmark.js +92 -27
- package/dist/state/startupAnalysis/contract.js +48 -10
- package/dist/state/startupAnalysis/helpers.js +27 -73
- package/dist/state/startupAnalysis/index.js +0 -1
- package/dist/state/startupAnalysis/metrics.js +25 -19
- package/dist/state/startupAnalysis/records.js +13 -10
- package/dist/state/startupAnalysis/report.js +26 -38
- package/dist/state/startupAnalysis/threshold.js +19 -7
- package/dist/state/startupAnalysis.js +0 -1
- package/dist/state/startupProjection.js +499 -0
- package/dist/state/stateMode.js +222 -0
- package/dist/state/stateStorageAuthority.js +47 -0
- package/dist/state/summaryEntityRead.js +25 -0
- package/dist/state/summaryMigrationProvenance.js +66 -0
- package/dist/state/summarySourceRowAuthority.js +36 -0
- package/dist/state/todoActivationSafety.js +58 -0
- package/dist/state/todoDocsEntities.js +1124 -0
- package/dist/state/todoDocsEntityValidation.js +158 -0
- package/dist/state/todoMarkdownProjection.js +51 -0
- package/dist/state/todoReconciliationActivation.js +182 -0
- package/dist/state/todoReconciliationInspection.js +171 -0
- package/dist/state/todoReconciliationRepair.js +318 -0
- package/dist/state/todoReconciliationTransaction.js +595 -0
- package/dist/state/write/assign.js +20 -0
- package/dist/state/write/candidateMutation.js +269 -0
- package/dist/state/write/errors.js +11 -0
- package/dist/state/write/experimentPublication.js +192 -0
- package/dist/state/write/explain.js +377 -0
- package/dist/state/write/fields.js +61 -0
- package/dist/state/write/glossaryPublication.js +263 -0
- package/dist/state/write/grammar.js +285 -0
- package/dist/state/write/helpers.js +29 -0
- package/dist/state/write/index.js +12 -0
- package/dist/state/write/input.js +391 -0
- package/dist/state/write/lock.js +837 -0
- package/dist/state/write/mutation.js +234 -0
- package/dist/state/write/operations.js +170 -0
- package/dist/state/write/planEvaluation.js +128 -0
- package/dist/state/write/planPublication.js +179 -0
- package/dist/state/write/runtimeOperations.js +146 -0
- package/dist/state/write/serialize.js +1 -0
- package/dist/state/write/transaction.js +57 -0
- package/dist/state/write/validate.js +7 -0
- package/dist/upgrade/appContentRefresh.js +383 -0
- package/dist/upgrade/appModel.js +8 -7
- package/dist/upgrade/atomicWriter.js +1 -0
- package/dist/upgrade/bundleEvidence.js +33 -0
- package/dist/upgrade/channels.js +12 -8
- package/dist/upgrade/compatibility.js +56 -21
- package/dist/upgrade/doctor.js +165 -199
- package/dist/upgrade/doctorClassifier.js +187 -0
- package/dist/upgrade/installedHooksRetirement.js +196 -0
- package/dist/upgrade/legacyAgentCleanup.js +282 -0
- package/dist/upgrade/lifecycleUpgrade.js +113 -0
- package/dist/upgrade/migrateArtifactsV2ToV3.js +375 -79
- package/dist/upgrade/migrationPublication.js +122 -0
- package/dist/upgrade/nextMajorDoctor.js +29 -10
- package/dist/upgrade/npxPlatformStatus.js +22 -0
- package/dist/upgrade/projectIntegration.js +145 -189
- package/dist/upgrade/projectIntegrationDecision.js +50 -0
- package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
- package/dist/upgrade/runtimeMigration.js +272 -373
- package/dist/upgrade/upgradeCommands.js +14 -1
- package/dist/upgrade/upgradeLock.js +85 -0
- package/dist/upgrade/upgradeOrchestrator.js +263 -59
- package/dist/upgrade/v3CapabilitySurface.js +2 -3
- package/dist/upgrade/versionResolution.js +2 -3
- package/dist/validate/activationArtifactEvidence.js +852 -0
- package/dist/validate/activationArtifactEvidenceTypes.js +12 -0
- package/dist/validate/activationConjunction.js +816 -0
- package/dist/validate/activationEvidenceManifest.js +531 -0
- package/dist/validate/activationPackageSemantics.js +29 -0
- package/dist/validate/appHomeContract.js +2 -8
- package/dist/validate/bootstrapAuthority.js +44 -0
- package/dist/validate/capability.js +133 -12
- package/dist/validate/crossCapability.js +15 -10
- package/dist/validate/retainedReferenceAuthority.js +879 -0
- package/dist/validate/selfAudit.js +39 -45
- package/dist/validate/v1LegacyCruft.js +131 -0
- package/dist/validate/vocabularyAuthority.js +18 -13
- package/package.json +60 -29
- package/bundle/references/adapters/cursor.md +0 -213
- package/bundle/references/adapters/opencode.md +0 -530
- package/bundle/references/adapters/package-manifest-interface-model.yaml +0 -337
- package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
- package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
- package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -548
- package/bundle/references/adapters/runtime-feature-parity.md +0 -189
- package/bundle/references/analysis/benchmark.md +0 -267
- package/bundle/references/analysis/startup-measurement-contract.yaml +0 -424
- package/bundle/references/cli/agent-ready-state-contract.yaml +0 -953
- package/bundle/references/cli/audience-namespace-cli-migration.yaml +0 -369
- package/bundle/references/cli/bundle-skill-vocabulary.yaml +0 -250
- package/bundle/references/cli/capability-tool-classification.yaml +0 -53
- package/bundle/references/cli/coexistence-probe.yaml +0 -9
- package/bundle/references/cli/routing-execution-vocabulary.yaml +0 -281
- package/bundle/references/cli/single-name-protocol.yaml +0 -42
- package/bundle/references/cli/upgrade-repair-wording.md +0 -31
- package/bundle/references/cli/v3-handoff-manifest.schema.yaml +0 -98
- package/bundle/references/meta/documentation-inventory.md +0 -49
- package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
- package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
- package/bundle/skills/agentera/agents/hej.toml +0 -6
- package/bundle/skills/agentera/agents/inspektera.toml +0 -6
- package/bundle/skills/agentera/agents/inspirera.toml +0 -6
- package/bundle/skills/agentera/agents/optimera.toml +0 -6
- package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
- package/bundle/skills/agentera/agents/planera.toml +0 -6
- package/bundle/skills/agentera/agents/profilera.toml +0 -6
- package/bundle/skills/agentera/agents/realisera.toml +0 -6
- package/bundle/skills/agentera/agents/resonera.toml +0 -6
- package/bundle/skills/agentera/agents/visionera.toml +0 -6
- package/bundle/skills/agentera/agents/visualisera.toml +0 -6
- package/bundle/skills/agentera/capabilities/dokumentera/schemas/artifacts.yaml +0 -73
- package/bundle/skills/agentera/capabilities/dokumentera/schemas/triggers.yaml +0 -35
- package/bundle/skills/agentera/capabilities/hej/schemas/artifacts.yaml +0 -69
- package/bundle/skills/agentera/capabilities/hej/schemas/triggers.yaml +0 -58
- package/bundle/skills/agentera/capabilities/inspektera/schemas/artifacts.yaml +0 -76
- package/bundle/skills/agentera/capabilities/inspektera/schemas/triggers.yaml +0 -38
- package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +0 -24
- package/bundle/skills/agentera/capabilities/inspirera/schemas/triggers.yaml +0 -34
- package/bundle/skills/agentera/capabilities/optimera/schemas/triggers.yaml +0 -39
- package/bundle/skills/agentera/capabilities/orkestrera/schemas/artifacts.yaml +0 -64
- package/bundle/skills/agentera/capabilities/orkestrera/schemas/triggers.yaml +0 -42
- package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +0 -120
- package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +0 -62
- package/bundle/skills/agentera/capabilities/planera/schemas/triggers.yaml +0 -34
- package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +0 -61
- package/bundle/skills/agentera/capabilities/profilera/schemas/artifacts.yaml +0 -18
- package/bundle/skills/agentera/capabilities/profilera/schemas/triggers.yaml +0 -45
- package/bundle/skills/agentera/capabilities/profilera/schemas/validation.yaml +0 -57
- package/bundle/skills/agentera/capabilities/realisera/schemas/artifacts.yaml +0 -80
- package/bundle/skills/agentera/capabilities/realisera/schemas/triggers.yaml +0 -39
- package/bundle/skills/agentera/capabilities/realisera/schemas/validation.yaml +0 -110
- package/bundle/skills/agentera/capabilities/resonera/schemas/artifacts.yaml +0 -47
- package/bundle/skills/agentera/capabilities/resonera/schemas/triggers.yaml +0 -46
- package/bundle/skills/agentera/capabilities/resonera/schemas/validation.yaml +0 -77
- package/bundle/skills/agentera/capabilities/visionera/schemas/triggers.yaml +0 -41
- package/bundle/skills/agentera/capabilities/visualisera/schemas/triggers.yaml +0 -33
- package/bundle/skills/agentera/references/contract.md +0 -1039
- package/dist/analytics/extractCorpus/cli.js.map +0 -1
- package/dist/analytics/extractCorpus/copilotSessions.js.map +0 -1
- package/dist/analytics/extractCorpus/core.js.map +0 -1
- package/dist/analytics/extractCorpus/corpus.js.map +0 -1
- package/dist/analytics/extractCorpus/cursorSessions.js.map +0 -1
- package/dist/analytics/extractCorpus/filesystemSources.js.map +0 -1
- package/dist/analytics/extractCorpus/index.js.map +0 -1
- package/dist/analytics/extractCorpus/jsonlSessions.js.map +0 -1
- package/dist/analytics/extractCorpus/sqliteSessions.js.map +0 -1
- package/dist/analytics/extractCorpus.js.map +0 -1
- package/dist/analytics/usageStats.js.map +0 -1
- package/dist/bin/agentera.js.map +0 -1
- package/dist/capabilities/dokumentera/instructions.js +0 -6
- package/dist/capabilities/dokumentera/instructions.js.map +0 -1
- package/dist/capabilities/hej/instructions.js +0 -6
- package/dist/capabilities/hej/instructions.js.map +0 -1
- package/dist/capabilities/index.js.map +0 -1
- package/dist/capabilities/inspektera/instructions.js +0 -6
- package/dist/capabilities/inspektera/instructions.js.map +0 -1
- package/dist/capabilities/inspirera/instructions.js +0 -6
- package/dist/capabilities/inspirera/instructions.js.map +0 -1
- package/dist/capabilities/optimera/instructions.js +0 -6
- package/dist/capabilities/optimera/instructions.js.map +0 -1
- package/dist/capabilities/orkestrera/instructions.js +0 -6
- package/dist/capabilities/orkestrera/instructions.js.map +0 -1
- package/dist/capabilities/planera/instructions.js +0 -6
- package/dist/capabilities/planera/instructions.js.map +0 -1
- package/dist/capabilities/profilera/instructions.js +0 -6
- package/dist/capabilities/profilera/instructions.js.map +0 -1
- package/dist/capabilities/realisera/instructions.js +0 -6
- package/dist/capabilities/realisera/instructions.js.map +0 -1
- package/dist/capabilities/resonera/instructions.js +0 -6
- package/dist/capabilities/resonera/instructions.js.map +0 -1
- package/dist/capabilities/visionera/instructions.js +0 -6
- package/dist/capabilities/visionera/instructions.js.map +0 -1
- package/dist/capabilities/visualisera/instructions.js +0 -6
- package/dist/capabilities/visualisera/instructions.js.map +0 -1
- package/dist/cli/appContext.js.map +0 -1
- package/dist/cli/argvalidate.js.map +0 -1
- package/dist/cli/capabilityContext/benchmark.js.map +0 -1
- package/dist/cli/capabilityContext/bespoke.js.map +0 -1
- package/dist/cli/capabilityContext/closeout.js.map +0 -1
- package/dist/cli/capabilityContext/contract.js.map +0 -1
- package/dist/cli/capabilityContext/evidence.js.map +0 -1
- package/dist/cli/capabilityContext/index.js.map +0 -1
- package/dist/cli/capabilityContext/orchestration.js.map +0 -1
- package/dist/cli/capabilityContext/planState.js.map +0 -1
- package/dist/cli/capabilityContext/progress.js.map +0 -1
- package/dist/cli/capabilityContext/realisera.js +0 -174
- package/dist/cli/capabilityContext/realisera.js.map +0 -1
- package/dist/cli/capabilityContext/shared.js.map +0 -1
- package/dist/cli/capabilityContext/slim.js.map +0 -1
- package/dist/cli/capabilityContext/startup.js.map +0 -1
- package/dist/cli/capabilityContext/types.js.map +0 -1
- package/dist/cli/capabilityContext.js.map +0 -1
- package/dist/cli/commands/backfill.js +0 -84
- package/dist/cli/commands/backfill.js.map +0 -1
- package/dist/cli/commands/capability.js.map +0 -1
- package/dist/cli/commands/compact.js.map +0 -1
- package/dist/cli/commands/doctor.js.map +0 -1
- package/dist/cli/commands/lint.js.map +0 -1
- package/dist/cli/commands/prime.js.map +0 -1
- package/dist/cli/commands/query.js.map +0 -1
- package/dist/cli/commands/report.js.map +0 -1
- package/dist/cli/commands/schema.js.map +0 -1
- package/dist/cli/commands/state/decisions.js.map +0 -1
- package/dist/cli/commands/state/docs.js.map +0 -1
- package/dist/cli/commands/state/experiments.js.map +0 -1
- package/dist/cli/commands/state/health.js.map +0 -1
- package/dist/cli/commands/state/index.js.map +0 -1
- package/dist/cli/commands/state/objective.js.map +0 -1
- package/dist/cli/commands/state/plan.js.map +0 -1
- package/dist/cli/commands/state/progress.js.map +0 -1
- package/dist/cli/commands/state/shared.js.map +0 -1
- package/dist/cli/commands/state/todo.js.map +0 -1
- package/dist/cli/commands/state.js +0 -1023
- package/dist/cli/commands/state.js.map +0 -1
- package/dist/cli/commands/upgrade.js.map +0 -1
- package/dist/cli/commands/validate.js.map +0 -1
- package/dist/cli/commands/verify.js.map +0 -1
- package/dist/cli/dispatch/check.js.map +0 -1
- package/dist/cli/dispatch/index.js.map +0 -1
- package/dist/cli/dispatch/lifecycle.js.map +0 -1
- package/dist/cli/dispatch/prime.js.map +0 -1
- package/dist/cli/dispatch/shared.js.map +0 -1
- package/dist/cli/dispatch/state.js.map +0 -1
- package/dist/cli/dispatch.js.map +0 -1
- package/dist/cli/errors.js.map +0 -1
- package/dist/cli/help.js.map +0 -1
- package/dist/cli/orientation.js.map +0 -1
- package/dist/cli/prime-blob.js.map +0 -1
- package/dist/cli/stateQuery.js.map +0 -1
- package/dist/cli/structured.js.map +0 -1
- package/dist/cli/todoMarkdown.js.map +0 -1
- package/dist/core/difflib.js.map +0 -1
- package/dist/core/git.js +0 -43
- package/dist/core/git.js.map +0 -1
- package/dist/core/paths.js.map +0 -1
- package/dist/core/pyjson.js.map +0 -1
- package/dist/core/sourceRoot.js.map +0 -1
- package/dist/core/toml.js.map +0 -1
- package/dist/core/yaml.js.map +0 -1
- package/dist/eval/evalSkills.js.map +0 -1
- package/dist/eval/semanticEval.js.map +0 -1
- package/dist/eval/semanticFixtures.js.map +0 -1
- package/dist/hooks/common.js.map +0 -1
- package/dist/hooks/compaction/apply.js.map +0 -1
- package/dist/hooks/compaction/dryRun.js.map +0 -1
- package/dist/hooks/compaction/index.js.map +0 -1
- package/dist/hooks/compaction/parse.js.map +0 -1
- package/dist/hooks/compaction/retention.js.map +0 -1
- package/dist/hooks/compaction/status.js.map +0 -1
- package/dist/hooks/compaction/types.js.map +0 -1
- package/dist/hooks/compaction.js +0 -935
- package/dist/hooks/compaction.js.map +0 -1
- package/dist/hooks/cursorPreToolUse.js +0 -19
- package/dist/hooks/cursorPreToolUse.js.map +0 -1
- package/dist/hooks/cursorSessionStart.js +0 -71
- package/dist/hooks/cursorSessionStart.js.map +0 -1
- package/dist/hooks/sessionStart.js +0 -209
- package/dist/hooks/sessionStart.js.map +0 -1
- package/dist/hooks/sessionStop.js +0 -203
- package/dist/hooks/sessionStop.js.map +0 -1
- package/dist/hooks/validateArtifact/agentFacing.js.map +0 -1
- package/dist/hooks/validateArtifact/index.js.map +0 -1
- package/dist/hooks/validateArtifact/markdown.js.map +0 -1
- package/dist/hooks/validateArtifact/runtime.js +0 -83
- package/dist/hooks/validateArtifact/runtime.js.map +0 -1
- package/dist/hooks/validateArtifact/schema.js.map +0 -1
- package/dist/hooks/validateArtifact/traversal.js.map +0 -1
- package/dist/hooks/validateArtifact/violations.js.map +0 -1
- package/dist/hooks/validateArtifact.js +0 -924
- package/dist/hooks/validateArtifact.js.map +0 -1
- package/dist/migrate/v2HandoffManifest.js.map +0 -1
- package/dist/registries/artifactProtocolIds.js.map +0 -1
- package/dist/registries/artifactRegistry.js.map +0 -1
- package/dist/registries/capabilityContract.js.map +0 -1
- package/dist/registries/evaluatorHandoffContract.js.map +0 -1
- package/dist/registries/packageRegistry.js.map +0 -1
- package/dist/registries/runtimeAdapterRegistry.js +0 -315
- package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
- package/dist/release/releaseMetadata.js.map +0 -1
- package/dist/setup/codex/agents.js +0 -96
- package/dist/setup/codex/agents.js.map +0 -1
- package/dist/setup/codex/cli.js +0 -161
- package/dist/setup/codex/cli.js.map +0 -1
- package/dist/setup/codex/configToml.js +0 -644
- package/dist/setup/codex/configToml.js.map +0 -1
- package/dist/setup/codex/constants.js +0 -29
- package/dist/setup/codex/constants.js.map +0 -1
- package/dist/setup/codex/installRoot.js +0 -64
- package/dist/setup/codex/installRoot.js.map +0 -1
- package/dist/setup/codex/state.js +0 -270
- package/dist/setup/codex/state.js.map +0 -1
- package/dist/setup/codex.js +0 -12
- package/dist/setup/codex.js.map +0 -1
- package/dist/setup/copilot.js +0 -227
- package/dist/setup/copilot.js.map +0 -1
- package/dist/setup/cursor.js +0 -127
- package/dist/setup/cursor.js.map +0 -1
- package/dist/setup/doctor/core.js +0 -300
- package/dist/setup/doctor/core.js.map +0 -1
- package/dist/setup/doctor/diagnostics.js +0 -247
- package/dist/setup/doctor/diagnostics.js.map +0 -1
- package/dist/setup/doctor/opencode.js +0 -281
- package/dist/setup/doctor/opencode.js.map +0 -1
- package/dist/setup/doctor/report.js +0 -474
- package/dist/setup/doctor/report.js.map +0 -1
- package/dist/setup/doctor.js +0 -10
- package/dist/setup/doctor.js.map +0 -1
- package/dist/setup/opencode.js.map +0 -1
- package/dist/setup/smokeChecks.js.map +0 -1
- package/dist/state/installRoot.js.map +0 -1
- package/dist/state/progressCommit.js +0 -289
- package/dist/state/progressCommit.js.map +0 -1
- package/dist/state/startupAnalysis/benchmark.js.map +0 -1
- package/dist/state/startupAnalysis/contract.js.map +0 -1
- package/dist/state/startupAnalysis/helpers.js.map +0 -1
- package/dist/state/startupAnalysis/index.js.map +0 -1
- package/dist/state/startupAnalysis/metrics.js.map +0 -1
- package/dist/state/startupAnalysis/records.js.map +0 -1
- package/dist/state/startupAnalysis/report.js.map +0 -1
- package/dist/state/startupAnalysis/threshold.js.map +0 -1
- package/dist/state/startupAnalysis.js.map +0 -1
- package/dist/upgrade/appModel.js.map +0 -1
- package/dist/upgrade/channels.js.map +0 -1
- package/dist/upgrade/coexistenceProbe.js +0 -83
- package/dist/upgrade/coexistenceProbe.js.map +0 -1
- package/dist/upgrade/compatibility.js.map +0 -1
- package/dist/upgrade/doctor.js.map +0 -1
- package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -570
- package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
- package/dist/upgrade/migrateArtifactsV2ToV3.js.map +0 -1
- package/dist/upgrade/nextMajorDoctor.js.map +0 -1
- package/dist/upgrade/projectIntegration.js.map +0 -1
- package/dist/upgrade/runtimeMigration.js.map +0 -1
- package/dist/upgrade/upgradeCommands.js.map +0 -1
- package/dist/upgrade/upgradeOrchestrator.js.map +0 -1
- package/dist/upgrade/v3CapabilitySurface.js.map +0 -1
- package/dist/upgrade/versionResolution.js.map +0 -1
- package/dist/validate/appHomeContract.js.map +0 -1
- package/dist/validate/capability.js.map +0 -1
- package/dist/validate/crossCapability.js.map +0 -1
- package/dist/validate/lifecycleAdapters.js +0 -772
- package/dist/validate/lifecycleAdapters.js.map +0 -1
- package/dist/validate/selfAudit.js.map +0 -1
- package/dist/validate/vocabularyAuthority.js.map +0 -1
- /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
- /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
- /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
|
@@ -1,25 +1,37 @@
|
|
|
1
|
-
import
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
import { cmdAppHome } from "../commands/appHome.js";
|
|
2
5
|
import { cmdDoctor } from "../commands/doctor.js";
|
|
3
6
|
import { cmdUpgrade } from "../commands/upgrade.js";
|
|
4
7
|
import { cmdVerify } from "../commands/verify.js";
|
|
5
8
|
import { cmdGate } from "../commands/compact.js";
|
|
6
9
|
import { cmdReport } from "../commands/report.js";
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
9
|
-
import {
|
|
10
|
-
import {
|
|
11
|
-
import { HookCliAdapter } from "../../hooks/validateArtifact/index.js";
|
|
10
|
+
import { runGlossaryAdviceCommand } from "../commands/glossaryAdvice.js";
|
|
11
|
+
import { runPersonalGlossaryCommand } from "../commands/personalGlossary.js";
|
|
12
|
+
import { runProfileGroundingCommand } from "../commands/profileGrounding.js";
|
|
13
|
+
import { preCutoverCommand } from "../preCutoverCommand.js";
|
|
12
14
|
import { usageMain } from "../../analytics/usageStats.js";
|
|
13
15
|
import { validatePathValue } from "../argvalidate.js";
|
|
14
|
-
import { printDoctorHelp, printUpgradeHelp, wantsHelp } from "../help.js";
|
|
16
|
+
import { printAppHomeHelp, printDoctorHelp, printUpgradeHelp, wantsHelp } from "../help.js";
|
|
17
|
+
import { makeArgvValueReader } from "./argvParser.js";
|
|
15
18
|
import { parseCompactArgs } from "./check.js";
|
|
16
|
-
import { asEnvelopeFormat, classifyParseError, emitDeprecationAlias } from "./shared.js";
|
|
19
|
+
import { asEnvelopeFormat, classifyParseError, detectTopLevelFormat, emitDeprecationAlias } from "./shared.js";
|
|
17
20
|
import { emitInvalidInput } from "../errors.js";
|
|
21
|
+
import { migrationProject } from "../migrationRequired.js";
|
|
22
|
+
import { fullEntityUpgradeCommand } from "../../upgrade/upgradeCommands.js";
|
|
23
|
+
import { nativeResourceCleanupIds, resolveNativeResourceCleanupId } from "../../runtime/nativeResourceCleanup.js";
|
|
24
|
+
function rejectUnsupportedUpgradeFlag(io, format, message, recovery) {
|
|
25
|
+
return emitInvalidInput(io, {
|
|
26
|
+
format: asEnvelopeFormat(format),
|
|
27
|
+
body: { class: "unsupported_target", message, recovery },
|
|
28
|
+
});
|
|
29
|
+
}
|
|
18
30
|
export function runGate(argv, io, prog) {
|
|
19
31
|
const parsed = parseCompactArgs(argv);
|
|
20
32
|
if ("error" in parsed) {
|
|
21
33
|
return emitInvalidInput(io, {
|
|
22
|
-
format:
|
|
34
|
+
format: detectTopLevelFormat(argv),
|
|
23
35
|
body: classifyParseError(parsed.error),
|
|
24
36
|
});
|
|
25
37
|
}
|
|
@@ -33,6 +45,58 @@ export function runGate(argv, io, prog) {
|
|
|
33
45
|
});
|
|
34
46
|
}
|
|
35
47
|
}
|
|
48
|
+
export function runAppHome(argv, io, prog) {
|
|
49
|
+
const out = io.out ?? ((t) => process.stdout.write(t));
|
|
50
|
+
if (wantsHelp(argv)) {
|
|
51
|
+
out(printAppHomeHelp() + "\n");
|
|
52
|
+
return 0;
|
|
53
|
+
}
|
|
54
|
+
const args = {
|
|
55
|
+
installRoot: null,
|
|
56
|
+
home: null,
|
|
57
|
+
format: "text",
|
|
58
|
+
};
|
|
59
|
+
let i = 0;
|
|
60
|
+
const value = makeArgvValueReader(argv, () => i, (n) => {
|
|
61
|
+
i = n;
|
|
62
|
+
});
|
|
63
|
+
for (; i < argv.length; i++) {
|
|
64
|
+
const a = argv[i];
|
|
65
|
+
let v;
|
|
66
|
+
if ((v = value("--install-root")) !== null)
|
|
67
|
+
args.installRoot = v;
|
|
68
|
+
else if ((v = value("--home")) !== null)
|
|
69
|
+
args.home = v;
|
|
70
|
+
else if ((v = value("--format")) !== null) {
|
|
71
|
+
if (v !== "text" && v !== "json") {
|
|
72
|
+
return emitInvalidInput(io, {
|
|
73
|
+
format: asEnvelopeFormat(args.format),
|
|
74
|
+
body: {
|
|
75
|
+
class: "invalid_choice",
|
|
76
|
+
message: `argument --format: invalid choice: '${v}' (choose from 'text', 'json')`,
|
|
77
|
+
valid_values: ["text", "json"],
|
|
78
|
+
},
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
args.format = v;
|
|
82
|
+
}
|
|
83
|
+
else {
|
|
84
|
+
return emitInvalidInput(io, {
|
|
85
|
+
format: asEnvelopeFormat(args.format),
|
|
86
|
+
body: { class: "unrecognized_argument", message: `unrecognized arguments: ${a}` },
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
try {
|
|
91
|
+
return cmdAppHome(args, io);
|
|
92
|
+
}
|
|
93
|
+
catch (exc) {
|
|
94
|
+
return emitInvalidInput(io, {
|
|
95
|
+
format: asEnvelopeFormat(args.format),
|
|
96
|
+
body: { class: "unsupported_target", message: exc.message },
|
|
97
|
+
});
|
|
98
|
+
}
|
|
99
|
+
}
|
|
36
100
|
export function runDoctor(argv, io, prog) {
|
|
37
101
|
const err = io.err ?? ((t) => process.stderr.write(t));
|
|
38
102
|
const out = io.out ?? ((t) => process.stdout.write(t));
|
|
@@ -46,20 +110,18 @@ export function runDoctor(argv, io, prog) {
|
|
|
46
110
|
project: null,
|
|
47
111
|
expectedVersion: null,
|
|
48
112
|
expectCommand: [],
|
|
113
|
+
retiredResource: null,
|
|
49
114
|
smoke: false,
|
|
50
115
|
allowLiveModel: false,
|
|
51
116
|
format: "text",
|
|
52
117
|
};
|
|
53
118
|
let jsonFlag = false;
|
|
54
|
-
|
|
119
|
+
let i = 0;
|
|
120
|
+
const value = makeArgvValueReader(argv, () => i, (n) => {
|
|
121
|
+
i = n;
|
|
122
|
+
});
|
|
123
|
+
for (; i < argv.length; i++) {
|
|
55
124
|
const a = argv[i];
|
|
56
|
-
const value = (name) => {
|
|
57
|
-
if (a === name)
|
|
58
|
-
return argv[++i];
|
|
59
|
-
if (a.startsWith(name + "="))
|
|
60
|
-
return a.slice(name.length + 1);
|
|
61
|
-
return null;
|
|
62
|
-
};
|
|
63
125
|
let v;
|
|
64
126
|
if ((v = value("--install-root")) !== null)
|
|
65
127
|
args.installRoot = v;
|
|
@@ -71,6 +133,8 @@ export function runDoctor(argv, io, prog) {
|
|
|
71
133
|
args.expectedVersion = v;
|
|
72
134
|
else if ((v = value("--expect-command")) !== null)
|
|
73
135
|
args.expectCommand.push(v);
|
|
136
|
+
else if ((v = value("--retired-resource")) !== null)
|
|
137
|
+
args.retiredResource = v;
|
|
74
138
|
else if ((v = value("--format")) !== null) {
|
|
75
139
|
if (v !== "text" && v !== "json") {
|
|
76
140
|
return emitInvalidInput(io, {
|
|
@@ -111,65 +175,18 @@ export function runDoctor(argv, io, prog) {
|
|
|
111
175
|
});
|
|
112
176
|
}
|
|
113
177
|
}
|
|
114
|
-
export function readStdin() {
|
|
115
|
-
try {
|
|
116
|
-
return fsForHooks.readFileSync(0, "utf8");
|
|
117
|
-
}
|
|
118
|
-
catch {
|
|
119
|
-
return "";
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
export function runHook(name, argv, io) {
|
|
123
|
-
const err = io.err ?? ((t) => process.stderr.write(t));
|
|
124
|
-
const raw = io.stdin ? io.stdin() : readStdin();
|
|
125
|
-
// Each hook owns its own stdout newline convention; do not wrap stdout here.
|
|
126
|
-
switch (name) {
|
|
127
|
-
case "session-start":
|
|
128
|
-
return runSessionStart(raw);
|
|
129
|
-
case "session-stop":
|
|
130
|
-
return runSessionStop(raw);
|
|
131
|
-
case "cursor-session-start":
|
|
132
|
-
return runCursorSessionStart(raw);
|
|
133
|
-
case "cursor-pre-tool-use":
|
|
134
|
-
return runCursorPreToolUse(raw);
|
|
135
|
-
case "validate-artifact": {
|
|
136
|
-
const [rc, violations] = new HookCliAdapter().run(raw, null);
|
|
137
|
-
for (const v of violations)
|
|
138
|
-
err(`${v}\n`);
|
|
139
|
-
return rc;
|
|
140
|
-
}
|
|
141
|
-
default:
|
|
142
|
-
return emitInvalidInput(io, {
|
|
143
|
-
format: "text",
|
|
144
|
-
body: {
|
|
145
|
-
class: "unsupported_target",
|
|
146
|
-
message: `unknown hook '${name}'`,
|
|
147
|
-
valid_values: [
|
|
148
|
-
"session-start",
|
|
149
|
-
"session-stop",
|
|
150
|
-
"cursor-session-start",
|
|
151
|
-
"cursor-pre-tool-use",
|
|
152
|
-
"validate-artifact",
|
|
153
|
-
],
|
|
154
|
-
},
|
|
155
|
-
});
|
|
156
|
-
}
|
|
157
|
-
}
|
|
158
178
|
export function runUsage(argv, io, prog) {
|
|
159
179
|
const realOut = io.out ?? ((t) => process.stdout.write(t));
|
|
160
180
|
const realErr = io.err ?? ((t) => process.stderr.write(t));
|
|
161
181
|
let format = "text";
|
|
162
182
|
let corpus = null;
|
|
163
183
|
let project = null;
|
|
164
|
-
|
|
184
|
+
let i = 0;
|
|
185
|
+
const value = makeArgvValueReader(argv, () => i, (n) => {
|
|
186
|
+
i = n;
|
|
187
|
+
});
|
|
188
|
+
for (; i < argv.length; i++) {
|
|
165
189
|
const a = argv[i];
|
|
166
|
-
const value = (name) => {
|
|
167
|
-
if (a === name)
|
|
168
|
-
return argv[++i] ?? null;
|
|
169
|
-
if (a.startsWith(name + "="))
|
|
170
|
-
return a.slice(name.length + 1);
|
|
171
|
-
return null;
|
|
172
|
-
};
|
|
173
190
|
let v;
|
|
174
191
|
if ((v = value("--format")) !== null)
|
|
175
192
|
format = v;
|
|
@@ -239,18 +256,18 @@ export function runUpgrade(argv, io, prog) {
|
|
|
239
256
|
dryRun: false,
|
|
240
257
|
only: [],
|
|
241
258
|
force: false,
|
|
259
|
+
verify: false,
|
|
260
|
+
runtime: null,
|
|
261
|
+
legacyCleanup: null,
|
|
242
262
|
format: "text",
|
|
243
263
|
};
|
|
244
264
|
let jsonFlag = false;
|
|
245
|
-
|
|
265
|
+
let i = 0;
|
|
266
|
+
const value = makeArgvValueReader(argv, () => i, (n) => {
|
|
267
|
+
i = n;
|
|
268
|
+
});
|
|
269
|
+
for (; i < argv.length; i++) {
|
|
246
270
|
const a = argv[i];
|
|
247
|
-
const value = (name) => {
|
|
248
|
-
if (a === name)
|
|
249
|
-
return argv[++i] ?? null;
|
|
250
|
-
if (a.startsWith(name + "="))
|
|
251
|
-
return a.slice(name.length + 1);
|
|
252
|
-
return null;
|
|
253
|
-
};
|
|
254
271
|
let v;
|
|
255
272
|
if ((v = value("--install-root")) !== null)
|
|
256
273
|
args.installRoot = v;
|
|
@@ -263,17 +280,34 @@ export function runUpgrade(argv, io, prog) {
|
|
|
263
280
|
else if ((v = value("--channel")) !== null)
|
|
264
281
|
args.channel = v;
|
|
265
282
|
else if ((v = value("--target-major")) !== null) {
|
|
266
|
-
|
|
283
|
+
return rejectUnsupportedUpgradeFlag(io, args.format ?? "text", "--target-major was removed; use --channel with dry-run preview then --yes", fullEntityUpgradeCommand(migrationProject(argv)));
|
|
284
|
+
}
|
|
285
|
+
else if ((v = value("--runtime")) !== null) {
|
|
267
286
|
return emitInvalidInput(io, {
|
|
268
|
-
format:
|
|
287
|
+
format: detectTopLevelFormat(argv),
|
|
269
288
|
body: {
|
|
270
|
-
class: "
|
|
271
|
-
message:
|
|
289
|
+
class: "invalid_choice",
|
|
290
|
+
message: `argument --runtime ${v} is retired; Agentera now uses the shared skill at ` +
|
|
291
|
+
"~/.agents/skills/agentera plus the CLI. Remove --runtime and rerun the app/project upgrade. " +
|
|
292
|
+
"For explicit Agentera-owned native resource cleanup, use --legacy-cleanup RESOURCE_ID.",
|
|
272
293
|
},
|
|
273
294
|
});
|
|
274
295
|
}
|
|
275
|
-
else if ((v = value("--
|
|
276
|
-
|
|
296
|
+
else if ((v = value("--legacy-cleanup")) !== null) {
|
|
297
|
+
const validValues = nativeResourceCleanupIds();
|
|
298
|
+
const selectedResource = resolveNativeResourceCleanupId(v);
|
|
299
|
+
if (!selectedResource) {
|
|
300
|
+
return emitInvalidInput(io, {
|
|
301
|
+
format: asEnvelopeFormat(args.format),
|
|
302
|
+
body: {
|
|
303
|
+
class: "invalid_choice",
|
|
304
|
+
message: `argument --legacy-cleanup: invalid choice: '${v}' (choose from ${validValues.map((id) => `'${id}'`).join(", ")})`,
|
|
305
|
+
valid_values: validValues,
|
|
306
|
+
},
|
|
307
|
+
});
|
|
308
|
+
}
|
|
309
|
+
args.legacyCleanup = selectedResource.id;
|
|
310
|
+
}
|
|
277
311
|
else if ((v = value("--only")) !== null) {
|
|
278
312
|
if (v !== "artifacts" && v !== "runtime" && v !== "cleanup") {
|
|
279
313
|
return emitInvalidInput(io, {
|
|
@@ -287,16 +321,23 @@ export function runUpgrade(argv, io, prog) {
|
|
|
287
321
|
}
|
|
288
322
|
args.only.push(v);
|
|
289
323
|
}
|
|
290
|
-
else if ((v = value("--opencode-config-dir")) !== null)
|
|
291
|
-
|
|
324
|
+
else if ((v = value("--opencode-config-dir")) !== null) {
|
|
325
|
+
return rejectUnsupportedUpgradeFlag(io, args.format ?? "text", "--opencode-config-dir is not yet supported by the TypeScript upgrade command");
|
|
326
|
+
}
|
|
292
327
|
else if (a === "--yes")
|
|
293
328
|
args.yes = true;
|
|
294
329
|
else if (a === "--dry-run")
|
|
295
330
|
args.dryRun = true;
|
|
296
331
|
else if (a === "--force")
|
|
297
332
|
args.force = true;
|
|
298
|
-
else if (a === "--
|
|
299
|
-
|
|
333
|
+
else if (a === "--verify")
|
|
334
|
+
args.verify = true;
|
|
335
|
+
else if (a === "--update-packages") {
|
|
336
|
+
return rejectUnsupportedUpgradeFlag(io, args.format ?? "text", "--update-packages is retired; Agentera does not manage host package installation or updates");
|
|
337
|
+
}
|
|
338
|
+
else if (["--restore", "--rollback", "--downgrade"].includes(a)) {
|
|
339
|
+
return rejectUnsupportedUpgradeFlag(io, args.format ?? "text", `${a} was removed; v2-to-v3 upgrade is one-way and apply must run as one full upgrade --yes`, fullEntityUpgradeCommand(migrationProject(argv)));
|
|
340
|
+
}
|
|
300
341
|
else if (a === "--json")
|
|
301
342
|
jsonFlag = true;
|
|
302
343
|
else if ((v = value("--format")) !== null) {
|
|
@@ -345,15 +386,12 @@ export function runVerify(argv, io, prog) {
|
|
|
345
386
|
fixtures: [],
|
|
346
387
|
};
|
|
347
388
|
const positionals = [];
|
|
348
|
-
|
|
389
|
+
let i = 0;
|
|
390
|
+
const value = makeArgvValueReader(argv, () => i, (n) => {
|
|
391
|
+
i = n;
|
|
392
|
+
});
|
|
393
|
+
for (; i < argv.length; i++) {
|
|
349
394
|
const a = argv[i];
|
|
350
|
-
const value = (name) => {
|
|
351
|
-
if (a === name)
|
|
352
|
-
return argv[++i] ?? null;
|
|
353
|
-
if (a.startsWith(name + "="))
|
|
354
|
-
return a.slice(name.length + 1);
|
|
355
|
-
return null;
|
|
356
|
-
};
|
|
357
395
|
let v;
|
|
358
396
|
if ((v = value("--format")) !== null) {
|
|
359
397
|
if (v !== "text" && v !== "json") {
|
|
@@ -382,7 +420,7 @@ export function runVerify(argv, io, prog) {
|
|
|
382
420
|
args.dryRun = true;
|
|
383
421
|
else if (a.startsWith("--")) {
|
|
384
422
|
return emitInvalidInput(io, {
|
|
385
|
-
format:
|
|
423
|
+
format: detectTopLevelFormat(argv),
|
|
386
424
|
body: { class: "unrecognized_argument", message: `unrecognized arguments: ${a}` },
|
|
387
425
|
});
|
|
388
426
|
}
|
|
@@ -404,29 +442,79 @@ export function runVerify(argv, io, prog) {
|
|
|
404
442
|
}
|
|
405
443
|
}
|
|
406
444
|
export function runReport(argv, io, prog) {
|
|
445
|
+
if (argv[0] === "glossary-advice") {
|
|
446
|
+
if (prog !== "agentera report") {
|
|
447
|
+
return emitInvalidInput(io, {
|
|
448
|
+
format: "json",
|
|
449
|
+
body: {
|
|
450
|
+
class: "unsupported_target",
|
|
451
|
+
message: "glossary-advice has no stats alias",
|
|
452
|
+
valid_values: ["report glossary-advice"],
|
|
453
|
+
recovery: `Run ${preCutoverCommand("report glossary-advice --input - --format json")}; no state was changed.`,
|
|
454
|
+
},
|
|
455
|
+
});
|
|
456
|
+
}
|
|
457
|
+
return runGlossaryAdviceCommand(argv.slice(1), io);
|
|
458
|
+
}
|
|
459
|
+
if (argv[0] === "profile-grounding") {
|
|
460
|
+
if (prog !== "agentera report") {
|
|
461
|
+
return emitInvalidInput(io, {
|
|
462
|
+
format: "json",
|
|
463
|
+
body: {
|
|
464
|
+
class: "unsupported_target",
|
|
465
|
+
message: "profile-grounding has no stats alias",
|
|
466
|
+
valid_values: ["report profile-grounding"],
|
|
467
|
+
recovery: `Run ${preCutoverCommand("report profile-grounding --format json")}; no profile bytes were changed.`,
|
|
468
|
+
},
|
|
469
|
+
});
|
|
470
|
+
}
|
|
471
|
+
return runProfileGroundingCommand(argv.slice(1), io);
|
|
472
|
+
}
|
|
473
|
+
if (argv[0] === "profile-glossary") {
|
|
474
|
+
if (prog !== "agentera report") {
|
|
475
|
+
return emitInvalidInput(io, {
|
|
476
|
+
format: "json",
|
|
477
|
+
body: {
|
|
478
|
+
class: "unsupported_target",
|
|
479
|
+
message: "profile-glossary has no stats alias",
|
|
480
|
+
valid_values: ["report profile-glossary"],
|
|
481
|
+
recovery: `Run ${preCutoverCommand("report profile-glossary --input PATH --format json")} with the same input; no profile bytes were changed.`,
|
|
482
|
+
},
|
|
483
|
+
});
|
|
484
|
+
}
|
|
485
|
+
return runPersonalGlossaryCommand(argv.slice(1), io);
|
|
486
|
+
}
|
|
407
487
|
const args = {
|
|
408
488
|
action: null,
|
|
409
489
|
format: "text",
|
|
410
490
|
project: null,
|
|
491
|
+
sources: "active",
|
|
411
492
|
dryRun: false,
|
|
412
493
|
consent: null,
|
|
413
494
|
projectRoot: [],
|
|
495
|
+
importSources: [],
|
|
414
496
|
};
|
|
415
497
|
const positionals = [];
|
|
416
|
-
|
|
498
|
+
let i = 0;
|
|
499
|
+
const value = makeArgvValueReader(argv, () => i, (n) => {
|
|
500
|
+
i = n;
|
|
501
|
+
});
|
|
502
|
+
for (; i < argv.length; i++) {
|
|
417
503
|
const a = argv[i];
|
|
418
|
-
const value = (name) => {
|
|
419
|
-
if (a === name)
|
|
420
|
-
return argv[++i] ?? null;
|
|
421
|
-
if (a.startsWith(name + "="))
|
|
422
|
-
return a.slice(name.length + 1);
|
|
423
|
-
return null;
|
|
424
|
-
};
|
|
425
504
|
let v;
|
|
426
505
|
if ((v = value("--format")) !== null)
|
|
427
506
|
args.format = v;
|
|
428
507
|
else if ((v = value("--project")) !== null)
|
|
429
508
|
args.project = v;
|
|
509
|
+
else if ((v = value("--sources")) !== null) {
|
|
510
|
+
if (v !== "active" && v !== "all") {
|
|
511
|
+
return emitInvalidInput(io, {
|
|
512
|
+
format: asEnvelopeFormat(args.format),
|
|
513
|
+
body: { class: "invalid_choice", message: `argument --sources: invalid choice: '${v}' (choose from 'active', 'all')`, valid_values: ["active", "all"] },
|
|
514
|
+
});
|
|
515
|
+
}
|
|
516
|
+
args.sources = v;
|
|
517
|
+
}
|
|
430
518
|
else if ((v = value("--consent")) !== null) {
|
|
431
519
|
if (v !== "local-history") {
|
|
432
520
|
return emitInvalidInput(io, {
|
|
@@ -448,6 +536,20 @@ export function runReport(argv, io, prog) {
|
|
|
448
536
|
args.codexSessionsDir = v;
|
|
449
537
|
else if ((v = value("--claude-projects-dir")) !== null)
|
|
450
538
|
args.claudeProjectsDir = v;
|
|
539
|
+
else if ((v = value("--import-source")) !== null) {
|
|
540
|
+
if (v !== "claude") {
|
|
541
|
+
return emitInvalidInput(io, {
|
|
542
|
+
format: asEnvelopeFormat(args.format),
|
|
543
|
+
body: {
|
|
544
|
+
class: "invalid_choice",
|
|
545
|
+
message: `argument --import-source: invalid choice: '${v}' (choose from 'claude')`,
|
|
546
|
+
valid_values: ["claude"],
|
|
547
|
+
},
|
|
548
|
+
});
|
|
549
|
+
}
|
|
550
|
+
if (!args.importSources.includes(v))
|
|
551
|
+
args.importSources.push(v);
|
|
552
|
+
}
|
|
451
553
|
else if ((v = value("--opencode-conversations-dir")) !== null)
|
|
452
554
|
args.opencodeConversationsDir = v;
|
|
453
555
|
else if ((v = value("--copilot-conversations-dir")) !== null)
|
|
@@ -458,19 +560,21 @@ export function runReport(argv, io, prog) {
|
|
|
458
560
|
args.cursorChatsDir = v;
|
|
459
561
|
else if (a === "--no-codex")
|
|
460
562
|
args.noCodex = true;
|
|
461
|
-
else if (a === "--no-claude")
|
|
462
|
-
args.noClaude = true;
|
|
463
563
|
else if (a === "--no-opencode")
|
|
464
564
|
args.noOpencode = true;
|
|
465
565
|
else if (a === "--no-copilot")
|
|
466
566
|
args.noCopilot = true;
|
|
467
567
|
else if (a === "--no-cursor")
|
|
468
568
|
args.noCursor = true;
|
|
569
|
+
else if (a === "--accept-coverage-gap")
|
|
570
|
+
args.acceptCoverageGap = true;
|
|
571
|
+
else if (a === "--coverage-audit-only")
|
|
572
|
+
args.coverageAuditOnly = true;
|
|
469
573
|
else if (a === "--dry-run")
|
|
470
574
|
args.dryRun = true;
|
|
471
575
|
else if (a.startsWith("--")) {
|
|
472
576
|
return emitInvalidInput(io, {
|
|
473
|
-
format:
|
|
577
|
+
format: detectTopLevelFormat(argv),
|
|
474
578
|
body: { class: "unrecognized_argument", message: `unrecognized arguments: ${a}` },
|
|
475
579
|
});
|
|
476
580
|
}
|
|
@@ -489,4 +593,60 @@ export function runReport(argv, io, prog) {
|
|
|
489
593
|
});
|
|
490
594
|
}
|
|
491
595
|
}
|
|
492
|
-
|
|
596
|
+
function resolveCliVersion() {
|
|
597
|
+
const moduleDir = path.dirname(fileURLToPath(import.meta.url));
|
|
598
|
+
const candidates = [
|
|
599
|
+
path.resolve(moduleDir, "..", "..", "package.json"),
|
|
600
|
+
path.resolve(moduleDir, "..", "..", "..", "package.json"),
|
|
601
|
+
];
|
|
602
|
+
for (const pkgPath of candidates) {
|
|
603
|
+
try {
|
|
604
|
+
const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
|
|
605
|
+
if (typeof pkg.version === "string" && pkg.version) {
|
|
606
|
+
return pkg.version;
|
|
607
|
+
}
|
|
608
|
+
}
|
|
609
|
+
catch {
|
|
610
|
+
continue;
|
|
611
|
+
}
|
|
612
|
+
}
|
|
613
|
+
return "unknown";
|
|
614
|
+
}
|
|
615
|
+
export function runVersion(argv, io) {
|
|
616
|
+
const out = io.out ?? ((t) => process.stdout.write(t));
|
|
617
|
+
const err = io.err ?? ((t) => process.stderr.write(t));
|
|
618
|
+
let format = "text";
|
|
619
|
+
for (let i = 0; i < argv.length; i++) {
|
|
620
|
+
const a = argv[i];
|
|
621
|
+
if (a === "--format") {
|
|
622
|
+
const v = argv[++i];
|
|
623
|
+
if (v !== "text" && v !== "json") {
|
|
624
|
+
return emitInvalidInput(io, {
|
|
625
|
+
format: "text",
|
|
626
|
+
body: {
|
|
627
|
+
class: "invalid_choice",
|
|
628
|
+
message: `argument --format: invalid choice: '${v}' (choose from 'text', 'json')`,
|
|
629
|
+
valid_values: ["text", "json"],
|
|
630
|
+
},
|
|
631
|
+
});
|
|
632
|
+
}
|
|
633
|
+
format = v;
|
|
634
|
+
}
|
|
635
|
+
else if (a === "--help" || a === "-h") {
|
|
636
|
+
out("usage: agentera --version [--format {text,json}]\n\nPrint the installed Agentera CLI version.\n");
|
|
637
|
+
return 0;
|
|
638
|
+
}
|
|
639
|
+
else {
|
|
640
|
+
err(`agentera --version: unrecognized argument: ${a}\n`);
|
|
641
|
+
return 2;
|
|
642
|
+
}
|
|
643
|
+
}
|
|
644
|
+
const version = resolveCliVersion();
|
|
645
|
+
if (format === "json") {
|
|
646
|
+
out(JSON.stringify({ version }) + "\n");
|
|
647
|
+
}
|
|
648
|
+
else {
|
|
649
|
+
out(version + "\n");
|
|
650
|
+
}
|
|
651
|
+
return 0;
|
|
652
|
+
}
|
|
@@ -1,16 +1,31 @@
|
|
|
1
1
|
import { cmdPrime } from "../commands/prime.js";
|
|
2
2
|
import { cmdCapability } from "../commands/capability.js";
|
|
3
|
+
import { makeArgvValueReader } from "./argvParser.js";
|
|
3
4
|
import { asEnvelopeFormat } from "./shared.js";
|
|
4
5
|
import { emitInvalidInput } from "../errors.js";
|
|
6
|
+
import { StateRetrievalFailure } from "../../state/directRetrieval.js";
|
|
7
|
+
import { emitStructured } from "../structured.js";
|
|
8
|
+
function emitStateFailure(error, format, io) {
|
|
9
|
+
const output = io.out ?? ((text) => process.stdout.write(text));
|
|
10
|
+
const diagnostic = io.err ?? ((text) => process.stderr.write(text));
|
|
11
|
+
if (format === "json" || format === "yaml")
|
|
12
|
+
emitStructured(error.body, format, output);
|
|
13
|
+
else
|
|
14
|
+
diagnostic(`Error: ${error.body.error.message}\nRecovery: ${error.body.error.recovery}\n`);
|
|
15
|
+
return error.exitCode;
|
|
16
|
+
}
|
|
5
17
|
export function runCapability(command, argv, io, prog) {
|
|
6
18
|
let format = "text";
|
|
7
|
-
|
|
19
|
+
let i = 0;
|
|
20
|
+
const value = makeArgvValueReader(argv, () => i, (n) => {
|
|
21
|
+
i = n;
|
|
22
|
+
});
|
|
23
|
+
for (; i < argv.length; i++) {
|
|
8
24
|
const a = argv[i];
|
|
9
25
|
let v = null;
|
|
10
|
-
if (
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
v = a.slice("--format=".length);
|
|
26
|
+
if ((v = value("--format")) !== null) {
|
|
27
|
+
// format handled below
|
|
28
|
+
}
|
|
14
29
|
else if (a === "--fields" || a.startsWith("--fields=")) {
|
|
15
30
|
// accepted by the parser but unused by capability routing
|
|
16
31
|
if (a === "--fields")
|
|
@@ -23,22 +38,26 @@ export function runCapability(command, argv, io, prog) {
|
|
|
23
38
|
body: { class: "unrecognized_argument", message: `unrecognized arguments: ${a}` },
|
|
24
39
|
});
|
|
25
40
|
}
|
|
26
|
-
if (v !==
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
41
|
+
if (v !== null) {
|
|
42
|
+
if (v !== "text" && v !== "json" && v !== "yaml") {
|
|
43
|
+
return emitInvalidInput(io, {
|
|
44
|
+
format: asEnvelopeFormat(format),
|
|
45
|
+
body: {
|
|
46
|
+
class: "invalid_choice",
|
|
47
|
+
message: `argument --format: invalid choice: '${v}' (choose from 'text', 'json', 'yaml')`,
|
|
48
|
+
valid_values: ["text", "json", "yaml"],
|
|
49
|
+
},
|
|
50
|
+
});
|
|
51
|
+
}
|
|
52
|
+
format = v;
|
|
35
53
|
}
|
|
36
|
-
format = v;
|
|
37
54
|
}
|
|
38
55
|
try {
|
|
39
56
|
return cmdCapability(command, { format }, io);
|
|
40
57
|
}
|
|
41
58
|
catch (exc) {
|
|
59
|
+
if (exc instanceof StateRetrievalFailure)
|
|
60
|
+
return emitStateFailure(exc, format, io);
|
|
42
61
|
return emitInvalidInput(io, {
|
|
43
62
|
format: asEnvelopeFormat(format),
|
|
44
63
|
body: { class: "unsupported_target", message: exc.message },
|
|
@@ -46,8 +65,12 @@ export function runCapability(command, argv, io, prog) {
|
|
|
46
65
|
}
|
|
47
66
|
}
|
|
48
67
|
export function runPrime(command, argv, io, prog) {
|
|
49
|
-
const args = { command, guidance: false, context: null, dashboard: false, orientation: false, format: "text" };
|
|
50
|
-
|
|
68
|
+
const args = { command, guidance: false, context: null, dashboard: false, orientation: false, format: "text", input: null };
|
|
69
|
+
let i = 0;
|
|
70
|
+
const value = makeArgvValueReader(argv, () => i, (n) => {
|
|
71
|
+
i = n;
|
|
72
|
+
});
|
|
73
|
+
for (; i < argv.length; i++) {
|
|
51
74
|
const a = argv[i];
|
|
52
75
|
let v = null;
|
|
53
76
|
if (a === "--guidance")
|
|
@@ -56,12 +79,30 @@ export function runPrime(command, argv, io, prog) {
|
|
|
56
79
|
args.dashboard = true;
|
|
57
80
|
else if (a === "--orientation")
|
|
58
81
|
args.orientation = true;
|
|
59
|
-
else if (
|
|
60
|
-
args.context =
|
|
61
|
-
else if (a.startsWith("--
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
82
|
+
else if ((v = value("--context")) !== null)
|
|
83
|
+
args.context = v;
|
|
84
|
+
else if (a === "--input" && (!argv[i + 1] || argv[i + 1].startsWith("--"))) {
|
|
85
|
+
return emitInvalidInput(io, {
|
|
86
|
+
format: asEnvelopeFormat(args.format),
|
|
87
|
+
body: { class: "missing_argument", message: "--input requires a file path or -", syntax: "--input <file|->" },
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
else if ((v = value("--input")) !== null) {
|
|
91
|
+
if (v.length === 0) {
|
|
92
|
+
return emitInvalidInput(io, {
|
|
93
|
+
format: asEnvelopeFormat(args.format),
|
|
94
|
+
body: { class: "missing_argument", message: "--input requires a file path or -", syntax: "--input <file|->" },
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
if (args.input !== null) {
|
|
98
|
+
return emitInvalidInput(io, {
|
|
99
|
+
format: asEnvelopeFormat(args.format),
|
|
100
|
+
body: { class: "mutually_exclusive", message: "--input may only be supplied once" },
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
args.input = v;
|
|
104
|
+
}
|
|
105
|
+
else if ((v = value("--format")) !== null) {
|
|
65
106
|
if (v !== "text" && v !== "json" && v !== "yaml") {
|
|
66
107
|
return emitInvalidInput(io, {
|
|
67
108
|
format: asEnvelopeFormat(args.format),
|
|
@@ -74,11 +115,8 @@ export function runPrime(command, argv, io, prog) {
|
|
|
74
115
|
}
|
|
75
116
|
args.format = v;
|
|
76
117
|
}
|
|
77
|
-
else if (
|
|
78
|
-
args.fields =
|
|
79
|
-
}
|
|
80
|
-
else if (a.startsWith("--fields=")) {
|
|
81
|
-
args.fields = a.slice("--fields=".length);
|
|
118
|
+
else if ((v = value("--fields")) !== null) {
|
|
119
|
+
args.fields = v;
|
|
82
120
|
}
|
|
83
121
|
else {
|
|
84
122
|
return emitInvalidInput(io, {
|
|
@@ -91,10 +129,11 @@ export function runPrime(command, argv, io, prog) {
|
|
|
91
129
|
return cmdPrime(args, io);
|
|
92
130
|
}
|
|
93
131
|
catch (exc) {
|
|
132
|
+
if (exc instanceof StateRetrievalFailure)
|
|
133
|
+
return emitStateFailure(exc, args.format, io);
|
|
94
134
|
return emitInvalidInput(io, {
|
|
95
135
|
format: asEnvelopeFormat(args.format),
|
|
96
136
|
body: { class: "unsupported_target", message: exc.message },
|
|
97
137
|
});
|
|
98
138
|
}
|
|
99
139
|
}
|
|
100
|
-
//# sourceMappingURL=prime.js.map
|