agentera 3.0.0-dev.6 → 3.0.0-dev.69
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/README.md +118 -22
- package/bundle/CHANGELOG.md +1361 -0
- package/bundle/DESIGN.md +229 -0
- package/bundle/LICENSE +201 -0
- package/bundle/README.md +143 -0
- package/bundle/UPGRADE.md +252 -0
- package/bundle/extract-corpus-parity.json +21 -0
- package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
- package/bundle/references/adapters/package-publication.json +488 -0
- package/bundle/references/adapters/package-registry.yaml +435 -188
- package/bundle/references/adapters/package-surface-characterization.md +66 -34
- package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +74 -0
- package/bundle/references/adapters/runtime-lifecycle-authority.yaml +62 -0
- package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
- package/bundle/references/adapters/runtime-retired-resources.yaml +333 -0
- package/bundle/references/analysis/evidence-tier-authority.yaml +518 -0
- package/bundle/references/analysis/verification-policy.yaml +266 -0
- package/bundle/references/artifacts/artifact-registry-interface-model.yaml +20 -10
- package/bundle/references/artifacts/glossary-entry-contract.yaml +1254 -0
- package/bundle/references/artifacts/state-storage-authority.yaml +3061 -0
- package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
- package/bundle/references/cli/app-lifecycle-vocabulary.yaml +7 -8
- package/bundle/references/cli/capability-instruction-contract.yaml +11 -14
- package/bundle/references/cli/hybrid-route-contract.yaml +438 -0
- package/bundle/references/cli/routing-model.md +155 -0
- package/bundle/references/cli/trigger-schema-enrichment.md +147 -0
- package/bundle/references/cli/update-channels.yaml +19 -2
- package/bundle/references/cli/vocabulary-index.yaml +20 -17
- package/bundle/references/cli/vocabulary.md +325 -362
- package/bundle/references/meta/retained-reference-authority.yaml +151 -0
- package/bundle/registry.json +13 -13
- package/bundle/skills/agentera/SKILL.md +226 -422
- package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +84 -0
- package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +25 -0
- package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/validation.yaml +37 -18
- package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +103 -0
- package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +8 -6
- package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +27 -0
- package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +184 -0
- package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/artifacts.yaml +12 -12
- package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/exit.yaml +5 -5
- package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +16 -0
- package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml +7 -7
- package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +51 -0
- package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +20 -0
- package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +144 -0
- package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +80 -0
- package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +16 -0
- package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml +18 -18
- package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml +18 -18
- package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +16 -0
- package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml +9 -9
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +76 -0
- package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/exit.yaml +9 -7
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +23 -0
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +121 -0
- package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +66 -0
- package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/exit.yaml +2 -2
- package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +23 -0
- package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +121 -0
- package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +23 -0
- package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/exit.yaml +6 -5
- package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +20 -0
- package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +115 -0
- package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +24 -0
- package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +16 -0
- package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/validation.yaml +2 -2
- package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +73 -0
- package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +22 -0
- package/bundle/skills/agentera/capabilities/{hej → status}/schemas/validation.yaml +5 -5
- package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/artifacts.yaml +16 -16
- package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/exit.yaml +7 -6
- package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +23 -0
- package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/validation.yaml +18 -20
- package/bundle/skills/agentera/capability_schema_contract.yaml +178 -34
- package/bundle/skills/agentera/protocol.yaml +31 -31
- package/bundle/skills/agentera/route-phrases.yaml +81 -0
- package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +5 -4
- package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +39 -21
- package/bundle/skills/agentera/schemas/artifacts/design.yaml +5 -4
- package/bundle/skills/agentera/schemas/artifacts/docs.yaml +15 -19
- package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +145 -14
- package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +82 -0
- package/bundle/skills/agentera/schemas/artifacts/health.yaml +58 -21
- package/bundle/skills/agentera/schemas/artifacts/objective.yaml +22 -8
- package/bundle/skills/agentera/schemas/artifacts/plan.yaml +461 -36
- package/bundle/skills/agentera/schemas/artifacts/progress.yaml +133 -20
- package/bundle/skills/agentera/schemas/artifacts/todo.yaml +342 -42
- package/bundle/skills/agentera/schemas/artifacts/vision.yaml +3 -3
- package/dist/analytics/extractCorpus/cli.js +101 -12
- package/dist/analytics/extractCorpus/copilotSessions.js +53 -9
- package/dist/analytics/extractCorpus/core.js +59 -24
- package/dist/analytics/extractCorpus/corpus.js +58 -23
- package/dist/analytics/extractCorpus/coverageAudit.js +260 -0
- package/dist/analytics/extractCorpus/cursorSessions.js +12 -7
- package/dist/analytics/extractCorpus/evidenceTiers.js +603 -0
- package/dist/analytics/extractCorpus/extractCorpusParity.js +105 -0
- package/dist/analytics/extractCorpus/filesystemSources.js +1 -5
- package/dist/analytics/extractCorpus/index.js +6 -1
- package/dist/analytics/extractCorpus/jsonlSessions.js +24 -5
- package/dist/analytics/extractCorpus/sqliteCaps.js +43 -0
- package/dist/analytics/extractCorpus/sqliteSessions.js +98 -6
- package/dist/analytics/extractCorpus/tierReader.js +108 -0
- package/dist/analytics/extractCorpus.js +0 -1
- package/dist/analytics/glossaryAdviceResolution.js +166 -0
- package/dist/analytics/glossaryInputAcquisition.js +319 -0
- package/dist/analytics/personalGlossaryAdmission.js +133 -0
- package/dist/analytics/personalGlossaryProfile.js +219 -0
- package/dist/analytics/profileSignals.js +211 -0
- package/dist/analytics/usageStats.js +169 -42
- package/dist/audit/terminologyDrift.js +281 -0
- package/dist/bin/agentera.js +3 -2
- package/dist/capabilities/audit/instructions.js +16 -0
- package/dist/capabilities/build/instructions.js +59 -0
- package/dist/capabilities/design/instructions.js +4 -0
- package/dist/capabilities/discuss/instructions.js +29 -0
- package/dist/capabilities/document/instructions.js +11 -0
- package/dist/capabilities/index.js +29 -27
- package/dist/capabilities/optimize/instructions.js +14 -0
- package/dist/capabilities/orchestrate/instructions.js +42 -0
- package/dist/capabilities/plan/instructions.js +33 -0
- package/dist/capabilities/profile/instructions.js +70 -0
- package/dist/capabilities/research/instructions.js +5 -0
- package/dist/capabilities/status/instructions.js +15 -0
- package/dist/capabilities/status/startupInstructions.js +34 -0
- package/dist/capabilities/vision/instructions.js +4 -0
- package/dist/cli/appContext.js +30 -24
- package/dist/cli/argvalidate.js +0 -1
- package/dist/cli/capabilityContext/benchmark.js +25 -17
- package/dist/cli/capabilityContext/bespoke.js +31 -12
- package/dist/cli/capabilityContext/build.js +251 -0
- package/dist/cli/capabilityContext/closeout.js +33 -30
- package/dist/cli/capabilityContext/contract.js +39 -46
- package/dist/cli/capabilityContext/evidence.js +90 -73
- package/dist/cli/capabilityContext/index.js +1 -2
- package/dist/cli/capabilityContext/orchestration.js +45 -21
- package/dist/cli/capabilityContext/planState.js +93 -100
- package/dist/cli/capabilityContext/progress.js +60 -14
- package/dist/cli/capabilityContext/projectVerification.js +409 -0
- package/dist/cli/capabilityContext/shared.js +9 -20
- package/dist/cli/capabilityContext/slim.js +56 -10
- package/dist/cli/capabilityContext/startup.js +57 -115
- package/dist/cli/capabilityContext/startupAggregation.js +68 -0
- package/dist/cli/capabilityContext/types.js +37 -24
- package/dist/cli/capabilityContext.js +1 -2
- package/dist/cli/commands/appHome.js +22 -0
- package/dist/cli/commands/capability.js +4 -4
- package/dist/cli/commands/compact.js +163 -13
- package/dist/cli/commands/doctor.js +122 -114
- package/dist/cli/commands/durability.js +81 -0
- package/dist/cli/commands/glossaryAdvice.js +138 -0
- package/dist/cli/commands/lint.js +22 -8
- package/dist/cli/commands/personalGlossary.js +176 -0
- package/dist/cli/commands/prime/briefOrientation.js +746 -0
- package/dist/cli/commands/prime/buildExecutionRequest.js +165 -0
- package/dist/cli/commands/prime/bundleStatus.js +190 -0
- package/dist/cli/commands/prime/collectEntityOrientation.js +326 -0
- package/dist/cli/commands/prime/collectOrientationState.js +219 -0
- package/dist/cli/commands/prime/orientationOutput.js +421 -0
- package/dist/cli/commands/prime/types.js +1 -0
- package/dist/cli/commands/prime/v1Migration.js +38 -0
- package/dist/cli/commands/prime.js +80 -558
- package/dist/cli/commands/profileGrounding.js +55 -0
- package/dist/cli/commands/query.js +77 -52
- package/dist/cli/commands/report.js +88 -26
- package/dist/cli/commands/route.js +142 -0
- package/dist/cli/commands/schema.js +266 -142
- package/dist/cli/commands/state/decisions.js +51 -61
- package/dist/cli/commands/state/docs.js +63 -86
- package/dist/cli/commands/state/experimentRecords.js +151 -0
- package/dist/cli/commands/state/experiments.js +11 -64
- package/dist/cli/commands/state/get.js +129 -0
- package/dist/cli/commands/state/health.js +11 -111
- package/dist/cli/commands/state/index.js +6 -41
- package/dist/cli/commands/state/list.js +194 -0
- package/dist/cli/commands/state/objective.js +21 -64
- package/dist/cli/commands/state/plan.js +11 -169
- package/dist/cli/commands/state/planTasks.js +154 -0
- package/dist/cli/commands/state/plans.js +154 -0
- package/dist/cli/commands/state/progress.js +11 -45
- package/dist/cli/commands/state/shared.js +0 -1
- package/dist/cli/commands/state/todo.js +29 -108
- package/dist/cli/commands/state/write.js +433 -0
- package/dist/cli/commands/upgrade.js +146 -5
- package/dist/cli/commands/upgradeVerify.js +118 -0
- package/dist/cli/commands/validate.js +246 -211
- package/dist/cli/commands/verify.js +24 -9
- package/dist/cli/contracts/bundleStatus.js +1 -0
- package/dist/cli/contracts/orientationState.js +1 -0
- package/dist/cli/dispatch/argvParser.js +32 -0
- package/dist/cli/dispatch/check.js +94 -50
- package/dist/cli/dispatch/commands.js +27 -0
- package/dist/cli/dispatch/index.js +82 -52
- package/dist/cli/dispatch/lifecycle.js +268 -108
- package/dist/cli/dispatch/prime.js +68 -29
- package/dist/cli/dispatch/projections.js +17 -0
- package/dist/cli/dispatch/shared.js +1 -2
- package/dist/cli/dispatch/state.js +68 -77
- package/dist/cli/dispatch.js +0 -1
- package/dist/cli/errors.js +16 -17
- package/dist/cli/help.js +395 -41
- package/dist/cli/migrationRequired.js +122 -0
- package/dist/cli/orientation/attention.js +61 -0
- package/dist/cli/orientation/corpusCoverage.js +102 -0
- package/dist/cli/orientation.js +438 -170
- package/dist/cli/planArtifacts.js +350 -0
- package/dist/cli/planEvidence.js +157 -0
- package/dist/cli/planLifecycleState.js +36 -0
- package/dist/cli/planTaskIndex.js +11 -0
- package/dist/cli/preCutoverCommand.js +32 -0
- package/dist/cli/prime-blob.js +71 -3
- package/dist/cli/profileAcquisition.js +167 -0
- package/dist/cli/startupCompletenessContract.js +59 -0
- package/dist/cli/stateQuery.js +56 -14
- package/dist/cli/structured.js +0 -1
- package/dist/cli/todoMarkdown.js +25 -12
- package/dist/cli/todoReadinessSelection.js +192 -0
- package/dist/cli/todoSeverity.js +18 -0
- package/dist/core/atomicWriter.js +20 -0
- package/dist/core/developmentChannel.js +1 -0
- package/dist/core/developmentInvocation.js +374 -0
- package/dist/core/difflib.js +0 -1
- package/dist/core/envPaths.js +20 -0
- package/dist/core/jsonValue.js +5 -0
- package/dist/core/paths.js +0 -1
- package/dist/core/pyjson.js +67 -3
- package/dist/core/shell.js +4 -0
- package/dist/core/skillIdentity.js +23 -0
- package/dist/core/sourceRoot.js +9 -12
- package/dist/core/text.js +10 -0
- package/dist/core/toml.js +0 -1
- package/dist/core/yaml.js +8 -1
- package/dist/eval/evalSkills.js +30 -26
- package/dist/eval/hybridRouteEvaluation.js +155 -0
- package/dist/eval/semanticEval.js +43 -20
- package/dist/eval/semanticFixtures.js +16 -5
- package/dist/hooks/common.js +3 -56
- package/dist/hooks/compaction/apply.js +252 -50
- package/dist/hooks/compaction/dryRun.js +7 -4
- package/dist/hooks/compaction/index.js +5 -6
- package/dist/hooks/compaction/parse.js +201 -5
- package/dist/hooks/compaction/retention.js +30 -25
- package/dist/hooks/compaction/status.js +149 -32
- package/dist/hooks/compaction/types.js +0 -1
- package/dist/hooks/validateArtifact/agentFacing.js +0 -1
- package/dist/hooks/validateArtifact/index.js +7 -64
- package/dist/hooks/validateArtifact/markdown.js +57 -7
- package/dist/hooks/validateArtifact/schema.js +110 -19
- package/dist/hooks/validateArtifact/traversal.js +13 -11
- package/dist/hooks/validateArtifact/violations.js +7 -5
- package/dist/migrate/v2HandoffManifest.js +127 -8
- package/dist/registries/activationContract.js +2 -0
- package/dist/registries/activationTuples.js +108 -0
- package/dist/registries/artifactProtocolIds.js +2 -1
- package/dist/registries/artifactRegistry.js +224 -63
- package/dist/registries/artifactSchemaProjection.js +45 -0
- package/dist/registries/capabilityContract.js +129 -2
- package/dist/registries/evaluatorHandoffContract.js +2 -3
- package/dist/registries/evidenceTierContract.js +371 -0
- package/dist/registries/glossaryAdviceContract.js +79 -0
- package/dist/registries/glossaryCaveatContract.js +67 -0
- package/dist/registries/glossaryConsumerContractValidation.js +787 -0
- package/dist/registries/glossaryEntryContract.js +757 -0
- package/dist/registries/glossaryTermIdentity.js +17 -0
- package/dist/registries/glossaryTermOccurrence.js +20 -0
- package/dist/registries/hybridRoute.js +274 -0
- package/dist/registries/hybridRouteReceipt.js +221 -0
- package/dist/registries/packagePublication.js +273 -0
- package/dist/registries/packageRegistry.js +187 -211
- package/dist/registries/todoReadinessContract.js +448 -0
- package/dist/registries/triggerLoader.js +174 -0
- package/dist/registries/verbosityBudgetContract.js +205 -0
- package/dist/release/releaseMetadata.js +156 -6
- package/dist/runtime/lifecycleAdapterContract.js +457 -0
- package/dist/runtime/lifecycleAdapters.js +777 -0
- package/dist/runtime/lifecycleAuthority.js +453 -0
- package/dist/runtime/lifecycleOperationContract.js +123 -0
- package/dist/runtime/lifecycleOperations.js +634 -0
- package/dist/runtime/lifecycleOwnershipJournal.js +622 -0
- package/dist/runtime/lifecyclePublication.js +415 -0
- package/dist/runtime/lifecycleSnapshot.js +438 -0
- package/dist/runtime/nativeResourceCleanup.js +502 -0
- package/dist/setup/opencode.js +20 -13
- package/dist/setup/opencodeConstants.js +1 -0
- package/dist/setup/sharedSkill.js +45 -0
- package/dist/setup/smokeChecks.js +21 -82
- package/dist/state/archiveDiscovery.js +580 -0
- package/dist/state/archivePublication.js +225 -0
- package/dist/state/archiveRecovery.js +237 -0
- package/dist/state/archiveReplay.js +53 -0
- package/dist/state/canonicalMigrationRecord.js +36 -0
- package/dist/state/changelog.js +221 -0
- package/dist/state/decisionEntities.js +367 -0
- package/dist/state/decisionLegacyValidation.js +215 -0
- package/dist/state/decisionMigrationProvenance.js +199 -0
- package/dist/state/decisionOverlay.js +254 -0
- package/dist/state/decisionRevision.js +256 -0
- package/dist/state/decisionRevisionMigration.js +89 -0
- package/dist/state/directRetrieval.js +323 -0
- package/dist/state/durability.js +324 -0
- package/dist/state/entityCutover.js +459 -0
- package/dist/state/entityCutoverGit.js +127 -0
- package/dist/state/entityGlossaryAuthority.js +13 -0
- package/dist/state/entityListProjection.js +187 -0
- package/dist/state/entityListRuntimeRegistry.js +85 -0
- package/dist/state/entityMigrationCausality.js +97 -0
- package/dist/state/entityMigrationIdentity.js +5 -0
- package/dist/state/entityMigrationPreview.js +840 -0
- package/dist/state/entityMigrationTodo.js +133 -0
- package/dist/state/entityPublicationContext.js +859 -0
- package/dist/state/entityRetrievalHelp.js +506 -0
- package/dist/state/entityStorage.js +899 -0
- package/dist/state/exactReplacementRecovery.js +18 -0
- package/dist/state/experimentArchive.js +63 -0
- package/dist/state/experimentIdentity.js +202 -0
- package/dist/state/healthEntities.js +262 -0
- package/dist/state/healthEntityValidation.js +18 -0
- package/dist/state/healthRepair.js +69 -0
- package/dist/state/installRoot.js +64 -25
- package/dist/state/legacyEntityCutoverEvidence.js +65 -0
- package/dist/state/legacyIdentity.js +47 -0
- package/dist/state/legacySummaryRecord.js +6 -0
- package/dist/state/listAccounting.js +54 -0
- package/dist/state/listClassification.js +17 -0
- package/dist/state/listCursor.js +42 -0
- package/dist/state/listRetrieval.js +781 -0
- package/dist/state/migrationSourceBinding.js +30 -0
- package/dist/state/objectiveExperimentEntities.js +322 -0
- package/dist/state/planEntities.js +1027 -0
- package/dist/state/planIdentity.js +47 -0
- package/dist/state/planLineageValidation.js +52 -0
- package/dist/state/planReplacementTransaction.js +475 -0
- package/dist/state/planRetrieval.js +313 -0
- package/dist/state/planTaskRetrieval.js +294 -0
- package/dist/state/progressEntities.js +512 -0
- package/dist/state/progressGlossaryCaveat.js +168 -0
- package/dist/state/progressPublicationOrder.js +19 -0
- package/dist/state/progressWritePolicy.js +33 -0
- package/dist/state/projectRoot.js +62 -0
- package/dist/state/projectionPolicy.js +190 -0
- package/dist/state/retrievalAuthority.js +156 -0
- package/dist/state/safeProjectFile.js +155 -0
- package/dist/state/startupAnalysis/benchmark.js +92 -27
- package/dist/state/startupAnalysis/contract.js +48 -10
- package/dist/state/startupAnalysis/helpers.js +27 -73
- package/dist/state/startupAnalysis/index.js +0 -1
- package/dist/state/startupAnalysis/metrics.js +25 -19
- package/dist/state/startupAnalysis/records.js +13 -10
- package/dist/state/startupAnalysis/report.js +26 -38
- package/dist/state/startupAnalysis/threshold.js +19 -7
- package/dist/state/startupAnalysis.js +0 -1
- package/dist/state/startupProjection.js +499 -0
- package/dist/state/stateMode.js +222 -0
- package/dist/state/stateStorageAuthority.js +47 -0
- package/dist/state/summaryEntityRead.js +25 -0
- package/dist/state/summaryMigrationProvenance.js +66 -0
- package/dist/state/summarySourceRowAuthority.js +36 -0
- package/dist/state/todoActivationSafety.js +58 -0
- package/dist/state/todoDocsEntities.js +1124 -0
- package/dist/state/todoDocsEntityValidation.js +158 -0
- package/dist/state/todoMarkdownProjection.js +51 -0
- package/dist/state/todoReconciliationActivation.js +182 -0
- package/dist/state/todoReconciliationInspection.js +171 -0
- package/dist/state/todoReconciliationRepair.js +318 -0
- package/dist/state/todoReconciliationTransaction.js +595 -0
- package/dist/state/write/assign.js +20 -0
- package/dist/state/write/candidateMutation.js +269 -0
- package/dist/state/write/errors.js +11 -0
- package/dist/state/write/experimentPublication.js +192 -0
- package/dist/state/write/explain.js +377 -0
- package/dist/state/write/fields.js +61 -0
- package/dist/state/write/glossaryPublication.js +263 -0
- package/dist/state/write/grammar.js +285 -0
- package/dist/state/write/helpers.js +29 -0
- package/dist/state/write/index.js +12 -0
- package/dist/state/write/input.js +391 -0
- package/dist/state/write/lock.js +837 -0
- package/dist/state/write/mutation.js +234 -0
- package/dist/state/write/operations.js +170 -0
- package/dist/state/write/planEvaluation.js +128 -0
- package/dist/state/write/planPublication.js +179 -0
- package/dist/state/write/runtimeOperations.js +146 -0
- package/dist/state/write/serialize.js +1 -0
- package/dist/state/write/transaction.js +57 -0
- package/dist/state/write/validate.js +7 -0
- package/dist/upgrade/appContentRefresh.js +383 -0
- package/dist/upgrade/appModel.js +8 -7
- package/dist/upgrade/atomicWriter.js +1 -0
- package/dist/upgrade/bundleEvidence.js +33 -0
- package/dist/upgrade/channels.js +12 -8
- package/dist/upgrade/compatibility.js +56 -21
- package/dist/upgrade/doctor.js +165 -199
- package/dist/upgrade/doctorClassifier.js +187 -0
- package/dist/upgrade/installedHooksRetirement.js +196 -0
- package/dist/upgrade/legacyAgentCleanup.js +282 -0
- package/dist/upgrade/lifecycleUpgrade.js +113 -0
- package/dist/upgrade/migrateArtifactsV2ToV3.js +375 -79
- package/dist/upgrade/migrationPublication.js +122 -0
- package/dist/upgrade/nextMajorDoctor.js +29 -10
- package/dist/upgrade/npxPlatformStatus.js +22 -0
- package/dist/upgrade/projectIntegration.js +145 -189
- package/dist/upgrade/projectIntegrationDecision.js +50 -0
- package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
- package/dist/upgrade/runtimeMigration.js +272 -373
- package/dist/upgrade/upgradeCommands.js +14 -1
- package/dist/upgrade/upgradeLock.js +85 -0
- package/dist/upgrade/upgradeOrchestrator.js +263 -59
- package/dist/upgrade/v3CapabilitySurface.js +2 -3
- package/dist/upgrade/versionResolution.js +2 -3
- package/dist/validate/activationArtifactEvidence.js +852 -0
- package/dist/validate/activationArtifactEvidenceTypes.js +12 -0
- package/dist/validate/activationConjunction.js +816 -0
- package/dist/validate/activationEvidenceManifest.js +531 -0
- package/dist/validate/activationPackageSemantics.js +29 -0
- package/dist/validate/appHomeContract.js +2 -8
- package/dist/validate/bootstrapAuthority.js +44 -0
- package/dist/validate/capability.js +133 -12
- package/dist/validate/crossCapability.js +15 -10
- package/dist/validate/retainedReferenceAuthority.js +879 -0
- package/dist/validate/selfAudit.js +39 -45
- package/dist/validate/v1LegacyCruft.js +131 -0
- package/dist/validate/vocabularyAuthority.js +18 -13
- package/package.json +60 -29
- package/bundle/references/adapters/cursor.md +0 -213
- package/bundle/references/adapters/opencode.md +0 -530
- package/bundle/references/adapters/package-manifest-interface-model.yaml +0 -337
- package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
- package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
- package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -548
- package/bundle/references/adapters/runtime-feature-parity.md +0 -189
- package/bundle/references/analysis/benchmark.md +0 -267
- package/bundle/references/analysis/startup-measurement-contract.yaml +0 -424
- package/bundle/references/cli/agent-ready-state-contract.yaml +0 -953
- package/bundle/references/cli/audience-namespace-cli-migration.yaml +0 -369
- package/bundle/references/cli/bundle-skill-vocabulary.yaml +0 -250
- package/bundle/references/cli/capability-tool-classification.yaml +0 -53
- package/bundle/references/cli/coexistence-probe.yaml +0 -9
- package/bundle/references/cli/routing-execution-vocabulary.yaml +0 -281
- package/bundle/references/cli/single-name-protocol.yaml +0 -42
- package/bundle/references/cli/upgrade-repair-wording.md +0 -31
- package/bundle/references/cli/v3-handoff-manifest.schema.yaml +0 -98
- package/bundle/references/meta/documentation-inventory.md +0 -49
- package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
- package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
- package/bundle/skills/agentera/agents/hej.toml +0 -6
- package/bundle/skills/agentera/agents/inspektera.toml +0 -6
- package/bundle/skills/agentera/agents/inspirera.toml +0 -6
- package/bundle/skills/agentera/agents/optimera.toml +0 -6
- package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
- package/bundle/skills/agentera/agents/planera.toml +0 -6
- package/bundle/skills/agentera/agents/profilera.toml +0 -6
- package/bundle/skills/agentera/agents/realisera.toml +0 -6
- package/bundle/skills/agentera/agents/resonera.toml +0 -6
- package/bundle/skills/agentera/agents/visionera.toml +0 -6
- package/bundle/skills/agentera/agents/visualisera.toml +0 -6
- package/bundle/skills/agentera/capabilities/dokumentera/schemas/artifacts.yaml +0 -73
- package/bundle/skills/agentera/capabilities/dokumentera/schemas/triggers.yaml +0 -35
- package/bundle/skills/agentera/capabilities/hej/schemas/artifacts.yaml +0 -69
- package/bundle/skills/agentera/capabilities/hej/schemas/triggers.yaml +0 -58
- package/bundle/skills/agentera/capabilities/inspektera/schemas/artifacts.yaml +0 -76
- package/bundle/skills/agentera/capabilities/inspektera/schemas/triggers.yaml +0 -38
- package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +0 -24
- package/bundle/skills/agentera/capabilities/inspirera/schemas/triggers.yaml +0 -34
- package/bundle/skills/agentera/capabilities/optimera/schemas/triggers.yaml +0 -39
- package/bundle/skills/agentera/capabilities/orkestrera/schemas/artifacts.yaml +0 -64
- package/bundle/skills/agentera/capabilities/orkestrera/schemas/triggers.yaml +0 -42
- package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +0 -120
- package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +0 -62
- package/bundle/skills/agentera/capabilities/planera/schemas/triggers.yaml +0 -34
- package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +0 -61
- package/bundle/skills/agentera/capabilities/profilera/schemas/artifacts.yaml +0 -18
- package/bundle/skills/agentera/capabilities/profilera/schemas/triggers.yaml +0 -45
- package/bundle/skills/agentera/capabilities/profilera/schemas/validation.yaml +0 -57
- package/bundle/skills/agentera/capabilities/realisera/schemas/artifacts.yaml +0 -80
- package/bundle/skills/agentera/capabilities/realisera/schemas/triggers.yaml +0 -39
- package/bundle/skills/agentera/capabilities/realisera/schemas/validation.yaml +0 -110
- package/bundle/skills/agentera/capabilities/resonera/schemas/artifacts.yaml +0 -47
- package/bundle/skills/agentera/capabilities/resonera/schemas/triggers.yaml +0 -46
- package/bundle/skills/agentera/capabilities/resonera/schemas/validation.yaml +0 -77
- package/bundle/skills/agentera/capabilities/visionera/schemas/triggers.yaml +0 -41
- package/bundle/skills/agentera/capabilities/visualisera/schemas/triggers.yaml +0 -33
- package/bundle/skills/agentera/references/contract.md +0 -1039
- package/dist/analytics/extractCorpus/cli.js.map +0 -1
- package/dist/analytics/extractCorpus/copilotSessions.js.map +0 -1
- package/dist/analytics/extractCorpus/core.js.map +0 -1
- package/dist/analytics/extractCorpus/corpus.js.map +0 -1
- package/dist/analytics/extractCorpus/cursorSessions.js.map +0 -1
- package/dist/analytics/extractCorpus/filesystemSources.js.map +0 -1
- package/dist/analytics/extractCorpus/index.js.map +0 -1
- package/dist/analytics/extractCorpus/jsonlSessions.js.map +0 -1
- package/dist/analytics/extractCorpus/sqliteSessions.js.map +0 -1
- package/dist/analytics/extractCorpus.js.map +0 -1
- package/dist/analytics/usageStats.js.map +0 -1
- package/dist/bin/agentera.js.map +0 -1
- package/dist/capabilities/dokumentera/instructions.js +0 -6
- package/dist/capabilities/dokumentera/instructions.js.map +0 -1
- package/dist/capabilities/hej/instructions.js +0 -6
- package/dist/capabilities/hej/instructions.js.map +0 -1
- package/dist/capabilities/index.js.map +0 -1
- package/dist/capabilities/inspektera/instructions.js +0 -6
- package/dist/capabilities/inspektera/instructions.js.map +0 -1
- package/dist/capabilities/inspirera/instructions.js +0 -6
- package/dist/capabilities/inspirera/instructions.js.map +0 -1
- package/dist/capabilities/optimera/instructions.js +0 -6
- package/dist/capabilities/optimera/instructions.js.map +0 -1
- package/dist/capabilities/orkestrera/instructions.js +0 -6
- package/dist/capabilities/orkestrera/instructions.js.map +0 -1
- package/dist/capabilities/planera/instructions.js +0 -6
- package/dist/capabilities/planera/instructions.js.map +0 -1
- package/dist/capabilities/profilera/instructions.js +0 -6
- package/dist/capabilities/profilera/instructions.js.map +0 -1
- package/dist/capabilities/realisera/instructions.js +0 -6
- package/dist/capabilities/realisera/instructions.js.map +0 -1
- package/dist/capabilities/resonera/instructions.js +0 -6
- package/dist/capabilities/resonera/instructions.js.map +0 -1
- package/dist/capabilities/visionera/instructions.js +0 -6
- package/dist/capabilities/visionera/instructions.js.map +0 -1
- package/dist/capabilities/visualisera/instructions.js +0 -6
- package/dist/capabilities/visualisera/instructions.js.map +0 -1
- package/dist/cli/appContext.js.map +0 -1
- package/dist/cli/argvalidate.js.map +0 -1
- package/dist/cli/capabilityContext/benchmark.js.map +0 -1
- package/dist/cli/capabilityContext/bespoke.js.map +0 -1
- package/dist/cli/capabilityContext/closeout.js.map +0 -1
- package/dist/cli/capabilityContext/contract.js.map +0 -1
- package/dist/cli/capabilityContext/evidence.js.map +0 -1
- package/dist/cli/capabilityContext/index.js.map +0 -1
- package/dist/cli/capabilityContext/orchestration.js.map +0 -1
- package/dist/cli/capabilityContext/planState.js.map +0 -1
- package/dist/cli/capabilityContext/progress.js.map +0 -1
- package/dist/cli/capabilityContext/realisera.js +0 -174
- package/dist/cli/capabilityContext/realisera.js.map +0 -1
- package/dist/cli/capabilityContext/shared.js.map +0 -1
- package/dist/cli/capabilityContext/slim.js.map +0 -1
- package/dist/cli/capabilityContext/startup.js.map +0 -1
- package/dist/cli/capabilityContext/types.js.map +0 -1
- package/dist/cli/capabilityContext.js.map +0 -1
- package/dist/cli/commands/backfill.js +0 -84
- package/dist/cli/commands/backfill.js.map +0 -1
- package/dist/cli/commands/capability.js.map +0 -1
- package/dist/cli/commands/compact.js.map +0 -1
- package/dist/cli/commands/doctor.js.map +0 -1
- package/dist/cli/commands/lint.js.map +0 -1
- package/dist/cli/commands/prime.js.map +0 -1
- package/dist/cli/commands/query.js.map +0 -1
- package/dist/cli/commands/report.js.map +0 -1
- package/dist/cli/commands/schema.js.map +0 -1
- package/dist/cli/commands/state/decisions.js.map +0 -1
- package/dist/cli/commands/state/docs.js.map +0 -1
- package/dist/cli/commands/state/experiments.js.map +0 -1
- package/dist/cli/commands/state/health.js.map +0 -1
- package/dist/cli/commands/state/index.js.map +0 -1
- package/dist/cli/commands/state/objective.js.map +0 -1
- package/dist/cli/commands/state/plan.js.map +0 -1
- package/dist/cli/commands/state/progress.js.map +0 -1
- package/dist/cli/commands/state/shared.js.map +0 -1
- package/dist/cli/commands/state/todo.js.map +0 -1
- package/dist/cli/commands/state.js +0 -1023
- package/dist/cli/commands/state.js.map +0 -1
- package/dist/cli/commands/upgrade.js.map +0 -1
- package/dist/cli/commands/validate.js.map +0 -1
- package/dist/cli/commands/verify.js.map +0 -1
- package/dist/cli/dispatch/check.js.map +0 -1
- package/dist/cli/dispatch/index.js.map +0 -1
- package/dist/cli/dispatch/lifecycle.js.map +0 -1
- package/dist/cli/dispatch/prime.js.map +0 -1
- package/dist/cli/dispatch/shared.js.map +0 -1
- package/dist/cli/dispatch/state.js.map +0 -1
- package/dist/cli/dispatch.js.map +0 -1
- package/dist/cli/errors.js.map +0 -1
- package/dist/cli/help.js.map +0 -1
- package/dist/cli/orientation.js.map +0 -1
- package/dist/cli/prime-blob.js.map +0 -1
- package/dist/cli/stateQuery.js.map +0 -1
- package/dist/cli/structured.js.map +0 -1
- package/dist/cli/todoMarkdown.js.map +0 -1
- package/dist/core/difflib.js.map +0 -1
- package/dist/core/git.js +0 -43
- package/dist/core/git.js.map +0 -1
- package/dist/core/paths.js.map +0 -1
- package/dist/core/pyjson.js.map +0 -1
- package/dist/core/sourceRoot.js.map +0 -1
- package/dist/core/toml.js.map +0 -1
- package/dist/core/yaml.js.map +0 -1
- package/dist/eval/evalSkills.js.map +0 -1
- package/dist/eval/semanticEval.js.map +0 -1
- package/dist/eval/semanticFixtures.js.map +0 -1
- package/dist/hooks/common.js.map +0 -1
- package/dist/hooks/compaction/apply.js.map +0 -1
- package/dist/hooks/compaction/dryRun.js.map +0 -1
- package/dist/hooks/compaction/index.js.map +0 -1
- package/dist/hooks/compaction/parse.js.map +0 -1
- package/dist/hooks/compaction/retention.js.map +0 -1
- package/dist/hooks/compaction/status.js.map +0 -1
- package/dist/hooks/compaction/types.js.map +0 -1
- package/dist/hooks/compaction.js +0 -935
- package/dist/hooks/compaction.js.map +0 -1
- package/dist/hooks/cursorPreToolUse.js +0 -19
- package/dist/hooks/cursorPreToolUse.js.map +0 -1
- package/dist/hooks/cursorSessionStart.js +0 -71
- package/dist/hooks/cursorSessionStart.js.map +0 -1
- package/dist/hooks/sessionStart.js +0 -209
- package/dist/hooks/sessionStart.js.map +0 -1
- package/dist/hooks/sessionStop.js +0 -203
- package/dist/hooks/sessionStop.js.map +0 -1
- package/dist/hooks/validateArtifact/agentFacing.js.map +0 -1
- package/dist/hooks/validateArtifact/index.js.map +0 -1
- package/dist/hooks/validateArtifact/markdown.js.map +0 -1
- package/dist/hooks/validateArtifact/runtime.js +0 -83
- package/dist/hooks/validateArtifact/runtime.js.map +0 -1
- package/dist/hooks/validateArtifact/schema.js.map +0 -1
- package/dist/hooks/validateArtifact/traversal.js.map +0 -1
- package/dist/hooks/validateArtifact/violations.js.map +0 -1
- package/dist/hooks/validateArtifact.js +0 -924
- package/dist/hooks/validateArtifact.js.map +0 -1
- package/dist/migrate/v2HandoffManifest.js.map +0 -1
- package/dist/registries/artifactProtocolIds.js.map +0 -1
- package/dist/registries/artifactRegistry.js.map +0 -1
- package/dist/registries/capabilityContract.js.map +0 -1
- package/dist/registries/evaluatorHandoffContract.js.map +0 -1
- package/dist/registries/packageRegistry.js.map +0 -1
- package/dist/registries/runtimeAdapterRegistry.js +0 -315
- package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
- package/dist/release/releaseMetadata.js.map +0 -1
- package/dist/setup/codex/agents.js +0 -96
- package/dist/setup/codex/agents.js.map +0 -1
- package/dist/setup/codex/cli.js +0 -161
- package/dist/setup/codex/cli.js.map +0 -1
- package/dist/setup/codex/configToml.js +0 -644
- package/dist/setup/codex/configToml.js.map +0 -1
- package/dist/setup/codex/constants.js +0 -29
- package/dist/setup/codex/constants.js.map +0 -1
- package/dist/setup/codex/installRoot.js +0 -64
- package/dist/setup/codex/installRoot.js.map +0 -1
- package/dist/setup/codex/state.js +0 -270
- package/dist/setup/codex/state.js.map +0 -1
- package/dist/setup/codex.js +0 -12
- package/dist/setup/codex.js.map +0 -1
- package/dist/setup/copilot.js +0 -227
- package/dist/setup/copilot.js.map +0 -1
- package/dist/setup/cursor.js +0 -127
- package/dist/setup/cursor.js.map +0 -1
- package/dist/setup/doctor/core.js +0 -300
- package/dist/setup/doctor/core.js.map +0 -1
- package/dist/setup/doctor/diagnostics.js +0 -247
- package/dist/setup/doctor/diagnostics.js.map +0 -1
- package/dist/setup/doctor/opencode.js +0 -281
- package/dist/setup/doctor/opencode.js.map +0 -1
- package/dist/setup/doctor/report.js +0 -474
- package/dist/setup/doctor/report.js.map +0 -1
- package/dist/setup/doctor.js +0 -10
- package/dist/setup/doctor.js.map +0 -1
- package/dist/setup/opencode.js.map +0 -1
- package/dist/setup/smokeChecks.js.map +0 -1
- package/dist/state/installRoot.js.map +0 -1
- package/dist/state/progressCommit.js +0 -289
- package/dist/state/progressCommit.js.map +0 -1
- package/dist/state/startupAnalysis/benchmark.js.map +0 -1
- package/dist/state/startupAnalysis/contract.js.map +0 -1
- package/dist/state/startupAnalysis/helpers.js.map +0 -1
- package/dist/state/startupAnalysis/index.js.map +0 -1
- package/dist/state/startupAnalysis/metrics.js.map +0 -1
- package/dist/state/startupAnalysis/records.js.map +0 -1
- package/dist/state/startupAnalysis/report.js.map +0 -1
- package/dist/state/startupAnalysis/threshold.js.map +0 -1
- package/dist/state/startupAnalysis.js.map +0 -1
- package/dist/upgrade/appModel.js.map +0 -1
- package/dist/upgrade/channels.js.map +0 -1
- package/dist/upgrade/coexistenceProbe.js +0 -83
- package/dist/upgrade/coexistenceProbe.js.map +0 -1
- package/dist/upgrade/compatibility.js.map +0 -1
- package/dist/upgrade/doctor.js.map +0 -1
- package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -570
- package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
- package/dist/upgrade/migrateArtifactsV2ToV3.js.map +0 -1
- package/dist/upgrade/nextMajorDoctor.js.map +0 -1
- package/dist/upgrade/projectIntegration.js.map +0 -1
- package/dist/upgrade/runtimeMigration.js.map +0 -1
- package/dist/upgrade/upgradeCommands.js.map +0 -1
- package/dist/upgrade/upgradeOrchestrator.js.map +0 -1
- package/dist/upgrade/v3CapabilitySurface.js.map +0 -1
- package/dist/upgrade/versionResolution.js.map +0 -1
- package/dist/validate/appHomeContract.js.map +0 -1
- package/dist/validate/capability.js.map +0 -1
- package/dist/validate/crossCapability.js.map +0 -1
- package/dist/validate/lifecycleAdapters.js +0 -772
- package/dist/validate/lifecycleAdapters.js.map +0 -1
- package/dist/validate/selfAudit.js.map +0 -1
- package/dist/validate/vocabularyAuthority.js.map +0 -1
- /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
- /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
- /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
|
@@ -9,13 +9,7 @@
|
|
|
9
9
|
# 3. Deprecation protocol (deprecated + replaced_by)
|
|
10
10
|
# 4. Directory structure requirements (instruction module, schemas/)
|
|
11
11
|
# 5. Machine-readable validation rules consumed by future contract loaders
|
|
12
|
-
#
|
|
13
|
-
# D65: the per-capability `instructions.md` Markdown file is retired. The
|
|
14
|
-
# behavioral instructions now live at
|
|
15
|
-
# `packages/cli/src/capabilities/<name>/instructions.ts` as a default-exported
|
|
16
|
-
# string constant. The directory requirement below points at the new path;
|
|
17
|
-
# the V1 directory_structure rule's `checks` list and the ARTIFACTS A3 path
|
|
18
|
-
# text follow the same move.
|
|
12
|
+
# 6. Optional trigger-entry intent documentation (TRIGGER_ENRICHMENT)
|
|
19
13
|
|
|
20
14
|
meta:
|
|
21
15
|
name: capability_schema_contract
|
|
@@ -54,9 +48,10 @@ ENTRY_SCHEMA:
|
|
|
54
48
|
type: string
|
|
55
49
|
required: false
|
|
56
50
|
description: >-
|
|
57
|
-
|
|
58
|
-
|
|
51
|
+
Advisory relevance-precedence hint a host reads alongside the entry
|
|
52
|
+
description only after deterministic routing returns semantic_required.
|
|
59
53
|
Required for all TRIGGERS entries.
|
|
54
|
+
Valid values: high, medium, low.
|
|
60
55
|
deprecated:
|
|
61
56
|
type: boolean
|
|
62
57
|
required: false
|
|
@@ -85,7 +80,7 @@ DIRECTORY_REQUIREMENTS:
|
|
|
85
80
|
TypeScript module that exports the capability's behavioral instructions
|
|
86
81
|
as a default-exported string constant. The runtime loads it via the
|
|
87
82
|
compiled .js path and surfaces the prose through
|
|
88
|
-
`agentera prime --context <name> --format json`.
|
|
83
|
+
`npx -y agentera@next prime --context <name> --format json`.
|
|
89
84
|
schemas_directory:
|
|
90
85
|
path: schemas
|
|
91
86
|
type: directory
|
|
@@ -141,7 +136,112 @@ FIELD_RULES:
|
|
|
141
136
|
- high
|
|
142
137
|
- medium
|
|
143
138
|
- low
|
|
144
|
-
description:
|
|
139
|
+
description: >-
|
|
140
|
+
Relevance-precedence hint a host reads when ordering capability intent
|
|
141
|
+
after deterministic abstention. See
|
|
142
|
+
references/cli/routing-model.md for routing semantics.
|
|
143
|
+
|
|
144
|
+
TRIGGER_ENRICHMENT:
|
|
145
|
+
description: >-
|
|
146
|
+
Optional trigger-entry fields. Every field is OPTIONAL: a triggers.yaml
|
|
147
|
+
entry that omits all enriched fields remains valid. A host consumes
|
|
148
|
+
disambiguates_against as semantic-phase intent documentation only after
|
|
149
|
+
deterministic abstention. patterns,
|
|
150
|
+
confidence_threshold, borderline_band, and patterns_regex are legacy
|
|
151
|
+
compatibility fields: they remain shape-validated only and never enter the
|
|
152
|
+
active semantic trigger model.
|
|
153
|
+
spec: references/cli/trigger-schema-enrichment.md
|
|
154
|
+
fields:
|
|
155
|
+
patterns:
|
|
156
|
+
type: list_of_strings
|
|
157
|
+
required: false
|
|
158
|
+
description: >-
|
|
159
|
+
Legacy matcher strings retained only so existing trigger files load and
|
|
160
|
+
validate. They are never matched or returned by the active model.
|
|
161
|
+
confidence_threshold:
|
|
162
|
+
type: integer
|
|
163
|
+
required: false
|
|
164
|
+
min: 0
|
|
165
|
+
max: 100
|
|
166
|
+
description: >-
|
|
167
|
+
Legacy integer 0-100. Not consumed by the LLM host; retained so
|
|
168
|
+
triggers.yaml files carrying the field still validate. A non-integer
|
|
169
|
+
or value outside 0..100 fails V7 validation with the valid range
|
|
170
|
+
and the offending entry ID.
|
|
171
|
+
borderline_band:
|
|
172
|
+
type: integer
|
|
173
|
+
required: false
|
|
174
|
+
min: 0
|
|
175
|
+
max: 100
|
|
176
|
+
description: >-
|
|
177
|
+
Legacy integer 0-100. Not consumed by the LLM host; retained so
|
|
178
|
+
triggers.yaml files carrying the field still validate. A non-integer
|
|
179
|
+
or value outside 0..100 fails V7 validation.
|
|
180
|
+
patterns_regex:
|
|
181
|
+
type: list_of_strings
|
|
182
|
+
required: false
|
|
183
|
+
each_must_be_valid_regex: true
|
|
184
|
+
description: >-
|
|
185
|
+
Legacy list of regex strings. Not consumed by the LLM host; retained
|
|
186
|
+
so triggers.yaml files carrying the field still validate. The loader
|
|
187
|
+
syntax-validates each entry but never returns a RegExp or matches it.
|
|
188
|
+
disambiguates_against:
|
|
189
|
+
type: list_of_mappings
|
|
190
|
+
required: false
|
|
191
|
+
description: >-
|
|
192
|
+
Declares which other capabilities this trigger's intent could be
|
|
193
|
+
confused with, with a hint the LLM host consults when a request could
|
|
194
|
+
match more than one capability (spec §1.2). Advisory: the LLM host
|
|
195
|
+
resolves ambiguity natively and MAY surface the hint when asking the
|
|
196
|
+
user to confirm or clarify. Each entry MUST be a mapping with
|
|
197
|
+
`capability` and `hint`.
|
|
198
|
+
entries:
|
|
199
|
+
capability:
|
|
200
|
+
type: string
|
|
201
|
+
required: true
|
|
202
|
+
enum_source: ROUTE_ALIASES.primary_aliases.capability
|
|
203
|
+
description: >-
|
|
204
|
+
Canonical capability ID. Must be one of the twelve English
|
|
205
|
+
canonical IDs enumerated by ROUTE_ALIASES.primary_aliases
|
|
206
|
+
(status, vision, discuss, research, plan, build, optimize, audit,
|
|
207
|
+
document, profile, design, orchestrate). A non-canonical value
|
|
208
|
+
fails V7 validation with the offending entry ID.
|
|
209
|
+
hint:
|
|
210
|
+
type: string
|
|
211
|
+
required: true
|
|
212
|
+
non_empty: true
|
|
213
|
+
description: >-
|
|
214
|
+
Non-empty string distinguishing this trigger's intent from the
|
|
215
|
+
named capability on near-equal requests. A missing or empty hint
|
|
216
|
+
fails V7 validation.
|
|
217
|
+
|
|
218
|
+
PROSE_CONVENTIONS:
|
|
219
|
+
description: >-
|
|
220
|
+
Authoring rules for capability behavioral instructions. These
|
|
221
|
+
conventions govern the prose in
|
|
222
|
+
packages/cli/src/capabilities/<name>/instructions.ts.
|
|
223
|
+
modal_vocabulary:
|
|
224
|
+
authority: RFC 2119
|
|
225
|
+
keywords:
|
|
226
|
+
- MUST
|
|
227
|
+
- MUST NOT
|
|
228
|
+
- SHOULD
|
|
229
|
+
- SHOULD NOT
|
|
230
|
+
- MAY
|
|
231
|
+
rule: >-
|
|
232
|
+
Capitalized keywords carry protocol force. Lowercase modal verbs
|
|
233
|
+
(should, must, may) remain ordinary English with no protocol force.
|
|
234
|
+
Use capitalized keywords when stating hard requirements, strong
|
|
235
|
+
recommendations, or optional behavior. Use lowercase modals in
|
|
236
|
+
natural prose that does not bind the agent.
|
|
237
|
+
rationale: >-
|
|
238
|
+
Weak models read capability instructions literally as user commands.
|
|
239
|
+
Deliberate modal vocabulary disambiguates intent: a capitalized MUST
|
|
240
|
+
signals a hard constraint, while lowercase "should" in descriptive
|
|
241
|
+
prose does not bind. This is the disambiguator, not the offender.
|
|
242
|
+
example: >-
|
|
243
|
+
Steps SHOULD be ordered by value/effort ratio. Each matrix cell
|
|
244
|
+
MUST be ≤15 words. A concept MAY reference external sources.
|
|
145
245
|
|
|
146
246
|
PRIMITIVE_REFERENCE_FIELDS:
|
|
147
247
|
description: >-
|
|
@@ -172,41 +272,68 @@ PRIMITIVE_REFERENCE_FIELDS:
|
|
|
172
272
|
|
|
173
273
|
ROUTE_ALIASES:
|
|
174
274
|
description: >-
|
|
175
|
-
Primary
|
|
176
|
-
|
|
177
|
-
|
|
275
|
+
Primary `/agentera <alias>` slash-route aliases for each capability.
|
|
276
|
+
English capability names are canonical protocol identity; the route alias
|
|
277
|
+
word is the canonical ID itself. Swedish -era names are legacy v2-stable
|
|
278
|
+
references, preserved for the v2 stable distribution and historical
|
|
279
|
+
artifacts (see legacy_aliases). Alias routes are not CLI commands.
|
|
178
280
|
route_prefix: /agentera
|
|
179
281
|
canonical_name_precedence: true
|
|
180
282
|
cli_boundary: >-
|
|
181
283
|
Slash routes and state commands are distinct: `/agentera plan` routes to
|
|
182
|
-
|
|
183
|
-
reading plan state. Do not add
|
|
184
|
-
CLI.
|
|
284
|
+
the plan capability, while `agentera state plan list` remains the
|
|
285
|
+
state-oriented CLI command for reading plan state. Do not add capability or
|
|
286
|
+
alias commands to the CLI.
|
|
185
287
|
primary_aliases:
|
|
186
288
|
- alias: status
|
|
187
|
-
capability:
|
|
289
|
+
capability: status
|
|
188
290
|
- alias: vision
|
|
189
|
-
capability:
|
|
291
|
+
capability: vision
|
|
190
292
|
- alias: discuss
|
|
191
|
-
capability:
|
|
293
|
+
capability: discuss
|
|
192
294
|
- alias: research
|
|
193
|
-
capability:
|
|
295
|
+
capability: research
|
|
194
296
|
- alias: plan
|
|
195
|
-
capability:
|
|
297
|
+
capability: plan
|
|
196
298
|
- alias: build
|
|
197
|
-
capability:
|
|
299
|
+
capability: build
|
|
198
300
|
- alias: optimize
|
|
199
|
-
capability:
|
|
301
|
+
capability: optimize
|
|
200
302
|
- alias: audit
|
|
201
|
-
capability:
|
|
303
|
+
capability: audit
|
|
202
304
|
- alias: document
|
|
203
|
-
capability:
|
|
305
|
+
capability: document
|
|
204
306
|
- alias: profile
|
|
205
|
-
capability:
|
|
307
|
+
capability: profile
|
|
206
308
|
- alias: design
|
|
207
|
-
capability:
|
|
309
|
+
capability: design
|
|
208
310
|
- alias: orchestrate
|
|
209
|
-
capability:
|
|
311
|
+
capability: orchestrate
|
|
312
|
+
legacy_aliases:
|
|
313
|
+
- legacy: hej
|
|
314
|
+
canonical: status
|
|
315
|
+
- legacy: visionera
|
|
316
|
+
canonical: vision
|
|
317
|
+
- legacy: resonera
|
|
318
|
+
canonical: discuss
|
|
319
|
+
- legacy: inspirera
|
|
320
|
+
canonical: research
|
|
321
|
+
- legacy: planera
|
|
322
|
+
canonical: plan
|
|
323
|
+
- legacy: realisera
|
|
324
|
+
canonical: build
|
|
325
|
+
- legacy: optimera
|
|
326
|
+
canonical: optimize
|
|
327
|
+
- legacy: inspektera
|
|
328
|
+
canonical: audit
|
|
329
|
+
- legacy: dokumentera
|
|
330
|
+
canonical: document
|
|
331
|
+
- legacy: profilera
|
|
332
|
+
canonical: profile
|
|
333
|
+
- legacy: visualisera
|
|
334
|
+
canonical: design
|
|
335
|
+
- legacy: orkestrera
|
|
336
|
+
canonical: orchestrate
|
|
210
337
|
|
|
211
338
|
# ---------------------------------------------------------------------------
|
|
212
339
|
# The four required groups follow. The contract IS a valid capability schema,
|
|
@@ -282,9 +409,7 @@ ARTIFACTS:
|
|
|
282
409
|
Behavioral instructions the agent reads. TypeScript module that exports
|
|
283
410
|
a default-exported string constant. The runtime loads it via the
|
|
284
411
|
compiled .js path and serves the prose through
|
|
285
|
-
`agentera prime --context <name> --format json`.
|
|
286
|
-
`instructions.md` file is no longer part of the on-disk capability
|
|
287
|
-
surface (D65).
|
|
412
|
+
`npx -y agentera@next prime --context <name> --format json`.
|
|
288
413
|
produces: false
|
|
289
414
|
consumes: true
|
|
290
415
|
4:
|
|
@@ -365,6 +490,25 @@ VALIDATION:
|
|
|
365
490
|
- "Contract file contains all required groups"
|
|
366
491
|
- "Contract file entries follow entry schema structure"
|
|
367
492
|
- "Contract file passes deprecation consistency check"
|
|
493
|
+
7:
|
|
494
|
+
id: V7
|
|
495
|
+
rule: trigger_enrichment_fields
|
|
496
|
+
description: >-
|
|
497
|
+
Trigger entries MAY carry the optional intent-documentation fields
|
|
498
|
+
defined in TRIGGER_ENRICHMENT. Enrichment is opt-in per entry;
|
|
499
|
+
triggers omitting every enriched field remain valid. patterns,
|
|
500
|
+
confidence_threshold, borderline_band, and patterns_regex are legacy
|
|
501
|
+
compatibility fields only; disambiguates_against is consumed by the
|
|
502
|
+
LLM host at runtime. Validating an entry with enriched fields fails
|
|
503
|
+
when the rules below are violated.
|
|
504
|
+
severity: error
|
|
505
|
+
checks:
|
|
506
|
+
- "patterns, when present, is a list of strings"
|
|
507
|
+
- "confidence_threshold, when present, is an integer in 0..100"
|
|
508
|
+
- "borderline_band, when present, is an integer in 0..100"
|
|
509
|
+
- "patterns_regex entries are strings that compile as regular expressions"
|
|
510
|
+
- "disambiguates_against entries are mappings with a non-empty hint"
|
|
511
|
+
- "disambiguates_against.capability is one of the twelve canonical capability IDs"
|
|
368
512
|
|
|
369
513
|
EXIT_CONDITIONS:
|
|
370
514
|
1:
|
|
@@ -378,8 +522,8 @@ EXIT_CONDITIONS:
|
|
|
378
522
|
id: E2
|
|
379
523
|
condition: invalid_structure
|
|
380
524
|
description: >-
|
|
381
|
-
Directory structure validation failed. Missing
|
|
382
|
-
directory, or YAML files.
|
|
525
|
+
Directory structure validation failed. Missing instruction module,
|
|
526
|
+
schemas/ directory, or YAML files.
|
|
383
527
|
exit_code: 1
|
|
384
528
|
3:
|
|
385
529
|
id: E3
|
|
@@ -59,18 +59,18 @@
|
|
|
59
59
|
# Structural: inline separator (·) → VISUAL_TOKENS.16 (VT16)
|
|
60
60
|
# Structural: flow/target (→) → VISUAL_TOKENS.17 (VT17)
|
|
61
61
|
# Structural: progress bar (█▓░) → VISUAL_TOKENS.18 (VT18)
|
|
62
|
-
# Skill glyph:
|
|
63
|
-
# Skill glyph:
|
|
64
|
-
# Skill glyph:
|
|
65
|
-
# Skill glyph:
|
|
66
|
-
# Skill glyph:
|
|
67
|
-
# Skill glyph:
|
|
68
|
-
# Skill glyph:
|
|
69
|
-
# Skill glyph:
|
|
70
|
-
# Skill glyph:
|
|
71
|
-
# Skill glyph:
|
|
72
|
-
# Skill glyph:
|
|
73
|
-
# Skill glyph:
|
|
62
|
+
# Skill glyph: status (⌂) → SKILL_GLYPHS.1 (SG1)
|
|
63
|
+
# Skill glyph: build (⧉) → SKILL_GLYPHS.2 (SG2)
|
|
64
|
+
# Skill glyph: audit (⛶) → SKILL_GLYPHS.3 (SG3)
|
|
65
|
+
# Skill glyph: discuss (❈) → SKILL_GLYPHS.4 (SG4)
|
|
66
|
+
# Skill glyph: plan (≡) → SKILL_GLYPHS.5 (SG5)
|
|
67
|
+
# Skill glyph: vision (⛥) → SKILL_GLYPHS.6 (SG6)
|
|
68
|
+
# Skill glyph: optimize (⎘) → SKILL_GLYPHS.7 (SG7)
|
|
69
|
+
# Skill glyph: document (▤) → SKILL_GLYPHS.8 (SG8)
|
|
70
|
+
# Skill glyph: profile (♾) → SKILL_GLYPHS.9 (SG9)
|
|
71
|
+
# Skill glyph: research (⬚) → SKILL_GLYPHS.10 (SG10)
|
|
72
|
+
# Skill glyph: design (◰) → SKILL_GLYPHS.11 (SG11)
|
|
73
|
+
# Skill glyph: orchestrate (⎈) → SKILL_GLYPHS.12 (SG12)
|
|
74
74
|
#
|
|
75
75
|
# SPEC Section 18 (Phase Tracking):
|
|
76
76
|
# Phase: envision → PHASES.1 (PH1)
|
|
@@ -349,73 +349,73 @@ VISUAL_TOKENS:
|
|
|
349
349
|
SKILL_GLYPHS:
|
|
350
350
|
1:
|
|
351
351
|
id: SG1
|
|
352
|
-
capability:
|
|
352
|
+
capability: status
|
|
353
353
|
glyph: "\u2302"
|
|
354
354
|
glyph_code: U+2302
|
|
355
355
|
meaning: "home base"
|
|
356
356
|
2:
|
|
357
357
|
id: SG2
|
|
358
|
-
capability:
|
|
358
|
+
capability: build
|
|
359
359
|
glyph: "\u29C9"
|
|
360
360
|
glyph_code: U+29C9
|
|
361
361
|
meaning: "joined building blocks"
|
|
362
362
|
3:
|
|
363
363
|
id: SG3
|
|
364
|
-
capability:
|
|
364
|
+
capability: audit
|
|
365
365
|
glyph: "\u26F6"
|
|
366
366
|
glyph_code: U+26F6
|
|
367
367
|
meaning: "viewfinder frame"
|
|
368
368
|
4:
|
|
369
369
|
id: SG4
|
|
370
|
-
capability:
|
|
370
|
+
capability: discuss
|
|
371
371
|
glyph: "\u2748"
|
|
372
372
|
glyph_code: U+2748
|
|
373
373
|
meaning: "spark of insight"
|
|
374
374
|
5:
|
|
375
375
|
id: SG5
|
|
376
|
-
capability:
|
|
376
|
+
capability: plan
|
|
377
377
|
glyph: "\u2261"
|
|
378
378
|
glyph_code: U+2261
|
|
379
379
|
meaning: "structured layers"
|
|
380
380
|
6:
|
|
381
381
|
id: SG6
|
|
382
|
-
capability:
|
|
382
|
+
capability: vision
|
|
383
383
|
glyph: "\u26E5"
|
|
384
384
|
glyph_code: U+26E5
|
|
385
385
|
meaning: "guiding star"
|
|
386
386
|
7:
|
|
387
387
|
id: SG7
|
|
388
|
-
capability:
|
|
388
|
+
capability: optimize
|
|
389
389
|
glyph: "\u2398"
|
|
390
390
|
glyph_code: U+2398
|
|
391
391
|
meaning: "measurement"
|
|
392
392
|
8:
|
|
393
393
|
id: SG8
|
|
394
|
-
capability:
|
|
394
|
+
capability: document
|
|
395
395
|
glyph: "\u25A4"
|
|
396
396
|
glyph_code: U+25A4
|
|
397
397
|
meaning: "text on page"
|
|
398
398
|
9:
|
|
399
399
|
id: SG9
|
|
400
|
-
capability:
|
|
400
|
+
capability: profile
|
|
401
401
|
glyph: "\u267E"
|
|
402
402
|
glyph_code: U+267E
|
|
403
403
|
meaning: "permanent mark"
|
|
404
404
|
10:
|
|
405
405
|
id: SG10
|
|
406
|
-
capability:
|
|
406
|
+
capability: research
|
|
407
407
|
glyph: "\u2B1A"
|
|
408
408
|
glyph_code: U+2B1A
|
|
409
409
|
meaning: "frame to fill"
|
|
410
410
|
11:
|
|
411
411
|
id: SG11
|
|
412
|
-
capability:
|
|
412
|
+
capability: design
|
|
413
413
|
glyph: "\u25F0"
|
|
414
414
|
glyph_code: U+25F0
|
|
415
415
|
meaning: "design grid"
|
|
416
416
|
12:
|
|
417
417
|
id: SG12
|
|
418
|
-
capability:
|
|
418
|
+
capability: orchestrate
|
|
419
419
|
glyph: "\u2388"
|
|
420
420
|
glyph_code: U+2388
|
|
421
421
|
meaning: "helm, steering"
|
|
@@ -424,7 +424,7 @@ PHASES:
|
|
|
424
424
|
1:
|
|
425
425
|
id: PH1
|
|
426
426
|
value: envision
|
|
427
|
-
capabilities: [
|
|
427
|
+
capabilities: [vision]
|
|
428
428
|
purpose: "Define or refine the project's north star"
|
|
429
429
|
valid_successors: [deliberate, plan, build]
|
|
430
430
|
terminal: false
|
|
@@ -432,15 +432,15 @@ PHASES:
|
|
|
432
432
|
2:
|
|
433
433
|
id: PH2
|
|
434
434
|
value: deliberate
|
|
435
|
-
capabilities: [
|
|
436
|
-
purpose: "Reason through decisions before committing to a direction"
|
|
435
|
+
capabilities: [discuss, research]
|
|
436
|
+
purpose: "Reason through decisions or external evidence before committing to a direction"
|
|
437
437
|
valid_successors: [plan, build, envision]
|
|
438
438
|
terminal: false
|
|
439
439
|
self_transition: false
|
|
440
440
|
3:
|
|
441
441
|
id: PH3
|
|
442
442
|
value: plan
|
|
443
|
-
capabilities: [
|
|
443
|
+
capabilities: [plan]
|
|
444
444
|
purpose: "Structure work into tasks with dependencies and acceptance criteria"
|
|
445
445
|
valid_successors: [build, deliberate]
|
|
446
446
|
terminal: false
|
|
@@ -448,15 +448,15 @@ PHASES:
|
|
|
448
448
|
4:
|
|
449
449
|
id: PH4
|
|
450
450
|
value: build
|
|
451
|
-
capabilities: [
|
|
452
|
-
purpose: "Implement, optimize, document, or design"
|
|
451
|
+
capabilities: [build, optimize, document, profile, design]
|
|
452
|
+
purpose: "Implement, optimize, document, profile, or design"
|
|
453
453
|
valid_successors: [build, audit, plan]
|
|
454
454
|
terminal: true
|
|
455
455
|
self_transition: true
|
|
456
456
|
5:
|
|
457
457
|
id: PH5
|
|
458
458
|
value: audit
|
|
459
|
-
capabilities: [
|
|
459
|
+
capabilities: [audit]
|
|
460
460
|
purpose: "Evaluate structural health and alignment"
|
|
461
461
|
valid_successors: [build, plan, deliberate, envision]
|
|
462
462
|
terminal: true
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
schema_version: agentera.route_phrase_registry.v1
|
|
2
|
+
status: active_authority
|
|
3
|
+
purpose: >-
|
|
4
|
+
Own the small, explicit inventory of deterministic leading phrases. Trigger
|
|
5
|
+
schemas remain semantic intent documentation and are not a phrase source.
|
|
6
|
+
normalization: references/cli/hybrid-route-contract.yaml#phrase_matching
|
|
7
|
+
rules:
|
|
8
|
+
stable_ids: Phrase IDs are permanent and never reassigned.
|
|
9
|
+
active_matching: Only entries with status active are eligible for matching.
|
|
10
|
+
global_collisions: >-
|
|
11
|
+
Normalized phrases must be unique across active and deprecated entries; a
|
|
12
|
+
collision is a validation error, never a precedence decision.
|
|
13
|
+
direct_route_collisions: >-
|
|
14
|
+
A phrase cannot duplicate or begin with a canonical capability name or a
|
|
15
|
+
primary alias under the direct-route grammar.
|
|
16
|
+
deprecation: >-
|
|
17
|
+
Remove no entry. Mark it deprecated, retain its ID and phrase, and set
|
|
18
|
+
replaced_by to an active registry ID. Deprecated phrases abstain.
|
|
19
|
+
prohibited_sources: [legacy_patterns, regexes, thresholds, bands, trigger_descriptions]
|
|
20
|
+
|
|
21
|
+
phrases:
|
|
22
|
+
- id: RP_STATUS_PROJECT_BRIEFING
|
|
23
|
+
capability: status
|
|
24
|
+
phrase: show project briefing
|
|
25
|
+
status: active
|
|
26
|
+
evidence: [DEV-PHRASE-STATUS]
|
|
27
|
+
- id: RP_VISION_PRODUCT_DIRECTION
|
|
28
|
+
capability: vision
|
|
29
|
+
phrase: define product direction
|
|
30
|
+
status: active
|
|
31
|
+
evidence: [DEV-PHRASE-VISION]
|
|
32
|
+
- id: RP_DISCUSS_DECISION
|
|
33
|
+
capability: discuss
|
|
34
|
+
phrase: help me decide
|
|
35
|
+
status: active
|
|
36
|
+
evidence: [DEV-PHRASE-DISCUSS]
|
|
37
|
+
- id: RP_RESEARCH_EXTERNAL_PATTERNS
|
|
38
|
+
capability: research
|
|
39
|
+
phrase: study external patterns
|
|
40
|
+
status: active
|
|
41
|
+
evidence: [DEV-PHRASE-RESEARCH]
|
|
42
|
+
- id: RP_PLAN_IMPLEMENTATION
|
|
43
|
+
capability: plan
|
|
44
|
+
phrase: make an implementation plan
|
|
45
|
+
status: active
|
|
46
|
+
evidence: [DEV-PHRASE-PLAN]
|
|
47
|
+
- id: RP_BUILD_APPROVED_PLAN
|
|
48
|
+
capability: build
|
|
49
|
+
phrase: implement the approved plan
|
|
50
|
+
status: active
|
|
51
|
+
evidence: [DEV-PHRASE-BUILD]
|
|
52
|
+
- id: RP_OPTIMIZE_BOTTLENECK
|
|
53
|
+
capability: optimize
|
|
54
|
+
phrase: improve a measured bottleneck
|
|
55
|
+
status: active
|
|
56
|
+
evidence: [DEV-PHRASE-OPTIMIZE]
|
|
57
|
+
- id: RP_AUDIT_CODEBASE_HEALTH
|
|
58
|
+
capability: audit
|
|
59
|
+
phrase: check codebase health
|
|
60
|
+
status: active
|
|
61
|
+
evidence: [DEV-PHRASE-AUDIT]
|
|
62
|
+
- id: RP_DOCUMENT_PROJECT
|
|
63
|
+
capability: document
|
|
64
|
+
phrase: refresh project documentation
|
|
65
|
+
status: active
|
|
66
|
+
evidence: [DEV-PHRASE-DOCUMENT]
|
|
67
|
+
- id: RP_PROFILE_DECISION
|
|
68
|
+
capability: profile
|
|
69
|
+
phrase: save a decision profile
|
|
70
|
+
status: active
|
|
71
|
+
evidence: [DEV-PHRASE-PROFILE]
|
|
72
|
+
- id: RP_DESIGN_INTERFACE
|
|
73
|
+
capability: design
|
|
74
|
+
phrase: shape the interface
|
|
75
|
+
status: active
|
|
76
|
+
evidence: [DEV-PHRASE-DESIGN]
|
|
77
|
+
- id: RP_ORCHESTRATE_DELIVERY
|
|
78
|
+
capability: orchestrate
|
|
79
|
+
phrase: execute the approved plan
|
|
80
|
+
status: active
|
|
81
|
+
evidence: [DEV-PHRASE-ORCHESTRATE]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Changelog Artifact Schema
|
|
2
2
|
#
|
|
3
|
-
# Release history maintained by
|
|
3
|
+
# Release history maintained by build. Tracks versioned releases with
|
|
4
4
|
# categorized changes (Added, Changed, Fixed, Removed).
|
|
5
5
|
#
|
|
6
6
|
# Note: CHANGELOG.md is a human-facing Markdown artifact. It remains at the
|
|
@@ -11,12 +11,12 @@ meta:
|
|
|
11
11
|
name: changelog
|
|
12
12
|
version: "1.0.0"
|
|
13
13
|
description: >-
|
|
14
|
-
Release history. Produced by
|
|
14
|
+
Release history. Produced by build. Consumed by users and agents
|
|
15
15
|
for version context. Human-facing: remains Markdown at project root.
|
|
16
16
|
artifact_type: human_facing
|
|
17
17
|
path: "CHANGELOG.md"
|
|
18
|
-
producer:
|
|
19
|
-
consumers: [
|
|
18
|
+
producer: build
|
|
19
|
+
consumers: [status, all_skills]
|
|
20
20
|
format: markdown
|
|
21
21
|
|
|
22
22
|
GROUP_PREFIXES:
|
|
@@ -27,6 +27,7 @@ GROUP_PREFIXES:
|
|
|
27
27
|
BUDGET:
|
|
28
28
|
1:
|
|
29
29
|
id: CB1
|
|
30
|
+
scope: full_file
|
|
30
31
|
token_budget: 5000
|
|
31
32
|
description: >-
|
|
32
33
|
Maximum tokens for CHANGELOG.md content. Exceeding triggers compaction.
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
# Decisions Artifact Schema
|
|
2
2
|
#
|
|
3
|
-
# Reasoning trail maintained by
|
|
4
|
-
# one entry. Decisions are referenced by
|
|
3
|
+
# Reasoning trail maintained by discuss. Each deliberation session appends
|
|
4
|
+
# one entry. Decisions are referenced by build, optimize, and profile
|
|
5
5
|
# for context on why choices were made.
|
|
6
6
|
#
|
|
7
|
-
#
|
|
8
|
-
#
|
|
7
|
+
# The active authority uses writer-owned decision, revision, and satisfaction
|
|
8
|
+
# entity files. The numbered projection model below is retained only as an exact
|
|
9
|
+
# legacy migration input schema; it is not an ordinary post-cutover contract.
|
|
9
10
|
#
|
|
10
11
|
# ── Field-by-field mapping: v1 DECISIONS.md → v2 decisions.yaml ──
|
|
11
12
|
#
|
|
@@ -32,16 +33,28 @@ meta:
|
|
|
32
33
|
name: decisions
|
|
33
34
|
version: "1.0.0"
|
|
34
35
|
description: >-
|
|
35
|
-
Reasoning trail maintained by
|
|
36
|
-
appends one entry. Decisions are referenced by
|
|
37
|
-
|
|
38
|
-
and
|
|
36
|
+
Reasoning trail maintained by discuss. Each deliberation session
|
|
37
|
+
appends one entry. Decisions are referenced by build, optimize,
|
|
38
|
+
profile, plan, audit, status, document, vision, discuss,
|
|
39
|
+
and orchestrate for context on why choices were made.
|
|
39
40
|
artifact_type: agent_facing
|
|
40
41
|
path: ".agentera/decisions.yaml"
|
|
41
|
-
|
|
42
|
-
|
|
42
|
+
authority: legacy_migration_input_only
|
|
43
|
+
producer: discuss
|
|
44
|
+
consumers: [document, status, audit, optimize, orchestrate, plan, profile, build, discuss, vision]
|
|
43
45
|
format: yaml
|
|
44
46
|
|
|
47
|
+
ENTITY_AUTHORITY:
|
|
48
|
+
identity_fields: [id, artifact]
|
|
49
|
+
artifact: decisions
|
|
50
|
+
boundaries: [decision, decision_revision, decision_satisfaction]
|
|
51
|
+
retrieval:
|
|
52
|
+
list: npx -y agentera@next state decisions list --format json
|
|
53
|
+
get: npx -y agentera@next state decisions get --id ID --format json
|
|
54
|
+
mutation: npx -y agentera@next state decisions explain --format json
|
|
55
|
+
direct_file_edits: forbidden
|
|
56
|
+
legacy_schema_below: migration_input_only
|
|
57
|
+
|
|
45
58
|
GROUP_PREFIXES:
|
|
46
59
|
BUDGET: DB
|
|
47
60
|
COMPACTION: DX
|
|
@@ -69,10 +82,10 @@ BUDGET:
|
|
|
69
82
|
COMPACTION:
|
|
70
83
|
1:
|
|
71
84
|
id: DX1
|
|
72
|
-
rule:
|
|
85
|
+
rule: lossless_projection
|
|
73
86
|
description: >-
|
|
74
|
-
|
|
75
|
-
|
|
87
|
+
The 10/40/50 values are current projection defaults, not deletion limits.
|
|
88
|
+
Numbered archive records remain complete and unlimited.
|
|
76
89
|
2:
|
|
77
90
|
id: DX2
|
|
78
91
|
full_detail:
|
|
@@ -93,21 +106,26 @@ COMPACTION:
|
|
|
93
106
|
the archive section. Compact summaries preserve decision number, date,
|
|
94
107
|
and chosen alternative; structured compact fields preserve outcome and
|
|
95
108
|
explicit feeds_into references when present so CLI downstream references
|
|
96
|
-
remain non-inferential.
|
|
109
|
+
remain non-inferential. Entries beyond the summary default are represented
|
|
110
|
+
by omission metadata while their numbered archive records remain available.
|
|
97
111
|
4:
|
|
98
112
|
id: DX4
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
113
|
+
omission:
|
|
114
|
+
fields: [omitted, omitted_count, omission_reason, retrieval]
|
|
115
|
+
reason: projection_capacity_or_byte_budget
|
|
102
116
|
description: >-
|
|
103
|
-
|
|
117
|
+
Omitted projection detail is never silently deleted or truncated. The
|
|
118
|
+
numbered archive is the complete historical source and retrieval points
|
|
119
|
+
use the direct state get contract.
|
|
104
120
|
5:
|
|
105
121
|
id: DX5
|
|
106
|
-
trigger: "When
|
|
122
|
+
trigger: "When discuss writes a new decision"
|
|
107
123
|
description: >-
|
|
108
124
|
Compaction runs when the producing skill writes a new entry.
|
|
109
|
-
If >10 full-detail entries exist
|
|
110
|
-
|
|
125
|
+
If >10 full-detail entries exist and their numbered archives verify,
|
|
126
|
+
collapse the oldest to one-line. If >40 summary entries exist, omit the
|
|
127
|
+
oldest from this bounded projection with metadata; never delete its
|
|
128
|
+
numbered archive record. Unresolved review entries do not block storage.
|
|
111
129
|
6:
|
|
112
130
|
id: DX6
|
|
113
131
|
archive_section:
|