trekoon 0.2.7 → 0.2.9

package/src/commands/init.ts

@@ -1,5 +1,7 @@
 import { unexpectedFailureResult } from "./error-utils";
 
+import { ensureBoardInstalled } from "../board/install";
+import { BoardInstallError } from "../board/types";
 import { DomainError } from "../domain/types";
 import { failResult, okResult } from "../io/output";
 import { type CliContext, type CliResult } from "../runtime/command-types";
@@ -80,6 +82,11 @@ export async function runInit(context: CliContext): Promise<CliResult> {
   try {
     database = openTrekoonDatabase(context.cwd);
     const diagnostics = database.diagnostics;
+    const bundledAssetRoot: string | undefined = process.env.TREKOON_BOARD_ASSET_ROOT;
+    const board = ensureBoardInstalled({
+      workingDirectory: context.cwd,
+      ...(bundledAssetRoot === undefined ? {} : { bundledAssetRoot }),
+    });
     const humanLines: string[] = [
       "Trekoon initialized.",
       `Storage mode: ${diagnostics.storageMode}`,
@@ -87,6 +94,8 @@ export async function runInit(context: CliContext): Promise<CliResult> {
       `Shared storage root: ${diagnostics.sharedStorageRoot}`,
       `Storage directory: ${database.paths.storageDir}`,
       `Database file: ${database.paths.databaseFile}`,
+      `Board assets: ${board.action}`,
+      `Board runtime root: ${board.paths.runtimeRoot}`,
       ...buildRecoverySummary(database),
     ];
 
@@ -101,6 +110,11 @@ export async function runInit(context: CliContext): Promise<CliResult> {
         sharedStorageRoot: diagnostics.sharedStorageRoot,
         storageDir: database.paths.storageDir,
         databaseFile: database.paths.databaseFile,
+        board: {
+          action: board.action,
+          paths: board.paths,
+          manifest: board.manifest,
+        },
         legacyStateDetected: diagnostics.legacyStateDetected,
         recoveryRequired: diagnostics.recoveryRequired,
         recoveryStatus: diagnostics.recoveryStatus,
@@ -120,6 +134,21 @@ export async function runInit(context: CliContext): Promise<CliResult> {
       }
     }
 
+    if (error instanceof BoardInstallError) {
+      return failResult({
+        command: "init",
+        human: error.message,
+        data: {
+          code: error.code,
+          ...error.details,
+        },
+        error: {
+          code: error.code,
+          message: error.message,
+        },
+      });
+    }
+
     return unexpectedFailureResult(error, {
       command: "init",
       human: "Unexpected init command failure",

package/src/domain/mutation-service.ts

@@ -18,6 +18,7 @@ import {
   type SearchField,
   type SearchNode,
   type SearchSummary,
+  type StatusCascadeBlocker,
   type StatusCascadePlan,
   type SubtaskRecord,
   type TaskRecord,
@@ -401,6 +402,45 @@ export class MutationService {
     })();
   }
 
+  describeError(error: unknown): string | undefined {
+    if (!(error instanceof DomainError) || error.code !== "dependency_blocked") {
+      return undefined;
+    }
+
+    const details = error.details as Record<string, unknown> | undefined;
+    const unresolvedDependencies = Array.isArray(details?.unresolvedDependencies)
+      ? details.unresolvedDependencies
+      : [];
+    if (unresolvedDependencies.length > 0) {
+      const blockers = unresolvedDependencies
+        .map((dependency) => {
+          if (!dependency || typeof dependency !== "object") {
+            return null;
+          }
+
+          const id = typeof dependency.id === "string" ? dependency.id : "unknown";
+          const kind = typeof dependency.kind === "string" ? dependency.kind : "dependency";
+          const status = typeof dependency.status === "string" ? dependency.status : "unknown";
+          return `${kind} ${id} is still ${status}`;
+        })
+        .filter((value): value is string => value !== null);
+
+      if (blockers.length > 0) {
+        return `Resolve dependencies first: ${blockers.join("; ")}.`;
+      }
+    }
+
+    const cascadeBlockers = Array.isArray(details?.blockers) ? details.blockers as StatusCascadeBlocker[] : [];
+    if (cascadeBlockers.length > 0) {
+      const blockers = cascadeBlockers.map((blocker) =>
+        `${blocker.sourceKind} ${blocker.sourceId} is blocked by ${blocker.dependsOnKind} ${blocker.dependsOnId} (${blocker.dependsOnStatus})`
+      );
+      return `Resolve dependencies first: ${blockers.join("; ")}.`;
+    }
+
+    return undefined;
+  }
+
   previewEpicReplacement(
     epicId: string,
     searchText: string,

package/src/domain/tracker-domain.ts

@@ -138,6 +138,14 @@ function normalizeStatus(value: string | undefined): string {
   return assertNonEmpty("status", value);
 }
 
+function normalizeSubtaskDescription(value: string | undefined): string {
+  if (value === undefined) {
+    return "";
+  }
+
+  return value.trim();
+}
+
 function mapEpic(row: EpicRow): EpicRecord {
   return {
     id: row.id,
@@ -431,7 +439,7 @@ export class TrackerDomain {
     const id: string = randomUUID();
     const taskId: string = assertNonEmpty("taskId", input.taskId);
     const title: string = assertNonEmpty("title", input.title);
-    const description: string = input.description === undefined ? "" : assertNonEmpty("description", input.description);
+    const description: string = normalizeSubtaskDescription(input.description);
     const status: string = normalizeStatus(input.status);
 
     this.getTaskOrThrow(taskId);
@@ -457,7 +465,7 @@ export class TrackerDomain {
         tempKey: assertNonEmpty("tempKey", spec.tempKey),
         taskId,
         title: assertNonEmpty("title", spec.title),
-        description: spec.description === undefined ? "" : assertNonEmpty("description", spec.description),
+        description: normalizeSubtaskDescription(spec.description),
         status: normalizeStatus(spec.status),
       };
     });
@@ -574,7 +582,7 @@ export class TrackerDomain {
     const existing: SubtaskRecord = this.getSubtaskOrThrow(id);
     const nextTitle: string = input.title !== undefined ? assertNonEmpty("title", input.title) : existing.title;
     const nextDescription: string =
-      input.description !== undefined ? assertNonEmpty("description", input.description) : existing.description;
+      input.description !== undefined ? normalizeSubtaskDescription(input.description) : existing.description;
     const nextStatus: string = input.status !== undefined ? assertNonEmpty("status", input.status) : existing.status;
     this.assertNoUnresolvedDependenciesForStatusTransition(id, "subtask", existing.status, nextStatus);
     const now: number = Date.now();

package/src/runtime/cli-shell.ts

@@ -1,3 +1,4 @@
+import { runBoard } from "../commands/board";
 import { runHelp } from "../commands/help";
 import { runDep } from "../commands/dep";
 import { runEpic } from "../commands/epic";
@@ -19,6 +20,7 @@ import { resolveStoragePaths } from "../storage/path";
 
 const SUPPORTED_ROOT_COMMANDS: readonly string[] = [
   "help",
+  "board",
   "init",
   "quickstart",
   "session",
@@ -334,6 +336,9 @@ export async function executeShell(parsed: ParsedInvocation, cwd: string = proce
     case "help":
       result = await runHelp(context);
       break;
+    case "board":
+      result = await runBoard(context);
+      break;
     case "init":
       result = await runInit(context);
       break;

package/src/storage/path.ts

@@ -4,6 +4,9 @@ import { resolve } from "node:path";
 
 export const TREKOON_STORAGE_DIRNAME = ".trekoon";
 export const TREKOON_DATABASE_FILENAME = "trekoon.db";
+export const TREKOON_BOARD_DIRNAME = "board";
+export const TREKOON_BOARD_ENTRY_FILENAME = "index.html";
+export const TREKOON_BOARD_MANIFEST_FILENAME = "manifest.json";
 
 export function resolveLegacyWorktreeStorageDir(worktreeRoot: string): string {
   return resolve(worktreeRoot, TREKOON_STORAGE_DIRNAME);
@@ -15,6 +18,18 @@ export function resolveLegacyWorktreeDatabaseFile(worktreeRoot: string): string
 
 export type StorageMode = "cwd" | "git_common_dir";
 
+export function resolveBoardStorageDir(storageDir: string): string {
+  return resolve(storageDir, TREKOON_BOARD_DIRNAME);
+}
+
+export function resolveBoardEntryFile(storageDir: string): string {
+  return resolve(resolveBoardStorageDir(storageDir), TREKOON_BOARD_ENTRY_FILENAME);
+}
+
+export function resolveBoardManifestFile(storageDir: string): string {
+  return resolve(resolveBoardStorageDir(storageDir), TREKOON_BOARD_MANIFEST_FILENAME);
+}
+
 export interface StoragePaths {
   readonly invocationCwd: string;
   readonly storageMode: StorageMode;
@@ -23,6 +38,9 @@ export interface StoragePaths {
   readonly sharedStorageRoot: string;
   readonly storageDir: string;
   readonly databaseFile: string;
+  readonly boardDir: string;
+  readonly boardEntryFile: string;
+  readonly boardManifestFile: string;
   readonly diagnostics: StoragePathDiagnostics;
 }
 
@@ -35,6 +53,9 @@ export interface StoragePathIssue {
   readonly worktreeRoot: string;
   readonly sharedStorageRoot: string;
   readonly databaseFile: string;
+  readonly boardDir: string;
+  readonly boardEntryFile: string;
+  readonly boardManifestFile: string;
 }
 
 export interface StoragePathDiagnostics {
@@ -44,6 +65,9 @@ export interface StoragePathDiagnostics {
   readonly worktreeRoot: string;
   readonly sharedStorageRoot: string;
   readonly databaseFile: string;
+  readonly boardDir: string;
+  readonly boardEntryFile: string;
+  readonly boardManifestFile: string;
   readonly warnings: readonly StoragePathIssue[];
   readonly errors: readonly StoragePathIssue[];
 }
@@ -76,6 +100,9 @@ export function resolveStoragePaths(workingDirectory: string = process.cwd()): S
   const sharedStorageRoot: string = repoCommonDir ? realpathSync(resolve(repoCommonDir, "..")) : invocationCwd;
   const storageDir: string = resolve(sharedStorageRoot, TREKOON_STORAGE_DIRNAME);
   const databaseFile: string = resolve(storageDir, TREKOON_DATABASE_FILENAME);
+  const boardDir: string = resolveBoardStorageDir(storageDir);
+  const boardEntryFile: string = resolveBoardEntryFile(storageDir);
+  const boardManifestFile: string = resolveBoardManifestFile(storageDir);
   const warnings: StoragePathIssue[] = [];
 
   const createIssue = (code: string, message: string): StoragePathIssue => ({
@@ -87,6 +114,9 @@ export function resolveStoragePaths(workingDirectory: string = process.cwd()): S
     worktreeRoot,
     sharedStorageRoot,
     databaseFile,
+    boardDir,
+    boardEntryFile,
+    boardManifestFile,
   });
 
   if (invocationCwd !== worktreeRoot) {
@@ -111,6 +141,9 @@ export function resolveStoragePaths(workingDirectory: string = process.cwd()): S
     worktreeRoot,
     sharedStorageRoot,
     databaseFile,
+    boardDir,
+    boardEntryFile,
+    boardManifestFile,
     warnings,
     errors: [],
   };
@@ -123,6 +156,9 @@ export function resolveStoragePaths(workingDirectory: string = process.cwd()): S
     sharedStorageRoot,
     storageDir,
     databaseFile,
+    boardDir,
+    boardEntryFile,
+    boardManifestFile,
     diagnostics,
   };
 }