@polderlabs/bizar 10.29.0 → 10.29.2

package/cli/commands/openkan.mjs

@@ -1,6 +1,12 @@
 import { spawnSync } from 'node:child_process';
+import { dirname, join, resolve as resolvePath } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { ensureOpenKanProject, installOpenKanPromise, OpenKanError, resolveOpenKanDashboard, runOpenKanOk } from '../openkan.mjs';
 
+const HERE = dirname(fileURLToPath(import.meta.url));
+const MIGRATE_TASKS = join(HERE, '..', '..', 'scripts', 'openkan', 'migrate-tasks-to-v2.mts');
+const MIGRATE_BOARD = join(HERE, '..', '..', 'scripts', 'openkan', 'migrate-board-to-v2.mts');
+
 function print(result) {
   if (result.stdout) process.stdout.write(result.stdout);
   if (result.stderr) process.stderr.write(result.stderr);
@@ -18,6 +24,10 @@ Usage:
   ok plan <add|list|show|update>         Manage plans and phases
   ok prd <add|list|show|update>          Manage PRDs, goals, and milestones
   ok doctor                              Validate the .ok/ workspace
+  bizar openkan project clean [--apply|--all|--dry-run]  Clean project workspace
+  bizar openkan board delete <id>        Delete a board
+  bizar openkan migrate [--apply] [--tasks|--board]       Migrate v1 tasks/board to v2 layout
+                                                          (default: dry-run; --apply to apply)
   bizar openkan dashboard [args...]     Forward to the OpenKan dashboard CLI
                                         (legacy openkan.mjs on pre-v0.5.0
                                          releases; ok serve on v0.5.0+ where
@@ -30,6 +40,25 @@ feature/progress files for live planning.
 `);
 }
 
+/**
+ * Run one of the vendored OpenKan migration scripts. The scripts are
+ * `.mts` files that need `--experimental-strip-types` because they
+ * preserve the upstream TypeScript source verbatim from the v0.7.0
+ * tag. See `scripts/openkan/` for the vendored files.
+ */
+function runMigrateScript(scriptPath, args) {
+  const resolved = resolvePath(scriptPath);
+  const result = spawnSync(process.execPath, ['--experimental-strip-types', resolved, ...args], {
+    cwd: process.cwd(),
+    encoding: 'utf8',
+    shell: false,
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+  if (result.stdout) process.stdout.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+  return result.status ?? 1;
+}
+
 function runDashboard(args) {
   const launcher = resolveOpenKanDashboard();
   // OpenKan v0.5.0 dropped the legacy `openkan` dashboard launcher. The
@@ -74,6 +103,48 @@ export async function run(name, args, isHelpRequest) {
       print(runOpenKanOk([subcommand, ...rest]));
       return true;
     }
+    if (subcommand === 'project') {
+      // Forward project subcommands (e.g., project clean)
+      print(runOpenKanOk([subcommand, ...rest]));
+      return true;
+    }
+    if (subcommand === 'board') {
+      // Forward board subcommands (e.g., board delete)
+      print(runOpenKanOk([subcommand, ...rest]));
+      return true;
+    }
+    if (subcommand === 'migrate') {
+      // Migrate v1 tasks/board to the v2 layout that OpenKan 0.7.0 ships.
+      // Default is dry-run; --apply actually moves files. --tasks / --board
+      // narrow scope. The vendored scripts live under scripts/openkan/ and
+      // run via --experimental-strip-types because they're .mts.
+      const apply = rest.includes('--apply');
+      const tasksOnly = rest.includes('--tasks');
+      const boardOnly = rest.includes('--board');
+      if (!apply) {
+        process.stdout.write('Running in dry-run mode. Pass --apply to actually migrate.\n\n');
+      }
+      let exitCode = 0;
+      if (!boardOnly) {
+        process.stdout.write('=== Migrating tasks (.ok/tasks/<id>.json → <id>/task.json) ===\n');
+        const code = runMigrateScript(MIGRATE_TASKS, apply ? [] : ['--dry-run']);
+        if (code !== 0) exitCode = code;
+      }
+      if (!tasksOnly) {
+        process.stdout.write('\n=== Migrating board.json → per-task directories ===\n');
+        const code = runMigrateScript(MIGRATE_BOARD, apply ? [] : ['--dry-run']);
+        if (code !== 0) exitCode = code;
+      }
+      if (exitCode === 0) {
+        process.stdout.write(apply
+          ? '\n✓ Migration complete.\n'
+          : '\n✓ Dry-run complete. Re-run with --apply to execute.\n');
+      } else {
+        process.stderr.write('\n✗ Migration completed with errors. See output above.\n');
+      }
+      process.exitCode = exitCode;
+      return true;
+    }
     if (subcommand === 'dashboard') { runDashboard(rest); return true; }
     help();
     process.exitCode = 2;

package/cli/commands/task.mjs

@@ -6,7 +6,7 @@ function help() {
   ok task — OpenKan-backed task lifecycle
 
   Usage:
-    ok task add <title> [--owner agent] [--priority p0|p1|p2|p3]
+    ok task add <title> [--owner agent] [--priority low|normal|high|urgent]
     ok task list [--status pending|in_progress|review|done|cancelled] [--json]
     ok task show <id> [--json]
     ok task claim <id> --owner <agent> [--lease-ms <ms>]

package/cli/install/index.mjs

@@ -5,8 +5,11 @@
  * that delegates to the provisioner.
  */
 
+import chalk from 'chalk';
+
 import { runProvision, forceCleanInstall, clearSavedEnv } from '../provision.mjs';
 import { runDoctor } from '../doctor.mjs';
+import { runStatuslineInstall } from '../commands/statusline.mjs';
 import { showBanner, sectionHeading } from './banner.mjs';
 import { printInstallLocations } from './paths.mjs';
 import { runInteractiveSetup } from './interactive-setup.mjs';
@@ -32,9 +35,19 @@ import { runInteractiveSetup } from './interactive-setup.mjs';
  * @param {boolean} [opts.quiet]   - Only print the location card
  * @param {string}  [opts.mode]    - 'install' | 'update'
  * @param {boolean} [opts.yes]     - assume yes for any non-destructive prompts
+ * @param {Function} [opts.statuslineInstall] - injectable statusline installer for tests
+ * @param {Function} [opts.provision] - injectable provisioner for tests
  */
 export async function runInstaller(opts = {}) {
-  const { dryRun = false, force = false, quiet = false, mode = 'install', yes = false } = opts;
+  const {
+    dryRun = false,
+    force = false,
+    quiet = false,
+    mode = 'install',
+    yes = false,
+    statuslineInstall = runStatuslineInstall,
+    provision = runProvision,
+  } = opts;
 
   if (quiet) {
     printInstallLocations({ dryRun, force });
@@ -78,7 +91,7 @@ export async function runInstaller(opts = {}) {
   // Always pass `force: true` downstream so `runProvision` re-emits the
   // template-owned keys (permissions.allow wildcards, mcpServers, hooks)
   // into the freshly-empty settings file.
-  const provisionResult = await runProvision({
+  const provisionResult = await provision({
     mode,
     dryRun,
     force: true,
@@ -87,6 +100,22 @@ export async function runInstaller(opts = {}) {
     initializeOpenKanProject: interactive?.initializeOpenKanProject === true,
   });
 
+  // Auto-install statusline (v10.29.2+). Skipped on dry-run, non-fatal on failure.
+  // Idempotent: re-running is safe — updateStatuslineSettings re-writes the same field.
+  if (!dryRun) {
+    try {
+      const statuslineResult = await statuslineInstall([]);
+      if (statuslineResult?.ok) {
+        provisionResult.statuslineInstalled = true;
+      } else {
+        console.log(chalk.yellow(`  ! statusline auto-install failed: ${statuslineResult?.error || 'unknown'}`));
+      }
+    } catch (err) {
+      // Non-fatal: the user can still run `bizar statusline install` manually.
+      console.log(chalk.yellow(`  ! statusline auto-install skipped: ${err?.message || err}`));
+    }
+  }
+
   // F-183 — post-install health check. Surfaced as a warning rather
   // than a hard failure so a forced install that completes without
   // error still reports its doctor summary; the operator decides

package/cli/openkan-store.mjs

@@ -1,18 +1,33 @@
 /** Read-only `.ok/` adapter used by Bizar hooks and control snapshots. */
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { existsSync, lstatSync, readFileSync, readdirSync } from 'node:fs';
 import { isAbsolute, join, relative, resolve } from 'node:path';
 
 function readJson(path, fallback = null) {
   try { return JSON.parse(readFileSync(path, 'utf8')); } catch { return fallback; }
 }
 
+function isDirectory(path) {
+  try { return lstatSync(path).isDirectory(); } catch { return false; }
+}
+
+/** Emits a warning if legacy v1 task files are detected. */
+function warnOnLegacyTasks(dir) {
+  try {
+    const files = readdirSync(dir).filter((name) => name.endsWith('.json'));
+    if (files.length > 0) {
+      process.stderr.write(`[openkan-store] Warning: Found ${files.length} legacy v1 task file(s) in ${dir}. Consider running 'ok project migrate' to upgrade to v2 layout.\n`);
+    }
+  } catch { /* dir doesn't exist */ }
+}
+
 export function openKanDir(root = process.cwd()) { return join(resolve(root), '.ok'); }
 
 export function listOpenKanTasks(root = process.cwd()) {
   const dir = join(openKanDir(root), 'tasks');
   if (!existsSync(dir)) return [];
-  return readdirSync(dir).filter((name) => name.endsWith('.json')).sort()
-    .map((name) => readJson(join(dir, name))).filter((task) => task?.schema === 'ok.task.v1');
+  warnOnLegacyTasks(dir);
+  return readdirSync(dir).filter((name) => isDirectory(join(dir, name))).sort()
+    .map((name) => readJson(join(dir, name, 'task.json'))).filter((task) => task?.schema === 'ok.task.v2');
 }
 
 export function listOpenKanPlans(root = process.cwd()) {

package/config/skills/autopilot/SKILL.md

@@ -38,7 +38,7 @@ Use Autopilot for a clear, non-trivial outcome that should be delivered locally
    ```sh
    # default profile → bounded task-wave execution, ≤3 parallel agents
    ok plan add "$TASK_GOAL" --summary "Autopilot plan-build-qa run" --json
-   ok task add "research/spec" --plan "$PLAN_ID" --priority p1 --json
+   ok task add "research/spec" --plan "$PLAN_ID" --priority normal --json
    ```
 
    Examples: `/autopilot implement the task` selects `default`; `/autopilot --workflow plan-build-qa implement the task` selects the plan-led profile. Reject unknown workflow names instead of silently substituting another profile.
@@ -52,7 +52,7 @@ For every transition, re-read task/plan state and use the current values. Record
 ```sh
 ok task update "$TASK_ID" --status in_progress --json
 ok task complete "$TASK_ID" --evidence "$BOUNDED_EVIDENCE" --json
-ok task add "<next-stage>" --plan "$PLAN_ID" --priority p1 --json
+ok task add "<next-stage>" --plan "$PLAN_ID" --priority normal --json
 ```
 
 Run the stages in order. Each stage is a task under the plan; advancing the run means completing the current task with evidence and creating the next.

package/config/skills/bizplan/SKILL.md

@@ -82,7 +82,7 @@ ok plan list --json
 ok prd list --json
 # When no plan exists:
 ok plan add "$ARGUMENTS" --summary "bizplan plan-build" --json
-ok task add "research/spec" --plan "$PLAN_ID" --priority p1 --json
+ok task add "research/spec" --plan "$PLAN_ID" --priority normal --json
 ```
 
 Ground the specification in repository evidence. For external APIs, frameworks,

package/config/skills/ralph/SKILL.md

@@ -25,7 +25,7 @@ ok plan list --json
 ok plan show "$ACTIVE_PLAN_ID" --json
 # When no plan exists:
 ok plan add "$ARGUMENTS" --summary "Ralph persistent loop" --json
-ok task add "research/spec" --plan "$PLAN_ID" --priority p1 --json
+ok task add "research/spec" --plan "$PLAN_ID" --priority normal --json
 ```
 
 At each phase boundary, re-read state and advance using the current task identity plus compact proving evidence:
@@ -33,7 +33,7 @@ At each phase boundary, re-read state and advance using the current task identit
 ```sh
 ok task update "$TASK_ID" --status in_progress --json
 ok task complete "$TASK_ID" --evidence "$BOUNDED_EVIDENCE" --json
-ok task add "<next-stage>" --plan "$PLAN_ID" --priority p1 --json
+ok task add "<next-stage>" --plan "$PLAN_ID" --priority normal --json
 ```
 
 ## Loop

package/config/skills/ultragoal/SKILL.md

@@ -65,7 +65,7 @@ ok task list --json
 # When no PRD exists:
 ok prd add "$ARGUMENTS" --review-cadence weekly --json
 ok plan add "<objective>" --prd "$PRD_ID" --json
-ok task add "research/spec" --plan "$PLAN_ID" --priority p1 --json
+ok task add "research/spec" --plan "$PLAN_ID" --priority normal --json
 ```
 
 `--mode aggregate|per-story` is a leading selector on the ultragoal CLI
@@ -90,7 +90,7 @@ sum of completed subgoals reaches the configured `completionThreshold`
 (default: `1.0`).
 
 ```sh
-ok task add "<summary>" --plan "$PLAN_ID" --priority p1 \
+ok task add "<summary>" --plan "$PLAN_ID" --priority normal \
   --acceptance "weight=0.25" --description "<summary>" --json
 ```
 
@@ -108,7 +108,7 @@ its own `done` state; partial completion stays at `review` or
 `checkpointing`.
 
 ```sh
-ok task add "<story summary>" --plan "$PLAN_ID" --priority p1 \
+ok task add "<story summary>" --plan "$PLAN_ID" --priority normal \
   --acceptance "story=true,story-id=<sid>" --description "<story summary>" --json
 ```
 

package/config/skills/ultraqa/SKILL.md

@@ -27,7 +27,7 @@ Resume an existing plan when present. If no plan exists, create a `plan-build-qa
 ```sh
 ok plan show "$ACTIVE_PLAN_ID" --json
 ok plan add "$ARGUMENTS" --summary "UltraQA plan-build-qa run" --json
-ok task add "qa" --plan "$PLAN_ID" --priority p1 --json
+ok task add "qa" --plan "$PLAN_ID" --priority normal --json
 ```
 
 ## Bounded cycle
@@ -45,7 +45,7 @@ When QA is green, re-read state and advance:
 ```sh
 ok task update "$TASK_ID" --status review --json
 ok task complete "$TASK_ID" --evidence "$BOUNDED_EVIDENCE" --json
-ok task add "validate" --plan "$PLAN_ID" --priority p1 --json
+ok task add "validate" --plan "$PLAN_ID" --priority normal --json
 ```
 
 If the cycle limit is reached, run `ok task cancel "$TASK_ID" --reason "$REASON" --json` and mark the owning plan `abandoned`. Never hide skipped checks or flaky results. After QA, functional, security/policy, and code-quality validation remain required. UltraQA never auto-commits, pushes, publishes, releases, deploys, changes credentials/access, or uses daemon/tmux or a general memory/wiki service.

package/config/skills/ultrawork/SKILL.md

@@ -23,7 +23,7 @@ ok plan list --json
 ok plan show "$ACTIVE_PLAN_ID" --json
 # When no plan exists:
 ok plan add "$ARGUMENTS" --summary "Ultrawork bounded parallel waves" --json
-ok task add "research/spec" --plan "$PLAN_ID" --priority p1 --json
+ok task add "research/spec" --plan "$PLAN_ID" --priority normal --json
 ```
 
 Advance only after re-reading status and collecting bounded evidence:
@@ -31,7 +31,7 @@ Advance only after re-reading status and collecting bounded evidence:
 ```sh
 ok task update "$TASK_ID" --status in_progress --json
 ok task complete "$TASK_ID" --evidence "$BOUNDED_EVIDENCE" --json
-ok task add "<next-stage>" --plan "$PLAN_ID" --priority p1 --json
+ok task add "<next-stage>" --plan "$PLAN_ID" --priority normal --json
 ```
 
 ## Wave protocol

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "10.29.0",
+  "version": "10.29.2",
   "description": "Autonomous, human-in-the-loop multi-agent harness for Claude Code with guarded workflows, typed SDK primitives, and MCP tools.",
   "type": "module",
   "bin": {

package/packages/sdk/dist/handoff/bizplan.js

@@ -250,7 +250,22 @@ export function spawnExecutorTask(plan, opts = {}) {
     });
     const tasksDir = join(okDir, "tasks");
     mkdirSync(tasksDir, { recursive: true });
-    atomicWrite(join(tasksDir, `${id}.json`), JSON.stringify(task, null, 2) + "\n");
+    // OpenKan 0.7.0 stores tasks under .ok/tasks/<id>/task.json with schema
+    // ok.task.v2. Write a minimal v2 record so the new layout is correct
+    // out of the box; downstream surfaces hydrate the full v2 superset
+    // when the executor claims the task.
+    const taskDir = join(tasksDir, id);
+    mkdirSync(taskDir, { recursive: true });
+    const v2Task = {
+        schema: "ok.task.v2",
+        id,
+        planId: plan.id,
+        status: "claimed",
+        assignedAt,
+        ...(opts.assignee ? { assignee: opts.assignee } : {}),
+        links: { planId: plan.id },
+    };
+    atomicWrite(join(taskDir, "task.json"), JSON.stringify(v2Task, null, 2) + "\n");
     return task;
 }
 //# sourceMappingURL=bizplan.js.map

package/packages/sdk/dist/version.d.ts

@@ -1,5 +1,5 @@
 /**
  * SDK version constant. Keep synchronized with the workspace package versions.
  */
-export declare const SDK_VERSION: "10.29.0";
+export declare const SDK_VERSION: "10.29.2";
 //# sourceMappingURL=version.d.ts.map

package/packages/sdk/dist/version.js

@@ -1,5 +1,5 @@
 /**
  * SDK version constant. Keep synchronized with the workspace package versions.
  */
-export const SDK_VERSION = "10.29.0";
+export const SDK_VERSION = "10.29.2";
 //# sourceMappingURL=version.js.map

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar-sdk",
-  "version": "10.29.0",
+  "version": "10.29.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",