akm-cli 0.7.5 → 0.8.0-rc2

package/dist/workflows/workflow-template.md

@@ -0,0 +1,24 @@
+---
+description: Describe what this workflow accomplishes
+tags:
+  - example
+params:
+  example_param: Explain this parameter
+---
+
+# Workflow: {{TITLE}}
+
+## Step: {{FIRST_STEP_TITLE}}
+Step ID: {{FIRST_STEP_ID}}
+
+### Instructions
+Describe what to do in this step.
+
+### Completion Criteria
+- Confirm the first step is complete
+
+## Step: Second Step
+Step ID: second-step
+
+### Instructions
+Describe what happens next.

package/docs/README.md

@@ -33,6 +33,9 @@
 - [Search](technical/search.md) -- Hybrid search architecture and scoring
 - [Indexing](technical/indexing.md) -- How the search index is built
 - [Classification](technical/classification.md) -- Matcher and renderer behavior
+- [Functional Contract Patterns](technical/functional-contract-patterns.md) -- Quick reference for contributor pipelines and small process contracts
+- [Implementation Plan: Functional Contract Refactor](technical/implementation-plan-functional-contract-refactor.md) -- Phased plan to move behavior from type-centric switchboards to process-local contributors
+- [Architecture Cleanup Checklist](technical/architecture-cleanup-checklist.md) -- Living checklist for executing the cleanup plan with parity gates, reviews, and git hygiene
 - [Show Response](technical/show-response.md) -- `akm show` output fields by asset type
 - [Testing Workflow](technical/testing-workflow.md) -- End-to-end, Docker, deployment, and upgrade validation
 - [Ref Format](technical/ref.md) -- Wire format for asset references

package/docs/migration/release-notes/0.7.0.md

@@ -90,7 +90,7 @@ until the user opts in. Seven keys ship in 0.7.0:
 | `feedback_distillation` | `akm distill <ref>` |
 | `embedding_fallback_score` | scorer fallback when embeddings unavailable |
 | `memory_inference` | indexer split of pending memories into atomic facts |
-| `graph_extraction` | indexer entity/relation extraction → `graph.json` |
+| `graph_extraction` | indexer entity/relation extraction → SQLite graph tables |
 
 Every gated call site uses `tryLlmFeature(feature, config, fn, fallback)`
 from `src/llm/feature-gate.ts`. The wrapper guarantees:

package/docs/migration/release-notes/0.8.0.md

