agentera 3.0.0-dev.8 → 3.0.0-dev.81
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 +252 -22
- package/bundle/.agentera-build-source.json +8 -0
- package/bundle/CHANGELOG.md +1389 -0
- package/bundle/DESIGN.md +229 -0
- package/bundle/LICENSE +201 -0
- package/bundle/README.md +142 -0
- package/bundle/UPGRADE.md +275 -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 +443 -188
- package/bundle/references/adapters/package-surface-characterization.md +68 -34
- package/bundle/references/adapters/product-v1-reset.yaml +101 -0
- 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 +357 -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 +262 -0
- package/bundle/references/artifacts/artifact-registry-interface-model.yaml +17 -8
- package/bundle/references/artifacts/glossary-entry-contract.yaml +2906 -0
- package/bundle/references/artifacts/state-storage-authority.yaml +3075 -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 +7 -5
- package/bundle/references/cli/vocabulary-index.yaml +7 -9
- package/bundle/references/cli/vocabulary.md +54 -97
- package/bundle/references/meta/retained-reference-authority.yaml +171 -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 +29 -30
- package/bundle/skills/agentera/schemas/artifacts/design.yaml +1 -0
- package/bundle/skills/agentera/schemas/artifacts/docs.yaml +7 -43
- package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +140 -34
- package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +87 -0
- package/bundle/skills/agentera/schemas/artifacts/health.yaml +53 -51
- package/bundle/skills/agentera/schemas/artifacts/objective.yaml +18 -35
- package/bundle/skills/agentera/schemas/artifacts/plan.yaml +453 -55
- package/bundle/skills/agentera/schemas/artifacts/progress.yaml +128 -39
- package/bundle/skills/agentera/schemas/artifacts/todo.yaml +305 -7
- package/bundle/skills/agentera/schemas/artifacts/vision.yaml +0 -19
- 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 +788 -0
- package/dist/analytics/personalGlossaryCandidateProjectionExcerpts.js +144 -0
- package/dist/analytics/personalGlossaryCandidateProjectionModel.js +1 -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/personalGlossaryRefreshProjection.js +351 -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 +52 -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 +162 -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 +755 -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 +338 -0
- package/dist/cli/commands/prime/collectOrientationState.js +124 -68
- package/dist/cli/commands/prime/orientationOutput.js +271 -59
- package/dist/cli/commands/prime/types.js +0 -1
- package/dist/cli/commands/prime.js +89 -11
- package/dist/cli/commands/profileGrounding.js +55 -0
- package/dist/cli/commands/query.js +74 -52
- package/dist/cli/commands/report.js +187 -27
- 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 +459 -0
- package/dist/cli/commands/upgrade.js +176 -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 +84 -52
- package/dist/cli/dispatch/lifecycle.js +182 -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 +419 -41
- package/dist/cli/migrationRequired.js +125 -0
- package/dist/cli/orientation/attention.js +19 -22
- 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/productV1Eol.js +55 -0
- package/dist/cli/profileAcquisition.js +167 -0
- package/dist/cli/startupCompletenessContract.js +11 -9
- 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 +145 -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 +345 -0
- package/dist/registries/glossaryCandidateProjectionContract.js +108 -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 +168 -11
- 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 +618 -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 +894 -0
- package/dist/state/entityWriterLock.js +18 -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/todoCreateBatch.js +69 -0
- package/dist/state/todoDocsEntities.js +1339 -0
- package/dist/state/todoDocsEntityValidation.js +158 -0
- package/dist/state/todoMarkdownProjection.js +63 -0
- package/dist/state/todoReconciliationActivation.js +182 -0
- package/dist/state/todoReconciliationInspection.js +184 -0
- package/dist/state/todoReconciliationRepair.js +320 -0
- package/dist/state/todoReconciliationTransaction.js +628 -0
- package/dist/state/todoSeverityHeadings.js +71 -0
- package/dist/state/todoTransitionBatch.js +65 -0
- package/dist/state/todoUpdateBatch.js +50 -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 +380 -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 +133 -34
- package/dist/upgrade/lifecycleUpgrade.js +126 -0
- package/dist/upgrade/migrateArtifactsV2ToV3.js +325 -82
- package/dist/upgrade/migrationPublication.js +122 -0
- package/dist/upgrade/nextMajorDoctor.js +0 -22
- package/dist/upgrade/npxPlatformStatus.js +2 -2
- package/dist/upgrade/productV1Reset.js +515 -0
- package/dist/upgrade/productV1ResetAuthority.js +139 -0
- package/dist/upgrade/projectIntegration.js +126 -134
- package/dist/upgrade/projectIntegrationDecision.js +21 -13
- package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
- package/dist/upgrade/runtimeMigration.js +210 -430
- package/dist/upgrade/upgradeCommands.js +14 -1
- package/dist/upgrade/upgradeLock.js +85 -0
- package/dist/upgrade/upgradeOrchestrator.js +257 -48
- 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/glossaryVariantGuard.js +96 -0
- package/dist/validate/retainedReferenceAuthority.js +879 -0
- package/dist/validate/selfAudit.js +39 -45
- 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/index.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/plan/instructions.js.map +0 -1
- package/dist/capabilities/profile/instructions.js.map +0 -1
- package/dist/capabilities/research/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/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/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/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/types.js.map +0 -1
- package/dist/cli/commands/prime/v1Migration.js +0 -39
- 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/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/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/types.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/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/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/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/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/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
|
@@ -1,47 +1,25 @@
|
|
|
1
1
|
TRIGGERS:
|
|
2
2
|
1:
|
|
3
3
|
id: T1
|
|
4
|
-
description:
|
|
5
|
-
Direct invocation by name or slash command. Matches when the user
|
|
6
|
-
explicitly requests audit.
|
|
4
|
+
description: Audit local codebase health, architecture, quality, or technical debt.
|
|
7
5
|
priority: high
|
|
8
|
-
patterns:
|
|
9
|
-
- "audit"
|
|
10
|
-
- "/audit"
|
|
11
|
-
confidence_threshold: 60
|
|
12
|
-
borderline_band: 10
|
|
13
|
-
patterns_regex:
|
|
14
|
-
- "\\b/audit\\b"
|
|
15
6
|
2:
|
|
16
7
|
id: T2
|
|
17
|
-
description:
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
-
|
|
27
|
-
|
|
28
|
-
- "what needs fixing"
|
|
29
|
-
- "structural review"
|
|
30
|
-
- "pattern audit"
|
|
31
|
-
- "dependency check"
|
|
32
|
-
- "test coverage audit"
|
|
33
|
-
confidence_threshold: 55
|
|
8
|
+
description: Review the local repository's code, architecture, dependencies, or structural health.
|
|
9
|
+
priority: high
|
|
10
|
+
disambiguates_against:
|
|
11
|
+
- capability: research
|
|
12
|
+
hint: "audit reviews this local codebase; research analyzes an external source or repository"
|
|
13
|
+
- capability: document
|
|
14
|
+
hint: "audit owns code and architecture health; document owns documentation maintenance and docs audits"
|
|
15
|
+
- capability: design
|
|
16
|
+
hint: "audit owns code and architecture health; design owns visual identity and design-system review"
|
|
17
|
+
- capability: optimize
|
|
18
|
+
hint: "audit assesses local health; optimize improves an existing system against a measurable target"
|
|
34
19
|
3:
|
|
35
20
|
id: T3
|
|
36
|
-
description:
|
|
37
|
-
Implicit trigger after extended build activity. Matches when
|
|
38
|
-
build has run 5+ cycles without a health check and the system
|
|
39
|
-
detects an overdue audit.
|
|
21
|
+
description: Review local health after implementation activity reveals a need for assessment.
|
|
40
22
|
priority: medium
|
|
41
|
-
patterns:
|
|
42
|
-
- "health check overdue"
|
|
43
|
-
- "audit after build"
|
|
44
|
-
confidence_threshold: 50
|
|
45
23
|
disambiguates_against:
|
|
46
24
|
- capability: build
|
|
47
25
|
hint: "audit checks codebase health after build activity; build continues development"
|
|
@@ -24,9 +24,10 @@ VALIDATION:
|
|
|
24
24
|
id: V3
|
|
25
25
|
rule: decisions_respected
|
|
26
26
|
description: >-
|
|
27
|
-
Findings that contradict deliberate decisions
|
|
28
|
-
MUST be discarded or downgraded to info
|
|
29
|
-
not a finding; it is an
|
|
27
|
+
Findings that contradict deliberate decisions returned by the bounded
|
|
28
|
+
decisions entity view MUST be discarded or downgraded to info
|
|
29
|
+
(SF3). A deliberate decision is not a finding; it is an
|
|
30
|
+
implementation of that decision.
|
|
30
31
|
severity: critical
|
|
31
32
|
checks:
|
|
32
33
|
- "No finding contradicts a known deliberate decision"
|
|
@@ -65,25 +66,25 @@ VALIDATION:
|
|
|
65
66
|
id: V7
|
|
66
67
|
rule: evidence_context_first
|
|
67
68
|
description: >-
|
|
68
|
-
Audit evaluation startup MUST begin with `agentera prime --context
|
|
69
|
+
Audit evaluation startup MUST begin with `npx -y agentera@next prime --context
|
|
69
70
|
audit --format json` and use complete CLI `evidence_context` before
|
|
70
|
-
|
|
71
|
+
bounded state list/get contracts for plan, progress, docs, health, TODO,
|
|
72
|
+
or decisions. Raw artifact access is diagnostic-only.
|
|
71
73
|
severity: critical
|
|
72
74
|
checks:
|
|
73
|
-
- "Evidence context is requested through prime --context before
|
|
74
|
-
- "Complete evidence_context is used for evaluation target, criteria, evidence, caveats, and residual risks"
|
|
75
|
+
- "Evidence context is requested through prime --context before bounded state list/get"
|
|
75
76
|
8:
|
|
76
77
|
id: V8
|
|
77
78
|
rule: evidence_context_fallback_before_raw
|
|
78
79
|
description: >-
|
|
79
80
|
When evidence_context is absent, incomplete, or caveated for needed state,
|
|
80
|
-
|
|
81
|
-
|
|
81
|
+
Audit MUST run listed bounded CLI fallback commands before any
|
|
82
|
+
diagnostic-only raw artifact read.
|
|
82
83
|
severity: critical
|
|
83
84
|
checks:
|
|
84
|
-
- "evidence_context.fallback_commands are attempted before raw
|
|
85
|
+
- "evidence_context.fallback_commands are attempted before diagnostic-only raw reads"
|
|
85
86
|
- "capability_context.state.fallback_commands is used when evidence_context is unavailable"
|
|
86
|
-
- "Raw artifact reads are
|
|
87
|
+
- "Raw artifact reads are diagnostic-only, not normal evaluation startup"
|
|
87
88
|
9:
|
|
88
89
|
id: V9
|
|
89
90
|
rule: evidence_context_caveats_preserved
|
|
@@ -111,3 +112,21 @@ VALIDATION:
|
|
|
111
112
|
- "Provisional satisfaction requires evidence"
|
|
112
113
|
- "Only the user confirms final satisfaction"
|
|
113
114
|
- "Missing or compacted satisfaction caveats are preserved"
|
|
115
|
+
11:
|
|
116
|
+
id: V11
|
|
117
|
+
rule: terminology_drift_read_only
|
|
118
|
+
description: >-
|
|
119
|
+
Terminology-drift findings MUST cite every variant with verified
|
|
120
|
+
project-relative file and line evidence. Canonical terms are proposals,
|
|
121
|
+
never decisions or writes. Optional personal-profile divergence is
|
|
122
|
+
comparison evidence only; missing profile evidence produces no claim.
|
|
123
|
+
Audit remains mutation-free and read-only. Build project-glossary
|
|
124
|
+
publication is active. Audit performs no consumer lookup; Discuss, Plan,
|
|
125
|
+
and Build use the separate active read-only advice path. Personal-profile
|
|
126
|
+
mutation and docs-mapping mutation remain outside both paths.
|
|
127
|
+
severity: critical
|
|
128
|
+
checks:
|
|
129
|
+
- "Every reported drift variant has project-file evidence"
|
|
130
|
+
- "Weak, deliberate, tracked, and no-drift candidates produce no finding"
|
|
131
|
+
- "Audit mutates no glossary, profile, docs mapping, code, or project file"
|
|
132
|
+
- "Build publication and read-only glossary consumers are active under separate mutation boundaries"
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
ARTIFACTS:
|
|
2
2
|
1:
|
|
3
3
|
id: A1
|
|
4
|
-
|
|
4
|
+
artifact: vision
|
|
5
5
|
local_role: produces_and_consumes
|
|
6
6
|
description: >-
|
|
7
7
|
Build consumes this through CLI execution_context caveats or explicit
|
|
8
8
|
fallback state when available, and never modifies it during cycles. Created
|
|
9
|
-
during
|
|
9
|
+
during vision bootstrap.
|
|
10
10
|
2:
|
|
11
11
|
id: A2
|
|
12
|
-
|
|
12
|
+
artifact: todo
|
|
13
13
|
local_role: produces_and_consumes
|
|
14
14
|
description: >-
|
|
15
15
|
Build consumes TODO state from execution_context and included status state
|
|
@@ -17,7 +17,7 @@ ARTIFACTS:
|
|
|
17
17
|
entries. Severity classified per protocol SI1-SI4.
|
|
18
18
|
3:
|
|
19
19
|
id: A3
|
|
20
|
-
|
|
20
|
+
artifact: changelog
|
|
21
21
|
local_role: produces_and_consumes
|
|
22
22
|
description: >-
|
|
23
23
|
Build consumes changelog boundary from execution_context or the listed
|
|
@@ -25,31 +25,38 @@ ARTIFACTS:
|
|
|
25
25
|
[Unreleased] based on commit type and promotes on version bumps.
|
|
26
26
|
4:
|
|
27
27
|
id: A4
|
|
28
|
-
|
|
28
|
+
artifact: progress
|
|
29
29
|
local_role: produces_and_consumes
|
|
30
30
|
description: >-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
31
|
+
Durable project-outcome log and the sole durable channel for bounded
|
|
32
|
+
autonomous glossary caveat lifecycle evidence. Build consumes latest
|
|
33
|
+
progress evidence from execution_context first, then bounded `npx -y
|
|
34
|
+
agentera@next state progress list --limit 20 --format json` discovery or
|
|
35
|
+
exact `state progress get --id ID` retrieval. The typed writer's
|
|
36
|
+
progress_write_policy governs whether a cycle appends zero or one record;
|
|
37
|
+
every appended cycle has a mandatory non-empty verified field.
|
|
34
38
|
5:
|
|
35
39
|
id: A5
|
|
36
|
-
|
|
40
|
+
artifact: health
|
|
37
41
|
local_role: consumes
|
|
38
42
|
description: >-
|
|
39
43
|
Build consumes health state from execution_context and included status
|
|
40
|
-
state before
|
|
41
|
-
|
|
44
|
+
state before bounded `npx -y agentera@next state health list --limit 20 --format json`
|
|
45
|
+
discovery or exact `state health get --id ID` retrieval, focusing on
|
|
46
|
+
critical and degraded findings for work selection. Raw reads are
|
|
47
|
+
diagnostic-only for corruption or CLI-defect investigation.
|
|
42
48
|
6:
|
|
43
49
|
id: A6
|
|
44
|
-
|
|
50
|
+
artifact: decisions
|
|
45
51
|
local_role: consumes
|
|
46
52
|
description: >-
|
|
47
|
-
Build consumes decision caveats and fallback commands from
|
|
53
|
+
Build consumes decision caveats and bounded list/get fallback commands from
|
|
48
54
|
execution_context first. Firm (DL1) entries are constraints and exploratory
|
|
49
|
-
(DL3) entries are uncertain foundations during work selection.
|
|
55
|
+
(DL3) entries are uncertain foundations during work selection. Raw reads are
|
|
56
|
+
diagnostic-only for corruption or CLI-defect investigation.
|
|
50
57
|
7:
|
|
51
58
|
id: A7
|
|
52
|
-
|
|
59
|
+
artifact: plan
|
|
53
60
|
local_role: produces_and_consumes
|
|
54
61
|
description: >-
|
|
55
62
|
Build consumes selected task, acceptance criteria, dependencies,
|
|
@@ -57,24 +64,40 @@ ARTIFACTS:
|
|
|
57
64
|
direct plan reads, then updates task status and surprises during execution.
|
|
58
65
|
8:
|
|
59
66
|
id: A8
|
|
60
|
-
|
|
67
|
+
artifact: profile
|
|
61
68
|
local_role: consumes
|
|
62
69
|
description: >-
|
|
63
|
-
Build consumes status profile summary first
|
|
64
|
-
|
|
65
|
-
|
|
70
|
+
Build consumes status profile summary first and reads profile grounding
|
|
71
|
+
only from `npx -y agentera@next report profile-grounding --format json` when shared
|
|
72
|
+
validity is `valid`. Absent or repair-needed state preserves exact
|
|
73
|
+
recovery and does not authorize refresh or direct profile reads.
|
|
66
74
|
9:
|
|
67
75
|
id: A9
|
|
68
|
-
|
|
76
|
+
artifact: docs
|
|
69
77
|
local_role: consumes
|
|
70
78
|
description: >-
|
|
71
79
|
Build consumes artifact mappings and docs caveats from execution_context
|
|
72
80
|
and included status docs state before direct docs reads.
|
|
73
81
|
10:
|
|
74
82
|
id: A10
|
|
75
|
-
|
|
83
|
+
artifact: design
|
|
76
84
|
local_role: consumes
|
|
77
85
|
description: >-
|
|
78
86
|
Build treats design state missing from execution_context as a caveat or
|
|
79
87
|
fallback-only need, and reads it only when building user-facing features
|
|
80
88
|
after listed CLI fallbacks are exhausted.
|
|
89
|
+
11:
|
|
90
|
+
id: A11
|
|
91
|
+
artifact: glossary
|
|
92
|
+
local_role: produces_and_consumes
|
|
93
|
+
description: >-
|
|
94
|
+
Build alone publishes one explicitly user-confirmed terminology proposal
|
|
95
|
+
through `npx -y agentera@next state glossary publish --input REQUEST`. The typed writer
|
|
96
|
+
revalidates audit source evidence and atomically records the immutable
|
|
97
|
+
approval beside the shared-only project entry. Build does not consume the
|
|
98
|
+
glossary only to validate replay and preserve unrelated publication state.
|
|
99
|
+
Separately, at governed meaning-sensitive Build events it requests bounded
|
|
100
|
+
read-only advice through `npx -y agentera@next report glossary-advice --input REQUEST
|
|
101
|
+
--format json`. Advice and progress caveats never publish terminology,
|
|
102
|
+
approve a proposal, reuse confirmation, mutate personal profiles or docs
|
|
103
|
+
mappings, or grant publication authority to another capability.
|
|
@@ -3,9 +3,11 @@ EXIT_CONDITIONS:
|
|
|
3
3
|
id: E1
|
|
4
4
|
condition: complete
|
|
5
5
|
description: >-
|
|
6
|
-
One full cycle completed. Work was selected, implemented, verified
|
|
7
|
-
against the project's test/build suite
|
|
8
|
-
|
|
6
|
+
One full cycle completed. Work was selected, implemented, and verified
|
|
7
|
+
against the project's test/build suite. Required artifact updates
|
|
8
|
+
preceded the cycle's single conventional commit. They include TODO,
|
|
9
|
+
changelog, and plan updates. Progress is present for policy-required
|
|
10
|
+
cases and optional for allowed durable outcomes.
|
|
9
11
|
exit_signal: complete
|
|
10
12
|
2:
|
|
11
13
|
id: E2
|
|
@@ -13,15 +15,15 @@ EXIT_CONDITIONS:
|
|
|
13
15
|
description: >-
|
|
14
16
|
The cycle completed but with notable issues. Possible causes:
|
|
15
17
|
verification passed but with warnings, the committed work is narrower
|
|
16
|
-
than intended due to scope reduction, or discoveries
|
|
17
|
-
|
|
18
|
+
than intended due to scope reduction, or durable discoveries recorded in
|
|
19
|
+
progress state suggest the next cycle may face blockers.
|
|
18
20
|
exit_signal: flagged
|
|
19
21
|
3:
|
|
20
22
|
id: E3
|
|
21
23
|
condition: stuck
|
|
22
24
|
description: >-
|
|
23
25
|
Cannot complete a cycle because VISION.md does not exist and the
|
|
24
|
-
|
|
26
|
+
vision bootstrap cannot proceed without the user, every available work item
|
|
25
27
|
is blocked, or the verification suite is broken and cannot be fixed
|
|
26
28
|
within the cycle's scope.
|
|
27
29
|
exit_signal: stuck
|
|
@@ -1,49 +1,27 @@
|
|
|
1
1
|
TRIGGERS:
|
|
2
2
|
1:
|
|
3
3
|
id: T1
|
|
4
|
-
description:
|
|
5
|
-
Direct invocation by name or slash command. Matches when the user
|
|
6
|
-
explicitly requests build for autonomous development.
|
|
4
|
+
description: A scoped implementation task or one verified development cycle.
|
|
7
5
|
priority: high
|
|
8
|
-
patterns:
|
|
9
|
-
- "build"
|
|
10
|
-
- "/build"
|
|
11
|
-
confidence_threshold: 60
|
|
12
|
-
borderline_band: 10
|
|
13
6
|
2:
|
|
14
7
|
id: T2
|
|
15
|
-
description:
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
confidence_threshold: 50
|
|
8
|
+
description: Implement one requested feature, fix, or bounded development task.
|
|
9
|
+
priority: high
|
|
10
|
+
disambiguates_against:
|
|
11
|
+
- capability: vision
|
|
12
|
+
hint: "build implements code; vision defines or refines project direction"
|
|
13
|
+
- capability: profile
|
|
14
|
+
hint: "build implements a software task; profile builds a reusable decision profile"
|
|
15
|
+
- capability: orchestrate
|
|
16
|
+
hint: "build completes one task or cycle; orchestrate runs an entire plan or multiple tasks"
|
|
25
17
|
3:
|
|
26
18
|
id: T3
|
|
27
|
-
description:
|
|
28
|
-
Continuous development signals. Matches when the user wants ongoing
|
|
29
|
-
building or to start working on the project.
|
|
19
|
+
description: Start or continue a single concrete implementation task.
|
|
30
20
|
priority: medium
|
|
31
|
-
patterns:
|
|
32
|
-
- "keep building"
|
|
33
|
-
- "start building"
|
|
34
|
-
- "work on the project"
|
|
35
|
-
confidence_threshold: 50
|
|
36
21
|
4:
|
|
37
22
|
id: T4
|
|
38
|
-
description:
|
|
39
|
-
Vision refinement within a development context. Matches when the user
|
|
40
|
-
wants to refine the project vision as part of a development session.
|
|
23
|
+
description: Implement a scoped task after its plan or requirements are established.
|
|
41
24
|
priority: medium
|
|
42
|
-
patterns:
|
|
43
|
-
- "refine the vision"
|
|
44
|
-
confidence_threshold: 50
|
|
45
25
|
disambiguates_against:
|
|
46
|
-
- capability:
|
|
47
|
-
hint: "build implements
|
|
48
|
-
patterns_regex:
|
|
49
|
-
- "\\brefine\\s+the\\s+vision\\b"
|
|
26
|
+
- capability: plan
|
|
27
|
+
hint: "build implements an established task; plan structures work before implementation"
|
|
@@ -3,9 +3,10 @@ VALIDATION:
|
|
|
3
3
|
id: V1
|
|
4
4
|
rule: verified_field_mandatory
|
|
5
5
|
description: >-
|
|
6
|
-
Every
|
|
7
|
-
carries either observed output from the primary
|
|
8
|
-
N/A tag, or a free-form rationale of at least 8
|
|
6
|
+
Every progress entity record appended by Build MUST have a non-empty
|
|
7
|
+
verified field. The field carries either observed output from the primary
|
|
8
|
+
entrypoint, an allowlisted N/A tag, or a free-form rationale of at least 8
|
|
9
|
+
words.
|
|
9
10
|
severity: critical
|
|
10
11
|
checks:
|
|
11
12
|
- "Every cycle entry has a verified field"
|
|
@@ -14,17 +15,22 @@ VALIDATION:
|
|
|
14
15
|
id: V2
|
|
15
16
|
rule: one_cycle_per_invocation
|
|
16
17
|
description: >-
|
|
17
|
-
Build executes exactly one cycle per invocation. After logging
|
|
18
|
-
|
|
19
|
-
|
|
18
|
+
Build executes exactly one cycle per invocation. After logging required
|
|
19
|
+
artifacts (Step 7) and committing once (Step 8), the capability MUST stop.
|
|
20
|
+
The typed progress_write_policy determines whether the cycle appends zero
|
|
21
|
+
or one progress record. Multiple cycles require separate invocations or an
|
|
22
|
+
explicit user request.
|
|
20
23
|
severity: critical
|
|
21
24
|
checks:
|
|
22
|
-
- "
|
|
25
|
+
- "At most one progress entity is appended per invocation"
|
|
26
|
+
- "Durable outcomes needed by future work may append one verified record"
|
|
27
|
+
- "Required glossary caveats and plan-completion sweeps append one verified record"
|
|
28
|
+
- "Attempt-only cycles with no durable project truth append no record"
|
|
23
29
|
3:
|
|
24
30
|
id: V3
|
|
25
31
|
rule: no_remote_push
|
|
26
32
|
description: >-
|
|
27
|
-
Build MUST
|
|
33
|
+
Build MUST NOT push to any remote repository. All commits are local
|
|
28
34
|
only. Remote operations require explicit user instruction outside this
|
|
29
35
|
capability.
|
|
30
36
|
severity: critical
|
|
@@ -35,36 +41,38 @@ VALIDATION:
|
|
|
35
41
|
rule: vision_readonly_during_cycle
|
|
36
42
|
description: >-
|
|
37
43
|
The canonical vision artifact MUST NOT be modified during a cycle. It may only be written
|
|
38
|
-
during a
|
|
44
|
+
during a vision bootstrap.
|
|
39
45
|
severity: critical
|
|
40
46
|
checks:
|
|
41
47
|
- "Vision artifact not modified outside brainstorm"
|
|
42
48
|
5:
|
|
43
49
|
id: V5
|
|
44
|
-
rule:
|
|
50
|
+
rule: attempt_history_authority
|
|
45
51
|
description: >-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
52
|
+
Build MUST NOT reconstruct task or release attempt history from progress.
|
|
53
|
+
Plan evaluations own task attempts, while qualification and publication
|
|
54
|
+
receipts own release attempts and retry state. Missing retry state does
|
|
55
|
+
not authorize an attempt-only progress record.
|
|
49
56
|
severity: critical
|
|
50
57
|
checks:
|
|
51
|
-
- "
|
|
58
|
+
- "Progress is not used as task or release attempt history"
|
|
59
|
+
- "Retry state comes only from its owning plan or receipt authority"
|
|
52
60
|
6:
|
|
53
61
|
id: V6
|
|
54
62
|
rule: artifact_path_resolution
|
|
55
63
|
description: >-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
other agent-facing artifacts as YAML in .agentera/).
|
|
64
|
+
Entity state MUST use exact/list CLI reads and typed writers discovered by
|
|
65
|
+
`npx -y agentera@next state <artifact> explain`. Check .agentera/docs.yaml only for
|
|
66
|
+
intentional singleton path overrides.
|
|
60
67
|
severity: warning
|
|
61
68
|
checks:
|
|
62
|
-
- "
|
|
69
|
+
- "Entity files are not read or edited directly"
|
|
70
|
+
- "docs.yaml checked before singleton artifact access"
|
|
63
71
|
7:
|
|
64
72
|
id: V7
|
|
65
73
|
rule: execution_context_first
|
|
66
74
|
description: >-
|
|
67
|
-
Build startup SHOULD begin from `agentera prime --context build
|
|
75
|
+
Build startup SHOULD begin from `npx -y agentera@next prime --context build
|
|
68
76
|
--format json` and consume complete execution_context
|
|
69
77
|
state before direct reads of plan, progress, TODO, docs, health,
|
|
70
78
|
decisions, changelog, vision, profile, or design artifacts.
|
|
@@ -93,7 +101,7 @@ VALIDATION:
|
|
|
93
101
|
severity: critical
|
|
94
102
|
checks:
|
|
95
103
|
- "No protected state mutation during context generation"
|
|
96
|
-
- "No unsupported `agentera build`
|
|
104
|
+
- "No unsupported `agentera build` command introduced"
|
|
97
105
|
10:
|
|
98
106
|
id: V10
|
|
99
107
|
rule: satisfaction_authority_boundary
|
|
@@ -108,3 +116,69 @@ VALIDATION:
|
|
|
108
116
|
- "Provisional satisfaction requires evidence"
|
|
109
117
|
- "Only the user confirms final satisfaction"
|
|
110
118
|
- "Missing or compacted satisfaction caveats are preserved"
|
|
119
|
+
11:
|
|
120
|
+
id: V11
|
|
121
|
+
rule: sanitized_profile_grounding
|
|
122
|
+
description: >-
|
|
123
|
+
Build MUST ground only from the `content` returned by `npx -y agentera@next report
|
|
124
|
+
profile-grounding --format json` when shared validity is valid; it MUST
|
|
125
|
+
preserve absent/repair-needed recovery and MUST NOT direct-read PROFILE.md.
|
|
126
|
+
severity: critical
|
|
127
|
+
checks:
|
|
128
|
+
- "Sanitized grounding command used after prime startup"
|
|
129
|
+
- "Prime and report validity objects agree before content use"
|
|
130
|
+
- "Raw profile path not read"
|
|
131
|
+
12:
|
|
132
|
+
id: V12
|
|
133
|
+
rule: governed_glossary_advice
|
|
134
|
+
description: >-
|
|
135
|
+
At initial meaning-sensitive cycle intent and later user-authored changes
|
|
136
|
+
or clarification answers that can alter intent, Build MUST request bounded
|
|
137
|
+
advice through `npx -y agentera@next report glossary-advice --input REQUEST --format
|
|
138
|
+
json`. Unchanged replay, unrelated turns, rendering, and tool output MUST
|
|
139
|
+
NOT refresh advice.
|
|
140
|
+
severity: critical
|
|
141
|
+
checks:
|
|
142
|
+
- "Exact project authority or proven-gap personal fallback grounds intent"
|
|
143
|
+
- "Governed changes refresh only the affected meaning"
|
|
144
|
+
- "Incidental turns and unchanged replay do not refresh"
|
|
145
|
+
13:
|
|
146
|
+
id: V13
|
|
147
|
+
rule: glossary_review_and_autonomy
|
|
148
|
+
description: >-
|
|
149
|
+
Interactive Build MUST ask one focused clarification before disputed
|
|
150
|
+
meaning-sensitive reliance whenever review is required. If autonomous Build
|
|
151
|
+
cannot pause, it MUST avoid the disputed meaning, proceed conservatively
|
|
152
|
+
only where safe, and append one idempotent privacy-safe glossary_caveat
|
|
153
|
+
lifecycle envelope through the typed progress writer.
|
|
154
|
+
severity: critical
|
|
155
|
+
checks:
|
|
156
|
+
- "Clarification precedes meaning-sensitive execution and re-evaluates only the affected meaning"
|
|
157
|
+
- "Autonomous work does not assume disputed meaning"
|
|
158
|
+
- "Current, resolved, and superseded caveat events obey opaque identity lifecycle"
|
|
159
|
+
14:
|
|
160
|
+
id: V14
|
|
161
|
+
rule: glossary_publication_isolation
|
|
162
|
+
description: >-
|
|
163
|
+
Advice, tension, clarification, and progress caveat lifecycle MUST NOT call
|
|
164
|
+
`npx -y agentera@next state glossary publish`, create or reuse approval, substitute for
|
|
165
|
+
digest-bound user confirmation, satisfy decisions or plan state, or grant
|
|
166
|
+
Discuss or Audit publication authority.
|
|
167
|
+
severity: critical
|
|
168
|
+
checks:
|
|
169
|
+
- "Advice and caveat paths perform zero glossary publication writes"
|
|
170
|
+
- "Only separately supplied digest-confirmed publication retains Build authority"
|
|
171
|
+
15:
|
|
172
|
+
id: V15
|
|
173
|
+
rule: transient_no_plan_execution_input
|
|
174
|
+
description: >-
|
|
175
|
+
When no current executable plan owns startup, Build MAY accept one bounded
|
|
176
|
+
`agentera.buildExecutionRequest.v1` through `prime --context build --input
|
|
177
|
+
<file|-> --format json`. The request supplies explicit scope and acceptance
|
|
178
|
+
transiently; it MUST NOT persist, create, or mutate plan state. Current
|
|
179
|
+
plan-owned execution conflicts instead of silently ignoring the request.
|
|
180
|
+
severity: critical
|
|
181
|
+
checks:
|
|
182
|
+
- "Transient input is used only when no current executable plan owns startup"
|
|
183
|
+
- "No request content is placed in argv or persisted"
|
|
184
|
+
- "No-plan execution requires explicit scope and acceptance"
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
ARTIFACTS:
|
|
2
2
|
1:
|
|
3
3
|
id: A1
|
|
4
|
-
|
|
4
|
+
artifact: design
|
|
5
5
|
local_role: produces_and_consumes
|
|
6
6
|
description: >-
|
|
7
7
|
Visual identity system with design tokens, typography, colors,
|
|
@@ -9,35 +9,35 @@ ARTIFACTS:
|
|
|
9
9
|
reads agent-readable YAML token blocks with HTML comment markers.
|
|
10
10
|
2:
|
|
11
11
|
id: A2
|
|
12
|
-
|
|
12
|
+
artifact: vision
|
|
13
13
|
local_role: consumes
|
|
14
14
|
description: >-
|
|
15
15
|
Design reads the Identity section to propose visual tokens
|
|
16
16
|
coherent with the declared verbal personality.
|
|
17
17
|
3:
|
|
18
18
|
id: A3
|
|
19
|
-
|
|
19
|
+
artifact: progress
|
|
20
20
|
local_role: consumes
|
|
21
21
|
description: >-
|
|
22
22
|
Design reads this during refine mode to identify UI work and
|
|
23
23
|
inline design decisions since the design system was written.
|
|
24
24
|
4:
|
|
25
25
|
id: A4
|
|
26
|
-
|
|
26
|
+
artifact: todo
|
|
27
27
|
local_role: produces_and_consumes
|
|
28
28
|
description: >-
|
|
29
29
|
Design reads this to check for design-related issues and files
|
|
30
30
|
code drift findings here during audit mode.
|
|
31
31
|
5:
|
|
32
32
|
id: A5
|
|
33
|
-
|
|
33
|
+
artifact: docs
|
|
34
34
|
local_role: consumes
|
|
35
35
|
description: >-
|
|
36
36
|
Design reads this first to resolve project-local artifact mappings
|
|
37
37
|
before accessing other artifacts.
|
|
38
38
|
6:
|
|
39
39
|
id: A6
|
|
40
|
-
|
|
40
|
+
artifact: profile
|
|
41
41
|
local_role: consumes
|
|
42
42
|
description: >-
|
|
43
43
|
Design reads aesthetic preferences from the profile as defaults
|
|
@@ -4,16 +4,16 @@ EXIT_CONDITIONS:
|
|
|
4
4
|
condition: complete
|
|
5
5
|
description: >-
|
|
6
6
|
DESIGN.md was written (Create/Replace mode), updated (Refine mode),
|
|
7
|
-
or audited with findings reported (Audit mode).
|
|
8
|
-
|
|
7
|
+
or audited with findings reported (Audit mode). npx -y agentera@next check lint
|
|
8
|
+
--artifact design passed, and all changes had explicit user approval.
|
|
9
9
|
exit_signal: complete
|
|
10
10
|
2:
|
|
11
11
|
id: E2
|
|
12
12
|
condition: flagged
|
|
13
13
|
description: >-
|
|
14
14
|
The design system was produced or audited but with issues worth
|
|
15
|
-
surfacing. Possible causes:
|
|
16
|
-
the design drifts from
|
|
15
|
+
surfacing. Possible causes: lint passed with advisory warnings,
|
|
16
|
+
the design drifts from vision Identity, or audit findings were
|
|
17
17
|
neither fixed nor filed.
|
|
18
18
|
exit_signal: flagged
|
|
19
19
|
3:
|
|
@@ -21,7 +21,7 @@ EXIT_CONDITIONS:
|
|
|
21
21
|
condition: stuck
|
|
22
22
|
description: >-
|
|
23
23
|
Cannot write DESIGN.md because the user declined to approve the
|
|
24
|
-
draft,
|
|
24
|
+
draft, npx -y agentera@next check lint reports unresolvable errors, or the
|
|
25
25
|
project's UI stack is inaccessible.
|
|
26
26
|
exit_signal: stuck
|
|
27
27
|
4:
|
|
@@ -1,45 +1,16 @@
|
|
|
1
1
|
TRIGGERS:
|
|
2
2
|
1:
|
|
3
3
|
id: T1
|
|
4
|
-
description:
|
|
5
|
-
Direct invocation by name or slash command. Matches when the user
|
|
6
|
-
explicitly requests design.
|
|
4
|
+
description: Define, maintain, or assess visual identity and a design system.
|
|
7
5
|
priority: high
|
|
8
|
-
patterns:
|
|
9
|
-
- "design"
|
|
10
|
-
- "/design"
|
|
11
|
-
confidence_threshold: 60
|
|
12
|
-
borderline_band: 10
|
|
13
|
-
patterns_regex:
|
|
14
|
-
- "\\b/design\\b"
|
|
15
6
|
2:
|
|
16
7
|
id: T2
|
|
17
|
-
description:
|
|
18
|
-
|
|
19
|
-
create or set up a visual identity system or design tokens.
|
|
20
|
-
priority: medium
|
|
21
|
-
patterns:
|
|
22
|
-
- "create design system"
|
|
23
|
-
- "write DESIGN.md"
|
|
24
|
-
- "design tokens"
|
|
25
|
-
- "visual identity"
|
|
26
|
-
- "define the aesthetic"
|
|
27
|
-
- "set up design system"
|
|
28
|
-
confidence_threshold: 50
|
|
8
|
+
description: Create a visual identity, design system, design tokens, or aesthetic direction.
|
|
9
|
+
priority: high
|
|
29
10
|
3:
|
|
30
11
|
id: T3
|
|
31
|
-
description:
|
|
32
|
-
|
|
33
|
-
wants to evolve, check, or update an existing design system.
|
|
34
|
-
priority: medium
|
|
35
|
-
patterns:
|
|
36
|
-
- "audit design"
|
|
37
|
-
- "refine design system"
|
|
38
|
-
- "update DESIGN.md"
|
|
39
|
-
confidence_threshold: 50
|
|
12
|
+
description: Refine, update, or audit a visual design system, including “audit the design system”.
|
|
13
|
+
priority: high
|
|
40
14
|
disambiguates_against:
|
|
41
15
|
- capability: audit
|
|
42
16
|
hint: "design here is about visual identity, not codebase auditing"
|
|
43
|
-
patterns_regex:
|
|
44
|
-
- "\\baudit\\s+design\\b"
|
|
45
|
-
- "update\\s+DESIGN\\.md"
|