akm-cli 0.7.4 → 0.7.5

package/dist/workflows/runs.js

@@ -12,20 +12,22 @@ import { resolveAssetPath } from "../sources/resolve";
 import { formatWorkflowErrors } from "./authoring";
 import { closeWorkflowDatabase, openWorkflowDatabase } from "./db";
 import { parseWorkflow } from "./parser";
+import { getCurrentWorkflowScopeKey } from "./scope-key";
 export async function startWorkflowRun(ref, params = {}) {
     const asset = await loadWorkflowAsset(ref);
     const workflowDb = openWorkflowDatabase();
     try {
         const now = new Date().toISOString();
         const runId = randomUUID();
+        const scopeKey = getCurrentWorkflowScopeKey();
         const currentStepId = asset.steps[0]?.id ?? null;
         const workflowEntryId = resolveWorkflowEntryId(asset.sourcePath, asset.ref);
         workflowDb.transaction(() => {
             workflowDb
                 .prepare(`INSERT INTO workflow_runs (
-          id, workflow_ref, workflow_entry_id, workflow_title, status, params_json, current_step_id, created_at, updated_at
-        ) VALUES (?, ?, ?, ?, 'active', ?, ?, ?, ?)`)
-                .run(runId, asset.ref, workflowEntryId, asset.title, JSON.stringify(params), currentStepId, now, now);
+          id, workflow_ref, scope_key, workflow_entry_id, workflow_title, status, params_json, current_step_id, created_at, updated_at
+        ) VALUES (?, ?, ?, ?, ?, 'active', ?, ?, ?, ?)`)
+                .run(runId, asset.ref, scopeKey, workflowEntryId, asset.title, JSON.stringify(params), currentStepId, now, now);
             const insertStep = workflowDb.prepare(`INSERT INTO workflow_run_steps (
           run_id, step_id, step_title, instructions, completion_json, sequence_index, status
         ) VALUES (?, ?, ?, ?, ?, ?, 'pending')`);
@@ -56,11 +58,24 @@ export function getWorkflowStatus(runId) {
         closeWorkflowDatabase(workflowDb);
     }
 }
+export function hasWorkflowRun(runId) {
+    const workflowDb = openWorkflowDatabase();
+    try {
+        const row = workflowDb.prepare("SELECT 1 FROM workflow_runs WHERE id = ? LIMIT 1").get(runId);
+        return !!row;
+    }
+    finally {
+        closeWorkflowDatabase(workflowDb);
+    }
+}
 export function listWorkflowRuns(input) {
     const workflowDb = openWorkflowDatabase();
     try {
         const filters = [];
         const params = [];
+        const scopeKey = getCurrentWorkflowScopeKey();
+        filters.push("scope_key = ?");
+        params.push(scopeKey);
         if (input?.workflowRef) {
             const parsed = parseAssetRef(input.workflowRef);
             if (parsed.type !== "workflow") {
@@ -211,9 +226,10 @@ async function resolveRunSpecifier(db, specifier, params) {
         throw new UsageError(`Expected a workflow ref or workflow run id, got "${specifier}".`);
     }
     const ref = `${parsed.origin ? `${parsed.origin}//` : ""}workflow:${parsed.name}`;
+    const scopeKey = getCurrentWorkflowScopeKey();
     const active = db
-        .prepare("SELECT * FROM workflow_runs WHERE workflow_ref = ? AND status = 'active' ORDER BY updated_at DESC LIMIT 1")
-        .get(ref);
+        .prepare("SELECT * FROM workflow_runs WHERE workflow_ref = ? AND scope_key = ? AND status = 'active' ORDER BY updated_at DESC LIMIT 1")
+        .get(ref, scopeKey);
     if (active) {
         if (params && Object.keys(params).length > 0) {
             throw new UsageError(`--params can only be set on a new run; ${ref} already has an active run`);
@@ -358,6 +374,7 @@ function toWorkflowRunSummary(run) {
     return {
         id: run.id,
         workflowRef: run.workflow_ref,
+        scopeKey: run.scope_key,
         workflowEntryId: run.workflow_entry_id,
         workflowTitle: run.workflow_title,
         status: run.status,
@@ -435,12 +452,12 @@ function parseJsonArray(value) {
     }
     return undefined;
 }
-export function getActiveWorkflowRun() {
+export function getActiveWorkflowRun(scopeKey = getCurrentWorkflowScopeKey()) {
     try {
         const workflowDb = openWorkflowDatabase();
         const row = workflowDb
-            .query("SELECT id, current_step_id, workflow_ref FROM workflow_runs WHERE status IN ('active', 'blocked') ORDER BY updated_at DESC LIMIT 1")
-            .get();
+            .query("SELECT id, current_step_id, workflow_ref FROM workflow_runs WHERE scope_key = ? AND status IN ('active', 'blocked') ORDER BY updated_at DESC LIMIT 1")
+            .get(scopeKey);
         closeWorkflowDatabase(workflowDb);
         if (!row)
             return null;

package/dist/workflows/scope-key.js

@@ -0,0 +1,76 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { isWithin, resolveStashDir, safeRealpath, toPosix } from "../core/common";
+const PROJECT_CONFIG_RELATIVE_PATH = path.join(".akm", "config.json");
+export function getCurrentWorkflowScopeKey() {
+    const anchor = resolveWorkflowScopeAnchor(process.cwd());
+    const normalized = normalizeScopePath(anchor);
+    const digest = createHash("sha256").update(normalized).digest("hex");
+    return `dir:v1:${digest}`;
+}
+export function resolveWorkflowScopeAnchor(startDir) {
+    const cwd = safeRealpath(startDir);
+    const projectRoot = findNearestProjectConfigRoot(cwd);
+    if (projectRoot)
+        return projectRoot;
+    const gitRoot = findNearestGitRoot(cwd);
+    if (gitRoot)
+        return gitRoot;
+    try {
+        const stashDir = safeRealpath(resolveStashDir({ readOnly: true }));
+        if (isWithin(cwd, stashDir))
+            return stashDir;
+    }
+    catch {
+        // Ignore stash resolution failures and fall back to cwd.
+    }
+    return cwd;
+}
+function findNearestProjectConfigRoot(startDir) {
+    let currentDir = startDir;
+    while (true) {
+        const configPath = path.join(currentDir, PROJECT_CONFIG_RELATIVE_PATH);
+        if (isFile(configPath)) {
+            return safeRealpath(currentDir);
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            return null;
+        currentDir = parentDir;
+    }
+}
+function findNearestGitRoot(startDir) {
+    let currentDir = startDir;
+    while (true) {
+        const gitPath = path.join(currentDir, ".git");
+        if (exists(gitPath)) {
+            return safeRealpath(currentDir);
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            return null;
+        currentDir = parentDir;
+    }
+}
+function exists(candidate) {
+    try {
+        fs.accessSync(candidate, fs.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isFile(candidate) {
+    try {
+        return fs.statSync(candidate).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeScopePath(value) {
+    const posix = toPosix(value);
+    return process.platform === "win32" ? posix.toLowerCase() : posix;
+}

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

@@ -14,4 +14,4 @@ This is a patch release that fixes the publish process. No functional changes fr
 - **`.stash.json` no longer drives incremental stale detection** — editing `.stash.json` alone no longer forces directories to rescan during incremental indexing.
 - **One-shot URL ingest for `akm import` and `akm wiki stash`** — both commands now accept a single HTTP/HTTPS URL in addition to file paths and stdin. `akm import <url>` fetches the exact page, converts it to markdown, and writes it into `knowledge/` using a URL-path-derived default name. `akm wiki stash <wiki> <url>` fetches the exact page, converts it to markdown, and writes it into `wikis/<wiki>/raw/`. Neither command registers a persistent website source or crawls linked pages.
 
-For stash authors on the 0.7.x pre-release line: `.stash.json` remains supported for compatibility in this release, but it is deprecated and will be removed in v0.8.0. That timeline is intentional: during this aggressive pre-release phase-out window, compatibility shims do not stay around until 1.0 unless they still earn their cost. Prefer frontmatter for markdown assets and structured code comments for scripts, and migrate any remaining `.stash.json` metadata before taking the 0.8 upgrade.
+For stash authors on the 0.7.x pre-release line: `.stash.json` remains supported for compatibility in this release, but it is deprecated and will be removed in v0.8.0. That timeline is intentional: during this aggressive pre-release phase-out window, compatibility shims do not stay around until 1.0 unless they still earn their cost. Prefer frontmatter for markdown assets and structured code comments for scripts, and migrate any remaining `.stash.json` metadata before taking the 0.8 upgrade.

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

@@ -0,0 +1,20 @@
+Migration notes for akm v0.7.5
+
+0.7.5 is a patch release that rolls up all changes shipped on `main` after v0.7.4.
+
+- **Workflow runs are now workspace-scoped** — ref-based workflow commands (`workflow next`, `workflow status`, `workflow list`) now resolve runs within the current project/worktree/directory instead of sharing one global active-run pool across every repo and local sandbox. This fixes cross-repo blocking and leakage for workflow refs such as `workflow:github-issues-parallel-implementer`. Direct run-id commands still target the exact run.
+- **Workflow help/docs now explain scope semantics** — CLI help, operator docs, and workflow-facing hints now describe the current-scope behavior so teams know that ref-based run resolution is local to the current workspace.
+- **`show` now prefers fresh index state** — stale index reads auto-refresh instead of silently falling back to a raw filesystem path, reducing search/show drift.
+- **External agent + LLM parsing is more defensive** — reflect/propose and related local-model JSON parsing paths are hardened against malformed or partial output.
+- **Reflect temp-file handling is safer** — draft files for reflection flows now live in OS temp space instead of the stash.
+- **Memory inference respects token budgets** — long inputs are now trimmed to the configured LLM budget.
+- **Vault and save follow-ups landed** — vault path/run flows and named git stash selection in `akm save` received targeted fixes and regression coverage.
+- **Release/migration packaging is tighter** — published static files, changelog resolution, and rerunnable release automation received follow-up fixes.
+
+No manual migration is required for most users, but note these operator-facing details:
+
+1. If you were relying on ref-based workflow runs being globally shared across repos or directories, that behavior is gone. Use direct run IDs when you intentionally need to resume a specific run created elsewhere.
+2. Existing older workflow runs created before the new workspace scope key was introduced are still accessible by direct run ID, but ref-based commands now prefer runs created in the current scope.
+3. `akm help migrate latest` now resolves to 0.7.5 and uses the published `.github/CHANGELOG.md` path.
+
+Full changelog: https://github.com/itlackey/akm/blob/main/.github/CHANGELOG.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "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": [
@@ -34,7 +34,7 @@
   "files": [
     "dist",
     "README.md",
-    "CHANGELOG.md",
+    ".github/CHANGELOG.md",
     "LICENSE",
     "docs/migration/release-notes"
   ],