akm-cli 0.9.0-beta.51 → 0.9.0-beta.52

package/dist/assets/wiki/ingest-workflow-template.md

@@ -48,8 +48,8 @@ empty and the caller explicitly asked for interactive ingest.
    ```sh
    akm wiki search {{WIKI_NAME}} "<key terms from the raw source>"
    ```
-   Read the top hits with `akm show wiki:{{WIKI_NAME}}/<page>`. Use
-   `akm show wiki:{{WIKI_NAME}}/<page> toc` for large pages.
+   Read the top hits with `akm show wiki:{{WIKI_NAME}}/pages/<page>`. Use
+   `akm show wiki:{{WIKI_NAME}}/pages/<page> toc` for large pages.
 
 4. **Decide for each candidate.** For each related page:
    - **Append**: add a section or paragraph under the relevant heading.
@@ -58,10 +58,11 @@ empty and the caller explicitly asked for interactive ingest.
      Follow the schema's contradiction policy.
    - **Skip**: source doesn't add to this page — move on.
 
-5. **Create new pages for concepts/entities the source introduces.** Each
-   new page must have frontmatter with `description`, `pageKind`,
-   `xrefs`, and `sources`. Cross-reference with related pages both
-   directions.
+5. **Create new pages for concepts/entities the source introduces**, under
+   `{{WIKI_DIR}}/pages/` (never at the wiki root — only `schema.md`,
+   `index.md`, and `log.md` belong there). Each new page must have
+   frontmatter with `description`, `pageKind`, `xrefs`, and `sources`.
+   Cross-reference with related pages both directions.
 
 6. **Update xrefs both ways.** If page A now xrefs page B, page B must xref
    page A. `akm wiki lint {{WIKI_NAME}}` will flag violations.

package/dist/assets/wiki/schema-template.md

@@ -8,7 +8,7 @@ wikiRole: schema
 This wiki follows the three-layer pattern:
 
 - `raw/` — immutable ingested sources (never edit)
-- `<page>.md` and `<topic>/<page>.md` — agent-authored pages
+- `pages/<page>.md` and `pages/<topic>/<page>.md` — agent-authored pages
 - `schema.md` (this file), `index.md`, `log.md` — wiki-level metadata
 
 ## Page frontmatter
@@ -20,7 +20,7 @@ Every page should carry frontmatter so akm can index and link it:
 description: one-sentence summary used in search and lint
 pageKind: entity | concept | question | note | <your-custom-kind>
 xrefs:
-  - wiki:{{WIKI_NAME}}/other-page
+  - wiki:{{WIKI_NAME}}/pages/other-page
 sources:
   - raw/<slug>.md
 ---
@@ -36,14 +36,14 @@ will surface in `index.md` as new sections after the next `akm index` run.
 1. Copy the new source into `raw/` with `akm wiki stash {{WIKI_NAME}} <path>`.
 2. Find related pages: `akm wiki search {{WIKI_NAME}} "<terms>"`.
 3. For each related page: append a section, note a contradiction, or create a
-   new page. Update xrefs on both sides.
+   new page under `pages/`. 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 {{WIKI_NAME}} "<question>"` — find candidate pages.
-2. `akm show wiki:{{WIKI_NAME}}/<page>` — read the top hits.
+2. `akm show wiki:{{WIKI_NAME}}/pages/<page>` — read the top hits.
 3. Compose the answer from the wiki; cite raw sources only when the wiki
    points at them.
 

package/dist/commands/improve/preparation.js

@@ -572,7 +572,7 @@ async function runSessionExtractPass(args) {
  * LLM schema repair, and returns the still-failing ref set + the repair records.
  */
 async function runValidationAndRepairPass(args) {
-    const { postCleanupRefs, options, startMs, budgetMs } = args;
+    const { postCleanupRefs, options, startMs, budgetMs, primaryStashDir } = args;
     const validationFailures = [];
     for (const candidate of postCleanupRefs) {
         try {
@@ -617,7 +617,14 @@ async function runValidationAndRepairPass(args) {
                 startMs,
                 budgetMs,
                 llmConfig: llmCfg,
-                stashDir: options.stashDir,
+                // #591/#379 regression: options.stashDir is the raw, unresolved CLI
+                // flag (only set when --stash-dir is passed explicitly — never true
+                // for the scheduled tasks). primaryStashDir is the already-resolved
+                // source path and is what runSchemaRepairPass's `stashDir` param
+                // documents itself as needing ("proposal-queue writes"). Passing
+                // options.stashDir here made every schema-repair attempt throw
+                // `runSchemaRepairPass requires stashDir` on every cron invocation.
+                stashDir: primaryStashDir,
                 findFilePath: findAssetFilePath,
                 isLessonCandidateFn: isLessonCandidate,
             });
@@ -737,6 +744,7 @@ export async function runImprovePreparationStage(args) {
         options,
         startMs,
         budgetMs,
+        primaryStashDir,
     });
     // Phase 0.5 — structural hygiene pass
     let lintSummary;

package/dist/wiki/wiki.js

@@ -58,6 +58,8 @@ export const SCHEMA_MD = "schema.md";
 export const INDEX_MD = "index.md";
 export const LOG_MD = "log.md";
 export const RAW_SUBDIR = "raw";
+/** Canonical location for agent-authored pages, mirroring RAW_SUBDIR. */
+export const PAGES_SUBDIR = "pages";
 /** Files at a wiki root that are not pages. */
 const WIKI_SPECIAL_FILES = new Set([SCHEMA_MD, INDEX_MD, LOG_MD]);
 const WIKI_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
@@ -406,18 +408,20 @@ export function createWiki(stashDir, name) {
         fs.writeFileSync(absPath, content, "utf8");
         created.push(absPath);
     }
-    // Ensure raw/ exists with a .gitkeep so empty wikis survive clean clones.
-    // Handle the dir-exists-but-no-.gitkeep case too (partial scaffolds,
+    // Ensure raw/ and pages/ exist with a .gitkeep so empty wikis survive clean
+    // clones. Handle the dir-exists-but-no-.gitkeep case too (partial scaffolds,
     // user-created directories) so the invariant always holds after `create`.
-    const rawDir = path.join(wikiDir, RAW_SUBDIR);
-    fs.mkdirSync(rawDir, { recursive: true });
-    const gitkeepPath = path.join(rawDir, ".gitkeep");
-    if (fs.existsSync(gitkeepPath)) {
-        skipped.push(gitkeepPath);
-    }
-    else {
-        fs.writeFileSync(gitkeepPath, "", "utf8");
-        created.push(gitkeepPath);
+    for (const subdir of [RAW_SUBDIR, PAGES_SUBDIR]) {
+        const dir = path.join(wikiDir, subdir);
+        fs.mkdirSync(dir, { recursive: true });
+        const gitkeepPath = path.join(dir, ".gitkeep");
+        if (fs.existsSync(gitkeepPath)) {
+            skipped.push(gitkeepPath);
+        }
+        else {
+            fs.writeFileSync(gitkeepPath, "", "utf8");
+            created.push(gitkeepPath);
+        }
     }
     return { name, ref: `wiki:${name}`, path: wikiDir, created, skipped };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.9.0-beta.51",
+  "version": "0.9.0-beta.52",
   "type": "module",
   "description": "akm (Agent Knowledge Management) — A package manager for AI agent skills, commands, tools, and knowledge. Works with Claude Code, OpenCode, Cursor, and any AI coding assistant.",
   "keywords": [