akm-cli 0.9.0-rc.1 → 0.9.0-rc.13
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/CHANGELOG.md +1190 -52
- package/README.md +62 -37
- package/SECURITY.md +46 -31
- package/dist/akm +162 -38
- package/dist/akm-migrate +44 -0
- package/dist/assets/backends/schtasks-template.xml +2 -1
- package/dist/assets/hints/cli-hints-full.md +268 -118
- package/dist/assets/hints/cli-hints-short.md +87 -24
- package/dist/assets/{profiles → improve-strategies}/catchup.json +3 -1
- package/dist/assets/{profiles → improve-strategies}/consolidate.json +3 -1
- package/dist/assets/{profiles → improve-strategies}/default.json +6 -7
- package/dist/assets/improve-strategies/frequent.json +15 -0
- package/dist/assets/{profiles → improve-strategies}/graph-refresh.json +4 -2
- package/dist/assets/{profiles → improve-strategies}/memory-focus.json +4 -1
- package/dist/assets/{profiles → improve-strategies}/proactive-maintenance.json +5 -5
- package/dist/assets/{profiles → improve-strategies}/quick.json +4 -2
- package/dist/assets/improve-strategies/reflect-distill.json +30 -0
- package/dist/assets/{profiles → improve-strategies}/thorough.json +1 -1
- package/dist/assets/prompts/consolidate-system.md +5 -5
- package/dist/assets/prompts/extract-session.md +2 -6
- package/dist/assets/prompts/memory-infer-user.md +2 -3
- package/dist/assets/prompts/reflect-llm-framed-contract.md +11 -0
- package/dist/assets/prompts/reflect-llm-schema-contract.md +3 -0
- package/dist/assets/prompts/reflect-output-repair.md +3 -0
- package/dist/assets/stash-skeleton/README.md +38 -10
- package/dist/assets/stash-skeleton/facts/conventions/assets/agent.md +8 -0
- package/dist/assets/stash-skeleton/facts/conventions/assets/command.md +8 -0
- package/dist/assets/stash-skeleton/facts/conventions/assets/fact.md +14 -1
- package/dist/assets/stash-skeleton/facts/conventions/assets/knowledge.md +13 -1
- package/dist/assets/stash-skeleton/facts/conventions/assets/lesson.md +9 -1
- package/dist/assets/stash-skeleton/facts/conventions/assets/memory.md +11 -0
- package/dist/assets/stash-skeleton/facts/conventions/assets/script.md +9 -0
- package/dist/assets/stash-skeleton/facts/conventions/assets/skill.md +9 -0
- package/dist/assets/stash-skeleton/facts/conventions/assets/workflow.md +8 -0
- package/dist/assets/stash-skeleton/facts/conventions/backlinks.md +100 -0
- package/dist/assets/stash-skeleton/facts/conventions/domains.md +64 -0
- package/dist/assets/stash-skeleton/facts/conventions/organization.md +136 -0
- package/dist/assets/tasks/core/extract.yml +3 -2
- package/dist/assets/tasks/core/improve.yml +2 -1
- package/dist/assets/tasks/core/index-refresh.yml +1 -0
- package/dist/assets/tasks/core/sync.yml +1 -0
- package/dist/assets/tasks/core/version-check.yml +2 -1
- package/dist/assets/tasks/improve/akm-graph-refresh-weekly.yml +5 -0
- package/dist/assets/tasks/improve/akm-improve-catchup.yml +8 -0
- package/dist/assets/tasks/improve/akm-improve-consolidate.yml +5 -0
- package/dist/assets/tasks/improve/akm-improve-frequent.yml +5 -0
- package/dist/assets/tasks/improve/akm-improve-nightly.yml +5 -0
- package/dist/assets/templates/html/health.html +5 -4
- package/dist/assets/workflows/workflow-template.md +31 -15
- package/dist/cli/invocation.js +279 -0
- package/dist/cli/parse-args.js +5 -90
- package/dist/cli/retired-commands.js +78 -0
- package/dist/cli/shared.js +158 -48
- package/dist/cli-node.mjs +2 -1
- package/dist/cli.js +747 -293
- package/dist/commands/agent/agent-dispatch.js +19 -18
- package/dist/commands/agent/agent-support.js +0 -24
- package/dist/commands/agent/contribute-cli.js +43 -97
- package/dist/commands/completions.js +80 -23
- package/dist/commands/config-cli.js +44 -281
- package/dist/commands/env/env-binding.js +13 -9
- package/dist/commands/env/env-cli.js +76 -159
- package/dist/commands/env/env.js +12 -163
- package/dist/commands/env/marker-path.js +6 -0
- package/dist/commands/env/secret-cli.js +45 -61
- package/dist/commands/env/secret.js +32 -62
- package/dist/commands/feedback-cli.js +179 -85
- package/dist/commands/health/accept-rate.js +58 -0
- package/dist/commands/health/advisories.js +7 -8
- package/dist/commands/health/checks.js +279 -94
- package/dist/commands/health/html-report.js +197 -578
- package/dist/commands/health/improve-metrics.js +277 -246
- package/dist/commands/health/llm-usage.js +19 -19
- package/dist/commands/health/md-report.js +16 -7
- package/dist/commands/health/metrics.js +67 -32
- package/dist/commands/health/renderers.js +47 -0
- package/dist/commands/health/report-view-model.js +508 -0
- package/dist/commands/health/stash-exposure.js +1 -1
- package/dist/commands/health/surfaces.js +16 -56
- package/dist/commands/health/task-runs.js +3 -67
- package/dist/{migrate-storage-node.mjs → commands/health/types-checks.js} +1 -5
- package/dist/commands/health/types-improve.js +29 -0
- package/dist/{output/text/save.js → commands/health/types-metrics.js} +1 -2
- package/dist/commands/health/types-result.js +7 -0
- package/dist/commands/health/types-runs.js +4 -0
- package/dist/commands/health/types-session-log.js +4 -0
- package/dist/commands/health/types-windows.js +4 -0
- package/dist/commands/health/types.js +26 -21
- package/dist/commands/health/windows.js +2 -3
- package/dist/commands/health.js +296 -167
- package/dist/commands/improve/anti-collapse.js +5 -5
- package/dist/commands/improve/autonomy-gate.js +68 -0
- package/dist/commands/improve/collapse-detector.js +65 -52
- package/dist/commands/improve/consolidate/chunking.js +9 -7
- package/dist/commands/improve/consolidate/eligibility.js +1 -23
- package/dist/commands/improve/consolidate/merge.js +4 -0
- package/dist/commands/improve/consolidate.js +454 -1354
- package/dist/commands/improve/content-hash.js +39 -0
- package/dist/commands/improve/distill/content-repair.js +4 -10
- package/dist/commands/improve/distill/promote-memory.js +89 -64
- package/dist/commands/improve/distill/quality-gate.js +118 -42
- package/dist/commands/improve/distill-guards.js +1 -1
- package/dist/commands/improve/distill-promotion-policy.js +33 -888
- package/dist/commands/improve/distill.js +607 -363
- package/dist/commands/improve/eligibility.js +165 -79
- package/dist/commands/improve/extract-cli.js +35 -126
- package/dist/commands/improve/extract-prompt.js +6 -35
- package/dist/commands/improve/extract.js +640 -391
- package/dist/commands/improve/feedback-valence.js +2 -12
- package/dist/commands/improve/improve-cli.js +134 -135
- package/dist/commands/improve/improve-result-file.js +30 -50
- package/dist/commands/improve/improve-run-types.js +4 -0
- package/dist/commands/improve/improve-strategies.js +135 -0
- package/dist/commands/improve/improve.js +904 -701
- package/dist/commands/improve/locks.js +64 -111
- package/dist/commands/improve/loop-stages.js +1110 -923
- package/dist/commands/improve/memory/derived-ref.js +124 -0
- package/dist/commands/improve/memory/memory-belief.js +79 -7
- package/dist/commands/improve/memory/memory-contradiction-detect.js +49 -52
- package/dist/commands/improve/memory/memory-improve.js +25 -37
- package/dist/commands/improve/outcome-loop.js +25 -88
- package/dist/commands/improve/preparation.js +1034 -813
- package/dist/commands/improve/proactive-maintenance.js +34 -9
- package/dist/commands/improve/proposal-envelope.js +31 -0
- package/dist/commands/improve/reflect.js +983 -794
- package/dist/commands/improve/run-context.js +119 -0
- package/dist/commands/improve/salience.js +24 -127
- package/dist/commands/improve/session-asset.js +7 -3
- package/dist/commands/improve/shared.js +14 -34
- package/dist/commands/improve/source-identity.js +28 -0
- package/dist/commands/improve/triage.js +20 -17
- package/dist/commands/lint/base-linter.js +340 -313
- package/dist/commands/lint/env-key-rules.js +31 -47
- package/dist/commands/lint/index.js +185 -30
- package/dist/commands/{events.js → log.js} +28 -38
- package/dist/commands/migrate-cli.js +54 -0
- package/dist/commands/migration-tool.js +55 -0
- package/dist/commands/observability-cli.js +70 -208
- package/dist/commands/proposal/diff-format.js +50 -0
- package/dist/commands/proposal/drain-policies.js +0 -6
- package/dist/commands/proposal/drain.js +91 -40
- package/dist/commands/proposal/proposal-cli.js +134 -132
- package/dist/commands/proposal/proposal-types.js +56 -0
- package/dist/commands/proposal/proposal.js +83 -65
- package/dist/commands/proposal/propose-cli.js +88 -0
- package/dist/commands/proposal/propose.js +105 -88
- package/dist/commands/proposal/repository.js +1303 -278
- package/dist/commands/proposal/validators/proposal-quality-validators.js +16 -6
- package/dist/commands/proposal/validators/proposal-validators.js +61 -12
- package/dist/commands/proposal/validators/proposals.js +6 -8
- package/dist/commands/read/curate.js +78 -73
- package/dist/commands/read/knowledge.js +510 -13
- package/dist/commands/read/registry-search.js +2 -2
- package/dist/commands/read/remember-cli.js +84 -15
- package/dist/commands/read/search-cli.js +203 -96
- package/dist/commands/read/search.js +126 -94
- package/dist/commands/read/show.js +226 -250
- package/dist/commands/registry-cli.js +34 -60
- package/dist/commands/remember.js +18 -57
- package/dist/commands/sources/add-cli.js +104 -49
- package/dist/commands/sources/bundle-cli.js +166 -0
- package/dist/commands/sources/bundle-config-ops.js +63 -0
- package/dist/commands/sources/info.js +27 -15
- package/dist/commands/sources/init.js +30 -40
- package/dist/commands/sources/installed-stashes.js +469 -172
- package/dist/commands/sources/schema-repair.js +10 -9
- package/dist/commands/sources/self-update.js +182 -121
- package/dist/commands/sources/source-add.js +169 -178
- package/dist/commands/sources/source-clone.js +144 -41
- package/dist/commands/sources/source-manage.js +94 -59
- package/dist/commands/sources/sources-cli.js +64 -205
- package/dist/commands/sources/stash-cli.js +91 -54
- package/dist/commands/sources/stash-skeleton.js +1 -1
- package/dist/commands/tasks/tasks-cli.js +106 -104
- package/dist/commands/tasks/tasks.js +445 -262
- package/dist/commands/workflow-cli.js +75 -228
- package/dist/core/action-contributors.js +1 -1
- package/dist/core/activation-policy.js +49 -0
- package/dist/core/adapter/adapters/agent-skills-adapter.js +181 -0
- package/dist/core/adapter/adapters/akm-adapter.js +528 -0
- package/dist/core/adapter/adapters/akm-lint.js +392 -0
- package/dist/core/adapter/adapters/akm-metadata.js +387 -0
- package/dist/core/adapter/adapters/akm-task-adapter.js +149 -0
- package/dist/core/adapter/adapters/akm-workflow-adapter.js +180 -0
- package/dist/core/adapter/adapters/claude-adapter.js +61 -0
- package/dist/core/adapter/adapters/dotenv-adapter.js +187 -0
- package/dist/core/adapter/adapters/generic-files-adapter.js +119 -0
- package/dist/core/adapter/adapters/index.js +80 -0
- package/dist/core/adapter/adapters/llm-wiki-adapter.js +419 -0
- package/dist/core/adapter/adapters/okf-adapter.js +391 -0
- package/dist/core/adapter/adapters/opencode-adapter.js +68 -0
- package/dist/core/adapter/adapters/shared.js +286 -0
- package/dist/core/adapter/adapters/tool-dir-shared.js +217 -0
- package/dist/core/adapter/adapters/website-snapshot-adapter.js +155 -0
- package/dist/core/adapter/bundle-adapter.js +4 -0
- package/dist/core/adapter/detect-adapter.js +17 -0
- package/dist/core/adapter/recognize-match.js +44 -0
- package/dist/core/adapter/registry.js +56 -0
- package/dist/core/adapter/types.js +4 -0
- package/dist/core/asset/akm-markdown.js +30 -0
- package/dist/core/asset/asset-placement.js +243 -0
- package/dist/core/asset/asset-ref.js +110 -79
- package/dist/core/asset/asset-serialize.js +20 -0
- package/dist/core/asset/frontmatter.js +28 -12
- package/dist/core/asset/markdown.js +40 -51
- package/dist/core/asset/resolve-ref.js +274 -0
- package/dist/core/asset/stash-meta.js +2 -2
- package/dist/core/bundle-id.js +51 -0
- package/dist/core/common.js +281 -86
- package/dist/core/config/config-io.js +42 -128
- package/dist/core/config/config-schema.js +233 -855
- package/dist/core/config/config-sources.js +162 -39
- package/dist/core/config/config-types.js +16 -11
- package/dist/core/config/config-version.js +29 -0
- package/dist/core/config/config-walker.js +126 -37
- package/dist/core/config/config.js +154 -331
- package/dist/core/config/deep-merge.js +41 -0
- package/dist/core/config/engine-semantics.js +28 -0
- package/dist/core/config/experimental.js +21 -0
- package/dist/core/config/schema/embedding.js +38 -0
- package/dist/core/config/schema/engines.js +116 -0
- package/dist/core/config/schema/experimental.js +47 -0
- package/dist/core/config/schema/feedback.js +31 -0
- package/dist/core/config/schema/improve-processes.js +389 -0
- package/dist/core/config/schema/improve.js +94 -0
- package/dist/core/config/schema/index-config.js +176 -0
- package/dist/core/config/schema/output.js +18 -0
- package/dist/core/config/schema/primitives.js +94 -0
- package/dist/core/config/schema/search.js +30 -0
- package/dist/core/config/schema/setup.js +18 -0
- package/dist/core/config/schema/sources-bundles.js +169 -0
- package/dist/core/config/schema/workflow.js +29 -0
- package/dist/core/env-secret-ref.js +155 -20
- package/dist/core/errors.js +17 -15
- package/dist/core/events-types.js +4 -0
- package/dist/core/events.js +46 -128
- package/dist/core/extra-params.js +62 -0
- package/dist/core/file-change.js +17 -0
- package/dist/core/file-lock.js +202 -57
- package/dist/core/fs-txn.js +392 -0
- package/dist/core/git-message.js +59 -0
- package/dist/core/improve-result.js +167 -0
- package/dist/core/lesson-lint.js +1 -17
- package/dist/core/logs-db.js +1 -1
- package/dist/core/maintenance-barrier.js +135 -0
- package/dist/core/migration-operation.js +44 -0
- package/dist/core/mutation-target.js +78 -0
- package/dist/core/paths.js +22 -25
- package/dist/core/platform.js +10 -0
- package/dist/core/recognition-util.js +128 -0
- package/dist/core/redaction.js +392 -0
- package/dist/core/standards/resolve-standards-context.js +36 -65
- package/dist/core/standards/resolve-stash-standards.js +2 -2
- package/dist/core/standards/resolve-type-conventions.js +5 -5
- package/dist/core/state/migrations.js +242 -11
- package/dist/core/state-db.js +98 -10
- package/dist/core/structured.js +1 -1
- package/dist/core/subprocess.js +303 -0
- package/dist/core/text-truncation.js +9 -5
- package/dist/core/time.js +20 -0
- package/dist/core/type-presentation.js +130 -0
- package/dist/core/warn.js +0 -3
- package/dist/core/write-source.js +834 -118
- package/dist/indexer/bundle-identity-guard.js +92 -0
- package/dist/indexer/db/graph-db.js +1 -25
- package/dist/indexer/db/llm-cache.js +1 -1
- package/dist/indexer/ensure-index.js +30 -9
- package/dist/indexer/graph/graph-boost.js +9 -30
- package/dist/indexer/graph/graph-extraction.js +41 -27
- package/dist/indexer/graph/graph-types.js +4 -0
- package/dist/indexer/index-writer-lock.js +93 -49
- package/dist/indexer/index-written-assets.js +100 -53
- package/dist/indexer/indexer.js +746 -329
- package/dist/indexer/init.js +18 -25
- package/dist/indexer/installations.js +142 -0
- package/dist/indexer/passes/dir-staleness.js +18 -10
- package/dist/indexer/passes/memory-inference.js +25 -15
- package/dist/indexer/passes/metadata.js +412 -243
- package/dist/indexer/scan/doc-to-entry.js +160 -0
- package/dist/indexer/scan/drain-dir.js +134 -0
- package/dist/indexer/search/db-search.js +292 -108
- package/dist/indexer/search/fts-query.js +64 -0
- package/dist/indexer/search/ranking-contributors.js +145 -25
- package/dist/indexer/search/ranking-types.js +4 -0
- package/dist/indexer/search/ranking.js +28 -71
- package/dist/indexer/search/search-attribution.js +67 -0
- package/dist/indexer/search/search-fields.js +18 -3
- package/dist/indexer/search/search-hit-enrichers.js +30 -40
- package/dist/indexer/search/search-source.js +157 -111
- package/dist/indexer/search/semantic-status.js +4 -1
- package/dist/indexer/usage/usage-events.js +10 -30
- package/dist/indexer/walk/file-context.js +3 -45
- package/dist/indexer/walk/matchers.js +42 -73
- package/dist/indexer/walk/path-resolver.js +11 -5
- package/dist/indexer/walk/walker.js +42 -14
- package/dist/integrations/agent/builder-shared.js +7 -0
- package/dist/integrations/agent/builders.js +5 -58
- package/dist/integrations/agent/config.js +3 -143
- package/dist/integrations/agent/detect.js +17 -2
- package/dist/integrations/agent/engine-resolution.js +231 -0
- package/dist/integrations/agent/index.js +1 -2
- package/dist/integrations/agent/model-aliases.js +8 -3
- package/dist/integrations/agent/profiles.js +6 -99
- package/dist/integrations/agent/prompts.js +46 -18
- package/dist/integrations/agent/runner-dispatch.js +78 -13
- package/dist/integrations/agent/runner.js +76 -208
- package/dist/integrations/agent/spawn.js +48 -279
- package/dist/integrations/harnesses/aider/agent-builder.js +9 -8
- package/dist/integrations/harnesses/aider/index.js +2 -12
- package/dist/integrations/harnesses/amazonq/agent-builder.js +10 -16
- package/dist/integrations/harnesses/amazonq/index.js +3 -17
- package/dist/integrations/harnesses/claude/agent-builder.js +2 -3
- package/dist/integrations/harnesses/claude/config-import.js +1 -3
- package/dist/integrations/harnesses/claude/index.js +1 -14
- package/dist/integrations/harnesses/claude/session-log.js +27 -75
- package/dist/integrations/harnesses/codex/agent-builder.js +8 -7
- package/dist/integrations/harnesses/codex/index.js +2 -13
- package/dist/integrations/harnesses/copilot/agent-builder.js +9 -9
- package/dist/integrations/harnesses/copilot/index.js +1 -13
- package/dist/integrations/harnesses/gemini/agent-builder.js +8 -9
- package/dist/integrations/harnesses/gemini/index.js +1 -13
- package/dist/integrations/harnesses/ids.js +24 -0
- package/dist/integrations/harnesses/index.js +31 -33
- package/dist/integrations/harnesses/opencode/agent-builder.js +23 -5
- package/dist/integrations/harnesses/opencode/config-import.js +1 -3
- package/dist/integrations/harnesses/opencode/index.js +1 -18
- package/dist/integrations/harnesses/opencode/session-log.js +67 -125
- package/dist/integrations/harnesses/opencode-sdk/harness.js +3 -17
- package/dist/integrations/harnesses/opencode-sdk/sdk-runner.js +274 -191
- package/dist/integrations/harnesses/openhands/agent-builder.js +12 -10
- package/dist/integrations/harnesses/openhands/index.js +2 -12
- package/dist/integrations/harnesses/pi/agent-builder.js +11 -18
- package/dist/integrations/harnesses/pi/index.js +3 -16
- package/dist/integrations/harnesses/shared.js +17 -0
- package/dist/integrations/harnesses/types.js +38 -34
- package/dist/integrations/lockfile.js +211 -24
- package/dist/integrations/session-logs/index.js +24 -40
- package/dist/integrations/session-logs/provider-base.js +113 -0
- package/dist/llm/client.js +182 -110
- package/dist/llm/embedders/deterministic.js +2 -2
- package/dist/llm/embedders/remote.js +21 -9
- package/dist/llm/feature-gate.js +17 -57
- package/dist/llm/graph-extract.js +12 -13
- package/dist/llm/index-passes.js +8 -42
- package/dist/llm/memory-infer.js +144 -1
- package/dist/llm/metadata-enhance.js +45 -30
- package/dist/llm/structured-call.js +16 -8
- package/dist/llm/usage-persist.js +30 -5
- package/dist/llm/usage-telemetry.js +59 -6
- package/dist/output/cli-hints.js +1 -2
- package/dist/output/command-registry.js +27 -0
- package/dist/output/context.js +22 -7
- package/dist/output/format-exempt.js +80 -0
- package/dist/output/generic-render.js +251 -0
- package/dist/output/html-render.js +11 -16
- package/dist/output/render-registry.js +57 -0
- package/dist/output/renderers.js +15 -281
- package/dist/output/shapes/curate.js +10 -1
- package/dist/output/shapes/events.js +12 -7
- package/dist/output/shapes/helpers.js +58 -84
- package/dist/output/shapes/passthrough.js +8 -40
- package/dist/output/shapes/proposal/producer.js +15 -7
- package/dist/output/shapes/registry.js +12 -6
- package/dist/output/shapes.js +0 -9
- package/dist/output/text/{init.js → bundle-create.js} +3 -1
- package/dist/output/text/bundle-show.js +7 -0
- package/dist/output/text/command-format.js +562 -0
- package/dist/output/text/env.js +1 -3
- package/dist/output/text/events.js +8 -7
- package/dist/output/text/helpers.js +15 -1375
- package/dist/output/text/proposal/producer.js +4 -2
- package/dist/output/text/proposal-format.js +202 -0
- package/dist/output/text/registry-commands.js +1 -2
- package/dist/output/text/registry.js +12 -6
- package/dist/output/text/show-directives.js +117 -0
- package/dist/output/text/show-format.js +103 -0
- package/dist/output/text/sync.js +5 -0
- package/dist/output/text/workflow-format.js +332 -0
- package/dist/output/text/workflow.js +1 -2
- package/dist/output/text.js +10 -19
- package/dist/registry/factory.js +4 -6
- package/dist/registry/origin-resolve.js +16 -27
- package/dist/registry/providers/skills-sh.js +3 -3
- package/dist/registry/providers/static-index.js +15 -25
- package/dist/registry/resolve.js +43 -94
- package/dist/registry/semver.js +43 -0
- package/dist/runtime.js +81 -12
- package/dist/scripts/akm-migrate.js +35529 -0
- package/dist/setup/detect.js +5 -7
- package/dist/setup/detected-engines.js +136 -0
- package/dist/setup/engine-config.js +100 -0
- package/dist/setup/registry-stash-loader.js +3 -3
- package/dist/setup/semantic-assets.js +12 -9
- package/dist/setup/setup.js +444 -208
- package/dist/setup/steps/connection-shared.js +120 -0
- package/dist/setup/steps/connection.js +108 -305
- package/dist/setup/steps/platforms.js +13 -12
- package/dist/setup/steps/semantic.js +15 -3
- package/dist/setup/steps/sources.js +21 -15
- package/dist/setup/steps/stashdir.js +6 -4
- package/dist/setup/steps/tasks.js +236 -119
- package/dist/setup/steps.js +3 -2
- package/dist/sources/freshness.js +39 -0
- package/dist/sources/provider-factory.js +11 -17
- package/dist/sources/providers/filesystem.js +2 -3
- package/dist/sources/providers/git-install.js +278 -34
- package/dist/sources/providers/git-provider.js +54 -56
- package/dist/sources/providers/git-stash.js +420 -91
- package/dist/sources/providers/git.js +2 -2
- package/dist/sources/providers/npm.js +16 -19
- package/dist/sources/providers/provider-utils.js +47 -22
- package/dist/sources/providers/sync-from-ref.js +3 -9
- package/dist/sources/providers/website.js +2 -2
- package/dist/sources/resolve.js +11 -10
- package/dist/sources/snapshot-fetchers/types.js +4 -0
- package/dist/sources/{website-ingest.js → snapshot-fetchers/website-ingest.js} +110 -41
- package/dist/storage/database.js +60 -4
- package/dist/storage/engines/sqlite-migrations.js +156 -5
- package/dist/storage/locations.js +1 -2
- package/dist/storage/repositories/canaries-repository.js +1 -1
- package/dist/storage/repositories/events-repository.js +51 -11
- package/dist/storage/repositories/improve-runs-repository.js +6 -32
- package/dist/storage/repositories/index-connection.js +79 -0
- package/dist/storage/repositories/index-db.js +4 -3
- package/dist/storage/repositories/index-entries-repository.js +863 -0
- package/dist/{indexer/db/entry-mapper.js → storage/repositories/index-entry-mapper.js} +19 -2
- package/dist/storage/repositories/index-entry-types.js +4 -0
- package/dist/storage/repositories/index-fts-repository.js +167 -0
- package/dist/storage/repositories/index-llm-cache-repository.js +108 -0
- package/dist/storage/repositories/index-meta-repository.js +49 -0
- package/dist/{indexer/db/schema.js → storage/repositories/index-schema.js} +226 -100
- package/dist/storage/repositories/index-sql.js +12 -0
- package/dist/storage/repositories/index-utility-repository.js +356 -0
- package/dist/storage/repositories/index-vec-repository.js +250 -0
- package/dist/storage/repositories/outcome-repository.js +119 -0
- package/dist/storage/repositories/proposals-repository.js +317 -75
- package/dist/storage/repositories/registry-cache.js +1 -1
- package/dist/storage/repositories/salience-repository.js +172 -0
- package/dist/storage/repositories/task-history-repository.js +110 -3
- package/dist/storage/repositories/workflow-runs-repository.js +68 -35
- package/dist/tasks/backends/cron.js +169 -46
- package/dist/tasks/backends/exec-utils.js +76 -3
- package/dist/tasks/backends/index.js +6 -9
- package/dist/tasks/backends/launchd.js +292 -55
- package/dist/tasks/backends/schtasks.js +557 -70
- package/dist/tasks/backends/types.js +4 -0
- package/dist/tasks/command-executable.js +93 -0
- package/dist/tasks/embedded.js +56 -38
- package/dist/tasks/parser.js +156 -64
- package/dist/tasks/resolve-akm-bin.js +144 -51
- package/dist/tasks/runner.js +377 -209
- package/dist/tasks/schedule.js +108 -19
- package/dist/tasks/scheduler-invocation.js +296 -0
- package/dist/tasks/schema.js +1 -1
- package/dist/tasks/task-id.js +35 -0
- package/dist/tasks/validator.js +30 -16
- package/dist/workflows/authoring/authoring.js +96 -148
- package/dist/workflows/authoring/scope-key.js +1 -1
- package/dist/workflows/cli.js +0 -20
- package/dist/workflows/concurrency-policy.js +15 -0
- package/dist/workflows/exec/brief.js +25 -59
- package/dist/workflows/exec/frozen-judge.js +47 -0
- package/dist/workflows/exec/native-executor.js +157 -94
- package/dist/workflows/exec/report.js +365 -200
- package/dist/workflows/exec/run-workflow.js +46 -40
- package/dist/workflows/exec/scheduler.js +12 -41
- package/dist/workflows/exec/step-work.js +239 -205
- package/dist/workflows/exec/workflow-engine-gate.js +67 -0
- package/dist/workflows/ir/compile.js +141 -283
- package/dist/workflows/ir/freeze.js +233 -0
- package/dist/workflows/ir/plan-hash.js +40 -5
- package/dist/workflows/ir/schema.js +537 -1
- package/dist/workflows/parser.js +878 -306
- package/dist/workflows/program/expressions.js +20 -208
- package/dist/workflows/program/schema.js +7 -10
- package/dist/workflows/renderer.js +99 -121
- package/dist/workflows/resource-limits.js +22 -0
- package/dist/workflows/runtime/checkin.js +1 -1
- package/dist/workflows/runtime/plan-classifier.js +131 -0
- package/dist/workflows/runtime/runs.js +200 -113
- package/dist/workflows/runtime/unit-checkin.js +1 -1
- package/dist/workflows/runtime/unit-phases.js +20 -0
- package/dist/workflows/runtime/workflow-asset-loader.js +235 -97
- package/dist/workflows/schema.js +1 -11
- package/dist/workflows/validate-summary.js +4 -26
- package/dist/workflows/validator.js +52 -30
- package/docs/README.md +42 -78
- package/docs/migration/README.md +8 -0
- package/docs/migration/release-notes/0.6.0.md +1 -1
- package/docs/migration/release-notes/0.7.0.md +9 -8
- package/docs/migration/release-notes/0.9.0.md +158 -14
- package/docs/migration/v0.7-to-v0.8.md +46 -47
- package/docs/migration/v0.8-to-v0.9.md +844 -0
- package/docs/reference/README.md +12 -0
- package/docs/reference/data-and-telemetry.md +333 -0
- package/package.json +21 -17
- package/schemas/akm-asset-envelope.json +93 -0
- package/schemas/akm-config.json +4636 -0
- package/schemas/akm-task.json +87 -0
- package/{dist/schemas → schemas}/akm-workflow.json +127 -82
- package/dist/akm-migrate-storage +0 -38
- package/dist/assets/help/help-accept.md +0 -12
- package/dist/assets/help/help-improve.md +0 -84
- package/dist/assets/help/help-proposals.md +0 -17
- package/dist/assets/help/help-propose.md +0 -17
- package/dist/assets/help/help-reject.md +0 -11
- package/dist/assets/profiles/frequent.json +0 -13
- package/dist/assets/profiles/recombine-only.json +0 -21
- package/dist/assets/profiles/reflect-distill.json +0 -30
- package/dist/assets/profiles/synthesize.json +0 -15
- package/dist/assets/prompts/procedural-system.md +0 -44
- package/dist/assets/prompts/recombine-system.md +0 -40
- package/dist/assets/prompts/staleness-detect-system.md +0 -6
- package/dist/assets/tasks/core/backup.yml +0 -4
- package/dist/assets/tasks/graph-refresh-weekly.yml +0 -10
- package/dist/assets/templates/html/default.html +0 -78
- package/dist/assets/templates/html/vendor/echarts.min.js +0 -45
- package/dist/assets/wiki/index-template.md +0 -12
- package/dist/assets/wiki/ingest-workflow-template.md +0 -83
- package/dist/assets/wiki/log-template.md +0 -8
- package/dist/assets/wiki/schema-template.md +0 -61
- package/dist/cli/config-migrate.js +0 -150
- package/dist/cli/config-validate.js +0 -39
- package/dist/commands/graph/graph-cli.js +0 -124
- package/dist/commands/graph/graph.js +0 -487
- package/dist/commands/improve/calibration.js +0 -161
- package/dist/commands/improve/dedup.js +0 -482
- package/dist/commands/improve/extract-watch.js +0 -140
- package/dist/commands/improve/hot-probation.js +0 -45
- package/dist/commands/improve/improve-auto-accept.js +0 -276
- package/dist/commands/improve/improve-profiles.js +0 -168
- package/dist/commands/improve/procedural.js +0 -398
- package/dist/commands/improve/recombine.js +0 -818
- package/dist/commands/improve/schema-similarity-gate.js +0 -168
- package/dist/commands/lint/agent-linter.js +0 -44
- package/dist/commands/lint/command-linter.js +0 -44
- package/dist/commands/lint/default-linter.js +0 -16
- package/dist/commands/lint/fact-linter.js +0 -39
- package/dist/commands/lint/knowledge-linter.js +0 -16
- package/dist/commands/lint/memory-linter.js +0 -61
- package/dist/commands/lint/registry.js +0 -41
- package/dist/commands/lint/skill-linter.js +0 -45
- package/dist/commands/lint/task-linter.js +0 -50
- package/dist/commands/lint/workflow-linter.js +0 -81
- package/dist/commands/proposal/legacy-import.js +0 -115
- package/dist/commands/sources/history.js +0 -196
- package/dist/commands/tasks/default-tasks.js +0 -186
- package/dist/commands/wiki-cli.js +0 -292
- package/dist/core/asset/asset-registry.js +0 -76
- package/dist/core/asset/asset-spec.js +0 -316
- package/dist/core/config/config-migration.js +0 -602
- package/dist/core/deep-merge.js +0 -38
- package/dist/core/eval/rank-metrics.js +0 -113
- package/dist/core/ripgrep/install.js +0 -163
- package/dist/core/ripgrep/resolve.js +0 -81
- package/dist/indexer/db/db.js +0 -1414
- package/dist/indexer/manifest.js +0 -170
- package/dist/indexer/passes/metadata-contributors.js +0 -31
- package/dist/indexer/usage/unmigrated-vaults-guard.js +0 -94
- package/dist/integrations/harnesses/opencode-sdk/index.js +0 -25
- package/dist/llm/call-ai.js +0 -62
- package/dist/llm/memory-infer-impl.js +0 -138
- package/dist/output/shapes/distill.js +0 -14
- package/dist/output/shapes/history.js +0 -11
- package/dist/output/text/distill.js +0 -6
- package/dist/output/text/enable-disable.js +0 -8
- package/dist/output/text/history.js +0 -6
- package/dist/output/text/wiki.js +0 -16
- package/dist/registry/build-index.js +0 -386
- package/dist/schemas/akm-config.json +0 -14225
- package/dist/scripts/migrate-storage.js +0 -13169
- package/dist/scripts/migrations/import-fs-improve-runs-to-db.js +0 -10169
- package/dist/scripts/migrations/v16-to-v17.js +0 -141
- package/dist/setup/legacy-config.js +0 -106
- package/dist/storage/repositories/consolidation-repository.js +0 -38
- package/dist/storage/repositories/recombine-repository.js +0 -213
- package/dist/wiki/wiki-templates.js +0 -15
- package/dist/wiki/wiki.js +0 -1012
- package/dist/workflows/authoring/workflow-program-template.yaml +0 -31
- package/dist/workflows/db.js +0 -350
- package/dist/workflows/exec/watch.js +0 -116
- package/dist/workflows/program/parser.js +0 -760
- package/dist/workflows/program/project.js +0 -105
- package/docs/data-and-telemetry.md +0 -227
- package/docs/migration/release-notes/0.9.0-beta.60.md +0 -19
- /package/dist/sources/{wiki-fetchers → snapshot-fetchers}/registry.js +0 -0
- /package/dist/sources/{wiki-fetchers → snapshot-fetchers}/youtube.js +0 -0
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// This Source Code Form is subject to the terms of the Mozilla Public
|
|
2
|
+
// License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
3
|
+
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
|
|
4
|
+
/**
|
|
5
|
+
* Per-command `md` / `html` renderer registries (D7).
|
|
6
|
+
*
|
|
7
|
+
* Mirrors `src/output/text/registry.ts`: a command may register a bespoke
|
|
8
|
+
* renderer for a document format, and anything unregistered falls back to the
|
|
9
|
+
* generic rendering of its shaped envelope (`./generic-render`). The fallback
|
|
10
|
+
* is what makes all six `--format` values universal; the registry is what lets
|
|
11
|
+
* a command that has something better to say — `akm health` and its report
|
|
12
|
+
* templates — say it without the output pipeline knowing that command exists.
|
|
13
|
+
*
|
|
14
|
+
* Kept separate from the module that dispatches through it so per-command
|
|
15
|
+
* renderer modules can import `registerMdRenderer` / `registerHtmlRenderer`
|
|
16
|
+
* without a cycle back into the pipeline, exactly as the text registry does.
|
|
17
|
+
*
|
|
18
|
+
* Returning `null` from a handler means "I have nothing special for this
|
|
19
|
+
* payload" and falls through to the generic renderer — `akm health` uses that
|
|
20
|
+
* to keep its bespoke tables for the shapes that have them while still
|
|
21
|
+
* rendering everything else.
|
|
22
|
+
*/
|
|
23
|
+
import { createCommandRegistry } from "./command-registry.js";
|
|
24
|
+
const MD_RENDERER_REGISTRY = createCommandRegistry();
|
|
25
|
+
const HTML_RENDERER_REGISTRY = createCommandRegistry();
|
|
26
|
+
/** Register a Markdown renderer for a command name. */
|
|
27
|
+
export function registerMdRenderer(command, handler) {
|
|
28
|
+
MD_RENDERER_REGISTRY.register(command, handler);
|
|
29
|
+
}
|
|
30
|
+
/** Register a batch of Markdown renderers in iteration order. */
|
|
31
|
+
export function registerMdRenderers(entries) {
|
|
32
|
+
MD_RENDERER_REGISTRY.registerAll(entries);
|
|
33
|
+
}
|
|
34
|
+
/** Look up a registered Markdown renderer, or `undefined` when unregistered. */
|
|
35
|
+
export function getMdRendererHandler(command) {
|
|
36
|
+
return MD_RENDERER_REGISTRY.get(command);
|
|
37
|
+
}
|
|
38
|
+
/** Remove a previously-registered Markdown renderer. Test-only utility. */
|
|
39
|
+
export function deregisterMdRenderer(command) {
|
|
40
|
+
MD_RENDERER_REGISTRY.deregister(command);
|
|
41
|
+
}
|
|
42
|
+
/** Register an HTML renderer for a command name. */
|
|
43
|
+
export function registerHtmlRenderer(command, handler) {
|
|
44
|
+
HTML_RENDERER_REGISTRY.register(command, handler);
|
|
45
|
+
}
|
|
46
|
+
/** Register a batch of HTML renderers in iteration order. */
|
|
47
|
+
export function registerHtmlRenderers(entries) {
|
|
48
|
+
HTML_RENDERER_REGISTRY.registerAll(entries);
|
|
49
|
+
}
|
|
50
|
+
/** Look up a registered HTML renderer, or `undefined` when unregistered. */
|
|
51
|
+
export function getHtmlRendererHandler(command) {
|
|
52
|
+
return HTML_RENDERER_REGISTRY.get(command);
|
|
53
|
+
}
|
|
54
|
+
/** Remove a previously-registered HTML renderer. Test-only utility. */
|
|
55
|
+
export function deregisterHtmlRenderer(command) {
|
|
56
|
+
HTML_RENDERER_REGISTRY.deregister(command);
|
|
57
|
+
}
|
package/dist/output/renderers.js
CHANGED
|
@@ -13,12 +13,10 @@ import fs from "node:fs";
|
|
|
13
13
|
import path from "node:path";
|
|
14
14
|
import { listKeys as listVaultKeys } from "../commands/env/env.js";
|
|
15
15
|
import { parseFrontmatter } from "../core/asset/frontmatter.js";
|
|
16
|
-
import { extractFrontmatterOnly, extractLineRange, extractSection, formatToc, parseMarkdownToc, } from "../core/asset/markdown.js";
|
|
17
16
|
import { asNonEmptyString, hasErrnoCode } from "../core/common.js";
|
|
18
|
-
import { extractCommentMetadata
|
|
19
|
-
import { registerMetadataContributor } from "../indexer/passes/metadata-contributors.js";
|
|
17
|
+
import { extractCommentMetadata } from "../indexer/passes/metadata.js";
|
|
20
18
|
import { registerRenderer } from "../indexer/walk/file-context.js";
|
|
21
|
-
import { buildWorkflowAction, workflowMdRenderer
|
|
19
|
+
import { buildWorkflowAction, workflowMdRenderer } from "../workflows/renderer.js";
|
|
22
20
|
// ── Interpreter auto-detection map ───────────────────────────────────────────
|
|
23
21
|
const INTERPRETER_MAP = {
|
|
24
22
|
".sh": "bash",
|
|
@@ -219,60 +217,20 @@ const agentMdRenderer = {
|
|
|
219
217
|
};
|
|
220
218
|
},
|
|
221
219
|
};
|
|
222
|
-
// ── 4. knowledge-md / wiki-md shared helper ───────────────────────────────────
|
|
223
|
-
const KNOWLEDGE_ACTION = "Reference material - read the content below. Use 'toc' view for large documents.";
|
|
224
|
-
const WIKI_PAGE_ACTION = "Wiki page — read below. Use 'toc' to scan, 'section <heading>' for depth.";
|
|
225
|
-
/**
|
|
226
|
-
* Shared implementation for knowledge-md and wiki-md `buildShowResponse`.
|
|
227
|
-
*
|
|
228
|
-
* Both renderers handle the same set of view modes (toc, frontmatter, section,
|
|
229
|
-
* lines, full). The only differences are the `type` discriminant and the
|
|
230
|
-
* section-not-found message. Extracting this helper eliminates ~90 lines of
|
|
231
|
-
* byte-for-byte duplication.
|
|
232
|
-
*/
|
|
233
|
-
function buildMarkdownViewResponse(ctx, type, action) {
|
|
234
|
-
const name = deriveName(ctx);
|
|
235
|
-
const v = ctx.matchResult.meta?.view ?? { mode: "full" };
|
|
236
|
-
const content = ctx.content();
|
|
237
|
-
switch (v.mode) {
|
|
238
|
-
case "toc": {
|
|
239
|
-
const toc = parseMarkdownToc(content);
|
|
240
|
-
return { type, name, path: ctx.absPath, action, content: formatToc(toc) };
|
|
241
|
-
}
|
|
242
|
-
case "frontmatter": {
|
|
243
|
-
const fm = extractFrontmatterOnly(content);
|
|
244
|
-
return { type, name, path: ctx.absPath, action, content: fm ?? "(no frontmatter)" };
|
|
245
|
-
}
|
|
246
|
-
case "section": {
|
|
247
|
-
const section = extractSection(content, v.heading);
|
|
248
|
-
if (!section) {
|
|
249
|
-
const notFoundMsg = type === "wiki"
|
|
250
|
-
? `Section "${v.heading}" not found in ${name}. Try \`akm show wiki:${name} toc\` to discover available headings.`
|
|
251
|
-
: `Section "${v.heading}" not found in ${name}. Try \`akm show <ref> toc\` to discover available headings.`;
|
|
252
|
-
return { type, name, path: ctx.absPath, action, content: notFoundMsg };
|
|
253
|
-
}
|
|
254
|
-
return { type, name, path: ctx.absPath, action, content: section.content };
|
|
255
|
-
}
|
|
256
|
-
case "lines": {
|
|
257
|
-
return { type, name, path: ctx.absPath, action, content: extractLineRange(content, v.start, v.end) };
|
|
258
|
-
}
|
|
259
|
-
default: {
|
|
260
|
-
return { type, name, path: ctx.absPath, action, content };
|
|
261
|
-
}
|
|
262
|
-
}
|
|
263
|
-
}
|
|
264
220
|
// ── 4. knowledge-md ──────────────────────────────────────────────────────────
|
|
221
|
+
const KNOWLEDGE_ACTION = "Reference material - read the content below. For a large document, read one section with `akm show <ref>#fragment` " +
|
|
222
|
+
"(an unmatched #fragment lists the available slugs).";
|
|
265
223
|
const knowledgeMdRenderer = {
|
|
266
224
|
name: "knowledge-md",
|
|
267
225
|
buildShowResponse(ctx) {
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
226
|
+
const instruction = ctx.matchResult.type === "instruction";
|
|
227
|
+
return {
|
|
228
|
+
type: instruction ? "instruction" : "knowledge",
|
|
229
|
+
name: deriveName(ctx),
|
|
230
|
+
path: ctx.absPath,
|
|
231
|
+
action: instruction ? "Project instructions — read and follow the content below." : KNOWLEDGE_ACTION,
|
|
232
|
+
content: ctx.content(),
|
|
233
|
+
};
|
|
276
234
|
},
|
|
277
235
|
};
|
|
278
236
|
// ── 4c. lesson-md ────────────────────────────────────────────────────────────
|
|
@@ -405,12 +363,12 @@ const secretFileRenderer = {
|
|
|
405
363
|
type: "secret",
|
|
406
364
|
name,
|
|
407
365
|
path: ctx.absPath,
|
|
408
|
-
action: "Secret — name only; the file contents are the value and are never written to akm's stdout. Use `akm secret
|
|
366
|
+
action: "Secret — name only; the file contents are the value and are never written to akm's stdout. Use `akm secret run <ref> <VAR> -- <command>` to run with the value injected into $VAR.",
|
|
409
367
|
};
|
|
410
368
|
},
|
|
411
369
|
};
|
|
412
370
|
// ── 7. task-md ───────────────────────────────────────────────────────────────
|
|
413
|
-
const TASK_PAGE_ACTION = "Scheduled task — `akm
|
|
371
|
+
const TASK_PAGE_ACTION = "Scheduled task — `akm show tasks/<id>` for parsed details, `akm task run <id>` to invoke now.";
|
|
414
372
|
const taskMdRenderer = {
|
|
415
373
|
name: "task-yaml",
|
|
416
374
|
buildShowResponse(ctx) {
|
|
@@ -508,228 +466,6 @@ const factMdRenderer = {
|
|
|
508
466
|
};
|
|
509
467
|
},
|
|
510
468
|
};
|
|
511
|
-
function applySessionMetadata(entry, ctx) {
|
|
512
|
-
try {
|
|
513
|
-
const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
|
|
514
|
-
entry.tags = Array.from(new Set([...(entry.tags ?? []), "session"]));
|
|
515
|
-
const hints = new Set(entry.searchHints ?? []);
|
|
516
|
-
const harness = asNonEmptyString(fm.harness);
|
|
517
|
-
if (harness)
|
|
518
|
-
hints.add(`harness:${harness}`);
|
|
519
|
-
const project = asNonEmptyString(fm.project);
|
|
520
|
-
if (project)
|
|
521
|
-
hints.add(`project:${project}`);
|
|
522
|
-
// log_path is the durable correlation key — keep it discoverable as a hint
|
|
523
|
-
// so it survives in the index even when the body is re-derived.
|
|
524
|
-
const logPath = asNonEmptyString(fm.log_path);
|
|
525
|
-
if (logPath)
|
|
526
|
-
hints.add(`log_path:${logPath}`);
|
|
527
|
-
if (hints.size > 0)
|
|
528
|
-
entry.searchHints = Array.from(hints).filter(Boolean);
|
|
529
|
-
}
|
|
530
|
-
catch {
|
|
531
|
-
// Non-fatal: skip metadata extraction on parse error
|
|
532
|
-
}
|
|
533
|
-
}
|
|
534
|
-
function applyTocMetadata(entry, ctx) {
|
|
535
|
-
try {
|
|
536
|
-
const toc = parseMarkdownToc(ctx.content());
|
|
537
|
-
if (toc.headings.length > 0)
|
|
538
|
-
entry.toc = toc.headings;
|
|
539
|
-
}
|
|
540
|
-
catch {
|
|
541
|
-
// Non-fatal: skip TOC if file can't be read
|
|
542
|
-
}
|
|
543
|
-
}
|
|
544
|
-
/**
|
|
545
|
-
* Fact metadata: surface `category` and the `pinned` core marker as tags +
|
|
546
|
-
* search hints (no dedicated DB columns — same encoding pattern as session /
|
|
547
|
-
* task). `pinned` is mirrored to both a `pinned` tag and a `pinned` search
|
|
548
|
-
* hint so the ranking contributor can detect it and queries can target it.
|
|
549
|
-
*/
|
|
550
|
-
function applyFactMetadata(entry, ctx) {
|
|
551
|
-
try {
|
|
552
|
-
const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
|
|
553
|
-
const tags = new Set([...(entry.tags ?? []), "fact"]);
|
|
554
|
-
const hints = new Set(entry.searchHints ?? []);
|
|
555
|
-
const category = asNonEmptyString(fm.category);
|
|
556
|
-
if (category) {
|
|
557
|
-
tags.add(category);
|
|
558
|
-
hints.add(`category:${category}`);
|
|
559
|
-
}
|
|
560
|
-
if (fm.pinned === true) {
|
|
561
|
-
tags.add("pinned");
|
|
562
|
-
hints.add("pinned");
|
|
563
|
-
}
|
|
564
|
-
entry.tags = Array.from(tags).filter(Boolean);
|
|
565
|
-
if (hints.size > 0)
|
|
566
|
-
entry.searchHints = Array.from(hints).filter(Boolean);
|
|
567
|
-
}
|
|
568
|
-
catch {
|
|
569
|
-
// Non-fatal: skip metadata extraction on parse error
|
|
570
|
-
}
|
|
571
|
-
}
|
|
572
|
-
/**
|
|
573
|
-
* Parse frontmatter, apply description (if not already set) and merge tags
|
|
574
|
-
* into `entry`. Returns the raw frontmatter data object so callers can access
|
|
575
|
-
* type-specific fields without re-parsing.
|
|
576
|
-
*/
|
|
577
|
-
function applyFrontmatterDescriptionAndTags(entry, ctx) {
|
|
578
|
-
const parsed = parseFrontmatter(ctx.content());
|
|
579
|
-
const fm = parsed.data;
|
|
580
|
-
const desc = asNonEmptyString(fm.description);
|
|
581
|
-
if (desc && !entry.description) {
|
|
582
|
-
entry.description = desc;
|
|
583
|
-
entry.source = "frontmatter";
|
|
584
|
-
entry.confidence = 0.9;
|
|
585
|
-
}
|
|
586
|
-
if (Array.isArray(fm.tags) && fm.tags.length > 0) {
|
|
587
|
-
const fmTags = fm.tags.filter((t) => typeof t === "string" && t.trim().length > 0);
|
|
588
|
-
if (fmTags.length > 0) {
|
|
589
|
-
entry.tags = Array.from(new Set([...(entry.tags ?? []), ...fmTags]));
|
|
590
|
-
}
|
|
591
|
-
}
|
|
592
|
-
return fm;
|
|
593
|
-
}
|
|
594
|
-
function applyLessonMetadata(entry, ctx) {
|
|
595
|
-
try {
|
|
596
|
-
const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
|
|
597
|
-
const whenToUse = asNonEmptyString(fm.when_to_use);
|
|
598
|
-
if (whenToUse) {
|
|
599
|
-
const hints = new Set(entry.searchHints ?? []);
|
|
600
|
-
hints.add(`when_to_use:${whenToUse}`);
|
|
601
|
-
entry.searchHints = Array.from(hints).filter(Boolean);
|
|
602
|
-
}
|
|
603
|
-
}
|
|
604
|
-
catch {
|
|
605
|
-
// Non-fatal: skip metadata extraction on parse error
|
|
606
|
-
}
|
|
607
|
-
}
|
|
608
|
-
function applyMemoryMetadata(entry, ctx) {
|
|
609
|
-
try {
|
|
610
|
-
const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
|
|
611
|
-
const hints = new Set(entry.searchHints ?? []);
|
|
612
|
-
const source = asNonEmptyString(fm.source);
|
|
613
|
-
if (source)
|
|
614
|
-
hints.add(source);
|
|
615
|
-
const fmObservedAt = asNonEmptyString(fm.observed_at);
|
|
616
|
-
if (fmObservedAt) {
|
|
617
|
-
hints.add(`observed_at:${fmObservedAt}`);
|
|
618
|
-
}
|
|
619
|
-
else {
|
|
620
|
-
try {
|
|
621
|
-
const isoDate = ctx.stat().mtime.toISOString().slice(0, 10);
|
|
622
|
-
hints.add(`observed_at:${isoDate}`);
|
|
623
|
-
}
|
|
624
|
-
catch {
|
|
625
|
-
// Non-fatal: skip mtime fallback on stat error
|
|
626
|
-
}
|
|
627
|
-
}
|
|
628
|
-
const expires = asNonEmptyString(fm.expires);
|
|
629
|
-
if (expires)
|
|
630
|
-
hints.add(`expires:${expires}`);
|
|
631
|
-
if (fm.subjective === true)
|
|
632
|
-
hints.add("subjective");
|
|
633
|
-
if (hints.size > 0) {
|
|
634
|
-
entry.searchHints = Array.from(hints).filter(Boolean);
|
|
635
|
-
}
|
|
636
|
-
}
|
|
637
|
-
catch {
|
|
638
|
-
// Non-fatal: skip metadata extraction on error
|
|
639
|
-
}
|
|
640
|
-
}
|
|
641
|
-
function applyScriptMetadata(entry, ctx) {
|
|
642
|
-
if (ctx.ext === ".md")
|
|
643
|
-
return;
|
|
644
|
-
const commentDesc = extractDescriptionFromComments(ctx.absPath);
|
|
645
|
-
if (commentDesc && !entry.description) {
|
|
646
|
-
entry.description = commentDesc;
|
|
647
|
-
entry.source = "comments";
|
|
648
|
-
entry.confidence = 0.7;
|
|
649
|
-
}
|
|
650
|
-
}
|
|
651
|
-
function applyEnvMetadata(entry, ctx) {
|
|
652
|
-
// Key names only — comment text must never reach description/search_text
|
|
653
|
-
// (comments routinely contain commented-out credentials).
|
|
654
|
-
const { keys } = listVaultKeys(ctx.absPath);
|
|
655
|
-
if (keys.length > 0) {
|
|
656
|
-
entry.searchHints = keys;
|
|
657
|
-
}
|
|
658
|
-
entry.tags = Array.from(new Set([...(entry.tags ?? []), "env", "secrets"]));
|
|
659
|
-
}
|
|
660
|
-
/**
|
|
661
|
-
* Secret metadata: tags only. Must NEVER read the file body — the whole file
|
|
662
|
-
* is the value, so the entry is built from the filename alone (name-only).
|
|
663
|
-
*/
|
|
664
|
-
function applySecretMetadata(entry, _ctx) {
|
|
665
|
-
entry.tags = Array.from(new Set([...(entry.tags ?? []), "secret", "sensitive"]));
|
|
666
|
-
}
|
|
667
|
-
function applyTaskMetadata(entry, ctx) {
|
|
668
|
-
try {
|
|
669
|
-
const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
|
|
670
|
-
entry.tags = Array.from(new Set([...(entry.tags ?? []), "task", "scheduled"]));
|
|
671
|
-
const hints = new Set(entry.searchHints ?? []);
|
|
672
|
-
const schedule = asNonEmptyString(fm.schedule);
|
|
673
|
-
if (schedule)
|
|
674
|
-
hints.add(`schedule:${schedule}`);
|
|
675
|
-
const workflow = asNonEmptyString(fm.workflow);
|
|
676
|
-
if (workflow)
|
|
677
|
-
hints.add(`workflow:${workflow}`);
|
|
678
|
-
const prompt = asNonEmptyString(fm.prompt);
|
|
679
|
-
if (prompt)
|
|
680
|
-
hints.add(`prompt:${prompt}`);
|
|
681
|
-
if (hints.size > 0)
|
|
682
|
-
entry.searchHints = Array.from(hints).filter(Boolean);
|
|
683
|
-
}
|
|
684
|
-
catch {
|
|
685
|
-
// Non-fatal: skip metadata extraction on error
|
|
686
|
-
}
|
|
687
|
-
}
|
|
688
|
-
registerMetadataContributor({
|
|
689
|
-
name: "toc-metadata",
|
|
690
|
-
appliesTo: ({ rendererName }) => rendererName === "knowledge-md" || rendererName === "wiki-md",
|
|
691
|
-
contribute: (entry, ctx) => applyTocMetadata(entry, ctx.renderContext),
|
|
692
|
-
});
|
|
693
|
-
registerMetadataContributor({
|
|
694
|
-
name: "lesson-frontmatter-metadata",
|
|
695
|
-
appliesTo: ({ rendererName }) => rendererName === "lesson-md",
|
|
696
|
-
contribute: (entry, ctx) => applyLessonMetadata(entry, ctx.renderContext),
|
|
697
|
-
});
|
|
698
|
-
registerMetadataContributor({
|
|
699
|
-
name: "memory-frontmatter-metadata",
|
|
700
|
-
appliesTo: ({ rendererName }) => rendererName === "memory-md",
|
|
701
|
-
contribute: (entry, ctx) => applyMemoryMetadata(entry, ctx.renderContext),
|
|
702
|
-
});
|
|
703
|
-
registerMetadataContributor({
|
|
704
|
-
name: "script-comment-metadata",
|
|
705
|
-
appliesTo: ({ rendererName }) => rendererName === "script-source",
|
|
706
|
-
contribute: (entry, ctx) => applyScriptMetadata(entry, ctx.renderContext),
|
|
707
|
-
});
|
|
708
|
-
registerMetadataContributor({
|
|
709
|
-
name: "env-file-metadata",
|
|
710
|
-
appliesTo: ({ rendererName }) => rendererName === "env-file",
|
|
711
|
-
contribute: (entry, ctx) => applyEnvMetadata(entry, ctx.renderContext),
|
|
712
|
-
});
|
|
713
|
-
registerMetadataContributor({
|
|
714
|
-
name: "secret-file-metadata",
|
|
715
|
-
appliesTo: ({ rendererName }) => rendererName === "secret-file",
|
|
716
|
-
contribute: (entry, ctx) => applySecretMetadata(entry, ctx.renderContext),
|
|
717
|
-
});
|
|
718
|
-
registerMetadataContributor({
|
|
719
|
-
name: "task-yaml-metadata",
|
|
720
|
-
appliesTo: ({ rendererName }) => rendererName === "task-yaml",
|
|
721
|
-
contribute: (entry, ctx) => applyTaskMetadata(entry, ctx.renderContext),
|
|
722
|
-
});
|
|
723
|
-
registerMetadataContributor({
|
|
724
|
-
name: "session-md-metadata",
|
|
725
|
-
appliesTo: ({ rendererName }) => rendererName === "session-md",
|
|
726
|
-
contribute: (entry, ctx) => applySessionMetadata(entry, ctx.renderContext),
|
|
727
|
-
});
|
|
728
|
-
registerMetadataContributor({
|
|
729
|
-
name: "fact-md-metadata",
|
|
730
|
-
appliesTo: ({ rendererName }) => rendererName === "fact-md",
|
|
731
|
-
contribute: (entry, ctx) => applyFactMetadata(entry, ctx.renderContext),
|
|
732
|
-
});
|
|
733
469
|
// ── Registration ─────────────────────────────────────────────────────────────
|
|
734
470
|
/** All built-in renderers. */
|
|
735
471
|
const builtinRenderers = [
|
|
@@ -737,11 +473,9 @@ const builtinRenderers = [
|
|
|
737
473
|
commandMdRenderer,
|
|
738
474
|
agentMdRenderer,
|
|
739
475
|
knowledgeMdRenderer,
|
|
740
|
-
wikiMdRenderer,
|
|
741
476
|
lessonMdRenderer,
|
|
742
477
|
memoryMdRenderer,
|
|
743
478
|
workflowMdRenderer,
|
|
744
|
-
workflowProgramRenderer,
|
|
745
479
|
scriptSourceRenderer,
|
|
746
480
|
envFileRenderer,
|
|
747
481
|
secretFileRenderer,
|
|
@@ -759,4 +493,4 @@ export function registerBuiltinRenderers() {
|
|
|
759
493
|
}
|
|
760
494
|
}
|
|
761
495
|
// ── Named exports for testing ────────────────────────────────────────────────
|
|
762
|
-
export { agentMdRenderer, commandMdRenderer, envFileRenderer, factMdRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, secretFileRenderer, skillMdRenderer,
|
|
496
|
+
export { agentMdRenderer, commandMdRenderer, envFileRenderer, factMdRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, secretFileRenderer, skillMdRenderer, workflowMdRenderer, };
|
|
@@ -11,6 +11,9 @@ const NORMAL_FIELDS = [
|
|
|
11
11
|
"type",
|
|
12
12
|
"name",
|
|
13
13
|
"ref",
|
|
14
|
+
"path",
|
|
15
|
+
"editable",
|
|
16
|
+
"editHint",
|
|
14
17
|
"id",
|
|
15
18
|
"description",
|
|
16
19
|
"preview",
|
|
@@ -28,6 +31,9 @@ const AGENT_FIELDS = [
|
|
|
28
31
|
"type",
|
|
29
32
|
"name",
|
|
30
33
|
"ref",
|
|
34
|
+
"path",
|
|
35
|
+
"editable",
|
|
36
|
+
"editHint",
|
|
31
37
|
"id",
|
|
32
38
|
"description",
|
|
33
39
|
"supportRefs",
|
|
@@ -37,7 +43,10 @@ const AGENT_FIELDS = [
|
|
|
37
43
|
];
|
|
38
44
|
function shapeCurateItem(item, detail, shape) {
|
|
39
45
|
if (shape === "agent") {
|
|
40
|
-
|
|
46
|
+
const shaped = pickFields(item, AGENT_FIELDS);
|
|
47
|
+
if (shaped.editable !== false)
|
|
48
|
+
delete shaped.editHint;
|
|
49
|
+
return capDescription(shaped, NORMAL_DESCRIPTION_LIMIT);
|
|
41
50
|
}
|
|
42
51
|
if (detail === "brief") {
|
|
43
52
|
return pickFields(item, BRIEF_FIELDS);
|
|
@@ -1,12 +1,17 @@
|
|
|
1
1
|
// This Source Code Form is subject to the terms of the Mozilla Public
|
|
2
2
|
// License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
3
3
|
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
|
|
4
|
-
// Output shape registration for `akm
|
|
5
|
-
//
|
|
6
|
-
//
|
|
4
|
+
// Output shape registration for `akm log` (#204).
|
|
5
|
+
//
|
|
6
|
+
// R-060: renamed from `events-list` (the command group used to be `akm
|
|
7
|
+
// events`) to `log-list`, matching the current `akm log` command name
|
|
8
|
+
// (src/commands/observability-cli.ts). This string is an internal registry
|
|
9
|
+
// key only — `shapeEventsOutput` builds its own envelope and never stamps a
|
|
10
|
+
// `shape` field on the wire, so the rename does not require a schemaVersion
|
|
11
|
+
// bump.
|
|
12
|
+
//
|
|
13
|
+
// 0.9.0 CLI overhaul (S3): `log tail` (and its `log-tail` shape entry) was
|
|
14
|
+
// dropped along with the command.
|
|
7
15
|
import { shapeEventsOutput } from "./helpers.js";
|
|
8
16
|
const handler = (result, detail) => shapeEventsOutput(result, detail);
|
|
9
|
-
export const eventsShapes = [
|
|
10
|
-
{ command: "events-list", handler },
|
|
11
|
-
{ command: "events-tail", handler },
|
|
12
|
-
];
|
|
17
|
+
export const eventsShapes = [{ command: "log-list", handler }];
|