@cleocode/core 2026.3.76 → 2026.4.2
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/agents/agent-schema.d.ts.map +1 -1
- package/dist/audit.d.ts +1 -1
- package/dist/audit.d.ts.map +1 -1
- package/dist/bootstrap.d.ts +2 -2
- package/dist/bootstrap.d.ts.map +1 -1
- package/dist/caamp/adapter.d.ts +6 -49
- package/dist/caamp/adapter.d.ts.map +1 -1
- package/dist/caamp/index.d.ts +2 -2
- package/dist/caamp/index.d.ts.map +1 -1
- package/dist/code/index.d.ts +10 -0
- package/dist/code/index.d.ts.map +1 -0
- package/dist/code/outline.d.ts +51 -0
- package/dist/code/outline.d.ts.map +1 -0
- package/dist/code/parser.d.ts +32 -0
- package/dist/code/parser.d.ts.map +1 -0
- package/dist/code/search.d.ts +42 -0
- package/dist/code/search.d.ts.map +1 -0
- package/dist/code/unfold.d.ts +44 -0
- package/dist/code/unfold.d.ts.map +1 -0
- package/dist/compliance/protocol-enforcement.d.ts +1 -1
- package/dist/compliance/protocol-rules.d.ts +1 -1
- package/dist/compliance/protocol-types.d.ts +2 -3
- package/dist/compliance/protocol-types.d.ts.map +1 -1
- package/dist/conduit/conduit-client.d.ts +14 -0
- package/dist/conduit/conduit-client.d.ts.map +1 -1
- package/dist/conduit/factory.d.ts +11 -1
- package/dist/conduit/factory.d.ts.map +1 -1
- package/dist/conduit/http-transport.d.ts +17 -5
- package/dist/conduit/http-transport.d.ts.map +1 -1
- package/dist/conduit/index.d.ts +5 -2
- package/dist/conduit/index.d.ts.map +1 -1
- package/dist/conduit/local-transport.d.ts +91 -0
- package/dist/conduit/local-transport.d.ts.map +1 -0
- package/dist/conduit/sse-transport.d.ts +68 -0
- package/dist/conduit/sse-transport.d.ts.map +1 -0
- package/dist/crypto/credentials.d.ts.map +1 -1
- package/dist/error-catalog.d.ts +3 -3
- package/dist/error-catalog.d.ts.map +1 -1
- package/dist/errors.d.ts +1 -1
- package/dist/hooks/handlers/index.d.ts +2 -2
- package/dist/hooks/handlers/index.d.ts.map +1 -1
- package/dist/hooks/handlers/notification-hooks.d.ts +31 -0
- package/dist/hooks/handlers/notification-hooks.d.ts.map +1 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4646 -3476
- package/dist/index.js.map +4 -4
- package/dist/init.d.ts +6 -6
- package/dist/init.d.ts.map +1 -1
- package/dist/injection.d.ts.map +1 -1
- package/dist/internal.d.ts +7 -5
- package/dist/internal.d.ts.map +1 -1
- package/dist/lib/index.d.ts +1 -0
- package/dist/lib/index.d.ts.map +1 -1
- package/dist/lib/tree-sitter-languages.d.ts +29 -0
- package/dist/lib/tree-sitter-languages.d.ts.map +1 -0
- package/dist/logger.d.ts +3 -3
- package/dist/memory/brain-links.d.ts.map +1 -1
- package/dist/memory/brain-maintenance.d.ts +13 -0
- package/dist/memory/brain-maintenance.d.ts.map +1 -1
- package/dist/memory/brain-retrieval.d.ts +1 -1
- package/dist/memory/brain-retrieval.d.ts.map +1 -1
- package/dist/memory/decisions.d.ts.map +1 -1
- package/dist/memory/engine-compat.d.ts +392 -25
- package/dist/memory/engine-compat.d.ts.map +1 -1
- package/dist/memory/index.d.ts +416 -3
- package/dist/memory/index.d.ts.map +1 -1
- package/dist/metrics/token-service.d.ts +3 -3
- package/dist/metrics/token-service.d.ts.map +1 -1
- package/dist/orchestration/hierarchy.d.ts +32 -0
- package/dist/orchestration/hierarchy.d.ts.map +1 -0
- package/dist/orchestration/index.d.ts +1 -0
- package/dist/orchestration/index.d.ts.map +1 -1
- package/dist/paths.d.ts +335 -2
- package/dist/paths.d.ts.map +1 -1
- package/dist/routing/capability-matrix.d.ts +3 -3
- package/dist/routing/capability-matrix.d.ts.map +1 -1
- package/dist/scaffold.d.ts +422 -11
- package/dist/scaffold.d.ts.map +1 -1
- package/dist/security/input-sanitization.d.ts +2 -2
- package/dist/skills/dynamic-skill-generator.d.ts +3 -2
- package/dist/skills/dynamic-skill-generator.d.ts.map +1 -1
- package/dist/skills/routing-table.d.ts +4 -4
- package/dist/skills/routing-table.d.ts.map +1 -1
- package/dist/store/agent-registry-accessor.d.ts +10 -433
- package/dist/store/agent-registry-accessor.d.ts.map +1 -1
- package/dist/store/cross-db-cleanup.d.ts +34 -0
- package/dist/store/cross-db-cleanup.d.ts.map +1 -1
- package/dist/store/provider.d.ts +1 -1
- package/dist/store/signaldock-sqlite.d.ts.map +1 -1
- package/dist/store/sqlite-data-accessor.d.ts.map +1 -1
- package/dist/store/sqlite.d.ts +1 -1
- package/dist/store/task-store.d.ts.map +1 -1
- package/dist/store/tasks-schema.d.ts +4 -228
- package/dist/store/tasks-schema.d.ts.map +1 -1
- package/dist/store/validation-schemas.d.ts +4 -5
- package/dist/store/validation-schemas.d.ts.map +1 -1
- package/dist/system/archive-analytics.d.ts +1 -1
- package/dist/system/health.d.ts +2 -2
- package/dist/system/health.d.ts.map +1 -1
- package/dist/system/runtime.d.ts +2 -1
- package/dist/system/runtime.d.ts.map +1 -1
- package/dist/tasks/list.d.ts +1 -1
- package/dist/tasks/list.d.ts.map +1 -1
- package/dist/tasks/task-ops.d.ts +415 -3
- package/dist/tasks/task-ops.d.ts.map +1 -1
- package/dist/templates/parser.d.ts +1 -1
- package/dist/ui/index.d.ts +1 -1
- package/dist/upgrade.d.ts +1 -1
- package/dist/upgrade.d.ts.map +1 -1
- package/dist/validation/operation-gate-validators.d.ts +1 -1
- package/dist/validation/operation-verification-gates.d.ts +3 -3
- package/dist/validation/param-utils.d.ts +6 -5
- package/dist/validation/param-utils.d.ts.map +1 -1
- package/dist/validation/validate-ops.d.ts +1 -1
- package/dist/validation/validate-ops.d.ts.map +1 -1
- package/package.json +19 -7
- package/src/__tests__/caamp-skill-install.test.js +0 -15
- package/src/__tests__/caamp-skill-install.test.js.map +1 -1
- package/src/__tests__/caamp-skill-install.test.ts +0 -16
- package/src/__tests__/injection-mvi-tiers.test.js +7 -7
- package/src/__tests__/injection-mvi-tiers.test.js.map +1 -1
- package/src/__tests__/injection-mvi-tiers.test.ts +55 -103
- package/src/agents/agent-schema.ts +2 -5
- package/src/audit.ts +2 -2
- package/src/bootstrap.ts +5 -39
- package/src/caamp/adapter.ts +3 -219
- package/src/caamp/index.ts +1 -13
- package/src/cant/__tests__/cant-agent-parse.test.d.ts.map +1 -0
- package/src/cant/__tests__/cant-agent-parse.test.js +77 -0
- package/src/cant/__tests__/cant-agent-parse.test.js.map +1 -0
- package/src/code/index.ts +10 -0
- package/src/code/outline.ts +214 -0
- package/src/code/parser.ts +331 -0
- package/src/code/search.ts +173 -0
- package/src/code/unfold.ts +204 -0
- package/src/codebase-map/analyzers/architecture.ts +2 -2
- package/src/compliance/protocol-enforcement.ts +1 -1
- package/src/compliance/protocol-rules.ts +1 -1
- package/src/compliance/protocol-types.ts +2 -3
- package/src/conduit/__tests__/dual-api-e2e.test.d.ts.map +1 -0
- package/src/conduit/__tests__/dual-api-e2e.test.js +178 -0
- package/src/conduit/__tests__/dual-api-e2e.test.js.map +1 -0
- package/src/conduit/__tests__/dual-api-e2e.test.ts +212 -0
- package/src/conduit/__tests__/local-credential-flow.test.d.ts.map +1 -0
- package/src/conduit/__tests__/local-credential-flow.test.js +185 -0
- package/src/conduit/__tests__/local-credential-flow.test.js.map +1 -0
- package/src/conduit/__tests__/local-credential-flow.test.ts +230 -0
- package/src/conduit/__tests__/local-transport.test.d.ts.map +1 -0
- package/src/conduit/__tests__/local-transport.test.js +404 -0
- package/src/conduit/__tests__/local-transport.test.js.map +1 -0
- package/src/conduit/__tests__/local-transport.test.ts +509 -0
- package/src/conduit/__tests__/sse-transport.test.d.ts.map +1 -0
- package/src/conduit/__tests__/sse-transport.test.js +291 -0
- package/src/conduit/__tests__/sse-transport.test.js.map +1 -0
- package/src/conduit/__tests__/sse-transport.test.ts +344 -0
- package/src/conduit/conduit-client.ts +14 -0
- package/src/conduit/factory.ts +29 -8
- package/src/conduit/http-transport.ts +78 -16
- package/src/conduit/index.ts +5 -2
- package/src/conduit/local-transport.ts +309 -0
- package/src/conduit/sse-transport.ts +382 -0
- package/src/crypto/credentials.ts +59 -13
- package/src/error-catalog.ts +3 -3
- package/src/errors.ts +1 -1
- package/src/hooks/__tests__/provider-hooks.test.js +4 -4
- package/src/hooks/__tests__/provider-hooks.test.js.map +1 -1
- package/src/hooks/__tests__/provider-hooks.test.ts +4 -4
- package/src/hooks/handlers/__tests__/hook-automation-e2e.test.js +2 -2
- package/src/hooks/handlers/__tests__/hook-automation-e2e.test.js.map +1 -1
- package/src/hooks/handlers/__tests__/hook-automation-e2e.test.ts +6 -4
- package/src/hooks/handlers/index.ts +2 -6
- package/src/hooks/handlers/notification-hooks.ts +65 -0
- package/src/index.ts +2 -1
- package/src/init.ts +14 -54
- package/src/injection.ts +4 -3
- package/src/internal.ts +7 -5
- package/src/lib/index.ts +8 -0
- package/src/lib/tree-sitter-languages.ts +88 -0
- package/src/logger.ts +5 -5
- package/src/memory/__tests__/brain-links.test.js +13 -0
- package/src/memory/__tests__/brain-links.test.js.map +1 -1
- package/src/memory/__tests__/brain-links.test.ts +14 -0
- package/src/memory/__tests__/brain-retrieval.test.js +9 -0
- package/src/memory/__tests__/brain-retrieval.test.js.map +1 -1
- package/src/memory/__tests__/brain-retrieval.test.ts +10 -0
- package/src/memory/__tests__/session-memory.test.js +16 -0
- package/src/memory/__tests__/session-memory.test.js.map +1 -1
- package/src/memory/__tests__/session-memory.test.ts +17 -0
- package/src/memory/brain-links.ts +17 -0
- package/src/memory/brain-maintenance.ts +33 -1
- package/src/memory/brain-retrieval.ts +19 -3
- package/src/memory/decisions.ts +18 -2
- package/src/memory/engine-compat.ts +392 -25
- package/src/memory/index.ts +417 -4
- package/src/metrics/token-service.ts +4 -4
- package/src/migration/index.ts +1 -1
- package/src/orchestration/hierarchy.ts +202 -0
- package/src/orchestration/index.ts +1 -0
- package/src/paths.ts +340 -5
- package/src/routing/capability-matrix.ts +49 -49
- package/src/scaffold.ts +428 -70
- package/src/security/input-sanitization.ts +4 -4
- package/src/sessions/__tests__/session-grade.integration.test.js +9 -9
- package/src/sessions/__tests__/session-grade.integration.test.ts +9 -9
- package/src/sessions/__tests__/session-grade.test.js +10 -10
- package/src/sessions/__tests__/session-grade.test.js.map +1 -1
- package/src/sessions/__tests__/session-grade.test.ts +10 -10
- package/src/sessions/session-grade.ts +4 -4
- package/src/skills/__tests__/dynamic-skill-generator.test.js +24 -26
- package/src/skills/__tests__/dynamic-skill-generator.test.js.map +1 -1
- package/src/skills/__tests__/dynamic-skill-generator.test.ts +24 -26
- package/src/skills/__tests__/routing-table.test.js +22 -22
- package/src/skills/__tests__/routing-table.test.js.map +1 -1
- package/src/skills/__tests__/routing-table.test.ts +23 -23
- package/src/skills/dynamic-skill-generator.ts +13 -24
- package/src/skills/routing-table.ts +4 -4
- package/src/store/__tests__/data-safety-central.test.js +8 -0
- package/src/store/__tests__/data-safety-central.test.js.map +1 -1
- package/src/store/__tests__/data-safety-central.test.ts +8 -0
- package/src/store/__tests__/safety-accessor.test.js +8 -0
- package/src/store/__tests__/safety-accessor.test.js.map +1 -1
- package/src/store/__tests__/safety-accessor.test.ts +8 -0
- package/src/store/agent-registry-accessor.ts +284 -108
- package/src/store/cross-db-cleanup.ts +175 -1
- package/src/store/provider.ts +2 -2
- package/src/store/signaldock-sqlite.ts +262 -60
- package/src/store/sqlite-data-accessor.ts +3 -0
- package/src/store/sqlite.ts +2 -2
- package/src/store/task-store.ts +8 -1
- package/src/store/tasks-schema.ts +5 -40
- package/src/system/__tests__/health.test.js +2 -2
- package/src/system/__tests__/health.test.js.map +1 -1
- package/src/system/__tests__/health.test.ts +2 -2
- package/src/system/archive-analytics.ts +1 -1
- package/src/system/health.ts +43 -19
- package/src/system/inject-generate.ts +20 -20
- package/src/system/runtime.ts +5 -4
- package/src/tasks/atomicity.ts +1 -1
- package/src/tasks/list.ts +1 -1
- package/src/tasks/task-ops.ts +415 -3
- package/src/templates/parser.ts +1 -1
- package/src/ui/index.ts +4 -4
- package/src/upgrade.ts +3 -14
- package/src/validation/operation-gate-validators.ts +1 -1
- package/src/validation/operation-verification-gates.ts +3 -3
- package/src/validation/param-utils.ts +11 -10
- package/src/validation/validate-ops.ts +6 -6
- package/templates/CLEO-INJECTION.md +38 -110
- package/dist/hooks/handlers/mcp-hooks.d.ts +0 -48
- package/dist/hooks/handlers/mcp-hooks.d.ts.map +0 -1
- package/dist/mcp/index.d.ts +0 -42
- package/dist/mcp/index.d.ts.map +0 -1
- package/src/__tests__/audit-prune.test.d.ts +0 -2
- package/src/__tests__/caamp-skill-install.test.d.ts +0 -14
- package/src/__tests__/cli-mcp-parity.integration.test.d.ts +0 -34
- package/src/__tests__/cli-mcp-parity.integration.test.d.ts.map +0 -1
- package/src/__tests__/cli-mcp-parity.integration.test.js +0 -898
- package/src/__tests__/cli-mcp-parity.integration.test.js.map +0 -1
- package/src/__tests__/cli-parity.test.d.ts +0 -9
- package/src/__tests__/config.test.d.ts +0 -7
- package/src/__tests__/core-parity.test.d.ts +0 -17
- package/src/__tests__/error-catalog.test.d.ts +0 -2
- package/src/__tests__/golden-parity.test.d.ts +0 -12
- package/src/__tests__/hooks.test.d.ts +0 -5
- package/src/__tests__/human-output.test.d.ts +0 -12
- package/src/__tests__/index-api-compat.test.d.ts +0 -2
- package/src/__tests__/init-e2e.test.d.ts +0 -12
- package/src/__tests__/injection-chain.test.d.ts +0 -18
- package/src/__tests__/injection-mvi-tiers.test.d.ts +0 -14
- package/src/__tests__/injection-shared.test.d.ts +0 -10
- package/src/__tests__/lafs-conformance.test.d.ts +0 -18
- package/src/__tests__/logger.test.d.ts +0 -2
- package/src/__tests__/mcp-install-verify.test.d.ts +0 -13
- package/src/__tests__/mcp-install-verify.test.d.ts.map +0 -1
- package/src/__tests__/mcp-install-verify.test.js +0 -177
- package/src/__tests__/mcp-install-verify.test.js.map +0 -1
- package/src/__tests__/mcp-install-verify.test.ts +0 -217
- package/src/__tests__/paths.test.d.ts +0 -7
- package/src/__tests__/project-info.test.d.ts +0 -2
- package/src/__tests__/rcsd-pipeline-e2e.test.d.ts +0 -14
- package/src/__tests__/remote.test.d.ts +0 -6
- package/src/__tests__/scaffold.test.d.ts +0 -6
- package/src/__tests__/schema-management.test.d.ts +0 -5
- package/src/__tests__/schema.test.d.ts +0 -2
- package/src/__tests__/sharing.test.d.ts +0 -6
- package/src/__tests__/snapshot.test.d.ts +0 -6
- package/src/__tests__/upgrade.test.d.ts +0 -7
- package/src/adapters/__tests__/discovery.test.d.ts +0 -6
- package/src/adapters/__tests__/manager.test.d.ts +0 -6
- package/src/agents/__tests__/agent-registry.test.d.ts +0 -12
- package/src/agents/__tests__/capacity.test.d.ts +0 -7
- package/src/agents/__tests__/execution-learning.test.d.ts +0 -14
- package/src/agents/__tests__/health-monitor.test.d.ts +0 -10
- package/src/agents/__tests__/registry.test.d.ts +0 -8
- package/src/agents/__tests__/retry.test.d.ts +0 -7
- package/src/compliance/__tests__/sync.test.d.ts +0 -5
- package/src/hooks/__tests__/provider-hooks.test.d.ts +0 -2
- package/src/hooks/__tests__/registry.test.d.ts +0 -2
- package/src/hooks/handlers/__tests__/error-hooks.test.d.ts +0 -2
- package/src/hooks/handlers/__tests__/file-hooks.test.d.ts +0 -2
- package/src/hooks/handlers/__tests__/hook-automation-e2e.test.d.ts +0 -13
- package/src/hooks/handlers/__tests__/mcp-hooks.test.d.ts +0 -2
- package/src/hooks/handlers/__tests__/mcp-hooks.test.d.ts.map +0 -1
- package/src/hooks/handlers/__tests__/mcp-hooks.test.js +0 -119
- package/src/hooks/handlers/__tests__/mcp-hooks.test.js.map +0 -1
- package/src/hooks/handlers/__tests__/mcp-hooks.test.ts +0 -150
- package/src/hooks/handlers/__tests__/session-hooks.test.d.ts +0 -2
- package/src/hooks/handlers/__tests__/task-hooks.test.d.ts +0 -2
- package/src/hooks/handlers/mcp-hooks.ts +0 -162
- package/src/intelligence/__tests__/adaptive-validation.test.d.ts +0 -11
- package/src/intelligence/__tests__/impact.test.d.ts +0 -16
- package/src/intelligence/__tests__/patterns.test.d.ts +0 -8
- package/src/intelligence/__tests__/prediction.test.d.ts +0 -8
- package/src/lib/__tests__/retry.test.d.ts +0 -7
- package/src/lifecycle/__tests__/chain-store.test.d.ts +0 -10
- package/src/lifecycle/__tests__/consolidate-rcasd.test.d.ts +0 -7
- package/src/lifecycle/__tests__/default-chain.test.d.ts +0 -7
- package/src/lifecycle/__tests__/frontmatter.test.d.ts +0 -7
- package/src/lifecycle/__tests__/lifecycle.test.d.ts +0 -7
- package/src/lifecycle/__tests__/pipeline.integration.test.d.ts +0 -19
- package/src/lifecycle/__tests__/rcasd-paths.test.d.ts +0 -7
- package/src/lifecycle/__tests__/resume-schema-contract.test.d.ts +0 -16
- package/src/lifecycle/__tests__/stage-record-provenance.integration.test.d.ts +0 -7
- package/src/lifecycle/__tests__/tessera-engine.test.d.ts +0 -10
- package/src/mcp/index.ts +0 -163
- package/src/memory/__tests__/auto-extract.test.d.ts +0 -7
- package/src/memory/__tests__/brain-automation.test.d.ts +0 -11
- package/src/memory/__tests__/brain-embedding.test.d.ts +0 -2
- package/src/memory/__tests__/brain-links.test.d.ts +0 -8
- package/src/memory/__tests__/brain-migration.test.d.ts +0 -8
- package/src/memory/__tests__/brain-retrieval.test.d.ts +0 -10
- package/src/memory/__tests__/brain-search.test.d.ts +0 -8
- package/src/memory/__tests__/claude-mem-migration.test.d.ts +0 -12
- package/src/memory/__tests__/decisions.test.d.ts +0 -8
- package/src/memory/__tests__/engine-compat.test.d.ts +0 -12
- package/src/memory/__tests__/memory-bridge.test.d.ts +0 -10
- package/src/memory/__tests__/pipeline-manifest-sqlite.test.d.ts +0 -13
- package/src/memory/__tests__/session-memory.test.d.ts +0 -9
- package/src/metrics/__tests__/model-provider-registry.test.d.ts +0 -2
- package/src/metrics/__tests__/provider-detection.test.d.ts +0 -2
- package/src/migration/__tests__/checksum.test.d.ts +0 -8
- package/src/migration/__tests__/logger.test.d.ts +0 -5
- package/src/migration/__tests__/migration-failure.integration.test.d.ts +0 -15
- package/src/migration/__tests__/migration.test.d.ts +0 -13
- package/src/migration/__tests__/state.test.d.ts +0 -8
- package/src/migration/__tests__/validate.test.d.ts +0 -8
- package/src/nexus/__tests__/deps.test.d.ts +0 -7
- package/src/nexus/__tests__/nexus-e2e.test.d.ts +0 -12
- package/src/nexus/__tests__/permissions.test.d.ts +0 -7
- package/src/nexus/__tests__/query.test.d.ts +0 -7
- package/src/nexus/__tests__/reconcile.test.d.ts +0 -7
- package/src/nexus/__tests__/registry.test.d.ts +0 -7
- package/src/nexus/__tests__/transfer.test.d.ts +0 -8
- package/src/observability/__tests__/index.test.d.ts +0 -7
- package/src/observability/__tests__/log-filter.test.d.ts +0 -7
- package/src/observability/__tests__/log-parser.test.d.ts +0 -7
- package/src/observability/__tests__/log-reader.test.d.ts +0 -7
- package/src/orchestration/__tests__/autonomous-spec.test.d.ts +0 -9
- package/src/orchestration/__tests__/orchestration.test.d.ts +0 -7
- package/src/orchestration/__tests__/protocol-validators.test.d.ts +0 -9
- package/src/phases/__tests__/deps.test.d.ts +0 -7
- package/src/phases/__tests__/phases.test.d.ts +0 -7
- package/src/release/__tests__/artifacts.test.d.ts +0 -7
- package/src/release/__tests__/cancel-release.test.d.ts +0 -10
- package/src/release/__tests__/changelog-writer.test.d.ts +0 -6
- package/src/release/__tests__/push-policy.test.d.ts +0 -14
- package/src/release/__tests__/release.test.d.ts +0 -11
- package/src/sequence/__tests__/allocate.test.d.ts +0 -6
- package/src/sessions/__tests__/briefing-blocked.test.d.ts +0 -6
- package/src/sessions/__tests__/briefing.test.d.ts +0 -11
- package/src/sessions/__tests__/handoff-integration.test.d.ts +0 -8
- package/src/sessions/__tests__/handoff.test.d.ts +0 -11
- package/src/sessions/__tests__/index.test.d.ts +0 -2
- package/src/sessions/__tests__/session-cleanup.test.d.ts +0 -7
- package/src/sessions/__tests__/session-edge-cases.test.d.ts +0 -9
- package/src/sessions/__tests__/session-find.test.d.ts +0 -9
- package/src/sessions/__tests__/session-grade.integration.test.d.ts +0 -11
- package/src/sessions/__tests__/session-grade.test.d.ts +0 -6
- package/src/sessions/__tests__/session-memory-bridge.test.d.ts +0 -2
- package/src/sessions/__tests__/sessions.test.d.ts +0 -7
- package/src/skills/__tests__/discovery.test.d.ts +0 -6
- package/src/skills/__tests__/dispatch.test.d.ts +0 -6
- package/src/skills/__tests__/dynamic-skill-generator.test.d.ts +0 -2
- package/src/skills/__tests__/manifests.test.d.ts +0 -6
- package/src/skills/__tests__/precedence.test.d.ts +0 -6
- package/src/skills/__tests__/routing-table.test.d.ts +0 -2
- package/src/skills/__tests__/skill-paths.test.d.ts +0 -7
- package/src/skills/__tests__/test-utility.test.d.ts +0 -7
- package/src/skills/__tests__/token.test.d.ts +0 -6
- package/src/skills/__tests__/validation.test.d.ts +0 -6
- package/src/skills/__tests__/version.test.d.ts +0 -5
- package/src/skills/injection/__tests__/subagent.test.d.ts +0 -2
- package/src/skills/orchestrator/__tests__/spawn-tier.test.d.ts +0 -2
- package/src/spawn/__tests__/adapter-registry.test.d.ts +0 -2
- package/src/stats/__tests__/stats.test.d.ts +0 -7
- package/src/sticky/__tests__/purge.test.d.ts +0 -9
- package/src/store/__tests__/atomic.test.d.ts +0 -7
- package/src/store/__tests__/backup.test.d.ts +0 -7
- package/src/store/__tests__/brain-accessor-pageindex.test.d.ts +0 -12
- package/src/store/__tests__/brain-accessor.test.d.ts +0 -10
- package/src/store/__tests__/brain-pageindex.test.d.ts +0 -11
- package/src/store/__tests__/brain-schema.test.d.ts +0 -11
- package/src/store/__tests__/brain-vec.test.d.ts +0 -11
- package/src/store/__tests__/collision-detection.test.d.ts +0 -11
- package/src/store/__tests__/data-safety-central.test.d.ts +0 -20
- package/src/store/__tests__/db-helpers.test.d.ts +0 -7
- package/src/store/__tests__/e2e-safety-integration.test.d.ts +0 -13
- package/src/store/__tests__/git-checkpoint.test.d.ts +0 -7
- package/src/store/__tests__/idempotent-migration.test.d.ts +0 -5
- package/src/store/__tests__/import-logging.test.d.ts +0 -7
- package/src/store/__tests__/import-sort.test.d.ts +0 -7
- package/src/store/__tests__/json.test.d.ts +0 -7
- package/src/store/__tests__/lifecycle-schema-parity.test.d.ts +0 -2
- package/src/store/__tests__/migration-integration.test.d.ts +0 -15
- package/src/store/__tests__/migration-retry.test.d.ts +0 -10
- package/src/store/__tests__/migration-safety.test.d.ts +0 -21
- package/src/store/__tests__/migration-sqlite.test.d.ts +0 -11
- package/src/store/__tests__/performance-safety.test.d.ts +0 -17
- package/src/store/__tests__/project-detect.test.d.ts +0 -6
- package/src/store/__tests__/project-registry.test.d.ts +0 -7
- package/src/store/__tests__/provider.test.d.ts +0 -9
- package/src/store/__tests__/relations.test.d.ts +0 -9
- package/src/store/__tests__/safety-accessor.test.d.ts +0 -18
- package/src/store/__tests__/sequence-validation.test.d.ts +0 -11
- package/src/store/__tests__/session-store.test.d.ts +0 -11
- package/src/store/__tests__/sqlite-backup.test.d.ts +0 -14
- package/src/store/__tests__/sqlite.test.d.ts +0 -11
- package/src/store/__tests__/task-store.test.d.ts +0 -11
- package/src/store/__tests__/test-db-helper.d.ts +0 -61
- package/src/store/__tests__/write-verification.test.d.ts +0 -11
- package/src/system/__tests__/cleanup.test.d.ts +0 -2
- package/src/system/__tests__/health.test.d.ts +0 -2
- package/src/task-work/__tests__/start-deps.test.d.ts +0 -6
- package/src/tasks/__tests__/add.test.d.ts +0 -7
- package/src/tasks/__tests__/archive.test.d.ts +0 -7
- package/src/tasks/__tests__/assignee.test.d.ts +0 -14
- package/src/tasks/__tests__/atomicity.test.d.ts +0 -6
- package/src/tasks/__tests__/cancel-ops.test.d.ts +0 -7
- package/src/tasks/__tests__/complete-unblocks.test.d.ts +0 -6
- package/src/tasks/__tests__/complete.test.d.ts +0 -7
- package/src/tasks/__tests__/delete.test.d.ts +0 -7
- package/src/tasks/__tests__/dependency-check.test.d.ts +0 -7
- package/src/tasks/__tests__/deps-ready.test.d.ts +0 -6
- package/src/tasks/__tests__/epic-enforcement.test.d.ts +0 -15
- package/src/tasks/__tests__/find.test.d.ts +0 -7
- package/src/tasks/__tests__/graph-ops.test.d.ts +0 -7
- package/src/tasks/__tests__/hierarchy-policy.test.d.ts +0 -6
- package/src/tasks/__tests__/hierarchy.test.d.ts +0 -7
- package/src/tasks/__tests__/id-generator.test.d.ts +0 -2
- package/src/tasks/__tests__/labels.test.d.ts +0 -7
- package/src/tasks/__tests__/list.test.d.ts +0 -7
- package/src/tasks/__tests__/minimal-test.test.d.ts +0 -2
- package/src/tasks/__tests__/phase-tracking.test.d.ts +0 -7
- package/src/tasks/__tests__/pipeline-stage.test.d.ts +0 -14
- package/src/tasks/__tests__/plan-priority.test.d.ts +0 -10
- package/src/tasks/__tests__/priority-normalization.test.d.ts +0 -7
- package/src/tasks/__tests__/relates.test.d.ts +0 -9
- package/src/tasks/__tests__/show-deps.test.d.ts +0 -6
- package/src/tasks/__tests__/show.test.d.ts +0 -7
- package/src/tasks/__tests__/staleness.test.d.ts +0 -7
- package/src/tasks/__tests__/task-ops-depends.test.d.ts +0 -6
- package/src/tasks/__tests__/update.test.d.ts +0 -7
- package/src/validation/__tests__/chain-validation.test.d.ts +0 -7
- package/src/validation/__tests__/compliance.test.d.ts +0 -7
- package/src/validation/__tests__/docs-sync.test.d.ts +0 -7
- package/src/validation/__tests__/doctor-gitignore.test.d.ts +0 -7
- package/src/validation/__tests__/doctor-injection.test.d.ts +0 -11
- package/src/validation/__tests__/doctor.test.d.ts +0 -7
- package/src/validation/__tests__/engine.test.d.ts +0 -7
- package/src/validation/__tests__/manifest.test.d.ts +0 -7
- package/src/validation/__tests__/protocol-common.test.d.ts +0 -7
- package/src/validation/__tests__/verification.test.d.ts +0 -7
|
@@ -15,17 +15,77 @@
|
|
|
15
15
|
import type { EngineResult } from '../engine-result.js';
|
|
16
16
|
import { type SearchLearningParams, type StoreLearningParams } from './learnings.js';
|
|
17
17
|
import { type SearchPatternParams, type StorePatternParams } from './patterns.js';
|
|
18
|
-
/**
|
|
18
|
+
/**
|
|
19
|
+
* Look up a brain.db entry by ID.
|
|
20
|
+
*
|
|
21
|
+
* @param entryId - Brain entry ID with type prefix (D-, P-, L-, O-, or CM-)
|
|
22
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
23
|
+
* @returns EngineResult containing the typed entry data on success
|
|
24
|
+
*
|
|
25
|
+
* @remarks
|
|
26
|
+
* Parses the ID prefix to determine the entry type (decision, pattern, learning,
|
|
27
|
+
* or observation) and queries the corresponding brain.db table.
|
|
28
|
+
*
|
|
29
|
+
* @example
|
|
30
|
+
* ```typescript
|
|
31
|
+
* const result = await memoryShow('O-abc123', '/project');
|
|
32
|
+
* if (result.success) console.log(result.data.type, result.data.entry);
|
|
33
|
+
* ```
|
|
34
|
+
*/
|
|
19
35
|
export declare function memoryShow(entryId: string, projectRoot?: string): Promise<EngineResult>;
|
|
20
|
-
/**
|
|
36
|
+
/**
|
|
37
|
+
* Aggregate stats from brain.db across all tables.
|
|
38
|
+
*
|
|
39
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
40
|
+
* @returns EngineResult with observation, decision, pattern, and learning counts
|
|
41
|
+
*
|
|
42
|
+
* @remarks
|
|
43
|
+
* Queries each brain.db table for row counts and returns a combined statistics object.
|
|
44
|
+
* Returns zero counts if brain.db is not initialized.
|
|
45
|
+
*
|
|
46
|
+
* @example
|
|
47
|
+
* ```typescript
|
|
48
|
+
* const result = await memoryBrainStats('/project');
|
|
49
|
+
* if (result.success) console.log(result.data.observations);
|
|
50
|
+
* ```
|
|
51
|
+
*/
|
|
21
52
|
export declare function memoryBrainStats(projectRoot?: string): Promise<EngineResult>;
|
|
22
|
-
/**
|
|
53
|
+
/**
|
|
54
|
+
* Search decisions in brain.db.
|
|
55
|
+
*
|
|
56
|
+
* @param params - Search parameters (query, limit, etc.)
|
|
57
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
58
|
+
* @returns EngineResult with matching decision entries
|
|
59
|
+
*
|
|
60
|
+
* @remarks
|
|
61
|
+
* Queries the brain.db decisions table with optional text filtering and pagination.
|
|
62
|
+
*
|
|
63
|
+
* @example
|
|
64
|
+
* ```typescript
|
|
65
|
+
* const result = await memoryDecisionFind({ query: 'auth' }, '/project');
|
|
66
|
+
* ```
|
|
67
|
+
*/
|
|
23
68
|
export declare function memoryDecisionFind(params: {
|
|
24
69
|
query?: string;
|
|
25
70
|
taskId?: string;
|
|
26
71
|
limit?: number;
|
|
27
72
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
28
|
-
/**
|
|
73
|
+
/**
|
|
74
|
+
* Store a decision to brain.db.
|
|
75
|
+
*
|
|
76
|
+
* @param params - Decision data including title, rationale, and alternatives
|
|
77
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
78
|
+
* @returns EngineResult with the stored decision ID
|
|
79
|
+
*
|
|
80
|
+
* @remarks
|
|
81
|
+
* Creates a new decision entry in brain.db with a D-prefixed ID.
|
|
82
|
+
* Optionally refreshes the memory bridge after storing.
|
|
83
|
+
*
|
|
84
|
+
* @example
|
|
85
|
+
* ```typescript
|
|
86
|
+
* const result = await memoryDecisionStore({ title: 'Use SQLite', rationale: 'Embedded, fast' }, '/project');
|
|
87
|
+
* ```
|
|
88
|
+
*/
|
|
29
89
|
export declare function memoryDecisionStore(params: {
|
|
30
90
|
decision: string;
|
|
31
91
|
rationale: string;
|
|
@@ -33,7 +93,22 @@ export declare function memoryDecisionStore(params: {
|
|
|
33
93
|
taskId?: string;
|
|
34
94
|
sessionId?: string;
|
|
35
95
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
36
|
-
/**
|
|
96
|
+
/**
|
|
97
|
+
* Token-efficient brain search returning compact results.
|
|
98
|
+
*
|
|
99
|
+
* @param params - Search parameters including query string and limit
|
|
100
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
101
|
+
* @returns EngineResult with compact search hits (IDs and titles)
|
|
102
|
+
*
|
|
103
|
+
* @remarks
|
|
104
|
+
* Designed for the cheapest-first retrieval pattern. Returns minimal fields
|
|
105
|
+
* per hit to conserve tokens. Use memoryFetch for full entry details.
|
|
106
|
+
*
|
|
107
|
+
* @example
|
|
108
|
+
* ```typescript
|
|
109
|
+
* const result = await memoryFind({ query: 'authentication', limit: 10 }, '/project');
|
|
110
|
+
* ```
|
|
111
|
+
*/
|
|
37
112
|
export declare function memoryFind(params: {
|
|
38
113
|
query: string;
|
|
39
114
|
limit?: number;
|
|
@@ -41,17 +116,62 @@ export declare function memoryFind(params: {
|
|
|
41
116
|
dateStart?: string;
|
|
42
117
|
dateEnd?: string;
|
|
43
118
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
44
|
-
/**
|
|
119
|
+
/**
|
|
120
|
+
* Chronological context around a brain entry anchor.
|
|
121
|
+
*
|
|
122
|
+
* @param params - Timeline parameters including anchor ID and window size
|
|
123
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
124
|
+
* @returns EngineResult with chronologically ordered entries around the anchor
|
|
125
|
+
*
|
|
126
|
+
* @remarks
|
|
127
|
+
* Retrieves entries before and after a given anchor ID for temporal context.
|
|
128
|
+
* Useful for understanding the sequence of observations and decisions.
|
|
129
|
+
*
|
|
130
|
+
* @example
|
|
131
|
+
* ```typescript
|
|
132
|
+
* const result = await memoryTimeline({ anchorId: 'O-abc123', window: 5 }, '/project');
|
|
133
|
+
* ```
|
|
134
|
+
*/
|
|
45
135
|
export declare function memoryTimeline(params: {
|
|
46
136
|
anchor: string;
|
|
47
137
|
depthBefore?: number;
|
|
48
138
|
depthAfter?: number;
|
|
49
139
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
50
|
-
/**
|
|
140
|
+
/**
|
|
141
|
+
* Batch fetch brain entries by IDs.
|
|
142
|
+
*
|
|
143
|
+
* @param params - Fetch parameters including an array of entry IDs
|
|
144
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
145
|
+
* @returns EngineResult with full entry details for each requested ID
|
|
146
|
+
*
|
|
147
|
+
* @remarks
|
|
148
|
+
* Use after memoryFind to retrieve full details for specific entries.
|
|
149
|
+
* Part of the 3-layer retrieval pattern: search -> filter -> fetch.
|
|
150
|
+
*
|
|
151
|
+
* @example
|
|
152
|
+
* ```typescript
|
|
153
|
+
* const result = await memoryFetch({ ids: ['O-abc123', 'D-def456'] }, '/project');
|
|
154
|
+
* ```
|
|
155
|
+
*/
|
|
51
156
|
export declare function memoryFetch(params: {
|
|
52
157
|
ids: string[];
|
|
53
158
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
54
|
-
/**
|
|
159
|
+
/**
|
|
160
|
+
* Save an observation to brain.db.
|
|
161
|
+
*
|
|
162
|
+
* @param params - Observation data including text, title, and optional tags
|
|
163
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
164
|
+
* @returns EngineResult with the stored observation ID
|
|
165
|
+
*
|
|
166
|
+
* @remarks
|
|
167
|
+
* Creates a new observation entry in brain.db with an O-prefixed ID.
|
|
168
|
+
* Optionally refreshes the memory bridge after storing.
|
|
169
|
+
*
|
|
170
|
+
* @example
|
|
171
|
+
* ```typescript
|
|
172
|
+
* const result = await memoryObserve({ text: 'Auth uses JWT', title: 'Auth discovery' }, '/project');
|
|
173
|
+
* ```
|
|
174
|
+
*/
|
|
55
175
|
export declare function memoryObserve(params: {
|
|
56
176
|
text: string;
|
|
57
177
|
title?: string;
|
|
@@ -60,44 +180,201 @@ export declare function memoryObserve(params: {
|
|
|
60
180
|
sourceSessionId?: string;
|
|
61
181
|
sourceType?: string;
|
|
62
182
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
63
|
-
/**
|
|
183
|
+
/**
|
|
184
|
+
* Store a pattern to BRAIN memory.
|
|
185
|
+
*
|
|
186
|
+
* @param params - Pattern data including pattern string, type, and confidence
|
|
187
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
188
|
+
* @returns EngineResult with the stored pattern ID
|
|
189
|
+
*
|
|
190
|
+
* @remarks
|
|
191
|
+
* Persists a detected pattern (success or failure) to brain.db for future scoring.
|
|
192
|
+
*
|
|
193
|
+
* @example
|
|
194
|
+
* ```typescript
|
|
195
|
+
* const result = await memoryPatternStore({ pattern: 'migration', type: 'success' }, '/project');
|
|
196
|
+
* ```
|
|
197
|
+
*/
|
|
64
198
|
export declare function memoryPatternStore(params: StorePatternParams, projectRoot?: string): Promise<EngineResult>;
|
|
65
|
-
/**
|
|
199
|
+
/**
|
|
200
|
+
* Search patterns in BRAIN memory.
|
|
201
|
+
*
|
|
202
|
+
* @param params - Search parameters including query and type filter
|
|
203
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
204
|
+
* @returns EngineResult with matching pattern entries
|
|
205
|
+
*
|
|
206
|
+
* @remarks
|
|
207
|
+
* Queries the brain.db patterns table with optional type filtering.
|
|
208
|
+
*
|
|
209
|
+
* @example
|
|
210
|
+
* ```typescript
|
|
211
|
+
* const result = await memoryPatternFind({ type: 'success', limit: 10 }, '/project');
|
|
212
|
+
* ```
|
|
213
|
+
*/
|
|
66
214
|
export declare function memoryPatternFind(params: SearchPatternParams, projectRoot?: string): Promise<EngineResult>;
|
|
67
|
-
/**
|
|
215
|
+
/**
|
|
216
|
+
* Get pattern memory statistics.
|
|
217
|
+
*
|
|
218
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
219
|
+
* @returns EngineResult with pattern counts by type and overall totals
|
|
220
|
+
*
|
|
221
|
+
* @remarks
|
|
222
|
+
* Aggregates pattern data from brain.db to provide type distribution and counts.
|
|
223
|
+
*
|
|
224
|
+
* @example
|
|
225
|
+
* ```typescript
|
|
226
|
+
* const result = await memoryPatternStats('/project');
|
|
227
|
+
* ```
|
|
228
|
+
*/
|
|
68
229
|
export declare function memoryPatternStats(projectRoot?: string): Promise<EngineResult>;
|
|
69
|
-
/**
|
|
230
|
+
/**
|
|
231
|
+
* Store a learning to BRAIN memory.
|
|
232
|
+
*
|
|
233
|
+
* @param params - Learning data including text and confidence level
|
|
234
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
235
|
+
* @returns EngineResult with the stored learning ID
|
|
236
|
+
*
|
|
237
|
+
* @remarks
|
|
238
|
+
* Creates a new learning entry in brain.db with an L-prefixed ID.
|
|
239
|
+
*
|
|
240
|
+
* @example
|
|
241
|
+
* ```typescript
|
|
242
|
+
* const result = await memoryLearningStore({ text: 'Drizzle v1 requires beta flag' }, '/project');
|
|
243
|
+
* ```
|
|
244
|
+
*/
|
|
70
245
|
export declare function memoryLearningStore(params: StoreLearningParams, projectRoot?: string): Promise<EngineResult>;
|
|
71
|
-
/**
|
|
246
|
+
/**
|
|
247
|
+
* Search learnings in BRAIN memory.
|
|
248
|
+
*
|
|
249
|
+
* @param params - Search parameters including query and limit
|
|
250
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
251
|
+
* @returns EngineResult with matching learning entries
|
|
252
|
+
*
|
|
253
|
+
* @remarks
|
|
254
|
+
* Queries the brain.db learnings table with optional text filtering.
|
|
255
|
+
*
|
|
256
|
+
* @example
|
|
257
|
+
* ```typescript
|
|
258
|
+
* const result = await memoryLearningFind({ query: 'drizzle' }, '/project');
|
|
259
|
+
* ```
|
|
260
|
+
*/
|
|
72
261
|
export declare function memoryLearningFind(params: SearchLearningParams, projectRoot?: string): Promise<EngineResult>;
|
|
73
|
-
/**
|
|
262
|
+
/**
|
|
263
|
+
* Get learning memory statistics.
|
|
264
|
+
*
|
|
265
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
266
|
+
* @returns EngineResult with learning counts and confidence distribution
|
|
267
|
+
*
|
|
268
|
+
* @remarks
|
|
269
|
+
* Aggregates learning data from brain.db to provide totals and breakdowns.
|
|
270
|
+
*
|
|
271
|
+
* @example
|
|
272
|
+
* ```typescript
|
|
273
|
+
* const result = await memoryLearningStats('/project');
|
|
274
|
+
* ```
|
|
275
|
+
*/
|
|
74
276
|
export declare function memoryLearningStats(projectRoot?: string): Promise<EngineResult>;
|
|
75
|
-
/**
|
|
277
|
+
/**
|
|
278
|
+
* Find contradictory entries in brain.db.
|
|
279
|
+
*
|
|
280
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
281
|
+
* @returns EngineResult with pairs of contradicting observations
|
|
282
|
+
*
|
|
283
|
+
* @remarks
|
|
284
|
+
* Scans brain.db for observations that contradict each other based on
|
|
285
|
+
* semantic similarity and opposing sentiment or content.
|
|
286
|
+
*
|
|
287
|
+
* @example
|
|
288
|
+
* ```typescript
|
|
289
|
+
* const result = await memoryContradictions('/project');
|
|
290
|
+
* if (result.success) console.log(result.data.contradictions);
|
|
291
|
+
* ```
|
|
292
|
+
*/
|
|
76
293
|
export declare function memoryContradictions(projectRoot?: string): Promise<EngineResult>;
|
|
77
|
-
/**
|
|
294
|
+
/**
|
|
295
|
+
* Find superseded entries in brain.db.
|
|
78
296
|
*
|
|
79
297
|
* Identifies entries that have been superseded by newer entries on the same topic.
|
|
298
|
+
*
|
|
299
|
+
* @param params - Superseded search parameters
|
|
300
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
301
|
+
* @returns EngineResult with superseded entry pairs and their replacements
|
|
302
|
+
*
|
|
303
|
+
* @remarks
|
|
304
|
+
* Scans brain.db for entries where a newer observation or decision covers
|
|
305
|
+
* the same topic, rendering the older entry obsolete.
|
|
306
|
+
*
|
|
80
307
|
* For brain.db, we group by:
|
|
81
308
|
* - Decisions: type + contextTaskId/contextEpicId
|
|
82
309
|
* - Patterns: type + context (first 100 chars for similarity)
|
|
83
310
|
* - Learnings: source + applicableTypes
|
|
84
311
|
* - Observations: type + project
|
|
312
|
+
*
|
|
313
|
+
* @example
|
|
314
|
+
* ```typescript
|
|
315
|
+
* const result = await memorySuperseded({ type: 'decision' }, '/project');
|
|
316
|
+
* ```
|
|
85
317
|
*/
|
|
86
318
|
export declare function memorySuperseded(params?: {
|
|
87
319
|
type?: string;
|
|
88
320
|
project?: string;
|
|
89
321
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
90
|
-
/**
|
|
322
|
+
/**
|
|
323
|
+
* Link a brain entry to a task.
|
|
324
|
+
*
|
|
325
|
+
* @param params - Link parameters including entryId and taskId
|
|
326
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
327
|
+
* @returns EngineResult confirming the link was created
|
|
328
|
+
*
|
|
329
|
+
* @remarks
|
|
330
|
+
* Creates an association between a brain.db entry and a task in tasks.db.
|
|
331
|
+
* Used for traceability between memory entries and the work they relate to.
|
|
332
|
+
*
|
|
333
|
+
* @example
|
|
334
|
+
* ```typescript
|
|
335
|
+
* const result = await memoryLink({ entryId: 'O-abc123', taskId: 'T042' }, '/project');
|
|
336
|
+
* ```
|
|
337
|
+
*/
|
|
91
338
|
export declare function memoryLink(params: {
|
|
92
339
|
taskId: string;
|
|
93
340
|
entryId: string;
|
|
94
341
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
95
|
-
/**
|
|
342
|
+
/**
|
|
343
|
+
* Remove a link between a brain entry and a task.
|
|
344
|
+
*
|
|
345
|
+
* @param params - Unlink parameters including entryId and taskId
|
|
346
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
347
|
+
* @returns EngineResult confirming the link was removed
|
|
348
|
+
*
|
|
349
|
+
* @remarks
|
|
350
|
+
* Removes the association created by memoryLink. Idempotent if the link
|
|
351
|
+
* does not exist.
|
|
352
|
+
*
|
|
353
|
+
* @example
|
|
354
|
+
* ```typescript
|
|
355
|
+
* const result = await memoryUnlink({ entryId: 'O-abc123', taskId: 'T042' }, '/project');
|
|
356
|
+
* ```
|
|
357
|
+
*/
|
|
96
358
|
export declare function memoryUnlink(params: {
|
|
97
359
|
taskId: string;
|
|
98
360
|
entryId: string;
|
|
99
361
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
100
|
-
/**
|
|
362
|
+
/**
|
|
363
|
+
* Add a node or edge to the PageIndex graph.
|
|
364
|
+
*
|
|
365
|
+
* @param params - Graph add parameters (node data or edge endpoints)
|
|
366
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
367
|
+
* @returns EngineResult confirming the node or edge was added
|
|
368
|
+
*
|
|
369
|
+
* @remarks
|
|
370
|
+
* Supports adding both nodes (concepts) and edges (relationships) to the
|
|
371
|
+
* brain.db knowledge graph (PageIndex).
|
|
372
|
+
*
|
|
373
|
+
* @example
|
|
374
|
+
* ```typescript
|
|
375
|
+
* const result = await memoryGraphAdd({ type: 'node', label: 'auth', nodeType: 'concept' }, '/project');
|
|
376
|
+
* ```
|
|
377
|
+
*/
|
|
101
378
|
export declare function memoryGraphAdd(params: {
|
|
102
379
|
nodeId?: string;
|
|
103
380
|
nodeType?: string;
|
|
@@ -108,25 +385,100 @@ export declare function memoryGraphAdd(params: {
|
|
|
108
385
|
edgeType?: string;
|
|
109
386
|
weight?: number;
|
|
110
387
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
111
|
-
/**
|
|
388
|
+
/**
|
|
389
|
+
* Get a node and its edges from the PageIndex graph.
|
|
390
|
+
*
|
|
391
|
+
* @param params - Parameters including the node ID to look up
|
|
392
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
393
|
+
* @returns EngineResult with the node data and its connected edges
|
|
394
|
+
*
|
|
395
|
+
* @remarks
|
|
396
|
+
* Returns the full node record plus all edges where the node appears as
|
|
397
|
+
* either source or target.
|
|
398
|
+
*
|
|
399
|
+
* @example
|
|
400
|
+
* ```typescript
|
|
401
|
+
* const result = await memoryGraphShow({ nodeId: 'auth' }, '/project');
|
|
402
|
+
* ```
|
|
403
|
+
*/
|
|
112
404
|
export declare function memoryGraphShow(params: {
|
|
113
405
|
nodeId: string;
|
|
114
406
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
115
|
-
/**
|
|
407
|
+
/**
|
|
408
|
+
* Get neighbor nodes from the PageIndex graph.
|
|
409
|
+
*
|
|
410
|
+
* @param params - Parameters including the node ID and optional depth
|
|
411
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
412
|
+
* @returns EngineResult with neighboring nodes and connecting edges
|
|
413
|
+
*
|
|
414
|
+
* @remarks
|
|
415
|
+
* Traverses the knowledge graph outward from a given node to find related
|
|
416
|
+
* concepts within the specified depth.
|
|
417
|
+
*
|
|
418
|
+
* @example
|
|
419
|
+
* ```typescript
|
|
420
|
+
* const result = await memoryGraphNeighbors({ nodeId: 'auth', depth: 2 }, '/project');
|
|
421
|
+
* ```
|
|
422
|
+
*/
|
|
116
423
|
export declare function memoryGraphNeighbors(params: {
|
|
117
424
|
nodeId: string;
|
|
118
425
|
edgeType?: string;
|
|
119
426
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
120
|
-
/**
|
|
427
|
+
/**
|
|
428
|
+
* Causal trace through task dependency chains.
|
|
429
|
+
*
|
|
430
|
+
* @param params - Parameters including the entry or task ID to trace
|
|
431
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
432
|
+
* @returns EngineResult with the causal chain explaining why something happened
|
|
433
|
+
*
|
|
434
|
+
* @remarks
|
|
435
|
+
* Traces backward through task dependencies and brain entries to build
|
|
436
|
+
* an explanation chain for a given decision or observation.
|
|
437
|
+
*
|
|
438
|
+
* @example
|
|
439
|
+
* ```typescript
|
|
440
|
+
* const result = await memoryReasonWhy({ id: 'D-abc123' }, '/project');
|
|
441
|
+
* ```
|
|
442
|
+
*/
|
|
121
443
|
export declare function memoryReasonWhy(params: {
|
|
122
444
|
taskId: string;
|
|
123
445
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
124
|
-
/**
|
|
446
|
+
/**
|
|
447
|
+
* Find semantically similar entries.
|
|
448
|
+
*
|
|
449
|
+
* @param params - Parameters including the source entry ID or query text
|
|
450
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
451
|
+
* @returns EngineResult with entries ranked by semantic similarity
|
|
452
|
+
*
|
|
453
|
+
* @remarks
|
|
454
|
+
* Uses embedding vectors or text similarity to find brain entries that are
|
|
455
|
+
* semantically close to the given reference.
|
|
456
|
+
*
|
|
457
|
+
* @example
|
|
458
|
+
* ```typescript
|
|
459
|
+
* const result = await memoryReasonSimilar({ id: 'O-abc123', limit: 5 }, '/project');
|
|
460
|
+
* ```
|
|
461
|
+
*/
|
|
125
462
|
export declare function memoryReasonSimilar(params: {
|
|
126
463
|
entryId: string;
|
|
127
464
|
limit?: number;
|
|
128
465
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
129
|
-
/**
|
|
466
|
+
/**
|
|
467
|
+
* Hybrid search across FTS5, vector, and graph.
|
|
468
|
+
*
|
|
469
|
+
* @param params - Search parameters including query and optional mode/limit
|
|
470
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
471
|
+
* @returns EngineResult with merged and ranked results from all search backends
|
|
472
|
+
*
|
|
473
|
+
* @remarks
|
|
474
|
+
* Combines full-text search (FTS5), vector similarity, and graph traversal
|
|
475
|
+
* to produce comprehensive search results with merged relevance scoring.
|
|
476
|
+
*
|
|
477
|
+
* @example
|
|
478
|
+
* ```typescript
|
|
479
|
+
* const result = await memorySearchHybrid({ query: 'authentication flow' }, '/project');
|
|
480
|
+
* ```
|
|
481
|
+
*/
|
|
130
482
|
export declare function memorySearchHybrid(params: {
|
|
131
483
|
query: string;
|
|
132
484
|
ftsWeight?: number;
|
|
@@ -134,7 +486,22 @@ export declare function memorySearchHybrid(params: {
|
|
|
134
486
|
graphWeight?: number;
|
|
135
487
|
limit?: number;
|
|
136
488
|
}, projectRoot?: string): Promise<EngineResult>;
|
|
137
|
-
/**
|
|
489
|
+
/**
|
|
490
|
+
* Remove a node or edge from the PageIndex graph.
|
|
491
|
+
*
|
|
492
|
+
* @param params - Parameters specifying the node or edge to remove
|
|
493
|
+
* @param projectRoot - Optional project root path; defaults to resolved root
|
|
494
|
+
* @returns EngineResult confirming the removal
|
|
495
|
+
*
|
|
496
|
+
* @remarks
|
|
497
|
+
* Removes a node (and its connected edges) or a specific edge from the
|
|
498
|
+
* brain.db knowledge graph.
|
|
499
|
+
*
|
|
500
|
+
* @example
|
|
501
|
+
* ```typescript
|
|
502
|
+
* const result = await memoryGraphRemove({ type: 'node', nodeId: 'stale-concept' }, '/project');
|
|
503
|
+
* ```
|
|
504
|
+
*/
|
|
138
505
|
export declare function memoryGraphRemove(params: {
|
|
139
506
|
nodeId?: string;
|
|
140
507
|
fromId?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"engine-compat.d.ts","sourceRoot":"","sources":["../../src/memory/engine-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcxD,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAGzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAGxB,MAAM,eAAe,CAAC;AA+BvB
|
|
1
|
+
{"version":3,"file":"engine-compat.d.ts","sourceRoot":"","sources":["../../src/memory/engine-compat.ts"],"names":[],"mappings":"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"}
|