agentera 3.0.0-dev.7 → 3.0.0-dev.72
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 +2 -4
- 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 +17 -8
- 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 +3 -4
- 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 +152 -93
- package/bundle/references/cli/trigger-schema-enrichment.md +57 -46
- package/bundle/references/cli/update-channels.yaml +4 -2
- package/bundle/references/cli/vocabulary-index.yaml +5 -7
- package/bundle/references/cli/vocabulary.md +51 -93
- package/bundle/references/meta/retained-reference-authority.yaml +151 -0
- package/bundle/skills/agentera/SKILL.md +183 -63
- package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +27 -19
- package/bundle/skills/agentera/capabilities/audit/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +13 -35
- package/bundle/skills/agentera/capabilities/audit/schemas/validation.yaml +30 -11
- package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +44 -21
- package/bundle/skills/agentera/capabilities/build/schemas/exit.yaml +8 -6
- package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +14 -36
- package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +95 -21
- package/bundle/skills/agentera/capabilities/design/schemas/artifacts.yaml +6 -6
- package/bundle/skills/agentera/capabilities/design/schemas/exit.yaml +5 -5
- package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +5 -34
- package/bundle/skills/agentera/capabilities/design/schemas/validation.yaml +2 -2
- package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +17 -13
- package/bundle/skills/agentera/capabilities/discuss/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +6 -40
- package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +72 -5
- package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +24 -17
- package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +5 -35
- package/bundle/skills/agentera/capabilities/document/schemas/validation.yaml +13 -13
- package/bundle/skills/agentera/capabilities/optimize/schemas/artifacts.yaml +10 -10
- package/bundle/skills/agentera/capabilities/optimize/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +4 -35
- package/bundle/skills/agentera/capabilities/optimize/schemas/validation.yaml +3 -3
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +34 -22
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/exit.yaml +9 -7
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +5 -37
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +38 -37
- package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +20 -16
- package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +8 -31
- package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +66 -6
- package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +9 -4
- package/bundle/skills/agentera/capabilities/profile/schemas/exit.yaml +4 -4
- package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +8 -37
- package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +61 -3
- package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +6 -6
- package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +5 -29
- package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +13 -12
- package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +7 -49
- package/bundle/skills/agentera/capabilities/vision/schemas/artifacts.yaml +8 -8
- package/bundle/skills/agentera/capabilities/vision/schemas/exit.yaml +7 -6
- package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +7 -39
- package/bundle/skills/agentera/capabilities/vision/schemas/validation.yaml +14 -16
- package/bundle/skills/agentera/capability_schema_contract.yaml +32 -32
- package/bundle/skills/agentera/protocol.yaml +4 -4
- package/bundle/skills/agentera/route-phrases.yaml +81 -0
- package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +1 -0
- package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +30 -12
- package/bundle/skills/agentera/schemas/artifacts/design.yaml +1 -0
- package/bundle/skills/agentera/schemas/artifacts/docs.yaml +7 -12
- package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +140 -9
- package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +82 -0
- package/bundle/skills/agentera/schemas/artifacts/health.yaml +56 -19
- package/bundle/skills/agentera/schemas/artifacts/objective.yaml +18 -4
- package/bundle/skills/agentera/schemas/artifacts/plan.yaml +457 -32
- package/bundle/skills/agentera/schemas/artifacts/progress.yaml +131 -18
- package/bundle/skills/agentera/schemas/artifacts/todo.yaml +302 -7
- package/dist/analytics/extractCorpus/cli.js +52 -11
- package/dist/analytics/extractCorpus/copilotSessions.js +6 -4
- package/dist/analytics/extractCorpus/core.js +40 -12
- package/dist/analytics/extractCorpus/corpus.js +39 -17
- package/dist/analytics/extractCorpus/coverageAudit.js +44 -45
- package/dist/analytics/extractCorpus/cursorSessions.js +6 -4
- package/dist/analytics/extractCorpus/evidenceTiers.js +603 -0
- package/dist/analytics/extractCorpus/extractCorpusParity.js +4 -4
- package/dist/analytics/extractCorpus/filesystemSources.js +1 -5
- package/dist/analytics/extractCorpus/index.js +3 -1
- package/dist/analytics/extractCorpus/jsonlSessions.js +24 -5
- package/dist/analytics/extractCorpus/sqliteCaps.js +0 -1
- package/dist/analytics/extractCorpus/sqliteSessions.js +0 -1
- 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 +150 -23
- package/dist/audit/terminologyDrift.js +281 -0
- package/dist/bin/agentera.js +3 -2
- package/dist/capabilities/audit/instructions.js +16 -6
- package/dist/capabilities/build/instructions.js +59 -6
- package/dist/capabilities/design/instructions.js +3 -4
- package/dist/capabilities/discuss/instructions.js +29 -6
- package/dist/capabilities/document/instructions.js +11 -6
- package/dist/capabilities/index.js +16 -14
- package/dist/capabilities/optimize/instructions.js +14 -6
- package/dist/capabilities/orchestrate/instructions.js +42 -6
- package/dist/capabilities/plan/instructions.js +30 -3
- package/dist/capabilities/profile/instructions.js +70 -6
- package/dist/capabilities/research/instructions.js +4 -5
- package/dist/capabilities/status/instructions.js +15 -6
- package/dist/capabilities/status/startupInstructions.js +34 -0
- package/dist/capabilities/vision/instructions.js +3 -5
- package/dist/cli/appContext.js +14 -7
- package/dist/cli/argvalidate.js +0 -1
- package/dist/cli/capabilityContext/benchmark.js +5 -4
- package/dist/cli/capabilityContext/bespoke.js +14 -6
- package/dist/cli/capabilityContext/build.js +116 -42
- package/dist/cli/capabilityContext/closeout.js +30 -27
- package/dist/cli/capabilityContext/contract.js +18 -27
- package/dist/cli/capabilityContext/evidence.js +84 -77
- package/dist/cli/capabilityContext/index.js +0 -1
- package/dist/cli/capabilityContext/orchestration.js +42 -18
- package/dist/cli/capabilityContext/planState.js +89 -96
- package/dist/cli/capabilityContext/progress.js +51 -12
- package/dist/cli/capabilityContext/projectVerification.js +409 -0
- package/dist/cli/capabilityContext/shared.js +9 -20
- package/dist/cli/capabilityContext/slim.js +52 -8
- package/dist/cli/capabilityContext/startup.js +51 -114
- package/dist/cli/capabilityContext/startupAggregation.js +68 -0
- package/dist/cli/capabilityContext/types.js +26 -10
- package/dist/cli/capabilityContext.js +0 -1
- package/dist/cli/commands/appHome.js +0 -1
- package/dist/cli/commands/capability.js +2 -2
- package/dist/cli/commands/compact.js +163 -13
- package/dist/cli/commands/doctor.js +117 -11
- 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 +54 -4
- package/dist/cli/commands/prime/collectEntityOrientation.js +326 -0
- package/dist/cli/commands/prime/collectOrientationState.js +126 -63
- package/dist/cli/commands/prime/orientationOutput.js +267 -56
- package/dist/cli/commands/prime/types.js +0 -1
- package/dist/cli/commands/prime/v1Migration.js +0 -1
- package/dist/cli/commands/prime.js +76 -11
- package/dist/cli/commands/profileGrounding.js +55 -0
- package/dist/cli/commands/query.js +74 -52
- package/dist/cli/commands/report.js +73 -19
- package/dist/cli/commands/route.js +142 -0
- package/dist/cli/commands/schema.js +257 -138
- package/dist/cli/commands/state/decisions.js +40 -56
- package/dist/cli/commands/state/docs.js +58 -85
- package/dist/cli/commands/state/experimentRecords.js +151 -0
- package/dist/cli/commands/state/experiments.js +11 -65
- package/dist/cli/commands/state/get.js +129 -0
- package/dist/cli/commands/state/health.js +11 -113
- 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 -65
- package/dist/cli/commands/state/plan.js +11 -170
- 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 +28 -107
- 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 +235 -136
- package/dist/cli/commands/verify.js +23 -8
- package/dist/cli/contracts/bundleStatus.js +0 -1
- package/dist/cli/contracts/orientationState.js +0 -1
- package/dist/cli/dispatch/argvParser.js +0 -1
- package/dist/cli/dispatch/check.js +84 -40
- package/dist/cli/dispatch/commands.js +3 -3
- package/dist/cli/dispatch/index.js +77 -52
- package/dist/cli/dispatch/lifecycle.js +117 -62
- package/dist/cli/dispatch/prime.js +37 -2
- package/dist/cli/dispatch/projections.js +17 -0
- package/dist/cli/dispatch/shared.js +1 -2
- package/dist/cli/dispatch/state.js +62 -66
- package/dist/cli/dispatch.js +0 -1
- package/dist/cli/errors.js +16 -17
- package/dist/cli/help.js +358 -39
- package/dist/cli/migrationRequired.js +122 -0
- package/dist/cli/orientation/attention.js +19 -19
- package/dist/cli/orientation/corpusCoverage.js +32 -1
- package/dist/cli/orientation.js +346 -129
- 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 +11 -8
- package/dist/cli/stateQuery.js +47 -12
- 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 +0 -1
- 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 +0 -1
- package/dist/core/jsonValue.js +0 -1
- package/dist/core/paths.js +0 -1
- package/dist/core/pyjson.js +0 -1
- 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 +13 -14
- package/dist/eval/hybridRouteEvaluation.js +155 -0
- package/dist/eval/semanticEval.js +0 -1
- package/dist/eval/semanticFixtures.js +0 -1
- package/dist/hooks/common.js +3 -56
- package/dist/hooks/compaction/apply.js +224 -47
- package/dist/hooks/compaction/dryRun.js +2 -1
- package/dist/hooks/compaction/index.js +5 -6
- package/dist/hooks/compaction/parse.js +73 -6
- package/dist/hooks/compaction/retention.js +28 -25
- package/dist/hooks/compaction/status.js +145 -26
- package/dist/hooks/compaction/types.js +0 -1
- package/dist/hooks/validateArtifact/agentFacing.js +0 -1
- package/dist/hooks/validateArtifact/index.js +6 -65
- package/dist/hooks/validateArtifact/markdown.js +9 -10
- package/dist/hooks/validateArtifact/schema.js +96 -9
- package/dist/hooks/validateArtifact/traversal.js +12 -11
- package/dist/hooks/validateArtifact/violations.js +5 -3
- package/dist/migrate/v2HandoffManifest.js +8 -3
- 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 +207 -60
- package/dist/registries/artifactSchemaProjection.js +45 -0
- package/dist/registries/capabilityContract.js +5 -21
- package/dist/registries/evaluatorHandoffContract.js +0 -1
- 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 +184 -209
- package/dist/registries/todoReadinessContract.js +448 -0
- package/dist/registries/triggerLoader.js +7 -44
- package/dist/registries/verbosityBudgetContract.js +205 -0
- package/dist/release/releaseMetadata.js +155 -5
- 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 +14 -75
- 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 +15 -7
- 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 +70 -9
- package/dist/state/startupAnalysis/contract.js +44 -10
- package/dist/state/startupAnalysis/helpers.js +1 -2
- package/dist/state/startupAnalysis/index.js +0 -1
- package/dist/state/startupAnalysis/metrics.js +0 -1
- package/dist/state/startupAnalysis/records.js +0 -1
- package/dist/state/startupAnalysis/report.js +0 -1
- package/dist/state/startupAnalysis/threshold.js +13 -1
- 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 +77 -36
- package/dist/upgrade/appModel.js +0 -1
- package/dist/upgrade/atomicWriter.js +1 -0
- package/dist/upgrade/bundleEvidence.js +0 -1
- package/dist/upgrade/channels.js +6 -9
- package/dist/upgrade/compatibility.js +43 -17
- package/dist/upgrade/doctor.js +55 -32
- package/dist/upgrade/doctorClassifier.js +11 -1
- package/dist/upgrade/installedHooksRetirement.js +46 -40
- package/dist/upgrade/legacyAgentCleanup.js +187 -21
- package/dist/upgrade/lifecycleUpgrade.js +113 -0
- package/dist/upgrade/migrateArtifactsV2ToV3.js +334 -64
- package/dist/upgrade/migrationPublication.js +122 -0
- package/dist/upgrade/nextMajorDoctor.js +0 -1
- package/dist/upgrade/npxPlatformStatus.js +0 -1
- package/dist/upgrade/projectIntegration.js +121 -159
- package/dist/upgrade/projectIntegrationDecision.js +42 -85
- package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
- package/dist/upgrade/runtimeMigration.js +262 -453
- 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 +0 -1
- 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 +1 -7
- package/dist/validate/bootstrapAuthority.js +44 -0
- package/dist/validate/capability.js +11 -3
- package/dist/validate/crossCapability.js +14 -9
- 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 +8 -8
- package/package.json +41 -13
- package/bundle/references/adapters/cursor.md +0 -214
- 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 -554
- 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 -13
- package/bundle/references/cli/parity-expected-actual-template.md +0 -30
- 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 -45
- 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/audit.toml +0 -6
- package/bundle/skills/agentera/agents/build.toml +0 -6
- package/bundle/skills/agentera/agents/design.toml +0 -6
- package/bundle/skills/agentera/agents/discuss.toml +0 -6
- package/bundle/skills/agentera/agents/document.toml +0 -6
- package/bundle/skills/agentera/agents/optimize.toml +0 -6
- package/bundle/skills/agentera/agents/orchestrate.toml +0 -6
- package/bundle/skills/agentera/agents/plan.toml +0 -6
- package/bundle/skills/agentera/agents/profile.toml +0 -6
- package/bundle/skills/agentera/agents/research.toml +0 -6
- package/bundle/skills/agentera/agents/status.toml +0 -6
- package/bundle/skills/agentera/agents/vision.toml +0 -6
- package/bundle/skills/agentera/references/contract.md +0 -1048
- 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/coverageAudit.js.map +0 -1
- package/dist/analytics/extractCorpus/cursorSessions.js.map +0 -1
- package/dist/analytics/extractCorpus/extractCorpusParity.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/sqliteCaps.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/audit/instructions.js.map +0 -1
- package/dist/capabilities/build/instructions.js.map +0 -1
- package/dist/capabilities/design/instructions.js.map +0 -1
- package/dist/capabilities/discuss/instructions.js.map +0 -1
- package/dist/capabilities/document/instructions.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/optimize/instructions.js.map +0 -1
- package/dist/capabilities/orchestrate/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/plan/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/profile/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/research/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/status/instructions.js.map +0 -1
- package/dist/capabilities/vision/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 -5
- 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/build.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/appHome.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/bundleStatus.js.map +0 -1
- package/dist/cli/commands/prime/collectOrientationState.js.map +0 -1
- package/dist/cli/commands/prime/orientationOutput.js.map +0 -1
- package/dist/cli/commands/prime/routeOutput.js +0 -50
- package/dist/cli/commands/prime/routeOutput.js.map +0 -1
- package/dist/cli/commands/prime/types.js.map +0 -1
- package/dist/cli/commands/prime/v1Migration.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/contracts/bundleStatus.js.map +0 -1
- package/dist/cli/contracts/orientationState.js.map +0 -1
- package/dist/cli/dispatch/argvParser.js.map +0 -1
- package/dist/cli/dispatch/check.js.map +0 -1
- package/dist/cli/dispatch/commands.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/attention.js.map +0 -1
- package/dist/cli/orientation/corpusCoverage.js.map +0 -1
- package/dist/cli/orientation.js.map +0 -1
- package/dist/cli/prime-blob.js.map +0 -1
- package/dist/cli/startupCompletenessContract.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/cli/todoSeverity.js.map +0 -1
- package/dist/core/difflib.js.map +0 -1
- package/dist/core/envPaths.js.map +0 -1
- package/dist/core/git.js +0 -43
- package/dist/core/git.js.map +0 -1
- package/dist/core/jsonValue.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/todoResolved.js +0 -137
- package/dist/hooks/compaction/todoResolved.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 -79
- package/dist/hooks/cursorSessionStart.js.map +0 -1
- package/dist/hooks/sessionStart.js +0 -216
- package/dist/hooks/sessionStart.js.map +0 -1
- package/dist/hooks/sessionStop.js +0 -206
- package/dist/hooks/sessionStop.js.map +0 -1
- package/dist/hooks/todoLayout.js +0 -177
- package/dist/hooks/todoLayout.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 -86
- 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 -316
- package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
- package/dist/registries/triggerLoader.js.map +0 -1
- package/dist/release/releaseMetadata.js.map +0 -1
- package/dist/routing/index.js +0 -2
- package/dist/routing/index.js.map +0 -1
- package/dist/routing/routeEngine.js +0 -189
- package/dist/routing/routeEngine.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 -639
- 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 -129
- package/dist/setup/cursor.js.map +0 -1
- package/dist/setup/cursorSurfaces.js +0 -67
- package/dist/setup/cursorSurfaces.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 -240
- package/dist/setup/doctor/diagnostics.js.map +0 -1
- package/dist/setup/doctor/opencode.js +0 -313
- package/dist/setup/doctor/opencode.js.map +0 -1
- package/dist/setup/doctor/report.js +0 -425
- 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/appContentRefresh.js.map +0 -1
- package/dist/upgrade/appModel.js.map +0 -1
- package/dist/upgrade/bundleEvidence.js.map +0 -1
- package/dist/upgrade/channels.js.map +0 -1
- package/dist/upgrade/cliProbe.js +0 -22
- package/dist/upgrade/cliProbe.js.map +0 -1
- package/dist/upgrade/coexistenceProbe.js +0 -107
- 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/doctorClassifier.js.map +0 -1
- package/dist/upgrade/installedHooksRetirement.js.map +0 -1
- package/dist/upgrade/legacyAgentCleanup.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/npxPlatformStatus.js.map +0 -1
- package/dist/upgrade/projectIntegration.js.map +0 -1
- package/dist/upgrade/projectIntegrationDecision.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/legacyPythonParity.js +0 -93
- package/dist/validate/lifecycleAdapters/legacyPythonParity.js.map +0 -1
- package/dist/validate/lifecycleAdapters/nodeFormChecks.js +0 -488
- package/dist/validate/lifecycleAdapters/nodeFormChecks.js.map +0 -1
- package/dist/validate/lifecycleAdapters/shared.js +0 -198
- package/dist/validate/lifecycleAdapters/shared.js.map +0 -1
- package/dist/validate/lifecycleAdapters.js +0 -62
- package/dist/validate/lifecycleAdapters.js.map +0 -1
- package/dist/validate/selfAudit.js.map +0 -1
- package/dist/validate/vocabularyAuthority.js.map +0 -1
|
@@ -0,0 +1,374 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { CANONICAL_DEVELOPMENT_CLI } from "./developmentChannel.js";
|
|
4
|
+
import { ENTITY_LIST_RUNTIME_FAMILIES, } from "../state/entityListRuntimeRegistry.js";
|
|
5
|
+
import { runtimeOperationSpec, runtimeOperationSpecs, } from "../state/write/runtimeOperations.js";
|
|
6
|
+
export const CANONICAL_DEVELOPMENT_INVOCATION = CANONICAL_DEVELOPMENT_CLI;
|
|
7
|
+
const LOCAL_RUNTIME_INVOCATION = "agentera";
|
|
8
|
+
export class DevelopmentInvocationError extends Error {
|
|
9
|
+
classification;
|
|
10
|
+
constructor(classification, reason) {
|
|
11
|
+
super(`development invocation rejected [${classification}]: ${reason}`);
|
|
12
|
+
this.name = "DevelopmentInvocationError";
|
|
13
|
+
this.classification = classification;
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
export const DEVELOPMENT_RUNTIME_REQUIRED_FILES = Object.freeze([
|
|
17
|
+
"package.json",
|
|
18
|
+
"README.md",
|
|
19
|
+
"LICENSE",
|
|
20
|
+
"dist/bin/agentera.js",
|
|
21
|
+
"bundle/.agentera-npx-bundle.json",
|
|
22
|
+
"bundle/registry.json",
|
|
23
|
+
"bundle/skills/agentera/SKILL.md",
|
|
24
|
+
"bundle/references/adapters/package-registry.yaml",
|
|
25
|
+
]);
|
|
26
|
+
export const DEVELOPMENT_CHILD_ENV_ALLOWLIST = Object.freeze([
|
|
27
|
+
"AGENTERA_BOOTSTRAP_SOURCE_ROOT",
|
|
28
|
+
"AGENTERA_HOME",
|
|
29
|
+
"AGENTERA_UPDATE_CHANNEL",
|
|
30
|
+
"DO_NOT_TRACK",
|
|
31
|
+
"HOME",
|
|
32
|
+
"LANG",
|
|
33
|
+
"LC_ALL",
|
|
34
|
+
"PATH",
|
|
35
|
+
"TMPDIR",
|
|
36
|
+
"XDG_CACHE_HOME",
|
|
37
|
+
"XDG_CONFIG_HOME",
|
|
38
|
+
"XDG_DATA_HOME",
|
|
39
|
+
"XDG_STATE_HOME",
|
|
40
|
+
]);
|
|
41
|
+
export const DEVELOPMENT_CHILD_PATH = process.platform === "win32"
|
|
42
|
+
? path.dirname(process.execPath)
|
|
43
|
+
: "/usr/bin:/bin";
|
|
44
|
+
function developmentCommand(argumentsText) {
|
|
45
|
+
return `${CANONICAL_DEVELOPMENT_INVOCATION} ${argumentsText}`;
|
|
46
|
+
}
|
|
47
|
+
const profileGroundingCommand = developmentCommand("report profile-grounding --format json");
|
|
48
|
+
const GLOSSARY_PROJECTIONS = {
|
|
49
|
+
"profile_output.command": developmentCommand("report profile-glossary"),
|
|
50
|
+
"profile_grounding.command": profileGroundingCommand,
|
|
51
|
+
"profile_grounding.repair": `Use the Profile capability to repair or regenerate PROFILE.md, then retry \`${profileGroundingCommand}\`; no profile bytes were changed.`,
|
|
52
|
+
"profile_grounding.absent": `Use the Profile capability to generate PROFILE.md, then retry ${profileGroundingCommand}.`,
|
|
53
|
+
"advice.command": developmentCommand("report glossary-advice --input REQUEST --format json"),
|
|
54
|
+
};
|
|
55
|
+
function invalid(reason) {
|
|
56
|
+
throw new Error(`invalid development command projection: ${reason}`);
|
|
57
|
+
}
|
|
58
|
+
function runtimeValue(source) {
|
|
59
|
+
return source.split(CANONICAL_DEVELOPMENT_INVOCATION).join(LOCAL_RUNTIME_INVOCATION);
|
|
60
|
+
}
|
|
61
|
+
function assertExact(value, owner, source) {
|
|
62
|
+
if (typeof value !== "string" || value !== source)
|
|
63
|
+
invalid(`'${owner}' does not match its code-owned exact source value`);
|
|
64
|
+
return runtimeValue(source);
|
|
65
|
+
}
|
|
66
|
+
function commandWords(command) {
|
|
67
|
+
const words = [];
|
|
68
|
+
let value = "";
|
|
69
|
+
let started = false;
|
|
70
|
+
let quote = null;
|
|
71
|
+
for (let index = 0; index < command.length; index += 1) {
|
|
72
|
+
const character = command[index];
|
|
73
|
+
if (quote) {
|
|
74
|
+
if (character === quote) {
|
|
75
|
+
quote = null;
|
|
76
|
+
started = true;
|
|
77
|
+
continue;
|
|
78
|
+
}
|
|
79
|
+
if (quote === '"' && character === "\\") {
|
|
80
|
+
const escaped = command[++index];
|
|
81
|
+
if (escaped === undefined)
|
|
82
|
+
invalid("trailing escape");
|
|
83
|
+
if (escaped === "\n" || escaped === "\r")
|
|
84
|
+
invalid("shell continuation is not allowed");
|
|
85
|
+
value += escaped;
|
|
86
|
+
started = true;
|
|
87
|
+
continue;
|
|
88
|
+
}
|
|
89
|
+
if (quote === '"' && (character === "`" || (character === "$" && command[index + 1] === "(")))
|
|
90
|
+
invalid("command substitution is not allowed");
|
|
91
|
+
value += character;
|
|
92
|
+
started = true;
|
|
93
|
+
continue;
|
|
94
|
+
}
|
|
95
|
+
if (character === "\n" || character === "\r")
|
|
96
|
+
invalid("line separators are allowed only inside one quoted argument");
|
|
97
|
+
if (/\s/u.test(character)) {
|
|
98
|
+
if (started) {
|
|
99
|
+
words.push({ value });
|
|
100
|
+
value = "";
|
|
101
|
+
started = false;
|
|
102
|
+
}
|
|
103
|
+
continue;
|
|
104
|
+
}
|
|
105
|
+
if (character === "'" || character === '"') {
|
|
106
|
+
quote = character;
|
|
107
|
+
started = true;
|
|
108
|
+
continue;
|
|
109
|
+
}
|
|
110
|
+
if (character === "\\") {
|
|
111
|
+
const escaped = command[++index];
|
|
112
|
+
if (escaped === undefined)
|
|
113
|
+
invalid("trailing escape");
|
|
114
|
+
if (escaped === "\n" || escaped === "\r")
|
|
115
|
+
invalid("shell continuation is not allowed");
|
|
116
|
+
value += escaped;
|
|
117
|
+
started = true;
|
|
118
|
+
continue;
|
|
119
|
+
}
|
|
120
|
+
if (";&|<>()`".includes(character) || (character === "$" && command[index + 1] === "("))
|
|
121
|
+
invalid("composition, redirection, substitution, and grouping are not allowed");
|
|
122
|
+
value += character;
|
|
123
|
+
started = true;
|
|
124
|
+
}
|
|
125
|
+
if (quote)
|
|
126
|
+
invalid("unclosed quote");
|
|
127
|
+
if (started)
|
|
128
|
+
words.push({ value });
|
|
129
|
+
return words;
|
|
130
|
+
}
|
|
131
|
+
function parsedDevelopmentWords(command, classification) {
|
|
132
|
+
try {
|
|
133
|
+
return commandWords(command).map(({ value }) => value);
|
|
134
|
+
}
|
|
135
|
+
catch (error) {
|
|
136
|
+
throw new DevelopmentInvocationError(classification, error instanceof Error ? error.message : String(error));
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
function hasDevelopmentPrefix(words) {
|
|
140
|
+
return words[0] === "npx" && words[1] === "-y" && words[2] === "agentera@next";
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Bind an untrusted command specification to one exact code-owned development
|
|
144
|
+
* command before a caller crosses a process boundary. The returned argv omits
|
|
145
|
+
* npx and the package selector because callers execute a verified local bin.
|
|
146
|
+
*/
|
|
147
|
+
export function bindDevelopmentInvocation(identity, candidate) {
|
|
148
|
+
if (!/^[a-z0-9][a-z0-9_.:-]*$/u.test(identity.owner)) {
|
|
149
|
+
throw new DevelopmentInvocationError("invalid_authority", "owner is not a canonical identity");
|
|
150
|
+
}
|
|
151
|
+
const authorityWords = parsedDevelopmentWords(identity.source, "invalid_authority");
|
|
152
|
+
if (!hasDevelopmentPrefix(authorityWords) || authorityWords.length === 3) {
|
|
153
|
+
throw new DevelopmentInvocationError("invalid_authority", `authority must be one complete ${CANONICAL_DEVELOPMENT_INVOCATION} command`);
|
|
154
|
+
}
|
|
155
|
+
const candidateWords = parsedDevelopmentWords(candidate, "malformed");
|
|
156
|
+
if (!hasDevelopmentPrefix(candidateWords)) {
|
|
157
|
+
throw new DevelopmentInvocationError("wrong_channel", `command must begin with the exact ${CANONICAL_DEVELOPMENT_INVOCATION} argv`);
|
|
158
|
+
}
|
|
159
|
+
if (candidate !== identity.source) {
|
|
160
|
+
throw new DevelopmentInvocationError("not_exact", `command does not match code-owned identity '${identity.owner}'`);
|
|
161
|
+
}
|
|
162
|
+
return Object.freeze({
|
|
163
|
+
owner: identity.owner,
|
|
164
|
+
source: identity.source,
|
|
165
|
+
argv: Object.freeze(candidateWords.slice(3)),
|
|
166
|
+
});
|
|
167
|
+
}
|
|
168
|
+
/** Fail closed before process start when a constructed runtime is incomplete. */
|
|
169
|
+
export function assertDevelopmentRuntimeSurface(root) {
|
|
170
|
+
for (const relative of DEVELOPMENT_RUNTIME_REQUIRED_FILES) {
|
|
171
|
+
const target = path.join(root, relative);
|
|
172
|
+
let stat;
|
|
173
|
+
try {
|
|
174
|
+
stat = fs.lstatSync(target);
|
|
175
|
+
}
|
|
176
|
+
catch {
|
|
177
|
+
throw new DevelopmentInvocationError("invalid_authority", `runtime is missing required file '${relative}'`);
|
|
178
|
+
}
|
|
179
|
+
if (!stat.isFile()) {
|
|
180
|
+
throw new DevelopmentInvocationError("invalid_authority", `runtime required file '${relative}' is not a regular file`);
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
let manifest;
|
|
184
|
+
try {
|
|
185
|
+
manifest = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
|
|
186
|
+
}
|
|
187
|
+
catch {
|
|
188
|
+
throw new DevelopmentInvocationError("invalid_authority", "package manifest is not valid JSON");
|
|
189
|
+
}
|
|
190
|
+
if (manifest.bin?.agentera !== "dist/bin/agentera.js") {
|
|
191
|
+
throw new DevelopmentInvocationError("invalid_authority", "package bin declaration is not canonical");
|
|
192
|
+
}
|
|
193
|
+
const files = manifest.files;
|
|
194
|
+
if (!Array.isArray(files) || !["dist", "bundle"].every((entry) => files.includes(entry))) {
|
|
195
|
+
throw new DevelopmentInvocationError("invalid_authority", "package files declaration omits dist or bundle");
|
|
196
|
+
}
|
|
197
|
+
const bin = path.join(root, "dist/bin/agentera.js");
|
|
198
|
+
if ((fs.statSync(bin).mode & 0o111) === 0) {
|
|
199
|
+
throw new DevelopmentInvocationError("invalid_authority", "package bin is not executable");
|
|
200
|
+
}
|
|
201
|
+
return bin;
|
|
202
|
+
}
|
|
203
|
+
/** Keep only reviewed process inputs; PATH is always code-owned. */
|
|
204
|
+
export function scrubDevelopmentChildEnvironment(inherited, explicit) {
|
|
205
|
+
const result = {};
|
|
206
|
+
for (const key of DEVELOPMENT_CHILD_ENV_ALLOWLIST) {
|
|
207
|
+
if (key === "PATH")
|
|
208
|
+
continue;
|
|
209
|
+
const value = explicit[key] ?? inherited[key];
|
|
210
|
+
if (value !== undefined)
|
|
211
|
+
result[key] = value;
|
|
212
|
+
}
|
|
213
|
+
result.PATH = DEVELOPMENT_CHILD_PATH;
|
|
214
|
+
return result;
|
|
215
|
+
}
|
|
216
|
+
function fieldValueIssue(field, value) {
|
|
217
|
+
if (field.validValues && !field.validValues.includes(value))
|
|
218
|
+
return "invalid value domain";
|
|
219
|
+
if (field.kind === "boolean" && value !== "true" && value !== "false")
|
|
220
|
+
return "invalid boolean";
|
|
221
|
+
if (field.kind === "integer" && !/^-?(?:0|[1-9][0-9]*)$/u.test(value))
|
|
222
|
+
return "invalid integer";
|
|
223
|
+
if (field.kind === "date" && !/^\d{4}-\d{2}-\d{2}$/u.test(value))
|
|
224
|
+
return "invalid date";
|
|
225
|
+
if (field.kind === "datetime" && !/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/u.test(value))
|
|
226
|
+
return "invalid datetime";
|
|
227
|
+
return undefined;
|
|
228
|
+
}
|
|
229
|
+
function validateOperationExample(spec, template) {
|
|
230
|
+
if (template.runtime !== runtimeValue(template.source))
|
|
231
|
+
invalid(`${spec.artifact}.${spec.verb} has a non-canonical runtime example`);
|
|
232
|
+
if (!template.source.startsWith(`${CANONICAL_DEVELOPMENT_INVOCATION} `))
|
|
233
|
+
invalid(`${spec.artifact}.${spec.verb} example has no canonical prefix`);
|
|
234
|
+
const words = commandWords(template.source).map(({ value }) => value);
|
|
235
|
+
const prefix = ["npx", "-y", "agentera@next", "state", spec.artifact, spec.verb];
|
|
236
|
+
if (!prefix.every((word, index) => words[index] === word))
|
|
237
|
+
invalid(`${spec.artifact}.${spec.verb} example has the wrong operation family`);
|
|
238
|
+
const fields = new Map(spec.fields.map((field) => [field.flag, field]));
|
|
239
|
+
const seen = new Map();
|
|
240
|
+
let input = false;
|
|
241
|
+
let format = false;
|
|
242
|
+
for (let index = prefix.length; index < words.length;) {
|
|
243
|
+
const flag = words[index++];
|
|
244
|
+
if (!flag.startsWith("--") || flag === "--")
|
|
245
|
+
invalid(`${spec.artifact}.${spec.verb} example has an extra positional argument`);
|
|
246
|
+
const count = (seen.get(flag) ?? 0) + 1;
|
|
247
|
+
seen.set(flag, count);
|
|
248
|
+
if (flag === "--dry-run" || flag === "--force") {
|
|
249
|
+
if (count > 1)
|
|
250
|
+
invalid(`${spec.artifact}.${spec.verb} example repeats ${flag}`);
|
|
251
|
+
if (flag === "--force" && !spec.allowForce)
|
|
252
|
+
invalid(`${spec.artifact}.${spec.verb} example uses unauthorized --force`);
|
|
253
|
+
continue;
|
|
254
|
+
}
|
|
255
|
+
const bareBoolean = fields.get(flag);
|
|
256
|
+
if (bareBoolean?.kind === "boolean" && (words[index] === undefined || words[index].startsWith("--"))) {
|
|
257
|
+
if (!bareBoolean.repeatable && count > 1)
|
|
258
|
+
invalid(`${spec.artifact}.${spec.verb} example repeats ${flag}`);
|
|
259
|
+
continue;
|
|
260
|
+
}
|
|
261
|
+
const argument = words[index++];
|
|
262
|
+
if (argument === undefined || argument.startsWith("--"))
|
|
263
|
+
invalid(`${spec.artifact}.${spec.verb} ${flag} needs one non-option value`);
|
|
264
|
+
if (flag === "--format") {
|
|
265
|
+
if (count > 1 || !spec.projection.formatValues.includes(argument))
|
|
266
|
+
invalid(`${spec.artifact}.${spec.verb} example has an invalid format`);
|
|
267
|
+
format = true;
|
|
268
|
+
continue;
|
|
269
|
+
}
|
|
270
|
+
if (flag === "--input") {
|
|
271
|
+
if (count > 1 || spec.inputMode !== "structured")
|
|
272
|
+
invalid(`${spec.artifact}.${spec.verb} example has an unauthorized input`);
|
|
273
|
+
input = true;
|
|
274
|
+
continue;
|
|
275
|
+
}
|
|
276
|
+
const field = fields.get(flag);
|
|
277
|
+
if (!field)
|
|
278
|
+
invalid(`${spec.artifact}.${spec.verb} example has unauthorized flag ${flag}`);
|
|
279
|
+
if (!field.repeatable && count > 1)
|
|
280
|
+
invalid(`${spec.artifact}.${spec.verb} example repeats ${flag}`);
|
|
281
|
+
const issue = fieldValueIssue(field, argument);
|
|
282
|
+
if (issue)
|
|
283
|
+
invalid(`${spec.artifact}.${spec.verb} example has ${issue} for ${flag}`);
|
|
284
|
+
}
|
|
285
|
+
if (!format)
|
|
286
|
+
invalid(`${spec.artifact}.${spec.verb} example omits --format`);
|
|
287
|
+
if (spec.inputMode === "structured" && !spec.inputOptional && !input)
|
|
288
|
+
invalid(`${spec.artifact}.${spec.verb} example omits --input`);
|
|
289
|
+
for (const field of spec.fields) {
|
|
290
|
+
if (field.required && !seen.has(field.flag))
|
|
291
|
+
invalid(`${spec.artifact}.${spec.verb} example omits ${field.flag}`);
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
const validatedOperations = new Set();
|
|
295
|
+
function exactOperation(artifact, verb) {
|
|
296
|
+
const spec = runtimeOperationSpec(artifact, verb);
|
|
297
|
+
if (!spec)
|
|
298
|
+
invalid(`operation '${artifact}.${verb}' is not code-owned`);
|
|
299
|
+
const key = `${artifact}.${verb}`;
|
|
300
|
+
if (!validatedOperations.has(key)) {
|
|
301
|
+
if (spec.projection.recovery.runtime !== runtimeValue(spec.projection.recovery.source))
|
|
302
|
+
invalid(`${key} has a non-canonical runtime recovery`);
|
|
303
|
+
if (spec.projection.examples.length === 0)
|
|
304
|
+
invalid(`${key} has no code-owned example`);
|
|
305
|
+
for (const example of spec.projection.examples)
|
|
306
|
+
validateOperationExample(spec, example);
|
|
307
|
+
validatedOperations.add(key);
|
|
308
|
+
}
|
|
309
|
+
return spec;
|
|
310
|
+
}
|
|
311
|
+
export function projectRuntimeOperationRecovery(value, artifact, verb) {
|
|
312
|
+
const spec = exactOperation(artifact, verb);
|
|
313
|
+
return assertExact(value, `mutation.${artifact}.${verb}.recovery`, spec.projection.recovery.source);
|
|
314
|
+
}
|
|
315
|
+
export function projectRuntimeOperationExamples(value, artifact, verb) {
|
|
316
|
+
const spec = exactOperation(artifact, verb);
|
|
317
|
+
if (!Array.isArray(value) || value.length !== spec.projection.examples.length)
|
|
318
|
+
invalid(`'mutation.${artifact}.${verb}.examples' does not match its code-owned exact source list`);
|
|
319
|
+
return spec.projection.examples.map((template, index) => assertExact(value[index], `mutation.${artifact}.${verb}.examples[${index}]`, template.source));
|
|
320
|
+
}
|
|
321
|
+
export function projectEntityDevelopmentValue(value, familyKey, field) {
|
|
322
|
+
const family = ENTITY_LIST_RUNTIME_FAMILIES.find(({ key }) => key === familyKey);
|
|
323
|
+
const source = family?.projection[field];
|
|
324
|
+
if (!family || typeof source !== "string")
|
|
325
|
+
invalid(`retrieval.${familyKey}.${field} is not a code-owned projection`);
|
|
326
|
+
return assertExact(value, `retrieval.${familyKey}.${field}`, source);
|
|
327
|
+
}
|
|
328
|
+
export function projectGlossaryDevelopmentValue(value, owner) {
|
|
329
|
+
return assertExact(value, `glossary.${owner}`, GLOSSARY_PROJECTIONS[owner]);
|
|
330
|
+
}
|
|
331
|
+
export function developmentProjectionOwners() {
|
|
332
|
+
const owners = [];
|
|
333
|
+
for (const spec of runtimeOperationSpecs()) {
|
|
334
|
+
exactOperation(spec.artifact, spec.verb);
|
|
335
|
+
owners.push({
|
|
336
|
+
owner: `mutation.${spec.artifact}.${spec.verb}.recovery`,
|
|
337
|
+
family: "mutation",
|
|
338
|
+
...spec.projection.recovery,
|
|
339
|
+
consumers: ["schema", "help", "explain"],
|
|
340
|
+
});
|
|
341
|
+
spec.projection.examples.forEach((example, index) => owners.push({
|
|
342
|
+
owner: `mutation.${spec.artifact}.${spec.verb}.examples[${index}]`,
|
|
343
|
+
family: "mutation",
|
|
344
|
+
...example,
|
|
345
|
+
consumers: ["schema", "help", "explain", "parity"],
|
|
346
|
+
}));
|
|
347
|
+
}
|
|
348
|
+
for (const family of ENTITY_LIST_RUNTIME_FAMILIES) {
|
|
349
|
+
for (const field of ["list", "get", "example", "bareRecovery"]) {
|
|
350
|
+
const source = family.projection[field];
|
|
351
|
+
if (typeof source !== "string")
|
|
352
|
+
continue;
|
|
353
|
+
owners.push({
|
|
354
|
+
owner: `retrieval.${family.key}.${field}`,
|
|
355
|
+
family: "retrieval",
|
|
356
|
+
source,
|
|
357
|
+
runtime: runtimeValue(source),
|
|
358
|
+
consumers: ["schema", "help", "runtime_failure"],
|
|
359
|
+
});
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
for (const [owner, source] of Object.entries(GLOSSARY_PROJECTIONS)) {
|
|
363
|
+
owners.push({
|
|
364
|
+
owner: `glossary.${owner}`,
|
|
365
|
+
family: "glossary",
|
|
366
|
+
source,
|
|
367
|
+
runtime: runtimeValue(source),
|
|
368
|
+
consumers: ["schema", "help", "runtime_contract"],
|
|
369
|
+
});
|
|
370
|
+
}
|
|
371
|
+
if (new Set(owners.map(({ owner }) => owner)).size !== owners.length)
|
|
372
|
+
invalid("code-owned projection owner identities are not unique");
|
|
373
|
+
return owners;
|
|
374
|
+
}
|
package/dist/core/difflib.js
CHANGED
package/dist/core/envPaths.js
CHANGED
package/dist/core/jsonValue.js
CHANGED
package/dist/core/paths.js
CHANGED
package/dist/core/pyjson.js
CHANGED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import YAML from "yaml";
|
|
2
|
+
export function declaresAgenteraSkill(text) {
|
|
3
|
+
const lines = text.split(/\r?\n/);
|
|
4
|
+
if (lines[0] !== "---")
|
|
5
|
+
return false;
|
|
6
|
+
const closing = lines.indexOf("---", 1);
|
|
7
|
+
if (closing === -1)
|
|
8
|
+
return false;
|
|
9
|
+
const metadataLines = lines.slice(1, closing);
|
|
10
|
+
try {
|
|
11
|
+
const document = YAML.parseDocument(metadataLines.join("\n"));
|
|
12
|
+
if (document.errors.length > 0)
|
|
13
|
+
return false;
|
|
14
|
+
const metadata = document.toJS();
|
|
15
|
+
if (metadata === null || typeof metadata !== "object" || Array.isArray(metadata))
|
|
16
|
+
return false;
|
|
17
|
+
}
|
|
18
|
+
catch {
|
|
19
|
+
return false;
|
|
20
|
+
}
|
|
21
|
+
const names = metadataLines.filter((line) => /^name\s*:/.test(line));
|
|
22
|
+
return names.length === 1 && names[0] === "name: agentera";
|
|
23
|
+
}
|
package/dist/core/sourceRoot.js
CHANGED
|
@@ -40,9 +40,9 @@ function walkUp(start) {
|
|
|
40
40
|
}
|
|
41
41
|
/**
|
|
42
42
|
* Resolve the Agentera "app source root" that holds skills/, scripts/, schemas,
|
|
43
|
-
* references/, etc.
|
|
44
|
-
*
|
|
45
|
-
*
|
|
43
|
+
* references/, etc. AGENTERA_BOOTSTRAP_SOURCE_ROOT wins, followed by a
|
|
44
|
+
* checkout containing the executing module, a self-contained package bundle,
|
|
45
|
+
* and finally a walk-up from the working directory.
|
|
46
46
|
*/
|
|
47
47
|
export function resolveSourceRoot(env = process.env) {
|
|
48
48
|
const configured = env[BOOTSTRAP_SOURCE_ROOT_ENV];
|
|
@@ -54,19 +54,16 @@ export function resolveSourceRoot(env = process.env) {
|
|
|
54
54
|
if (fromModule) {
|
|
55
55
|
return fromModule;
|
|
56
56
|
}
|
|
57
|
+
// A packaged CLI must keep runtime code and app data on the same version.
|
|
58
|
+
// Otherwise an Agentera checkout used as cwd can override the package bundle.
|
|
59
|
+
const bundled = path.resolve(moduleDir, "..", "..", "bundle");
|
|
60
|
+
if (isNpxBundleRoot(bundled)) {
|
|
61
|
+
return bundled;
|
|
62
|
+
}
|
|
57
63
|
const fromCwd = walkUp(process.cwd());
|
|
58
64
|
if (fromCwd) {
|
|
59
65
|
return fromCwd;
|
|
60
66
|
}
|
|
61
|
-
// Self-contained npm package: app data is staged under <packageRoot>/bundle
|
|
62
|
-
// (see scripts/copy-bundle.mjs). This makes `npx agentera` work with no repo
|
|
63
|
-
// checkout and no AGENTERA_HOME. Only reached when no checkout/app-home is
|
|
64
|
-
// found, so it never overrides a real checkout, installed app, or cwd match.
|
|
65
|
-
const bundled = path.resolve(moduleDir, "..", "..", "bundle");
|
|
66
|
-
if (hasSourceMarker(bundled)) {
|
|
67
|
-
return bundled;
|
|
68
|
-
}
|
|
69
67
|
// Last resort: package root two levels above dist/core.
|
|
70
68
|
return path.resolve(moduleDir, "..", "..");
|
|
71
69
|
}
|
|
72
|
-
//# sourceMappingURL=sourceRoot.js.map
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export function truncateCodePoints(value, maxChars, suffix = "", trimTrailingWhitespace = false) {
|
|
2
|
+
const characters = Array.from(value);
|
|
3
|
+
if (characters.length <= maxChars)
|
|
4
|
+
return value;
|
|
5
|
+
const suffixCharacters = Array.from(suffix).slice(0, maxChars);
|
|
6
|
+
const prefix = characters
|
|
7
|
+
.slice(0, Math.max(0, maxChars - suffixCharacters.length))
|
|
8
|
+
.join("");
|
|
9
|
+
return `${trimTrailingWhitespace ? prefix.replace(/\s+$/, "") : prefix}${suffixCharacters.join("")}`;
|
|
10
|
+
}
|
package/dist/core/toml.js
CHANGED
package/dist/core/yaml.js
CHANGED
|
@@ -22,4 +22,11 @@ export function loadYamlMappingFile(path) {
|
|
|
22
22
|
export function parseYaml(text) {
|
|
23
23
|
return YAML.parse(text);
|
|
24
24
|
}
|
|
25
|
-
|
|
25
|
+
/** Serialize a YAML mapping with stable block-style prose and insertion-order keys. */
|
|
26
|
+
export function dumpYamlMapping(doc) {
|
|
27
|
+
return YAML.stringify(doc, {
|
|
28
|
+
blockQuote: "literal",
|
|
29
|
+
collectionStyle: "block",
|
|
30
|
+
lineWidth: 0,
|
|
31
|
+
});
|
|
32
|
+
}
|
package/dist/eval/evalSkills.js
CHANGED
|
@@ -41,7 +41,11 @@ export function detectRuntime(explicit, opts = {}) {
|
|
|
41
41
|
const which = opts.which ?? realWhich;
|
|
42
42
|
const err = opts.err ?? ((line) => process.stderr.write(line + "\n"));
|
|
43
43
|
if (explicit && explicit !== "auto") {
|
|
44
|
-
if (explicit
|
|
44
|
+
if (explicit !== "opencode" && explicit !== "cursor") {
|
|
45
|
+
err(`ERROR: '${explicit}' is not an active eval runtime; choose opencode or cursor.`);
|
|
46
|
+
throw new ExitError(1);
|
|
47
|
+
}
|
|
48
|
+
if (explicit === "cursor") {
|
|
45
49
|
if (which("cursor-agent") === null && which("agent") === null) {
|
|
46
50
|
err("ERROR: 'cursor-agent' not found on PATH. Install Cursor Agent CLI " +
|
|
47
51
|
"and ensure the binary is accessible.");
|
|
@@ -50,17 +54,14 @@ export function detectRuntime(explicit, opts = {}) {
|
|
|
50
54
|
}
|
|
51
55
|
return explicit;
|
|
52
56
|
}
|
|
53
|
-
const hasClaude = which("claude") !== null;
|
|
54
57
|
const hasOpencode = which("opencode") !== null;
|
|
55
58
|
const hasCursorAgent = which("cursor-agent") !== null || which("agent") !== null;
|
|
56
|
-
if (hasClaude)
|
|
57
|
-
return "claude";
|
|
58
59
|
if (hasOpencode)
|
|
59
60
|
return "opencode";
|
|
60
61
|
if (hasCursorAgent)
|
|
61
|
-
return "cursor
|
|
62
|
-
err("ERROR: Neither
|
|
63
|
-
"Install
|
|
62
|
+
return "cursor";
|
|
63
|
+
err("ERROR: Neither the OpenCode nor Cursor eval surface was found on PATH. " +
|
|
64
|
+
"Install an active eval runtime host and ensure the binary is accessible.");
|
|
64
65
|
throw new ExitError(1);
|
|
65
66
|
}
|
|
66
67
|
export function parseFrontmatterName(text) {
|
|
@@ -108,7 +109,7 @@ const realRun = (cmd, opts) => {
|
|
|
108
109
|
timedOut: result.signal === "SIGTERM" && result.error !== undefined,
|
|
109
110
|
};
|
|
110
111
|
};
|
|
111
|
-
export function invokeSkill(name, prompt, timeout, runtime = "
|
|
112
|
+
export function invokeSkill(name, prompt, timeout, runtime = "opencode", opts = {}) {
|
|
112
113
|
const which = opts.which ?? realWhich;
|
|
113
114
|
const run = opts.run ?? realRun;
|
|
114
115
|
const repoRoot = opts.repoRoot ?? resolveSourceRoot();
|
|
@@ -118,14 +119,13 @@ export function invokeSkill(name, prompt, timeout, runtime = "claude", opts = {}
|
|
|
118
119
|
cmd = ["opencode", "run", "--prompt"];
|
|
119
120
|
stdinPrompt = prompt;
|
|
120
121
|
}
|
|
121
|
-
else if (runtime === "cursor
|
|
122
|
+
else if (runtime === "cursor") {
|
|
122
123
|
const binary = which("cursor-agent") ? "cursor-agent" : "agent";
|
|
123
124
|
cmd = [binary, "-p", "--output-format", "json", "--force", prompt];
|
|
124
125
|
stdinPrompt = null;
|
|
125
126
|
}
|
|
126
127
|
else {
|
|
127
|
-
|
|
128
|
-
stdinPrompt = prompt;
|
|
128
|
+
throw new ExitError(1, `unsupported active eval runtime: ${runtime}`);
|
|
129
129
|
}
|
|
130
130
|
const start = Date.now();
|
|
131
131
|
let error = null;
|
|
@@ -168,7 +168,7 @@ export function invokeSkill(name, prompt, timeout, runtime = "claude", opts = {}
|
|
|
168
168
|
error,
|
|
169
169
|
};
|
|
170
170
|
}
|
|
171
|
-
export function runSkills(skills, timeout, _parallel, runtime = "
|
|
171
|
+
export function runSkills(skills, timeout, _parallel, runtime = "opencode", opts = {}) {
|
|
172
172
|
// Parallelism in the Python runner is a maintainer perf detail; the smoke
|
|
173
173
|
// semantics (one result per skill, original order) are preserved sequentially.
|
|
174
174
|
return skills.map((entry) => invokeSkill(entry.name, entry.prompt, timeout, runtime, opts));
|
|
@@ -184,7 +184,7 @@ export function buildReport(results) {
|
|
|
184
184
|
results,
|
|
185
185
|
};
|
|
186
186
|
}
|
|
187
|
-
export function buildDryRun(skills, runtime = "
|
|
187
|
+
export function buildDryRun(skills, runtime = "opencode", runtimeSource = "auto-detected") {
|
|
188
188
|
return {
|
|
189
189
|
mode: "dry-run",
|
|
190
190
|
runtime: `${runtime} (${runtimeSource})`,
|
|
@@ -260,4 +260,3 @@ export function parseArgs(argv) {
|
|
|
260
260
|
}
|
|
261
261
|
return args;
|
|
262
262
|
}
|
|
263
|
-
//# sourceMappingURL=evalSkills.js.map
|