principles-disciple 1.127.0 → 1.129.0
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/dist/commands/archive-impl.d.ts +18 -0
- package/dist/commands/archive-impl.js +105 -0
- package/dist/commands/capabilities.d.ts +3 -0
- package/dist/commands/capabilities.js +76 -0
- package/dist/commands/context.d.ts +5 -0
- package/{src/commands/context.ts → dist/commands/context.js} +34 -83
- package/dist/commands/disable-impl.d.ts +22 -0
- package/dist/commands/disable-impl.js +118 -0
- package/dist/commands/evolution-status.d.ts +4 -0
- package/dist/commands/evolution-status.js +187 -0
- package/dist/commands/export.d.ts +2 -0
- package/dist/commands/export.js +53 -0
- package/dist/commands/focus.d.ts +14 -0
- package/dist/commands/focus.js +443 -0
- package/dist/commands/pain.d.ts +6 -0
- package/{src/commands/pain.ts → dist/commands/pain.js} +137 -188
- package/dist/commands/principle-rollback.d.ts +4 -0
- package/dist/commands/principle-rollback.js +26 -0
- package/dist/commands/promote-impl.d.ts +22 -0
- package/dist/commands/promote-impl.js +194 -0
- package/dist/commands/rollback-impl.d.ts +32 -0
- package/dist/commands/rollback-impl.js +180 -0
- package/dist/commands/rollback.d.ts +19 -0
- package/{src/commands/rollback.ts → dist/commands/rollback.js} +10 -53
- package/dist/commands/samples.d.ts +2 -0
- package/dist/commands/samples.js +58 -0
- package/dist/commands/strategy.d.ts +2 -0
- package/dist/commands/strategy.js +16 -0
- package/dist/commands/thinking-os.d.ts +2 -0
- package/{src/commands/thinking-os.ts → dist/commands/thinking-os.js} +35 -58
- package/dist/commands/workflow-debug.d.ts +6 -0
- package/{src/commands/workflow-debug.ts → dist/commands/workflow-debug.js} +13 -33
- package/dist/config/defaults/runtime.d.ts +58 -0
- package/{src/config/defaults/runtime.ts → dist/config/defaults/runtime.js} +4 -41
- package/dist/config/errors.d.ts +86 -0
- package/dist/config/errors.js +107 -0
- package/{src/config/index.ts → dist/config/index.d.ts} +1 -2
- package/dist/config/index.js +7 -0
- package/dist/constants/diagnostician.d.ts +12 -0
- package/{src/constants/diagnostician.ts → dist/constants/diagnostician.js} +0 -1
- package/dist/constants/tools.d.ts +17 -0
- package/dist/constants/tools.js +53 -0
- package/dist/core/__tests__/focus-history.test.d.ts +1 -0
- package/dist/core/__tests__/focus-history.test.js +160 -0
- package/dist/core/bootstrap-rules.d.ts +50 -0
- package/dist/core/bootstrap-rules.js +187 -0
- package/dist/core/code-implementation-storage.d.ts +71 -0
- package/dist/core/code-implementation-storage.js +139 -0
- package/dist/core/config-health.d.ts +27 -0
- package/dist/core/config-health.js +60 -0
- package/dist/core/config-service.d.ts +15 -0
- package/{src/core/config-service.ts → dist/core/config-service.js} +4 -7
- package/dist/core/config.d.ts +111 -0
- package/{src/core/config.ts → dist/core/config.js} +46 -146
- package/dist/core/control-ui-db.d.ts +106 -0
- package/dist/core/control-ui-db.js +309 -0
- package/dist/core/correction-cue-learner.d.ts +33 -0
- package/dist/core/correction-cue-learner.js +184 -0
- package/dist/core/correction-types.d.ts +3 -0
- package/dist/core/correction-types.js +1 -0
- package/dist/core/detection-funnel.d.ts +33 -0
- package/{src/core/detection-funnel.ts → dist/core/detection-funnel.js} +17 -37
- package/dist/core/detection-service.d.ts +15 -0
- package/{src/core/detection-service.ts → dist/core/detection-service.js} +4 -7
- package/dist/core/dictionary-service.d.ts +15 -0
- package/{src/core/dictionary-service.ts → dist/core/dictionary-service.js} +4 -7
- package/dist/core/dictionary.d.ts +38 -0
- package/{src/core/dictionary.ts → dist/core/dictionary.js} +33 -59
- package/dist/core/empathy-keyword-matcher.d.ts +5 -0
- package/dist/core/empathy-keyword-matcher.js +40 -0
- package/dist/core/empathy-types.d.ts +2 -0
- package/dist/core/empathy-types.js +1 -0
- package/dist/core/event-log.d.ts +90 -0
- package/dist/core/event-log.js +702 -0
- package/dist/core/evolution-engine.d.ts +119 -0
- package/dist/core/evolution-engine.js +460 -0
- package/dist/core/evolution-logger.d.ts +137 -0
- package/dist/core/evolution-logger.js +261 -0
- package/dist/core/evolution-migration.d.ts +5 -0
- package/dist/core/evolution-migration.js +65 -0
- package/dist/core/evolution-reducer.d.ts +124 -0
- package/dist/core/evolution-reducer.js +730 -0
- package/dist/core/evolution-types.d.ts +50 -0
- package/dist/core/evolution-types.js +11 -0
- package/dist/core/external-training-contract.d.ts +276 -0
- package/dist/core/external-training-contract.js +269 -0
- package/dist/core/file-store.d.ts +41 -0
- package/dist/core/file-store.js +46 -0
- package/dist/core/focus-history.d.ts +50 -0
- package/dist/core/focus-history.js +574 -0
- package/dist/core/hygiene/tracker.d.ts +22 -0
- package/dist/core/hygiene/tracker.js +110 -0
- package/dist/core/init.d.ts +30 -0
- package/{src/core/init.ts → dist/core/init.js} +87 -118
- package/dist/core/local-worker-routing.d.ts +124 -0
- package/dist/core/local-worker-routing.js +216 -0
- package/dist/core/migration.d.ts +6 -0
- package/{src/core/migration.ts → dist/core/migration.js} +10 -18
- package/dist/core/model-deployment-registry.d.ts +218 -0
- package/dist/core/model-deployment-registry.js +502 -0
- package/dist/core/model-training-registry.d.ts +295 -0
- package/dist/core/model-training-registry.js +474 -0
- package/dist/core/observability.d.ts +40 -0
- package/dist/core/observability.js +164 -0
- package/dist/core/pain-diagnostic-gate.d.ts +36 -0
- package/dist/core/pain-diagnostic-gate.js +105 -0
- package/dist/core/pain.d.ts +87 -0
- package/dist/core/pain.js +223 -0
- package/dist/core/path-resolver.d.ts +60 -0
- package/{src/core/path-resolver.ts → dist/core/path-resolver.js} +41 -131
- package/dist/core/paths.d.ts +60 -0
- package/{src/core/paths.ts → dist/core/paths.js} +4 -13
- package/dist/core/pd-config-loader.d.ts +96 -0
- package/dist/core/pd-config-loader.js +307 -0
- package/dist/core/pd-task-reconciler.d.ts +89 -0
- package/dist/core/pd-task-reconciler.js +262 -0
- package/dist/core/pd-task-service.d.ts +2 -0
- package/dist/core/pd-task-service.js +32 -0
- package/dist/core/pd-task-store.d.ts +5 -0
- package/dist/core/pd-task-store.js +62 -0
- package/dist/core/pd-task-types.d.ts +8 -0
- package/dist/core/pd-task-types.js +2 -0
- package/dist/core/principle-compiler/__tests__/compiler-replay-gate.test.d.ts +1 -0
- package/dist/core/principle-compiler/__tests__/compiler-replay-gate.test.js +132 -0
- package/dist/core/principle-compiler/code-validator.d.ts +14 -0
- package/dist/core/principle-compiler/code-validator.js +86 -0
- package/dist/core/principle-compiler/compiler.d.ts +45 -0
- package/dist/core/principle-compiler/compiler.js +287 -0
- package/{src/core/principle-compiler/index.ts → dist/core/principle-compiler/index.d.ts} +0 -1
- package/dist/core/principle-compiler/index.js +10 -0
- package/dist/core/principle-compiler/ledger-registrar.d.ts +28 -0
- package/dist/core/principle-compiler/ledger-registrar.js +95 -0
- package/{src/core/principle-compiler/template-generator.ts → dist/core/principle-compiler/template-generator.d.ts} +0 -1
- package/dist/core/principle-compiler/template-generator.js +7 -0
- package/{src/core/principle-injection.ts → dist/core/principle-injection.d.ts} +1 -7
- package/dist/core/principle-injection.js +10 -0
- package/dist/core/principle-internalization/filesystem-lifecycle-datasource.d.ts +15 -0
- package/dist/core/principle-internalization/filesystem-lifecycle-datasource.js +34 -0
- package/dist/core/principle-internalization/lifecycle-read-model.d.ts +17 -0
- package/{src/core/principle-internalization/lifecycle-read-model.ts → dist/core/principle-internalization/lifecycle-read-model.js} +2 -21
- package/dist/core/principle-internalization/lifecycle-refresh.d.ts +2 -0
- package/dist/core/principle-internalization/lifecycle-refresh.js +4 -0
- package/dist/core/principle-internalization/principle-lifecycle-service.d.ts +28 -0
- package/dist/core/principle-internalization/principle-lifecycle-service.js +89 -0
- package/dist/core/principle-training-state.d.ts +47 -0
- package/dist/core/principle-training-state.js +113 -0
- package/dist/core/principle-tree-ledger-adapter.d.ts +32 -0
- package/dist/core/principle-tree-ledger-adapter.js +125 -0
- package/dist/core/principle-tree-ledger.d.ts +82 -0
- package/dist/core/principle-tree-ledger.js +527 -0
- package/dist/core/profile.d.ts +62 -0
- package/dist/core/profile.js +211 -0
- package/dist/core/promotion-gate.d.ts +243 -0
- package/dist/core/promotion-gate.js +554 -0
- package/dist/core/reflection/reflection-context.d.ts +31 -0
- package/dist/core/reflection/reflection-context.js +91 -0
- package/dist/core/replay-engine.d.ts +12 -0
- package/dist/core/replay-engine.js +82 -0
- package/dist/core/risk-calculator.d.ts +22 -0
- package/{src/core/risk-calculator.ts → dist/core/risk-calculator.js} +19 -49
- package/{src/core/rule-host-helpers.ts → dist/core/rule-host-helpers.d.ts} +0 -1
- package/dist/core/rule-host-helpers.js +7 -0
- package/{src/core/rule-host-types.ts → dist/core/rule-host-types.d.ts} +1 -8
- package/dist/core/rule-host-types.js +7 -0
- package/dist/core/rule-host.d.ts +86 -0
- package/dist/core/rule-host.js +311 -0
- package/dist/core/rule-implementation-runtime.d.ts +18 -0
- package/dist/core/rule-implementation-runtime.js +112 -0
- package/dist/core/runtime-v2-prompt-activation-reader.d.ts +22 -0
- package/dist/core/runtime-v2-prompt-activation-reader.js +99 -0
- package/{src/core/schema/db-types.ts → dist/core/schema/db-types.d.ts} +4 -9
- package/dist/core/schema/db-types.js +5 -0
- package/{src/core/schema/index.ts → dist/core/schema/index.d.ts} +1 -10
- package/dist/core/schema/index.js +15 -0
- package/dist/core/schema/migration-runner.d.ts +53 -0
- package/dist/core/schema/migration-runner.js +170 -0
- package/dist/core/schema/migrations/001-init-trajectory.d.ts +6 -0
- package/{src/core/schema/migrations/001-init-trajectory.ts → dist/core/schema/migrations/001-init-trajectory.js} +38 -56
- package/dist/core/schema/migrations/002-init-central.d.ts +5 -0
- package/{src/core/schema/migrations/002-init-central.ts → dist/core/schema/migrations/002-init-central.js} +27 -41
- package/dist/core/schema/migrations/003-init-workflow.d.ts +5 -0
- package/{src/core/schema/migrations/003-init-workflow.ts → dist/core/schema/migrations/003-init-workflow.js} +16 -21
- package/dist/core/schema/migrations/004-add-thinking-and-gfi.d.ts +8 -0
- package/{src/core/schema/migrations/004-add-thinking-and-gfi.ts → dist/core/schema/migrations/004-add-thinking-and-gfi.js} +19 -27
- package/{src/core/schema/migrations/index.ts → dist/core/schema/migrations/index.d.ts} +1 -16
- package/dist/core/schema/migrations/index.js +27 -0
- package/dist/core/schema/schema-definitions.d.ts +46 -0
- package/{src/core/schema/schema-definitions.ts → dist/core/schema/schema-definitions.js} +242 -291
- package/dist/core/session-tracker.d.ts +119 -0
- package/{src/core/session-tracker.ts → dist/core/session-tracker.js} +96 -239
- package/dist/core/shadow-observation-registry.d.ts +217 -0
- package/dist/core/shadow-observation-registry.js +280 -0
- package/dist/core/surface-guard.d.ts +31 -0
- package/dist/core/surface-guard.js +131 -0
- package/dist/core/system-logger.d.ts +8 -0
- package/{src/core/system-logger.ts → dist/core/system-logger.js} +20 -34
- package/dist/core/thinking-models.d.ts +70 -0
- package/dist/core/thinking-models.js +300 -0
- package/dist/core/thinking-os-parser.d.ts +35 -0
- package/dist/core/thinking-os-parser.js +123 -0
- package/dist/core/trajectory-types.d.ts +220 -0
- package/dist/core/trajectory-types.js +8 -0
- package/dist/core/trajectory.d.ts +242 -0
- package/dist/core/trajectory.js +1500 -0
- package/dist/core/workflow-funnel-loader.d.ts +72 -0
- package/dist/core/workflow-funnel-loader.js +135 -0
- package/dist/core/workspace-context.d.ts +111 -0
- package/{src/core/workspace-context.ts → dist/core/workspace-context.js} +50 -105
- package/dist/core/workspace-dir-validation.d.ts +11 -0
- package/dist/core/workspace-dir-validation.js +37 -0
- package/dist/core/workspace-guidance-migrator.d.ts +12 -0
- package/{src/core/workspace-guidance-migrator.ts → dist/core/workspace-guidance-migrator.js} +21 -59
- package/dist/hooks/after-tool-call-helpers.d.ts +89 -0
- package/dist/hooks/after-tool-call-helpers.js +475 -0
- package/dist/hooks/after-tool-call-types.d.ts +86 -0
- package/dist/hooks/after-tool-call-types.js +13 -0
- package/dist/hooks/gate-block-helper.d.ts +44 -0
- package/dist/hooks/gate-block-helper.js +209 -0
- package/dist/hooks/gate.d.ts +16 -0
- package/dist/hooks/gate.js +381 -0
- package/dist/hooks/lifecycle.d.ts +5 -0
- package/dist/hooks/lifecycle.js +287 -0
- package/dist/hooks/llm.d.ts +13 -0
- package/{src/hooks/llm.ts → dist/hooks/llm.js} +63 -117
- package/dist/hooks/message-sanitize.d.ts +24 -0
- package/dist/hooks/message-sanitize.js +77 -0
- package/dist/hooks/pain.d.ts +33 -0
- package/dist/hooks/pain.js +294 -0
- package/dist/hooks/prompt.d.ts +52 -0
- package/dist/hooks/prompt.js +930 -0
- package/dist/hooks/raw-observation-adapter.d.ts +57 -0
- package/dist/hooks/raw-observation-adapter.js +170 -0
- package/dist/hooks/raw-observation-types.d.ts +62 -0
- package/dist/hooks/raw-observation-types.js +15 -0
- package/dist/hooks/subagent.d.ts +9 -0
- package/{src/hooks/subagent.ts → dist/hooks/subagent.js} +20 -60
- package/dist/hooks/trajectory-collector.d.ts +25 -0
- package/dist/hooks/trajectory-collector.js +225 -0
- package/dist/hooks/trajectory-evidence.d.ts +11 -0
- package/dist/hooks/trajectory-evidence.js +88 -0
- package/dist/hooks/triage-adapter.d.ts +58 -0
- package/{src/hooks/triage-adapter.ts → dist/hooks/triage-adapter.js} +36 -68
- package/dist/hooks/trigger-cooldown-tracker.d.ts +30 -0
- package/dist/hooks/trigger-cooldown-tracker.js +55 -0
- package/dist/i18n/commands.d.ts +26 -0
- package/dist/i18n/commands.js +96 -0
- package/dist/index.d.ts +50 -0
- package/dist/index.js +829 -0
- package/dist/openclaw-sdk.d.ts +293 -0
- package/dist/openclaw-sdk.js +4 -0
- package/dist/service/central-database.d.ts +138 -0
- package/dist/service/central-database.js +731 -0
- package/dist/service/central-sync-service.d.ts +8 -0
- package/dist/service/central-sync-service.js +71 -0
- package/dist/service/correction-observer-service.d.ts +19 -0
- package/{src/service/correction-observer-service.ts → dist/service/correction-observer-service.js} +36 -76
- package/dist/service/evolution-dedup.d.ts +27 -0
- package/{src/service/evolution-dedup.ts → dist/service/evolution-dedup.js} +11 -31
- package/{src/service/evolution-queue-migration.ts → dist/service/evolution-queue-migration.d.ts} +15 -62
- package/dist/service/evolution-queue-migration.js +53 -0
- package/dist/service/evolution-worker.d.ts +103 -0
- package/{src/service/evolution-worker.ts → dist/service/evolution-worker.js} +169 -331
- package/dist/service/internalization-auto-consumer-service.d.ts +8 -0
- package/dist/service/internalization-auto-consumer-service.js +322 -0
- package/dist/service/keyword-optimization-service.d.ts +44 -0
- package/dist/service/keyword-optimization-service.js +137 -0
- package/dist/service/phase3-input-filter.d.ts +73 -0
- package/dist/service/phase3-input-filter.js +172 -0
- package/dist/service/queue-io.d.ts +30 -0
- package/dist/service/queue-io.js +79 -0
- package/{src/service/queue-migration.ts → dist/service/queue-migration.d.ts} +6 -45
- package/dist/service/queue-migration.js +56 -0
- package/dist/service/runtime-summary-service.d.ts +158 -0
- package/dist/service/runtime-summary-service.js +636 -0
- package/dist/service/subagent-workflow/subagent-error-utils.d.ts +8 -0
- package/{src/service/subagent-workflow/subagent-error-utils.ts → dist/service/subagent-workflow/subagent-error-utils.js} +3 -6
- package/{src/service/subagent-workflow/types.ts → dist/service/subagent-workflow/types.d.ts} +17 -80
- package/dist/service/subagent-workflow/types.js +11 -0
- package/dist/service/subagent-workflow/workflow-store.d.ts +30 -0
- package/{src/service/subagent-workflow/workflow-store.ts → dist/service/subagent-workflow/workflow-store.js} +43 -108
- package/dist/service/trajectory-service.d.ts +2 -0
- package/dist/service/trajectory-service.js +16 -0
- package/dist/service/workflow-watchdog.d.ts +23 -0
- package/dist/service/workflow-watchdog.js +103 -0
- package/dist/types/event-types.d.ts +2 -0
- package/dist/types/event-types.js +1 -0
- package/dist/types/hygiene-types.d.ts +2 -0
- package/dist/types/hygiene-types.js +1 -0
- package/{src/types/principle-tree-schema.ts → dist/types/principle-tree-schema.d.ts} +2 -25
- package/dist/types/principle-tree-schema.js +24 -0
- package/dist/types/queue.d.ts +2 -0
- package/dist/types/queue.js +1 -0
- package/dist/types/runtime-summary.d.ts +1 -0
- package/dist/types/runtime-summary.js +1 -0
- package/dist/types.d.ts +33 -0
- package/dist/types.js +16 -0
- package/dist/utils/file-lock.d.ts +68 -0
- package/dist/utils/file-lock.js +310 -0
- package/dist/utils/hashing.d.ts +9 -0
- package/{src/utils/hashing.ts → dist/utils/hashing.js} +4 -6
- package/dist/utils/io.d.ts +11 -0
- package/dist/utils/io.js +174 -0
- package/dist/utils/node-vm-polyfill.d.ts +9 -0
- package/{src/utils/node-vm-polyfill.ts → dist/utils/node-vm-polyfill.js} +0 -2
- package/dist/utils/retry.d.ts +210 -0
- package/dist/utils/retry.js +375 -0
- package/dist/utils/session-key.d.ts +10 -0
- package/{src/utils/session-key.ts → dist/utils/session-key.js} +5 -4
- package/dist/utils/shadow-fingerprint.d.ts +16 -0
- package/dist/utils/shadow-fingerprint.js +34 -0
- package/dist/utils/workspace-resolver.d.ts +82 -0
- package/dist/utils/workspace-resolver.js +288 -0
- package/openclaw.plugin.json +1 -1
- package/package.json +8 -2
- package/templates/workspace/.principles/DECISION_POLICY.json +44 -0
- package/templates/workspace/.principles/PRINCIPLES.md +20 -0
- package/templates/workspace/.principles/PROFILE.json +54 -0
- package/templates/workspace/.principles/PROFILE.schema.json +56 -0
- package/templates/workspace/.principles/THINKING_OS.md +65 -0
- package/templates/workspace/.principles/THINKING_OS_ARCHIVE.md +7 -0
- package/templates/workspace/.principles/THINKING_OS_CANDIDATES.md +9 -0
- package/templates/workspace/.principles/models/_INDEX.md +27 -0
- package/templates/workspace/.principles/models/first_principles.md +62 -0
- package/templates/workspace/.principles/models/marketing_4p.md +52 -0
- package/templates/workspace/.principles/models/porter_five.md +63 -0
- package/templates/workspace/.principles/models/swot.md +60 -0
- package/templates/workspace/.principles/models/user_story_map.md +63 -0
- package/templates/workspace/.state/WORKBOARD.json +4 -0
- package/.dependency-cruiser.json +0 -19
- package/ADVANCED_CONFIG_ZH.md +0 -93
- package/AGENT_INSTALL.md +0 -173
- package/AGENT_INSTALL_EN.md +0 -173
- package/CHANGELOG.md +0 -26
- package/INSTALL.md +0 -254
- package/SKILL.md +0 -63
- package/esbuild.config.js +0 -104
- package/src/commands/archive-impl.ts +0 -147
- package/src/commands/capabilities.ts +0 -89
- package/src/commands/disable-impl.ts +0 -159
- package/src/commands/evolution-status.ts +0 -247
- package/src/commands/export.ts +0 -59
- package/src/commands/focus.ts +0 -523
- package/src/commands/principle-rollback.ts +0 -32
- package/src/commands/promote-impl.ts +0 -254
- package/src/commands/rollback-impl.ts +0 -246
- package/src/commands/samples.ts +0 -65
- package/src/commands/strategy.ts +0 -21
- package/src/config/errors.ts +0 -180
- package/src/constants/tools.ts +0 -62
- package/src/core/AGENTS.md +0 -34
- package/src/core/__tests__/focus-history.test.ts +0 -210
- package/src/core/bootstrap-rules.ts +0 -216
- package/src/core/code-implementation-storage.ts +0 -213
- package/src/core/config-health.ts +0 -72
- package/src/core/control-ui-db.ts +0 -454
- package/src/core/correction-cue-learner.ts +0 -239
- package/src/core/correction-types.ts +0 -16
- package/src/core/empathy-keyword-matcher.ts +0 -64
- package/src/core/empathy-types.ts +0 -18
- package/src/core/event-log.ts +0 -787
- package/src/core/evolution-engine.ts +0 -613
- package/src/core/evolution-logger.ts +0 -357
- package/src/core/evolution-migration.ts +0 -77
- package/src/core/evolution-reducer.ts +0 -891
- package/src/core/evolution-types.ts +0 -110
- package/src/core/external-training-contract.ts +0 -530
- package/src/core/file-store.ts +0 -80
- package/src/core/focus-history.ts +0 -763
- package/src/core/hygiene/tracker.ts +0 -122
- package/src/core/local-worker-routing.ts +0 -337
- package/src/core/model-deployment-registry.ts +0 -724
- package/src/core/model-training-registry.ts +0 -815
- package/src/core/observability.ts +0 -242
- package/src/core/pain-diagnostic-gate.ts +0 -169
- package/src/core/pain.ts +0 -309
- package/src/core/pd-config-loader.ts +0 -400
- package/src/core/pd-task-reconciler.ts +0 -380
- package/src/core/pd-task-service.ts +0 -43
- package/src/core/pd-task-store.ts +0 -78
- package/src/core/pd-task-types.ts +0 -24
- package/src/core/principle-compiler/__tests__/compiler-replay-gate.test.ts +0 -174
- package/src/core/principle-compiler/code-validator.ts +0 -96
- package/src/core/principle-compiler/compiler.ts +0 -327
- package/src/core/principle-compiler/ledger-registrar.ts +0 -116
- package/src/core/principle-internalization/filesystem-lifecycle-datasource.ts +0 -42
- package/src/core/principle-internalization/lifecycle-refresh.ts +0 -11
- package/src/core/principle-internalization/principle-lifecycle-service.ts +0 -170
- package/src/core/principle-training-state.ts +0 -177
- package/src/core/principle-tree-ledger-adapter.ts +0 -145
- package/src/core/principle-tree-ledger.ts +0 -725
- package/src/core/profile.ts +0 -228
- package/src/core/promotion-gate.ts +0 -854
- package/src/core/reflection/reflection-context.ts +0 -133
- package/src/core/replay-engine.ts +0 -106
- package/src/core/rule-host.ts +0 -386
- package/src/core/rule-implementation-runtime.ts +0 -145
- package/src/core/runtime-v2-prompt-activation-reader.ts +0 -114
- package/src/core/schema/migration-runner.ts +0 -207
- package/src/core/shadow-observation-registry.ts +0 -508
- package/src/core/surface-guard.ts +0 -188
- package/src/core/thinking-models.ts +0 -377
- package/src/core/thinking-os-parser.ts +0 -165
- package/src/core/trajectory-types.ts +0 -247
- package/src/core/trajectory.ts +0 -1831
- package/src/core/workflow-funnel-loader.ts +0 -195
- package/src/core/workspace-dir-validation.ts +0 -52
- package/src/hooks/AGENTS.md +0 -31
- package/src/hooks/after-tool-call-helpers.ts +0 -601
- package/src/hooks/after-tool-call-types.ts +0 -99
- package/src/hooks/gate-block-helper.ts +0 -265
- package/src/hooks/gate.ts +0 -394
- package/src/hooks/lifecycle.ts +0 -334
- package/src/hooks/message-sanitize.ts +0 -102
- package/src/hooks/pain.ts +0 -358
- package/src/hooks/prompt.ts +0 -1102
- package/src/hooks/raw-observation-adapter.ts +0 -215
- package/src/hooks/raw-observation-types.ts +0 -77
- package/src/hooks/trajectory-collector.ts +0 -253
- package/src/hooks/trajectory-evidence.ts +0 -97
- package/src/hooks/trigger-cooldown-tracker.ts +0 -82
- package/src/i18n/commands.ts +0 -101
- package/src/index.ts +0 -939
- package/src/openclaw-sdk.ts +0 -312
- package/src/service/central-database.ts +0 -936
- package/src/service/central-sync-service.ts +0 -85
- package/src/service/internalization-auto-consumer-service.ts +0 -397
- package/src/service/keyword-optimization-service.ts +0 -169
- package/src/service/phase3-input-filter.ts +0 -237
- package/src/service/queue-io.ts +0 -108
- package/src/service/runtime-summary-service.ts +0 -990
- package/src/service/trajectory-service.ts +0 -16
- package/src/service/workflow-watchdog.ts +0 -125
- package/src/types/event-types.ts +0 -39
- package/src/types/hygiene-types.ts +0 -8
- package/src/types/queue.ts +0 -15
- package/src/types/runtime-summary.ts +0 -5
- package/src/types.ts +0 -53
- package/src/utils/file-lock.ts +0 -394
- package/src/utils/io.ts +0 -176
- package/src/utils/retry.ts +0 -573
- package/src/utils/shadow-fingerprint.ts +0 -42
- package/src/utils/workspace-resolver.ts +0 -393
- package/tests/README.md +0 -120
- package/tests/build-artifacts.test.ts +0 -55
- package/tests/commands/evolution-status.test.ts +0 -511
- package/tests/commands/export.test.ts +0 -78
- package/tests/commands/pain.test.ts +0 -287
- package/tests/commands/samples.test.ts +0 -65
- package/tests/commands/strategy.test.ts +0 -19
- package/tests/commands/thinking-os.test.ts +0 -88
- package/tests/core/bootstrap-rules.test.ts +0 -596
- package/tests/core/code-implementation-storage.test.ts +0 -300
- package/tests/core/code-validator.test.ts +0 -197
- package/tests/core/config-service.test.ts +0 -89
- package/tests/core/config.test.ts +0 -90
- package/tests/core/control-ui-db.test.ts +0 -75
- package/tests/core/core-principle-registry-drift.test.ts +0 -39
- package/tests/core/core-template-guidance.test.ts +0 -21
- package/tests/core/correction-cue-learner.test.ts +0 -345
- package/tests/core/detection-service.test.ts +0 -50
- package/tests/core/dictionary-service.test.ts +0 -116
- package/tests/core/dictionary.test.ts +0 -171
- package/tests/core/empathy-keyword-matcher.test.ts +0 -209
- package/tests/core/event-log.test.ts +0 -484
- package/tests/core/evolution-engine.test.ts +0 -610
- package/tests/core/evolution-logger.test.ts +0 -148
- package/tests/core/evolution-migration.test.ts +0 -374
- package/tests/core/evolution-paths.test.ts +0 -21
- package/tests/core/evolution-reducer.compilation-retry.test.ts +0 -189
- package/tests/core/evolution-reducer.detector-metadata.test.ts +0 -602
- package/tests/core/evolution-types-loop.test.ts +0 -48
- package/tests/core/external-training-contract.test.ts +0 -463
- package/tests/core/file-store.test.ts +0 -102
- package/tests/core/focus-history.test.ts +0 -874
- package/tests/core/init-flatten.test.ts +0 -69
- package/tests/core/init-refactor.test.ts +0 -87
- package/tests/core/init-v1.3.test.ts +0 -46
- package/tests/core/init.test.ts +0 -190
- package/tests/core/ledger-registrar.test.ts +0 -235
- package/tests/core/migration.test.ts +0 -84
- package/tests/core/model-deployment-registry.test.ts +0 -858
- package/tests/core/model-training-registry.test.ts +0 -908
- package/tests/core/observability.test.ts +0 -382
- package/tests/core/pain-diagnostic-gate.test.ts +0 -614
- package/tests/core/pain-score.property.test.ts +0 -19
- package/tests/core/pain.test.ts +0 -132
- package/tests/core/path-resolver.test.ts +0 -57
- package/tests/core/paths-refactor.test.ts +0 -20
- package/tests/core/pd-config-loader.test.ts +0 -407
- package/tests/core/pd-task-store.test.ts +0 -126
- package/tests/core/phase7-rollout-integration.test.ts +0 -477
- package/tests/core/principle-compiler.test.ts +0 -350
- package/tests/core/principle-injection.test.ts +0 -223
- package/tests/core/principle-internalization/deprecated-readiness.test.ts +0 -193
- package/tests/core/principle-internalization/lifecycle-metrics.test.ts +0 -350
- package/tests/core/principle-internalization/lifecycle-routing-policy.test.ts +0 -212
- package/tests/core/principle-internalization/lineage-source-retired.test.ts +0 -56
- package/tests/core/principle-internalization/principle-lifecycle-service.test.ts +0 -189
- package/tests/core/principle-training-state.test.ts +0 -939
- package/tests/core/principle-tree-ledger-adapter.test.ts +0 -253
- package/tests/core/principle-tree-ledger.test.ts +0 -423
- package/tests/core/profile.test.ts +0 -56
- package/tests/core/promotion-gate.test.ts +0 -561
- package/tests/core/queue-purge.test.ts +0 -337
- package/tests/core/reflection-context.test.ts +0 -342
- package/tests/core/regression-v1-9-1.test.ts +0 -266
- package/tests/core/replay-engine.test.ts +0 -165
- package/tests/core/risk-calculator.test.ts +0 -168
- package/tests/core/rule-host-adversarial-output.test.ts +0 -242
- package/tests/core/rule-host-autocorrect-vm.test.ts +0 -163
- package/tests/core/rule-host-helpers.test.ts +0 -120
- package/tests/core/rule-host-resource-bounds.test.ts +0 -231
- package/tests/core/rule-host-sqlite-source.test.ts +0 -720
- package/tests/core/rule-host-unhealthy-visibility.test.ts +0 -261
- package/tests/core/rule-host-validation.test.ts +0 -315
- package/tests/core/rule-implementation-runtime.test.ts +0 -49
- package/tests/core/session-tracker.test.ts +0 -191
- package/tests/core/surface-guard.test.ts +0 -338
- package/tests/core/template-generator.test.ts +0 -101
- package/tests/core/trajectory.test.ts +0 -427
- package/tests/core/workflow-funnel-loader.test.ts +0 -1028
- package/tests/core/workspace-context-factory.test.ts +0 -18
- package/tests/core/workspace-context.test.ts +0 -187
- package/tests/core/workspace-guidance-migrator.test.ts +0 -248
- package/tests/core-anti-growth.test.ts +0 -182
- package/tests/evolution-worker-quarantine.test.ts +0 -400
- package/tests/evolution-worker-slimming.test.ts +0 -380
- package/tests/fixtures/legacy-queue-v1.json +0 -74
- package/tests/fixtures/production-compatibility.test.ts +0 -147
- package/tests/fixtures/production-mock-generator.ts +0 -282
- package/tests/globalSetup.ts +0 -38
- package/tests/hook-workspace-nextaction-contract.test.ts +0 -50
- package/tests/hooks/confirm-first-removal.test.ts +0 -188
- package/tests/hooks/gate-auto-correct-shadow.test.ts +0 -309
- package/tests/hooks/gate-auto-correct.test.ts +0 -664
- package/tests/hooks/gate-block-helper-profile.test.ts +0 -186
- package/tests/hooks/gate-no-path-write-tool.test.ts +0 -171
- package/tests/hooks/gate-rule-host-pipeline.test.ts +0 -230
- package/tests/hooks/gate-rule-host-real-pipeline.test.ts +0 -190
- package/tests/hooks/lifecycle.test.ts +0 -248
- package/tests/hooks/message-sanitize.test.ts +0 -244
- package/tests/hooks/pain-emission-characterization.test.ts +0 -420
- package/tests/hooks/pain.test.ts +0 -795
- package/tests/hooks/prompt-characterization.test.ts +0 -476
- package/tests/hooks/prompt-diet.test.ts +0 -335
- package/tests/hooks/prompt-size-guard.test.ts +0 -319
- package/tests/hooks/raw-observation-adapter.test.ts +0 -312
- package/tests/hooks/runtime-v2-prompt-activation.test.ts +0 -895
- package/tests/hooks/single-gate-pain-admission.test.ts +0 -258
- package/tests/hooks/subagent.test.ts +0 -469
- package/tests/hooks/trajectory-collector.test.ts +0 -269
- package/tests/hooks/trajectory-evidence.test.ts +0 -280
- package/tests/hooks/triage-adapter.test.ts +0 -331
- package/tests/hygiene-tracker.test.ts +0 -77
- package/tests/index.test.ts +0 -142
- package/tests/integration/auto-entry-gate.test.ts +0 -256
- package/tests/integration/gate-real-io.e2e.test.ts +0 -248
- package/tests/integration/m8-legacy-paths.test.ts +0 -63
- package/tests/integration/mvp-surface-registry-guard.test.ts +0 -536
- package/tests/integration/pain-id-chain-e2e.test.ts +0 -313
- package/tests/integration/principle-compiler-e2e.test.ts +0 -403
- package/tests/integration/principle-lifecycle.e2e.test.ts +0 -198
- package/tests/integration/runtime-v2-pain-guard.test.ts +0 -125
- package/tests/integration/trajectory-lifecycle.e2e.test.ts +0 -523
- package/tests/internalization-auto-consumer-gate.test.ts +0 -158
- package/tests/internalization-auto-consumer-service.test.ts +0 -219
- package/tests/plugin-config-resolution-cutover.test.ts +0 -359
- package/tests/queue/async-lock.test.ts +0 -200
- package/tests/runtime-v2-discovery-guard.test.ts +0 -153
- package/tests/scripts/validate-live-path.test.ts +0 -286
- package/tests/service/central-database.test.ts +0 -457
- package/tests/service/correction-observer-service.test.ts +0 -505
- package/tests/service/evolution-worker.compilation-backfill.test.ts +0 -203
- package/tests/service/evolution-worker.correction-observer.test.ts +0 -50
- package/tests/service/evolution-worker.queue.test.ts +0 -296
- package/tests/service/evolution-worker.timeout.test.ts +0 -233
- package/tests/service/keyword-optimization-service.test.ts +0 -121
- package/tests/service/phase3-input-filter.test.ts +0 -289
- package/tests/service/queue-io.test.ts +0 -168
- package/tests/service/queue-migration.test.ts +0 -147
- package/tests/service/runtime-summary-service.test.ts +0 -1100
- package/tests/service/workflow-watchdog.test.ts +0 -281
- package/tests/task-compliance.test.ts +0 -166
- package/tests/test-utils.ts +0 -48
- package/tests/utils/file-lock.test.ts +0 -409
- package/tests/utils/hashing.test.ts +0 -32
- package/tests/utils/hook-workspace-resolver.test.ts +0 -524
- package/tests/utils/io.test.ts +0 -39
- package/tests/utils/retry.test.ts +0 -327
- package/tests/utils/session-key.test.ts +0 -52
- package/tsconfig.json +0 -16
- package/vitest.config.ts +0 -61
- package/vitest.unit.config.ts +0 -12
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Raw Observation Adapter — PRI-362
|
|
3
|
+
*
|
|
4
|
+
* Unified source-kind resolution from RawObservation.
|
|
5
|
+
*
|
|
6
|
+
* Replaces scattered resolveSourceKindFrom* functions with a single
|
|
7
|
+
* field-driven adapter that maps observation fields to SourceKind.
|
|
8
|
+
*
|
|
9
|
+
* Field precedence (highest to lowest):
|
|
10
|
+
* 1. isManualEntry → owner_reported
|
|
11
|
+
* 2. isGateBlock → rulehost_block
|
|
12
|
+
* 3. isSubagentError → subagent_error
|
|
13
|
+
* 4. isRateLimit → rate_limit (if true)
|
|
14
|
+
* 5. toolName === 'pain' / 'skill:pain' → agent_on_owner_request (with openclaw_context_bound) / owner_reported
|
|
15
|
+
* 6. failureSource → tool_failure / dispatch_error
|
|
16
|
+
* 7. isGfiTriggered → gfi_threshold
|
|
17
|
+
* 8. detectionSource → llm_paralysis / semantic / empathy_inferred / unknown
|
|
18
|
+
* 9. Fallback → unknown
|
|
19
|
+
*
|
|
20
|
+
* ERR checklist:
|
|
21
|
+
* - ERR-001: Source kind resolved from runtime values, no `as` casts.
|
|
22
|
+
* - ERR-002: Every path returns a valid SourceKind (fallback to 'unknown').
|
|
23
|
+
* - EP-01: Runtime values validated before use.
|
|
24
|
+
*/
|
|
25
|
+
import type { SourceKind } from '@principles/core/runtime-v2';
|
|
26
|
+
import type { RawObservation } from './raw-observation-types.js';
|
|
27
|
+
export type { RawObservation } from './raw-observation-types.js';
|
|
28
|
+
/**
|
|
29
|
+
* Resolve SourceKind from a unified RawObservation.
|
|
30
|
+
*
|
|
31
|
+
* This function replaces the scattered resolveSourceKindFrom* functions
|
|
32
|
+
* and provides a single entry point for source-kind classification.
|
|
33
|
+
*
|
|
34
|
+
* Field precedence is explicitly defined in the function body to ensure
|
|
35
|
+
* deterministic behavior and make the logic easy to understand and test.
|
|
36
|
+
*/
|
|
37
|
+
export declare function resolveSourceKind(observation: RawObservation): SourceKind;
|
|
38
|
+
/**
|
|
39
|
+
* Build a RawObservation for a tool failure context.
|
|
40
|
+
*
|
|
41
|
+
* This replaces classifyToolFailureSource and the inline classification
|
|
42
|
+
* in after-tool-call-helpers. All tool error → dispatch/tool_failure
|
|
43
|
+
* classification is centralized here.
|
|
44
|
+
*/
|
|
45
|
+
export declare function buildToolFailureObservation(options: {
|
|
46
|
+
toolName: string | undefined;
|
|
47
|
+
error: unknown;
|
|
48
|
+
exitCode?: number;
|
|
49
|
+
provenance?: RawObservation['provenance'];
|
|
50
|
+
}): RawObservation;
|
|
51
|
+
/**
|
|
52
|
+
* Build a RawObservation for an LLM detection context.
|
|
53
|
+
*/
|
|
54
|
+
export declare function buildLlmDetectionObservation(options: {
|
|
55
|
+
detectionSource: string;
|
|
56
|
+
isGfiTriggered: boolean;
|
|
57
|
+
}): RawObservation;
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Raw Observation Adapter — PRI-362
|
|
3
|
+
*
|
|
4
|
+
* Unified source-kind resolution from RawObservation.
|
|
5
|
+
*
|
|
6
|
+
* Replaces scattered resolveSourceKindFrom* functions with a single
|
|
7
|
+
* field-driven adapter that maps observation fields to SourceKind.
|
|
8
|
+
*
|
|
9
|
+
* Field precedence (highest to lowest):
|
|
10
|
+
* 1. isManualEntry → owner_reported
|
|
11
|
+
* 2. isGateBlock → rulehost_block
|
|
12
|
+
* 3. isSubagentError → subagent_error
|
|
13
|
+
* 4. isRateLimit → rate_limit (if true)
|
|
14
|
+
* 5. toolName === 'pain' / 'skill:pain' → agent_on_owner_request (with openclaw_context_bound) / owner_reported
|
|
15
|
+
* 6. failureSource → tool_failure / dispatch_error
|
|
16
|
+
* 7. isGfiTriggered → gfi_threshold
|
|
17
|
+
* 8. detectionSource → llm_paralysis / semantic / empathy_inferred / unknown
|
|
18
|
+
* 9. Fallback → unknown
|
|
19
|
+
*
|
|
20
|
+
* ERR checklist:
|
|
21
|
+
* - ERR-001: Source kind resolved from runtime values, no `as` casts.
|
|
22
|
+
* - ERR-002: Every path returns a valid SourceKind (fallback to 'unknown').
|
|
23
|
+
* - EP-01: Runtime values validated before use.
|
|
24
|
+
*/
|
|
25
|
+
/**
|
|
26
|
+
* Resolve SourceKind from a unified RawObservation.
|
|
27
|
+
*
|
|
28
|
+
* This function replaces the scattered resolveSourceKindFrom* functions
|
|
29
|
+
* and provides a single entry point for source-kind classification.
|
|
30
|
+
*
|
|
31
|
+
* Field precedence is explicitly defined in the function body to ensure
|
|
32
|
+
* deterministic behavior and make the logic easy to understand and test.
|
|
33
|
+
*/
|
|
34
|
+
export function resolveSourceKind(observation) {
|
|
35
|
+
const { isManualEntry, isGateBlock, isSubagentError, isRateLimit, toolName, failureSource, isGfiTriggered, detectionSource, nonZeroExit, timedOut, toolNotFound, } = observation;
|
|
36
|
+
// Priority 1: Manual entry (CLI, owner-reported)
|
|
37
|
+
if (isManualEntry) {
|
|
38
|
+
return 'owner_reported';
|
|
39
|
+
}
|
|
40
|
+
// Priority 2: Gate block
|
|
41
|
+
if (isGateBlock) {
|
|
42
|
+
return 'rulehost_block';
|
|
43
|
+
}
|
|
44
|
+
// Priority 3: Subagent error
|
|
45
|
+
if (isSubagentError) {
|
|
46
|
+
return 'subagent_error';
|
|
47
|
+
}
|
|
48
|
+
// Priority 4: Provider rate limit (explicit true/false)
|
|
49
|
+
if (isRateLimit === true) {
|
|
50
|
+
return 'rate_limit';
|
|
51
|
+
}
|
|
52
|
+
if (isRateLimit === false) {
|
|
53
|
+
return 'provider_failure';
|
|
54
|
+
}
|
|
55
|
+
// Priority 5: Manual pain tool
|
|
56
|
+
if (toolName === 'pain' || toolName === 'skill:pain') {
|
|
57
|
+
// Match resolveSourceKindFromToolFailure behavior:
|
|
58
|
+
// openclaw_context_bound → agent_on_owner_request
|
|
59
|
+
// other provenance or undefined → owner_reported
|
|
60
|
+
if (observation.provenance === 'openclaw_context_bound') {
|
|
61
|
+
return 'agent_on_owner_request';
|
|
62
|
+
}
|
|
63
|
+
return 'owner_reported';
|
|
64
|
+
}
|
|
65
|
+
// Priority 6: GFI threshold (must check before failure source for LLM detection path)
|
|
66
|
+
if (isGfiTriggered) {
|
|
67
|
+
return 'gfi_threshold';
|
|
68
|
+
}
|
|
69
|
+
// Priority 7: Tool failure / dispatch error
|
|
70
|
+
if (failureSource) {
|
|
71
|
+
// Match resolveSourceKindFromToolFailure behavior:
|
|
72
|
+
// dispatch_error → dispatch_error, anything else → tool_failure
|
|
73
|
+
if (failureSource === 'dispatch_error') {
|
|
74
|
+
return 'dispatch_error';
|
|
75
|
+
}
|
|
76
|
+
return 'tool_failure';
|
|
77
|
+
}
|
|
78
|
+
// Infer failureSource from tool failure indicators if not explicitly set
|
|
79
|
+
if (toolNotFound) {
|
|
80
|
+
return 'dispatch_error';
|
|
81
|
+
}
|
|
82
|
+
// Match classifyToolFailureSource behavior: unknown tool name → dispatch_error
|
|
83
|
+
// BUT only if this looks like a tool failure context (has other tool fields)
|
|
84
|
+
// Otherwise, this is likely a non-tool observation (e.g., LLM detection)
|
|
85
|
+
const hasToolContext = toolName !== undefined || nonZeroExit || timedOut || toolNotFound;
|
|
86
|
+
if (hasToolContext && (!toolName || toolName.trim() === '')) {
|
|
87
|
+
return 'dispatch_error';
|
|
88
|
+
}
|
|
89
|
+
// Exit code-based detection: non-zero exit or timeout → tool_failure
|
|
90
|
+
if (nonZeroExit || timedOut) {
|
|
91
|
+
return 'tool_failure';
|
|
92
|
+
}
|
|
93
|
+
// Priority 8: LLM detection source
|
|
94
|
+
if (detectionSource) {
|
|
95
|
+
// Match resolveSourceKindFromLlmDetection behavior:
|
|
96
|
+
if (detectionSource === 'llm_paralysis') {
|
|
97
|
+
return 'llm_paralysis';
|
|
98
|
+
}
|
|
99
|
+
if (detectionSource.startsWith('llm_')) {
|
|
100
|
+
return 'semantic';
|
|
101
|
+
}
|
|
102
|
+
if (detectionSource === 'user_empathy') {
|
|
103
|
+
return 'empathy_inferred';
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
// Fallback: unknown
|
|
107
|
+
return 'unknown';
|
|
108
|
+
}
|
|
109
|
+
// ── Builder Functions ──────────────────────────────────────────────────────
|
|
110
|
+
//
|
|
111
|
+
// PRI-360 S1: These builders construct RawObservation from specific contexts,
|
|
112
|
+
// centralizing source classification rules in the adapter layer.
|
|
113
|
+
// Hooks should NOT hold source classification logic — use these builders.
|
|
114
|
+
/**
|
|
115
|
+
* Classify error message as dispatch_error vs tool_failure.
|
|
116
|
+
*
|
|
117
|
+
* This centralizes the regex-based classification that was previously
|
|
118
|
+
* scattered in classifyToolFailureSource and after-tool-call-helpers.
|
|
119
|
+
* Now hooks call this builder + resolveSourceKind instead of holding rules.
|
|
120
|
+
*/
|
|
121
|
+
function classifyErrorForDispatch(error) {
|
|
122
|
+
if (!error)
|
|
123
|
+
return 'tool_failure';
|
|
124
|
+
const msg = String(error);
|
|
125
|
+
if (/\btool\s+(?:\S+\s+)?not\s+found\b/i.test(msg) || /\bunknown\s+tool\b/i.test(msg)) {
|
|
126
|
+
return 'dispatch_error';
|
|
127
|
+
}
|
|
128
|
+
return 'tool_failure';
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Build a RawObservation for a tool failure context.
|
|
132
|
+
*
|
|
133
|
+
* This replaces classifyToolFailureSource and the inline classification
|
|
134
|
+
* in after-tool-call-helpers. All tool error → dispatch/tool_failure
|
|
135
|
+
* classification is centralized here.
|
|
136
|
+
*/
|
|
137
|
+
export function buildToolFailureObservation(options) {
|
|
138
|
+
const { toolName, error, provenance } = options;
|
|
139
|
+
const nonZeroExit = typeof options.exitCode === 'number' && options.exitCode !== 0;
|
|
140
|
+
// Classify dispatch vs tool_failure centrally
|
|
141
|
+
let failureSource;
|
|
142
|
+
if (!toolName || toolName.trim() === '') {
|
|
143
|
+
// Empty/whitespace tool name → dispatch error
|
|
144
|
+
failureSource = 'dispatch_error';
|
|
145
|
+
}
|
|
146
|
+
else {
|
|
147
|
+
failureSource = classifyErrorForDispatch(error);
|
|
148
|
+
}
|
|
149
|
+
// If neither error nor non-zero exit, this is not a failure context
|
|
150
|
+
if (!error && !nonZeroExit) {
|
|
151
|
+
failureSource = undefined;
|
|
152
|
+
}
|
|
153
|
+
return {
|
|
154
|
+
observedAt: new Date().toISOString(),
|
|
155
|
+
toolName,
|
|
156
|
+
failureSource,
|
|
157
|
+
nonZeroExit,
|
|
158
|
+
provenance,
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Build a RawObservation for an LLM detection context.
|
|
163
|
+
*/
|
|
164
|
+
export function buildLlmDetectionObservation(options) {
|
|
165
|
+
return {
|
|
166
|
+
observedAt: new Date().toISOString(),
|
|
167
|
+
detectionSource: options.detectionSource,
|
|
168
|
+
isGfiTriggered: options.isGfiTriggered,
|
|
169
|
+
};
|
|
170
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Raw Observation Types — PRI-362
|
|
3
|
+
*
|
|
4
|
+
* Source adapter layer that normalizes diverse hook contexts into a unified
|
|
5
|
+
* observation model before mapping to SourceKind.
|
|
6
|
+
*
|
|
7
|
+
* This replaces scattered resolveSourceKindFrom* functions with a single
|
|
8
|
+
* field-driven adapter.
|
|
9
|
+
*
|
|
10
|
+
* ERR checklist:
|
|
11
|
+
* - ERR-001: No `as` casts; validate unknown payload field-by-field.
|
|
12
|
+
* - ERR-002: Every decision carries reason + nextAction.
|
|
13
|
+
* - EP-01: Source adapter validates before use.
|
|
14
|
+
*/
|
|
15
|
+
/**
|
|
16
|
+
* Raw observation from a source adapter.
|
|
17
|
+
*
|
|
18
|
+
* This is the input to resolveSourceKind. It contains all possible
|
|
19
|
+
* context fields that different sources may provide. The adapter
|
|
20
|
+
* reads only the fields it needs based on the observation source.
|
|
21
|
+
*/
|
|
22
|
+
export interface RawObservation {
|
|
23
|
+
/** When the observation was made (ISO timestamp) */
|
|
24
|
+
readonly observedAt: string;
|
|
25
|
+
/** Workspace identifier */
|
|
26
|
+
readonly workspaceId?: string;
|
|
27
|
+
/** Session identifier */
|
|
28
|
+
readonly sessionId?: string;
|
|
29
|
+
/** Trace identifier for correlation */
|
|
30
|
+
readonly traceId?: string;
|
|
31
|
+
/** Tool name (for after_tool_call hook) */
|
|
32
|
+
readonly toolName?: string;
|
|
33
|
+
/** Failure source classification */
|
|
34
|
+
readonly failureSource?: 'tool_failure' | 'dispatch_error';
|
|
35
|
+
/** Whether the tool call exited with non-zero code */
|
|
36
|
+
readonly nonZeroExit?: boolean;
|
|
37
|
+
/** Whether the tool call timed out */
|
|
38
|
+
readonly timedOut?: boolean;
|
|
39
|
+
/** Whether the tool does not exist */
|
|
40
|
+
readonly toolNotFound?: boolean;
|
|
41
|
+
/** Detection source identifier */
|
|
42
|
+
readonly detectionSource?: string;
|
|
43
|
+
/** Whether GFI threshold was crossed */
|
|
44
|
+
readonly isGfiTriggered?: boolean;
|
|
45
|
+
/** Whether the failure was a rate limit (429) */
|
|
46
|
+
readonly isRateLimit?: boolean;
|
|
47
|
+
/** Whether this observation came from a gate block */
|
|
48
|
+
readonly isGateBlock?: boolean;
|
|
49
|
+
/** Whether this was a manual CLI entry */
|
|
50
|
+
readonly isManualEntry?: boolean;
|
|
51
|
+
/** Provenance: how trustworthy and context-bound is the observation */
|
|
52
|
+
readonly provenance?: 'openclaw_context_bound' | 'owner_reported_no_host_trace' | 'automatic_hook';
|
|
53
|
+
/** Whether this observation came from a subagent error */
|
|
54
|
+
readonly isSubagentError?: boolean;
|
|
55
|
+
/**
|
|
56
|
+
* Raw payload from the source.
|
|
57
|
+
*
|
|
58
|
+
* This is always `unknown` (ERR-005). Source adapters validate only
|
|
59
|
+
* enough to identify the source and capture bounded context.
|
|
60
|
+
*/
|
|
61
|
+
readonly payload?: unknown;
|
|
62
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Raw Observation Types — PRI-362
|
|
3
|
+
*
|
|
4
|
+
* Source adapter layer that normalizes diverse hook contexts into a unified
|
|
5
|
+
* observation model before mapping to SourceKind.
|
|
6
|
+
*
|
|
7
|
+
* This replaces scattered resolveSourceKindFrom* functions with a single
|
|
8
|
+
* field-driven adapter.
|
|
9
|
+
*
|
|
10
|
+
* ERR checklist:
|
|
11
|
+
* - ERR-001: No `as` casts; validate unknown payload field-by-field.
|
|
12
|
+
* - ERR-002: Every decision carries reason + nextAction.
|
|
13
|
+
* - EP-01: Source adapter validates before use.
|
|
14
|
+
*/
|
|
15
|
+
export {};
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { PluginHookSubagentEndedEvent, PluginHookSubagentContext, OpenClawPluginApi } from '../openclaw-sdk.js';
|
|
2
|
+
type SubagentEndedHookContext = PluginHookSubagentContext & {
|
|
3
|
+
api?: OpenClawPluginApi;
|
|
4
|
+
workspaceDir?: string;
|
|
5
|
+
sessionId?: string;
|
|
6
|
+
agentId?: string;
|
|
7
|
+
};
|
|
8
|
+
export declare function handleSubagentEnded(event: PluginHookSubagentEndedEvent, ctx: SubagentEndedHookContext): Promise<void>;
|
|
9
|
+
export {};
|
|
@@ -1,42 +1,20 @@
|
|
|
1
|
-
import type { PluginHookSubagentEndedEvent, PluginHookSubagentContext, PluginLogger, OpenClawPluginApi } from '../openclaw-sdk.js';
|
|
2
1
|
import { WorkspaceContext } from '../core/workspace-context.js';
|
|
3
2
|
import { extractAgentIdFromSessionKey } from '../utils/session-key.js';
|
|
4
3
|
import { recordEvolutionSuccess } from '../core/evolution-engine.js';
|
|
5
4
|
import { WorkflowStore } from '../service/subagent-workflow/workflow-store.js';
|
|
6
|
-
import type { WorkflowManager } from '../service/subagent-workflow/types.js';
|
|
7
|
-
|
|
8
5
|
/**
|
|
9
6
|
* Factory to create the appropriate WorkflowManager by workflow_type string.
|
|
10
7
|
* Used by the subagent_ended hook to dispatch lifecycle recovery to the right manager.
|
|
11
8
|
*/
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
function createWorkflowManagerForType(
|
|
15
|
-
workflowType: string,
|
|
16
|
-
): WorkflowManager | null {
|
|
9
|
+
function createWorkflowManagerForType(workflowType) {
|
|
17
10
|
switch (workflowType) {
|
|
18
11
|
default:
|
|
19
12
|
return null;
|
|
20
13
|
}
|
|
21
14
|
}
|
|
22
|
-
|
|
23
15
|
const HELPER_WORKFLOW_SESSION_PREFIX = 'agent:main:subagent:workflow-';
|
|
24
|
-
|
|
25
|
-
type HookLogger = Pick<PluginLogger, 'info' | 'warn' | 'error'>;
|
|
26
|
-
|
|
27
16
|
// Cleanup expired retry entries periodically
|
|
28
|
-
|
|
29
|
-
function emitSubagentPainEvent(
|
|
30
|
-
wctx: WorkspaceContext,
|
|
31
|
-
payload: {
|
|
32
|
-
source: string;
|
|
33
|
-
reason: string;
|
|
34
|
-
score: number;
|
|
35
|
-
sessionId?: string;
|
|
36
|
-
agentId?: string;
|
|
37
|
-
},
|
|
38
|
-
logger: HookLogger
|
|
39
|
-
): void {
|
|
17
|
+
function emitSubagentPainEvent(wctx, payload, logger) {
|
|
40
18
|
try {
|
|
41
19
|
wctx.evolutionReducer.emitSync({
|
|
42
20
|
ts: new Date().toISOString(),
|
|
@@ -51,29 +29,18 @@ function emitSubagentPainEvent(
|
|
|
51
29
|
agentId: payload.agentId,
|
|
52
30
|
},
|
|
53
31
|
});
|
|
54
|
-
}
|
|
32
|
+
}
|
|
33
|
+
catch (e) {
|
|
55
34
|
logger.warn(`[PD:Subagent] failed to emit evolution event: ${String(e)}`);
|
|
56
35
|
}
|
|
57
36
|
}
|
|
58
|
-
|
|
59
|
-
type SubagentEndedHookContext = PluginHookSubagentContext & {
|
|
60
|
-
api?: OpenClawPluginApi;
|
|
61
|
-
workspaceDir?: string;
|
|
62
|
-
sessionId?: string;
|
|
63
|
-
agentId?: string;
|
|
64
|
-
};
|
|
65
|
-
|
|
66
|
-
export async function handleSubagentEnded(
|
|
67
|
-
event: PluginHookSubagentEndedEvent,
|
|
68
|
-
ctx: SubagentEndedHookContext
|
|
69
|
-
): Promise<void> {
|
|
37
|
+
export async function handleSubagentEnded(event, ctx) {
|
|
70
38
|
const { outcome, targetSessionKey } = event;
|
|
71
|
-
const {workspaceDir} = ctx;
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
39
|
+
const { workspaceDir } = ctx;
|
|
40
|
+
if (!workspaceDir)
|
|
41
|
+
return;
|
|
75
42
|
const wctx = WorkspaceContext.fromHookContext(ctx);
|
|
76
|
-
const logger
|
|
43
|
+
const logger = ctx.api?.logger ?? console;
|
|
77
44
|
// ── Helper Workflow Lifecycle Notification ──
|
|
78
45
|
// When a helper workflow's subagent ends, notify the workflow manager
|
|
79
46
|
// so that it can trigger fallback recovery (notifyWaitResult → finalizeOnce)
|
|
@@ -83,13 +50,11 @@ export async function handleSubagentEnded(
|
|
|
83
50
|
const workflow = store.getWorkflowByChildSession(targetSessionKey);
|
|
84
51
|
if (workflow && workflow.state !== 'completed' && workflow.state !== 'terminal_error' && workflow.state !== 'expired') {
|
|
85
52
|
logger.info(`[PD:Subagent] Helper workflow lifecycle event: workflowId=${workflow.workflow_id}, workflowType=${workflow.workflow_type}, outcome=${outcome}`);
|
|
86
|
-
|
|
87
53
|
const mappedOutcome = outcome === 'deleted' ? 'deleted' :
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
54
|
+
outcome === 'killed' ? 'killed' :
|
|
55
|
+
outcome === 'reset' ? 'reset' :
|
|
56
|
+
outcome === 'error' ? 'error' :
|
|
57
|
+
outcome === 'timeout' ? 'timeout' : 'ok';
|
|
93
58
|
// Call notifyLifecycleEvent on the appropriate manager so it
|
|
94
59
|
// triggers notifyWaitResult → finalizeOnce / terminal transition.
|
|
95
60
|
const subagentRuntime = ctx.api?.runtime?.subagent;
|
|
@@ -98,11 +63,13 @@ export async function handleSubagentEnded(
|
|
|
98
63
|
if (mgr) {
|
|
99
64
|
await mgr.notifyLifecycleEvent(workflow.workflow_id, 'subagent_ended', { outcome: mappedOutcome });
|
|
100
65
|
mgr.dispose();
|
|
101
|
-
}
|
|
66
|
+
}
|
|
67
|
+
else {
|
|
102
68
|
logger.warn(`[PD:Subagent] Unknown workflow type ${workflow.workflow_type} — falling back to store-only event`);
|
|
103
69
|
store.recordEvent(workflow.workflow_id, 'subagent_ended', workflow.state, workflow.state, `subagent ended with outcome: ${outcome}`, { outcome: mappedOutcome });
|
|
104
70
|
}
|
|
105
|
-
}
|
|
71
|
+
}
|
|
72
|
+
else {
|
|
106
73
|
logger.warn(`[PD:Subagent] Subagent runtime not available — cannot notify manager, falling back to store event`);
|
|
107
74
|
store.recordEvent(workflow.workflow_id, 'subagent_ended', workflow.state, workflow.state, `subagent ended with outcome: ${outcome}`, { outcome: mappedOutcome });
|
|
108
75
|
}
|
|
@@ -110,23 +77,20 @@ export async function handleSubagentEnded(
|
|
|
110
77
|
return;
|
|
111
78
|
}
|
|
112
79
|
store.dispose();
|
|
113
|
-
}
|
|
80
|
+
}
|
|
81
|
+
catch (e) {
|
|
114
82
|
logger.warn(`[PD:Subagent] Failed to notify helper workflow lifecycle: ${String(e)}`);
|
|
115
83
|
}
|
|
116
84
|
}
|
|
117
|
-
|
|
118
|
-
const {config} = wctx;
|
|
119
|
-
|
|
85
|
+
const { config } = wctx;
|
|
120
86
|
// ── Outcome-based EP and Pain Signal handling ──
|
|
121
87
|
// OpenClaw v2026.3.23 fixes: timeout may be false positive (fast-finishing workers)
|
|
122
88
|
// Only penalize actual errors, not timeout/killed/reset
|
|
123
|
-
|
|
124
89
|
if (outcome === 'error') {
|
|
125
90
|
// Only actual errors trigger penalty
|
|
126
91
|
const scoreSettings = config.get('scores');
|
|
127
92
|
const score = scoreSettings.subagent_error_penalty;
|
|
128
93
|
const reason = `Subagent session ${targetSessionKey} ended with error`;
|
|
129
|
-
|
|
130
94
|
// Emit pain via Runtime v2 chain (M8: no .pain_flag file)
|
|
131
95
|
emitSubagentPainEvent(wctx, {
|
|
132
96
|
source: `subagent_error`,
|
|
@@ -136,26 +100,22 @@ export async function handleSubagentEnded(
|
|
|
136
100
|
agentId: ctx.agentId || extractAgentIdFromSessionKey(targetSessionKey),
|
|
137
101
|
}, logger);
|
|
138
102
|
}
|
|
139
|
-
|
|
140
103
|
if (outcome === 'timeout') {
|
|
141
104
|
// OpenClaw v2026.3.23 fix: timeout may be false positive
|
|
142
105
|
// Fast-finishing workers are no longer incorrectly reported as timed out
|
|
143
106
|
// Do not penalize - the task may have actually succeeded
|
|
144
107
|
logger.warn(`[PD:Subagent] Session ${targetSessionKey} timed out - not penalizing (OpenClaw fix applied)`);
|
|
145
108
|
}
|
|
146
|
-
|
|
147
109
|
if (outcome === 'killed' || outcome === 'reset') {
|
|
148
110
|
// User-initiated termination or system reset - not an agent failure
|
|
149
111
|
logger.info(`[PD:Subagent] Session ${targetSessionKey} ended with ${outcome} - no penalty (user/system action)`);
|
|
150
112
|
}
|
|
151
|
-
|
|
152
113
|
if (outcome === 'ok' || outcome === 'deleted') {
|
|
153
114
|
recordEvolutionSuccess(workspaceDir, 'subagent', {
|
|
154
115
|
sessionId: ctx.sessionId,
|
|
155
116
|
reason: 'subagent_success',
|
|
156
117
|
});
|
|
157
118
|
}
|
|
158
|
-
|
|
159
119
|
// ── End of subagent_ended handling ──
|
|
160
120
|
// Note: Diagnostician runs via HEARTBEAT (main session LLM), not as a subagent.
|
|
161
121
|
// Principle creation happens in evolution-worker.ts marker detection path.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Trajectory Collector - message write trajectory recording
|
|
3
|
+
*
|
|
4
|
+
* Records message data to memory/trajectories/ JSONL files.
|
|
5
|
+
* PRI-347 removed tool_call and llm_output JSONL writers (no consumers).
|
|
6
|
+
* PRI-346 will repurpose handleBeforeMessageWrite for SQLite collection.
|
|
7
|
+
*/
|
|
8
|
+
import type { PluginHookAgentContext, PluginHookBeforeMessageWriteEvent } from '../openclaw-sdk.js';
|
|
9
|
+
/**
|
|
10
|
+
* PRI-346: Message write hook with SQLite fallback trajectory recording.
|
|
11
|
+
*
|
|
12
|
+
* When allowConversationAccess is NOT set (unauthorized), llm_output is silently
|
|
13
|
+
* blocked by OpenClaw and trajectory.db has no data. This hook is NOT in
|
|
14
|
+
* CONVERSATION_HOOK_NAMES, so it always fires — making it the natural fallback.
|
|
15
|
+
*
|
|
16
|
+
* De-duplication: only writes to SQLite when llm_output is blocked (unauthorized).
|
|
17
|
+
* When llm_output is working (authorized), this hook degrades to JSONL-only.
|
|
18
|
+
*
|
|
19
|
+
* ERR-002: structured observability when fallback fires.
|
|
20
|
+
* ERR-001/005: content is sanitized before persisting.
|
|
21
|
+
*/
|
|
22
|
+
export declare function handleBeforeMessageWrite(event: PluginHookBeforeMessageWriteEvent, ctx: PluginHookAgentContext & {
|
|
23
|
+
workspaceDir?: string;
|
|
24
|
+
pluginConfig?: unknown;
|
|
25
|
+
}): void;
|