agentera 3.0.0-dev.7 → 3.0.0-dev.74
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 +229 -22
- package/bundle/.agentera-build-source.json +8 -0
- 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 +484 -0
- package/bundle/references/adapters/package-registry.yaml +439 -188
- package/bundle/references/adapters/package-surface-characterization.md +68 -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 +559 -0
- package/bundle/references/analysis/personal-glossary-evaluation-authority.yaml +175 -0
- package/bundle/references/analysis/personal-glossary-evaluation-corpus.yaml +291 -0
- package/bundle/references/analysis/personal-glossary-holdout.yaml +192 -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 +2752 -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 +6 -4
- package/bundle/references/cli/vocabulary-index.yaml +5 -7
- package/bundle/references/cli/vocabulary.md +52 -94
- package/bundle/references/meta/retained-reference-authority.yaml +166 -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 +13 -4
- package/bundle/skills/agentera/capabilities/profile/schemas/exit.yaml +8 -5
- package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +8 -37
- package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +67 -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 +87 -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 +464 -32
- package/bundle/skills/agentera/schemas/artifacts/progress.yaml +131 -18
- package/bundle/skills/agentera/schemas/artifacts/todo.yaml +302 -7
- package/dist/.agentera-build-source.json +8 -0
- package/dist/analytics/extractCorpus/cli.js +52 -11
- package/dist/analytics/extractCorpus/copilotSessions.js +19 -8
- package/dist/analytics/extractCorpus/core.js +262 -14
- package/dist/analytics/extractCorpus/corpus.js +57 -18
- package/dist/analytics/extractCorpus/coverageAudit.js +44 -45
- package/dist/analytics/extractCorpus/cursorSessions.js +28 -8
- package/dist/analytics/extractCorpus/evidenceTiers.js +709 -0
- package/dist/analytics/extractCorpus/extractCorpusParity.js +4 -4
- package/dist/analytics/extractCorpus/filesystemSources.js +5 -5
- package/dist/analytics/extractCorpus/index.js +4 -2
- package/dist/analytics/extractCorpus/jsonlSessions.js +76 -8
- package/dist/analytics/extractCorpus/sqliteCaps.js +0 -1
- package/dist/analytics/extractCorpus/sqliteSessions.js +12 -4
- 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 +113 -0
- package/dist/analytics/personalGlossaryCandidateProjection.js +692 -0
- package/dist/analytics/personalGlossaryCandidateProjectionExcerpts.js +144 -0
- package/dist/analytics/personalGlossaryCandidateReadView.js +23 -0
- package/dist/analytics/personalGlossaryCurrentGeneration.js +25 -0
- package/dist/analytics/personalGlossaryDecision.js +203 -0
- package/dist/analytics/personalGlossaryExplicit.js +788 -0
- package/dist/analytics/personalGlossaryExplicitMining.js +285 -0
- package/dist/analytics/personalGlossaryExplicitScope.js +41 -0
- package/dist/analytics/personalGlossaryExplicitSegments.js +418 -0
- package/dist/analytics/personalGlossaryExplicitTypes.js +26 -0
- package/dist/analytics/personalGlossaryLexicalClassifier.js +175 -0
- package/dist/analytics/personalGlossaryProfile.js +229 -0
- package/dist/analytics/personalGlossaryRecurrence.js +618 -0
- package/dist/analytics/personalGlossaryReviewRecordStorage.js +428 -0
- package/dist/analytics/personalGlossaryReviewRecords.js +332 -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 +20 -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 +104 -5
- 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/personalGlossaryCandidateReads.js +744 -0
- package/dist/cli/commands/personalGlossaryDecision.js +349 -0
- package/dist/cli/commands/personalGlossaryPublish.js +484 -0
- package/dist/cli/commands/personalGlossaryReviewRecordReads.js +209 -0
- package/dist/cli/commands/personalGlossaryReviewRecords.js +623 -0
- package/dist/cli/commands/prime/briefOrientation.js +845 -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 +91 -21
- package/dist/cli/commands/route.js +142 -0
- package/dist/cli/commands/schema.js +436 -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 +73 -16
- 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 +162 -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 +404 -39
- package/dist/cli/migrationRequired.js +125 -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 +23 -0
- package/dist/core/developmentChannel.js +1 -0
- package/dist/core/developmentInvocation.js +377 -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 +61 -2
- package/dist/eval/evalSkills.js +13 -14
- package/dist/eval/glossaryEvaluation.js +751 -0
- package/dist/eval/glossaryEvaluationProcess.js +29 -0
- package/dist/eval/glossaryEvaluationRunner.js +571 -0
- package/dist/eval/glossaryEvaluationSuccessReport.js +297 -0
- 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 +136 -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 +375 -0
- package/dist/registries/explicitSegmentGrammarContract.js +619 -0
- package/dist/registries/glossaryAdviceContract.js +79 -0
- package/dist/registries/glossaryCandidateContractPaths.js +6 -0
- package/dist/registries/glossaryCandidateContracts.js +820 -0
- package/dist/registries/glossaryCandidateDecisionAuthority.js +119 -0
- package/dist/registries/glossaryCandidateDecisionContract.js +62 -0
- package/dist/registries/glossaryCandidateProjectionAuthority.js +197 -0
- package/dist/registries/glossaryCandidateProjectionContract.js +104 -0
- package/dist/registries/glossaryCaveatContract.js +67 -0
- package/dist/registries/glossaryConsumerContractValidation.js +787 -0
- package/dist/registries/glossaryEntryContract.js +759 -0
- package/dist/registries/glossaryEntryTemporal.js +12 -0
- package/dist/registries/glossaryMiningAuthority.js +764 -0
- package/dist/registries/glossaryProfileFullContract.js +24 -0
- package/dist/registries/glossaryReviewRecordsAuthority.js +426 -0
- package/dist/registries/glossaryReviewRecordsContract.js +129 -0
- package/dist/registries/glossaryTermIdentity.js +139 -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/personalGlossaryContracts.js +1 -0
- 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 +167 -10
- 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 +2 -2
- package/dist/upgrade/projectIntegration.js +128 -160
- 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 +866 -0
- package/dist/validate/activationArtifactEvidenceTypes.js +12 -0
- package/dist/validate/activationConjunction.js +816 -0
- package/dist/validate/activationEvidenceManifest.js +610 -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 +39 -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,297 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { resolveSourceRoot } from "../core/sourceRoot.js";
|
|
4
|
+
import { canonicalDigest, GLOSSARY_EVALUATION_SCHEMA_VERSION, GLOSSARY_METRIC_IDS, glossaryEvaluationAuthorityPath, glossaryEvaluationBehaviorFixturePath, glossaryEvaluationCaseCounts, glossaryEvaluationHoldoutPath, glossaryEvaluationLabelDigest, loadGlossaryEvaluationAuthority, loadGlossaryEvaluationBehaviorFixture, loadGlossaryEvaluationHoldout, mapping, metricRule, sha256, validateFrozenGlossaryBehaviorFixture, validateFrozenGlossaryHoldout, validateGlossaryEvaluationAuthority, wilsonLowerBound, } from "./glossaryEvaluation.js";
|
|
5
|
+
const MAX_SUCCESS_REPORT_UTF8_BYTES = 1_048_576;
|
|
6
|
+
const POLICY_PATH = "references/artifacts/glossary-entry-contract.yaml";
|
|
7
|
+
const SUCCESS_REPORT_FIELDS = [
|
|
8
|
+
"schemaVersion",
|
|
9
|
+
"status",
|
|
10
|
+
"report",
|
|
11
|
+
"authority",
|
|
12
|
+
"policy",
|
|
13
|
+
"holdout",
|
|
14
|
+
"behavior_fixture",
|
|
15
|
+
"observations",
|
|
16
|
+
"metrics",
|
|
17
|
+
"metrics_sha256",
|
|
18
|
+
"gates",
|
|
19
|
+
"denominator_counts",
|
|
20
|
+
];
|
|
21
|
+
function record(value) {
|
|
22
|
+
return mapping(value);
|
|
23
|
+
}
|
|
24
|
+
function exactFields(value, expected) {
|
|
25
|
+
const fields = Object.keys(value);
|
|
26
|
+
return fields.length === expected.length && expected.every((field) => Object.hasOwn(value, field));
|
|
27
|
+
}
|
|
28
|
+
function same(value, expected) {
|
|
29
|
+
try {
|
|
30
|
+
return canonicalDigest(value) === canonicalDigest(expected);
|
|
31
|
+
}
|
|
32
|
+
catch {
|
|
33
|
+
return false;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
function isLowerSha256(value) {
|
|
37
|
+
return typeof value === "string" && /^[a-f0-9]{64}$/u.test(value);
|
|
38
|
+
}
|
|
39
|
+
function nonNegativeInteger(value) {
|
|
40
|
+
return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
|
|
41
|
+
}
|
|
42
|
+
function positiveInteger(value) {
|
|
43
|
+
return nonNegativeInteger(value) && value > 0;
|
|
44
|
+
}
|
|
45
|
+
function probability(value) {
|
|
46
|
+
return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1;
|
|
47
|
+
}
|
|
48
|
+
function currentBindings(root) {
|
|
49
|
+
try {
|
|
50
|
+
const authorityPath = glossaryEvaluationAuthorityPath(root);
|
|
51
|
+
const holdoutPath = glossaryEvaluationHoldoutPath(root);
|
|
52
|
+
const behaviorPath = glossaryEvaluationBehaviorFixturePath(root);
|
|
53
|
+
const authorityBytes = fs.readFileSync(authorityPath);
|
|
54
|
+
const holdoutBytes = fs.readFileSync(holdoutPath);
|
|
55
|
+
const behaviorBytes = fs.readFileSync(behaviorPath);
|
|
56
|
+
const authority = loadGlossaryEvaluationAuthority(root);
|
|
57
|
+
const holdout = loadGlossaryEvaluationHoldout(root);
|
|
58
|
+
const behavior = loadGlossaryEvaluationBehaviorFixture(root);
|
|
59
|
+
if (validateGlossaryEvaluationAuthority(authority).length > 0 ||
|
|
60
|
+
validateFrozenGlossaryHoldout(authority, holdout, holdoutBytes).length > 0 ||
|
|
61
|
+
validateFrozenGlossaryBehaviorFixture(authority, holdout, behavior, behaviorBytes).length > 0) {
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
return {
|
|
65
|
+
authority,
|
|
66
|
+
authorityBytes,
|
|
67
|
+
holdout,
|
|
68
|
+
holdoutBytes,
|
|
69
|
+
behavior,
|
|
70
|
+
behaviorBytes,
|
|
71
|
+
policyBytes: fs.readFileSync(path.join(root, POLICY_PATH)),
|
|
72
|
+
holdoutCaseCounts: glossaryEvaluationCaseCounts(holdout),
|
|
73
|
+
behaviorCaseCounts: glossaryEvaluationCaseCounts(behavior),
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
catch {
|
|
77
|
+
return null;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
function passedMetric(value, expectedMetric, authority) {
|
|
81
|
+
const source = record(value);
|
|
82
|
+
if (source === null || source.metric !== expectedMetric)
|
|
83
|
+
return null;
|
|
84
|
+
const uncertainty = record(source.uncertainty);
|
|
85
|
+
const thresholds = record(source.thresholds);
|
|
86
|
+
const gates = record(source.gates);
|
|
87
|
+
if (uncertainty === null || thresholds === null || gates === null)
|
|
88
|
+
return null;
|
|
89
|
+
const numerator = source.numerator;
|
|
90
|
+
const denominator = source.denominator;
|
|
91
|
+
const pointEstimate = source.point_estimate;
|
|
92
|
+
const lowerBound = uncertainty.lower_bound;
|
|
93
|
+
const rule = metricRule(authority, expectedMetric);
|
|
94
|
+
if (!nonNegativeInteger(numerator) ||
|
|
95
|
+
!positiveInteger(denominator) ||
|
|
96
|
+
numerator > denominator ||
|
|
97
|
+
!probability(pointEstimate) ||
|
|
98
|
+
!probability(lowerBound) ||
|
|
99
|
+
pointEstimate !== numerator / denominator ||
|
|
100
|
+
lowerBound !== wilsonLowerBound(numerator, denominator, rule.confidence) ||
|
|
101
|
+
denominator < rule.minimumSampleSize ||
|
|
102
|
+
pointEstimate < rule.pointEstimateMinimum ||
|
|
103
|
+
lowerBound < rule.lowerBoundMinimum ||
|
|
104
|
+
uncertainty.method !== rule.uncertaintyMethod ||
|
|
105
|
+
uncertainty.confidence !== rule.confidence ||
|
|
106
|
+
uncertainty.one_sided !== true ||
|
|
107
|
+
thresholds.minimum_sample_size !== rule.minimumSampleSize ||
|
|
108
|
+
thresholds.point_estimate_minimum !== rule.pointEstimateMinimum ||
|
|
109
|
+
thresholds.lower_bound_minimum !== rule.lowerBoundMinimum ||
|
|
110
|
+
gates.denominator_nonzero !== true ||
|
|
111
|
+
gates.sample_sufficient !== true ||
|
|
112
|
+
gates.point_threshold !== true ||
|
|
113
|
+
gates.uncertainty_threshold !== true ||
|
|
114
|
+
source.status !== "pass" ||
|
|
115
|
+
!Array.isArray(source.failure_reasons) ||
|
|
116
|
+
source.failure_reasons.length !== 0) {
|
|
117
|
+
return null;
|
|
118
|
+
}
|
|
119
|
+
const metric = {
|
|
120
|
+
metric: expectedMetric,
|
|
121
|
+
numerator,
|
|
122
|
+
denominator,
|
|
123
|
+
point_estimate: pointEstimate,
|
|
124
|
+
uncertainty: {
|
|
125
|
+
method: rule.uncertaintyMethod,
|
|
126
|
+
confidence: rule.confidence,
|
|
127
|
+
one_sided: true,
|
|
128
|
+
lower_bound: lowerBound,
|
|
129
|
+
},
|
|
130
|
+
thresholds: {
|
|
131
|
+
minimum_sample_size: rule.minimumSampleSize,
|
|
132
|
+
point_estimate_minimum: rule.pointEstimateMinimum,
|
|
133
|
+
lower_bound_minimum: rule.lowerBoundMinimum,
|
|
134
|
+
},
|
|
135
|
+
gates: {
|
|
136
|
+
denominator_nonzero: true,
|
|
137
|
+
sample_sufficient: true,
|
|
138
|
+
point_threshold: true,
|
|
139
|
+
uncertainty_threshold: true,
|
|
140
|
+
},
|
|
141
|
+
status: "pass",
|
|
142
|
+
failure_reasons: [],
|
|
143
|
+
};
|
|
144
|
+
return same(source, metric) ? metric : null;
|
|
145
|
+
}
|
|
146
|
+
function validObservationSeams(value, counts) {
|
|
147
|
+
const seams = Array.isArray(value) ? value : null;
|
|
148
|
+
const expected = [
|
|
149
|
+
["discovery_recall", "discovery", "mineExplicitGlossaryCandidates", false],
|
|
150
|
+
["scope_accuracy", "scope", "mineExplicitGlossaryCandidates", true],
|
|
151
|
+
["inferred_review_precision", "inferred_review", "mineRecurringGlossaryCandidates+personalGlossaryDecision.v2", false],
|
|
152
|
+
["explicit_admission_precision", "explicit_admission", "mineExplicitGlossaryCandidates+personalGlossaryDecision.v2", false],
|
|
153
|
+
];
|
|
154
|
+
if (seams === null || seams.length !== expected.length)
|
|
155
|
+
return false;
|
|
156
|
+
return expected.every(([metric, family, producer, hasAbstentions], index) => {
|
|
157
|
+
const seam = record(seams[index]);
|
|
158
|
+
if (seam === null || !exactFields(seam, hasAbstentions
|
|
159
|
+
? ["metric", "producer", "cases", "candidates", "abstentions"]
|
|
160
|
+
: ["metric", "producer", "cases", "candidates"]))
|
|
161
|
+
return false;
|
|
162
|
+
const candidates = seam.candidates;
|
|
163
|
+
const abstentions = seam.abstentions;
|
|
164
|
+
return seam.metric === metric &&
|
|
165
|
+
seam.producer === producer &&
|
|
166
|
+
seam.cases === counts[family] &&
|
|
167
|
+
nonNegativeInteger(candidates) &&
|
|
168
|
+
candidates <= counts[family] &&
|
|
169
|
+
(!hasAbstentions || (nonNegativeInteger(abstentions) &&
|
|
170
|
+
candidates + abstentions <= counts[family]));
|
|
171
|
+
});
|
|
172
|
+
}
|
|
173
|
+
function validBindings(source, bindings) {
|
|
174
|
+
const expectedAuthority = {
|
|
175
|
+
schema_version: bindings.authority.schema_version,
|
|
176
|
+
path: "references/analysis/personal-glossary-evaluation-authority.yaml",
|
|
177
|
+
sha256: sha256(bindings.authorityBytes),
|
|
178
|
+
};
|
|
179
|
+
const expectedPolicy = { path: POLICY_PATH, sha256: sha256(bindings.policyBytes) };
|
|
180
|
+
const expectedHoldout = {
|
|
181
|
+
id: bindings.holdout.holdout_id,
|
|
182
|
+
status: bindings.holdout.status,
|
|
183
|
+
fixture_sha256: sha256(bindings.holdoutBytes),
|
|
184
|
+
labels_sha256: glossaryEvaluationLabelDigest(bindings.holdout),
|
|
185
|
+
provenance: bindings.holdout.provenance,
|
|
186
|
+
case_counts: bindings.holdoutCaseCounts,
|
|
187
|
+
};
|
|
188
|
+
const expectedBehavior = {
|
|
189
|
+
id: bindings.behavior.fixture_id,
|
|
190
|
+
status: bindings.behavior.status,
|
|
191
|
+
path: "references/analysis/personal-glossary-evaluation-corpus.yaml",
|
|
192
|
+
fixture_sha256: sha256(bindings.behaviorBytes),
|
|
193
|
+
provenance: bindings.behavior.provenance,
|
|
194
|
+
case_counts: bindings.behaviorCaseCounts,
|
|
195
|
+
};
|
|
196
|
+
const observations = record(source.observations);
|
|
197
|
+
return same(source.authority, expectedAuthority) &&
|
|
198
|
+
same(source.policy, expectedPolicy) &&
|
|
199
|
+
same(source.holdout, expectedHoldout) &&
|
|
200
|
+
same(source.behavior_fixture, expectedBehavior) &&
|
|
201
|
+
observations !== null &&
|
|
202
|
+
exactFields(observations, [
|
|
203
|
+
"schema_version",
|
|
204
|
+
"source",
|
|
205
|
+
"sha256",
|
|
206
|
+
"holdout_fixture_sha256",
|
|
207
|
+
"behavior_fixture_sha256",
|
|
208
|
+
"case_counts",
|
|
209
|
+
"seams",
|
|
210
|
+
"effects",
|
|
211
|
+
]) &&
|
|
212
|
+
observations.schema_version === "agentera.personalGlossaryEvaluationObservations.v2" &&
|
|
213
|
+
observations.source === "current_product_behavior" &&
|
|
214
|
+
isLowerSha256(observations.sha256) &&
|
|
215
|
+
observations.holdout_fixture_sha256 === expectedHoldout.fixture_sha256 &&
|
|
216
|
+
observations.behavior_fixture_sha256 === expectedBehavior.fixture_sha256 &&
|
|
217
|
+
same(observations.case_counts, bindings.holdoutCaseCounts) &&
|
|
218
|
+
same(observations.effects, []) &&
|
|
219
|
+
validObservationSeams(observations.seams, bindings.holdoutCaseCounts);
|
|
220
|
+
}
|
|
221
|
+
function validReleaseReport(source, metrics) {
|
|
222
|
+
const expectedReport = {
|
|
223
|
+
exploratory: { release_authorizing: false, status: "report_only", metrics },
|
|
224
|
+
release_gate: {
|
|
225
|
+
release_authorizing: true,
|
|
226
|
+
release_authorized: true,
|
|
227
|
+
status: "pass",
|
|
228
|
+
failure_reasons: [],
|
|
229
|
+
},
|
|
230
|
+
};
|
|
231
|
+
const expectedGates = {
|
|
232
|
+
explicit_admission: {
|
|
233
|
+
metric: "explicit_admission_precision",
|
|
234
|
+
status: "pass",
|
|
235
|
+
qualification_blocker: true,
|
|
236
|
+
outcome: "explicit_automatic_admission_only",
|
|
237
|
+
},
|
|
238
|
+
inferred_review: {
|
|
239
|
+
metric: "inferred_review_precision",
|
|
240
|
+
status: "pass",
|
|
241
|
+
outcome: "review_suggestions_only",
|
|
242
|
+
},
|
|
243
|
+
inferred_automatic_admission: {
|
|
244
|
+
status: "disabled",
|
|
245
|
+
enabled: false,
|
|
246
|
+
measured_result: "cannot_enable",
|
|
247
|
+
},
|
|
248
|
+
release_authorizing: "pass",
|
|
249
|
+
};
|
|
250
|
+
const denominatorCounts = Object.fromEntries(metrics.map(({ metric, denominator }) => [metric, denominator]));
|
|
251
|
+
return same(source.report, expectedReport) &&
|
|
252
|
+
same(source.gates, expectedGates) &&
|
|
253
|
+
same(source.denominator_counts, denominatorCounts);
|
|
254
|
+
}
|
|
255
|
+
/**
|
|
256
|
+
* Accept only the current, complete, successful glossary evaluator report.
|
|
257
|
+
* This parser reads authority inputs but never imports or runs the evaluator.
|
|
258
|
+
*/
|
|
259
|
+
export function validateGlossaryEvaluationSuccessReport(result, root = resolveSourceRoot()) {
|
|
260
|
+
if (result.returncode !== 0 || Buffer.byteLength(result.stdout, "utf8") > MAX_SUCCESS_REPORT_UTF8_BYTES) {
|
|
261
|
+
return null;
|
|
262
|
+
}
|
|
263
|
+
let source;
|
|
264
|
+
try {
|
|
265
|
+
source = record(JSON.parse(result.stdout));
|
|
266
|
+
}
|
|
267
|
+
catch {
|
|
268
|
+
return null;
|
|
269
|
+
}
|
|
270
|
+
if (source === null ||
|
|
271
|
+
!exactFields(source, SUCCESS_REPORT_FIELDS) ||
|
|
272
|
+
source.schemaVersion !== GLOSSARY_EVALUATION_SCHEMA_VERSION ||
|
|
273
|
+
source.status !== "pass") {
|
|
274
|
+
return null;
|
|
275
|
+
}
|
|
276
|
+
const bindings = currentBindings(root);
|
|
277
|
+
if (bindings === null || !validBindings(source, bindings))
|
|
278
|
+
return null;
|
|
279
|
+
const sourceMetrics = source.metrics;
|
|
280
|
+
if (!Array.isArray(sourceMetrics) || sourceMetrics.length !== GLOSSARY_METRIC_IDS.length)
|
|
281
|
+
return null;
|
|
282
|
+
const metrics = [];
|
|
283
|
+
for (const [index, metric] of GLOSSARY_METRIC_IDS.entries()) {
|
|
284
|
+
const passed = passedMetric(sourceMetrics[index], metric, bindings.authority);
|
|
285
|
+
if (passed === null)
|
|
286
|
+
return null;
|
|
287
|
+
metrics.push(passed);
|
|
288
|
+
}
|
|
289
|
+
const metricsSha256 = source.metrics_sha256;
|
|
290
|
+
if (!isLowerSha256(metricsSha256) ||
|
|
291
|
+
metricsSha256 !== canonicalDigest(metrics) ||
|
|
292
|
+
canonicalDigest(sourceMetrics) !== canonicalDigest(metrics) ||
|
|
293
|
+
!validReleaseReport(source, metrics)) {
|
|
294
|
+
return null;
|
|
295
|
+
}
|
|
296
|
+
return { metrics, metrics_sha256: metricsSha256 };
|
|
297
|
+
}
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
2
|
+
import fs from "node:fs";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import { loadYamlMapping } from "../core/yaml.js";
|
|
5
|
+
import { resolveSourceRoot } from "../core/sourceRoot.js";
|
|
6
|
+
import { resolveRouteRequest } from "../registries/hybridRoute.js";
|
|
7
|
+
import { validateRouteReceiptSubmission } from "../registries/hybridRouteReceipt.js";
|
|
8
|
+
function mapping(value, source) {
|
|
9
|
+
if (value === null || typeof value !== "object" || Array.isArray(value))
|
|
10
|
+
throw new Error(`${source} must be a mapping`);
|
|
11
|
+
return value;
|
|
12
|
+
}
|
|
13
|
+
function requiredString(value, source) {
|
|
14
|
+
if (typeof value !== "string" || !value)
|
|
15
|
+
throw new Error(`${source} must be a non-empty string`);
|
|
16
|
+
return value;
|
|
17
|
+
}
|
|
18
|
+
function cases(value, source) {
|
|
19
|
+
if (!Array.isArray(value))
|
|
20
|
+
throw new Error(`${source} must be a list`);
|
|
21
|
+
return value;
|
|
22
|
+
}
|
|
23
|
+
function elapsedMs(start) {
|
|
24
|
+
return Number(process.hrtime.bigint() - start) / 1_000_000;
|
|
25
|
+
}
|
|
26
|
+
function percentile(values) {
|
|
27
|
+
if (values.length === 0)
|
|
28
|
+
return null;
|
|
29
|
+
const sorted = [...values].sort((left, right) => left - right);
|
|
30
|
+
return sorted[Math.ceil(sorted.length * 0.95) - 1];
|
|
31
|
+
}
|
|
32
|
+
function hashFile(file) {
|
|
33
|
+
return crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex");
|
|
34
|
+
}
|
|
35
|
+
function nullableFixtureReceipt(receipt) {
|
|
36
|
+
return {
|
|
37
|
+
version: null,
|
|
38
|
+
request_sha256: null,
|
|
39
|
+
semantic_capsule_sha256: null,
|
|
40
|
+
outcome: null,
|
|
41
|
+
capability: null,
|
|
42
|
+
compound: null,
|
|
43
|
+
question: null,
|
|
44
|
+
remainder_span: null,
|
|
45
|
+
...receipt,
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
/** Runs the complete frozen synthetic conformance corpus without invoking a semantic host. */
|
|
49
|
+
export function evaluateHybridRoute(sourceRoot = resolveSourceRoot()) {
|
|
50
|
+
const contractPath = path.join(sourceRoot, "references/cli/hybrid-route-contract.yaml");
|
|
51
|
+
const corpusPath = path.join(sourceRoot, "fixtures/routing/hybrid-corpus.yaml");
|
|
52
|
+
const phrasePath = path.join(sourceRoot, "skills/agentera/route-phrases.yaml");
|
|
53
|
+
const skillPath = path.join(sourceRoot, "skills/agentera/SKILL.md");
|
|
54
|
+
const contract = loadYamlMapping(fs.readFileSync(contractPath, "utf8"));
|
|
55
|
+
const corpus = loadYamlMapping(fs.readFileSync(corpusPath, "utf8"));
|
|
56
|
+
const evaluation = mapping(contract.evaluation, "contract.evaluation");
|
|
57
|
+
const targetGates = mapping(evaluation.target_gates, "contract.evaluation.target_gates");
|
|
58
|
+
const routeCases = cases(corpus.route_cases, "corpus.route_cases");
|
|
59
|
+
const receiptCases = cases(corpus.receipt_cases, "corpus.receipt_cases");
|
|
60
|
+
const results = [];
|
|
61
|
+
const deterministicTimings = [];
|
|
62
|
+
const receiptTimings = [];
|
|
63
|
+
for (const routeCase of routeCases) {
|
|
64
|
+
const start = process.hrtime.bigint();
|
|
65
|
+
const observed = resolveRouteRequest(routeCase.request, sourceRoot);
|
|
66
|
+
const elapsed = elapsedMs(start);
|
|
67
|
+
deterministicTimings.push(elapsed);
|
|
68
|
+
const passed = observed.outcome === routeCase.expected.phase1
|
|
69
|
+
&& (observed.outcome !== "deterministic_selection" || (observed.tier === routeCase.expected.tier && observed.capability === routeCase.expected.capability));
|
|
70
|
+
const harmfulMisroute = observed.outcome === "deterministic_selection"
|
|
71
|
+
&& (routeCase.expected.phase1 !== "deterministic_selection" || observed.capability !== routeCase.expected.capability);
|
|
72
|
+
results.push({
|
|
73
|
+
case_id: routeCase.id,
|
|
74
|
+
partition: routeCase.partition,
|
|
75
|
+
evaluation_tier: "deterministic",
|
|
76
|
+
routing_tier: observed.outcome === "deterministic_selection" ? observed.tier : "deterministic_abstention",
|
|
77
|
+
expected_outcome: routeCase.expected.phase1,
|
|
78
|
+
observed_outcome: observed.outcome,
|
|
79
|
+
...(observed.outcome === "deterministic_selection" ? { capability: observed.capability } : {}),
|
|
80
|
+
status: passed ? "pass" : "fail",
|
|
81
|
+
...(passed ? {} : { failure_tier: "deterministic" }),
|
|
82
|
+
harmful_misroute: harmfulMisroute,
|
|
83
|
+
elapsed_ms: elapsed,
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
for (const receiptCase of receiptCases) {
|
|
87
|
+
const start = process.hrtime.bigint();
|
|
88
|
+
let terminal = "invalid_receipt";
|
|
89
|
+
try {
|
|
90
|
+
const receipt = receiptCase.valid ? nullableFixtureReceipt(receiptCase.receipt) : receiptCase.receipt;
|
|
91
|
+
terminal = validateRouteReceiptSubmission({ request: receiptCase.request, receipt }, sourceRoot).outcome;
|
|
92
|
+
}
|
|
93
|
+
catch {
|
|
94
|
+
terminal = "invalid_receipt";
|
|
95
|
+
}
|
|
96
|
+
const elapsed = elapsedMs(start);
|
|
97
|
+
receiptTimings.push(elapsed);
|
|
98
|
+
const passed = terminal === receiptCase.expected_terminal;
|
|
99
|
+
const harmfulMisroute = terminal === "selected" && receiptCase.expected_terminal !== "selected";
|
|
100
|
+
results.push({
|
|
101
|
+
case_id: receiptCase.id,
|
|
102
|
+
partition: receiptCase.partition,
|
|
103
|
+
evaluation_tier: "receipt_validation",
|
|
104
|
+
routing_tier: "semantic_receipt_validation",
|
|
105
|
+
expected_outcome: receiptCase.expected_terminal,
|
|
106
|
+
observed_outcome: terminal,
|
|
107
|
+
status: passed ? "pass" : "fail",
|
|
108
|
+
...(passed ? {} : { failure_tier: "receipt_validation" }),
|
|
109
|
+
harmful_misroute: harmfulMisroute,
|
|
110
|
+
elapsed_ms: elapsed,
|
|
111
|
+
});
|
|
112
|
+
}
|
|
113
|
+
const failed = results.filter(({ status }) => status === "fail");
|
|
114
|
+
const harmfulMisroutes = results.filter((result) => result.harmful_misroute === true).length;
|
|
115
|
+
return {
|
|
116
|
+
schemaVersion: "agentera.hybrid_route_evaluation.v1",
|
|
117
|
+
status: failed.length === 0 ? "pass" : "fail",
|
|
118
|
+
authority: {
|
|
119
|
+
contract_version: requiredString(contract.schema_version, "contract.schema_version"),
|
|
120
|
+
protocol_sha256: hashFile(contractPath),
|
|
121
|
+
phrase_authority_sha256: hashFile(phrasePath),
|
|
122
|
+
shared_skill_sha256: hashFile(skillPath),
|
|
123
|
+
},
|
|
124
|
+
corpus: {
|
|
125
|
+
schema_version: requiredString(corpus.schema_version, "corpus.schema_version"),
|
|
126
|
+
content_sha256: hashFile(corpusPath),
|
|
127
|
+
partitions: corpus.partitions,
|
|
128
|
+
case_count: results.length,
|
|
129
|
+
},
|
|
130
|
+
results,
|
|
131
|
+
aggregate_metrics: {
|
|
132
|
+
passed: results.length - failed.length,
|
|
133
|
+
failed: failed.length,
|
|
134
|
+
harmful_misroutes: {
|
|
135
|
+
scope: "deterministic_and_receipt_validation_conformance",
|
|
136
|
+
target: targetGates.harmful_misroutes,
|
|
137
|
+
observed: harmfulMisroutes,
|
|
138
|
+
status: harmfulMisroutes === 0 ? "pass" : "fail",
|
|
139
|
+
taxonomy: evaluation.harmful_misroute_taxonomy,
|
|
140
|
+
},
|
|
141
|
+
},
|
|
142
|
+
model_context: {
|
|
143
|
+
status: "unmeasured",
|
|
144
|
+
reason: "host_dependent",
|
|
145
|
+
samples: 0,
|
|
146
|
+
distributions: {},
|
|
147
|
+
},
|
|
148
|
+
latency: {
|
|
149
|
+
deterministic_phase1: { sample_count: deterministicTimings.length, p95_ms: percentile(deterministicTimings), target: targetGates.deterministic_phase1_p95 },
|
|
150
|
+
receipt_validation: { sample_count: receiptTimings.length, p95_ms: percentile(receiptTimings), target: targetGates.receipt_validation_p95 },
|
|
151
|
+
semantic_model: { status: "unmeasured", reason: "host_dependent" },
|
|
152
|
+
end_to_end: { status: "unmeasured", reason: "host_dependent" },
|
|
153
|
+
},
|
|
154
|
+
};
|
|
155
|
+
}
|
package/dist/hooks/common.js
CHANGED
|
@@ -1,19 +1,13 @@
|
|
|
1
|
-
import crypto from "node:crypto";
|
|
2
1
|
import fs from "node:fs";
|
|
3
|
-
import os from "node:os";
|
|
4
2
|
import path from "node:path";
|
|
5
|
-
import { expanduser, resolvePath } from "../core/paths.js";
|
|
6
3
|
import { ARTIFACT_PROTOCOL_PATHS, normalizeArtifactMappingKeys, normalizeArtifactProtocolId, } from "../registries/artifactProtocolIds.js";
|
|
7
|
-
import { resolveCandidate } from "../state/installRoot.js";
|
|
8
4
|
/**
|
|
9
|
-
* Shared utilities for
|
|
10
|
-
* compaction retention caps, runtime-local session bookmark paths, and artifact
|
|
11
|
-
* path resolution.
|
|
5
|
+
* Shared utilities for compaction retention caps and artifact path resolution.
|
|
12
6
|
*/
|
|
13
7
|
export { loadYamlMapping, loadYamlMappingFile, } from "../core/yaml.js";
|
|
14
8
|
export const MAX_FULL_ENTRIES = 10;
|
|
15
9
|
export const MAX_ONELINE_ENTRIES = 40;
|
|
16
|
-
export const MAX_TOTAL_ENTRIES =
|
|
10
|
+
export const MAX_TOTAL_ENTRIES = 50;
|
|
17
11
|
export function applyRetentionCaps(fullEntries, archiveEntries, opts = {}) {
|
|
18
12
|
const maxFull = opts.maxFull ?? MAX_FULL_ENTRIES;
|
|
19
13
|
const maxOneline = opts.maxOneline ?? MAX_ONELINE_ENTRIES;
|
|
@@ -21,52 +15,6 @@ export function applyRetentionCaps(fullEntries, archiveEntries, opts = {}) {
|
|
|
21
15
|
const cappedArchive = archiveEntries.slice(0, maxOneline);
|
|
22
16
|
return [...fullEntries.slice(0, maxFull), ...cappedArchive].slice(0, maxTotal);
|
|
23
17
|
}
|
|
24
|
-
export function resolveAgenteraDataHome(env = process.env, home = os.homedir()) {
|
|
25
|
-
const configured = env.AGENTERA_HOME;
|
|
26
|
-
if (configured) {
|
|
27
|
-
return expanduser(configured);
|
|
28
|
-
}
|
|
29
|
-
const [root] = resolveCandidate(null, { env, home });
|
|
30
|
-
return root;
|
|
31
|
-
}
|
|
32
|
-
export function resolveSessionPath(projectRoot, env = process.env, home = os.homedir()) {
|
|
33
|
-
const dataHome = resolveAgenteraDataHome(env, home);
|
|
34
|
-
const resolved = resolvePath(projectRoot);
|
|
35
|
-
const digest = crypto.createHash("sha256").update(resolved, "utf8").digest("hex").slice(0, 16);
|
|
36
|
-
const name = path.basename(projectRoot);
|
|
37
|
-
const slug = name.replace(/[^A-Za-z0-9_.-]+/g, "-").replace(/^[.-]+|[.-]+$/g, "") || "project";
|
|
38
|
-
return path.join(dataHome, "sessions", `${slug}-${digest}`, "session.yaml");
|
|
39
|
-
}
|
|
40
|
-
export function sessionBookmarkToOneline(entry) {
|
|
41
|
-
return {
|
|
42
|
-
timestamp: String(entry.timestamp ?? ""),
|
|
43
|
-
artifacts: [],
|
|
44
|
-
summary: String(entry.summary ?? ""),
|
|
45
|
-
kind: "oneline",
|
|
46
|
-
};
|
|
47
|
-
}
|
|
48
|
-
export function compactSessionBookmarkEntries(entries, opts = {}) {
|
|
49
|
-
const maxFull = opts.maxFull ?? MAX_FULL_ENTRIES;
|
|
50
|
-
const maxOneline = opts.maxOneline ?? MAX_ONELINE_ENTRIES;
|
|
51
|
-
const maxTotal = opts.maxTotal ?? MAX_TOTAL_ENTRIES;
|
|
52
|
-
const convert = opts.toOneline ?? sessionBookmarkToOneline;
|
|
53
|
-
const ordered = [...entries].sort((a, b) => {
|
|
54
|
-
const ta = String(a.timestamp ?? "");
|
|
55
|
-
const tb = String(b.timestamp ?? "");
|
|
56
|
-
return ta < tb ? 1 : ta > tb ? -1 : 0;
|
|
57
|
-
});
|
|
58
|
-
const full = [];
|
|
59
|
-
const archive = [];
|
|
60
|
-
for (const entry of ordered) {
|
|
61
|
-
if (entry.kind === "full" && full.length < maxFull) {
|
|
62
|
-
full.push(entry);
|
|
63
|
-
}
|
|
64
|
-
else {
|
|
65
|
-
archive.push(convert(entry));
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
return applyRetentionCaps(full, archive, { maxFull, maxOneline, maxTotal });
|
|
69
|
-
}
|
|
70
18
|
export const DEFAULT_ARTIFACT_PATHS = { ...ARTIFACT_PROTOCOL_PATHS };
|
|
71
19
|
function stripQuotes(value) {
|
|
72
20
|
return value.replace(/^['"]|['"]$/g, "");
|
|
@@ -131,7 +79,7 @@ export function resolveArtifactPath(projectRoot, artifact, overrides = null) {
|
|
|
131
79
|
return path.join(projectRoot, DEFAULT_ARTIFACT_PATHS[artifactId] ?? `.agentera/${artifactId}.yaml`);
|
|
132
80
|
}
|
|
133
81
|
export function loadArtifactOverrides(projectRoot) {
|
|
134
|
-
const yamlPath = path.join(projectRoot,
|
|
82
|
+
const yamlPath = path.join(projectRoot, ARTIFACT_PROTOCOL_PATHS.docs);
|
|
135
83
|
if (fs.existsSync(yamlPath)) {
|
|
136
84
|
const mapping = parseDocsYamlMapping(fs.readFileSync(yamlPath, "utf8"));
|
|
137
85
|
if (Object.keys(mapping).length > 0) {
|
|
@@ -140,4 +88,3 @@ export function loadArtifactOverrides(projectRoot) {
|
|
|
140
88
|
}
|
|
141
89
|
return null;
|
|
142
90
|
}
|
|
143
|
-
//# sourceMappingURL=common.js.map
|