@@ -0,0 +1,43 @@
+Migration notes for akm v0.8.0
+
+This release combines the 0.8.0 CLI/storage break with the final improve-owned
+maintenance migration work that landed before release validation closed.
+
+Key operator-facing changes:
+
+- `akm index --enrich` and `akm index --re-enrich` are removed.
+- Plain `akm index` now owns metadata enhancement only.
+- Memory inference and graph extraction now run from `akm improve` after
+  consolidation, not from `akm index`.
+- Manual QA and sandbox guidance now require isolating `AKM_DATA_DIR` in
+  addition to `HOME`, XDG dirs, and `AKM_STASH_DIR`.
+- `akm health` is available for post-upgrade runtime checks against `state.db`,
+  task-history integrity, agent availability, and recent improve telemetry.
+
+Primary public command family for 0.8.0:
+
+- `akm improve [<type>|<ref>]`
+- `akm propose <type> <name> (--task "..." | --file <path>)`
+- `akm proposals`
+- `akm show proposal <id>`
+- `akm diff proposal <id>`
+- `akm accept <id>`
+- `akm reject <id> --reason "..."`
+
+Proposal-queue and improvement workflows are consolidated around this family.
+Update scripts, prompts, docs, and agent instructions before upgrading.
+
+Behavior changes worth noting:
+
+- `akm search` with no query now fails with `MISSING_REQUIRED_ARGUMENT`.
+- `akm remember --enrich` is fail-soft: if no LLM is configured, the memory is
+  still written.
+- `akm wiki stash <wiki> <url>` once again fetches and stores URL snapshots in
+  `wikis/<name>/raw/`.
+- `akm health --since 24h` provides a fast operator check for state-db
+  round-trip health, task-log backing, and recent improve outcomes.
+
+Release validation status for the final 0.8.0 cut:
+
+- Full repo test suite passed.
+- Docker install matrix passed for both Bun and binary install paths.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.7.5",
+  "version": "0.8.0-rc2",
   "type": "module",
   "description": "akm (Agent Kit Manager) — A package manager for AI agent skills, commands, tools, and knowledge. Works with Claude Code, OpenCode, Cursor, and any AI coding assistant.",
   "keywords": [
@@ -42,7 +42,7 @@
     "akm": "dist/cli.js"
   },
   "scripts": {
-    "build": "rm -rf dist && bun run tsc --project ./tsconfig.build.json",
+    "build": "rm -rf dist && bun run tsc --project ./tsconfig.build.json && bun scripts/copy-assets.ts",
     "check": "bun run lint && bunx tsc --noEmit && bun test ./tests",
     "check:changed": "bun test tests/output-baseline.test.ts tests/e2e.test.ts tests/stash-search.test.ts && bun run lint && bunx tsc --noEmit",
     "test": "bun test ./tests",
@@ -74,6 +74,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.3.0",
+    "@opencode-ai/sdk": "1.2.20",
     "citty": "^0.2.2",
     "dotenv": "^17.4.2",
     "yaml": "^2.8.4"

package/dist/templates/wiki-templates.js

@@ -1,100 +0,0 @@
-/**
- * Scaffolded content for a fresh `wikis/<name>/` directory.
- *
- * Inlined as TypeScript constants so they ship with the published bundle
- * (the build step is `tsc` — non-TS files are not copied to dist).
- *
- * The scaffold is deliberately minimal: akm does not prescribe conventions
- * beyond the three-layer layout. `schema.md` is the per-wiki rulebook the
- * agent reads first; authors customise it freely.
- */
-export function buildSchemaMd(wikiName) {
-    return `---
-description: Rules that govern this wiki. Read before ingesting, searching, or editing pages.
-wikiRole: schema
----
-
-# ${wikiName} wiki schema
-
-This wiki follows the three-layer pattern:
-
-- \`raw/\` — immutable ingested sources (never edit)
-- \`<page>.md\` and \`<topic>/<page>.md\` — agent-authored pages
-- \`schema.md\` (this file), \`index.md\`, \`log.md\` — wiki-level metadata
-
-## Page frontmatter
-
-Every page should carry frontmatter so akm can index and link it:
-
-\`\`\`yaml
----
-description: one-sentence summary used in search and lint
-pageKind: entity | concept | question | note | <your-custom-kind>
-xrefs:
-  - wiki:${wikiName}/other-page
-sources:
-  - raw/<slug>.md
----
-\`\`\`
-
-\`pageKind\` accepts any non-empty string. Add new categories freely; they
-will surface in \`index.md\` as new sections after the next \`akm index\` run.
-
-## Three operations
-
-### Ingest
-
-1. Copy the new source into \`raw/\` with \`akm wiki stash ${wikiName} <path>\`.
-2. Find related pages: \`akm wiki search ${wikiName} "<terms>"\`.
-3. For each related page: append a section, note a contradiction, or create a
-   new page. Update xrefs on both sides.
-4. Cite the raw source in each touched page's \`sources:\` frontmatter.
-5. Append one entry to \`log.md\` describing what was assimilated.
-
-### Query
-
-1. \`akm wiki search ${wikiName} "<question>"\` — find candidate pages.
-2. \`akm show wiki:${wikiName}/<page>\` — read the top hits.
-3. Compose the answer from the wiki; cite raw sources only when the wiki
-   points at them.
-
-### Lint
-
-1. \`akm wiki lint ${wikiName}\` — deterministic structural checks.
-2. Resolve each finding: link orphans, fix broken xrefs, add descriptions,
-   cite uncited raws, refresh the index.
-
-## Hard rules
-
-- \`raw/\` is immutable. Never edit ingested sources.
-- Cross-references must point at pages that actually exist.
-- Prefer appending to an existing page over duplicating one.
-- Cite the raw source id (e.g. \`raw/2026-04-foo.md\`) when copying claims.
-`;
-}
-export function buildIndexMd(wikiName) {
-    return `---
-description: Catalog of pages in the ${wikiName} wiki. Regenerated by \`akm index\`.
-wikiRole: index
----
-
-# ${wikiName} — index
-
-_This file is regenerated on every \`akm index\` run. Manual edits are
-preserved until the next regeneration, then replaced._
-
-_(no pages yet — create one with your editor, or ingest a source with \`akm
-wiki stash ${wikiName} <path>\`.)_
-`;
-}
-export function buildLogMd(wikiName) {
-    return `---
-description: Append-only log for the ${wikiName} wiki. Newest entries at the top.
-wikiRole: log
----
-
-# ${wikiName} — log
-
-_Each entry: ISO date, operation, brief summary._
-`;
-}