@brainfile/cli 0.15.0 → 0.15.1

package/dist/schemas/board.json

@@ -2,10 +2,9 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://brainfile.md/v1/board.json",
   "title": "Brainfile Board Schema",
-  "description": "Schema for Kanban-style task boards with columns and tasks",
+  "description": "Schema for Kanban-style task boards. In v2 (per-task file architecture), the board file is config-only: it defines columns, rules, and project metadata. Tasks are standalone .md files in .brainfile/tasks/ (active) and .brainfile/logs/ (completed), each validated against task.json. In v1 (legacy), tasks are embedded in column arrays within this file.",
   "x-brainfile-renderer": "kanban",
   "x-brainfile-columns-path": "$.columns",
-  "x-brainfile-items-path": "$.columns[*].tasks",
   "x-brainfile-title-field": "title",
   "x-brainfile-status-field": "priority",
   "allOf": [
@@ -14,19 +13,47 @@
     },
     {
       "type": "object",
-      "required": ["columns"],
+      "required": [
+        "columns"
+      ],
       "properties": {
         "type": {
           "const": "board"
         },
         "columns": {
           "type": "array",
-          "description": "Task columns (e.g., To Do, In Progress, Done)",
+          "description": "Board columns defining workflow stages. In v2, columns are config-only (no embedded tasks). In v1 (legacy), columns may contain a tasks array.",
           "minItems": 1,
           "items": {
             "$ref": "#/definitions/column"
           }
         },
+        "types": {
+          "type": "object",
+          "description": "Optional map of document type definitions. Keys are type identifiers (e.g., 'epic', 'adr') that match the type field in task.json. In strict mode, this map is the allowlist for non-task types; the built-in task type is always implicitly valid. When omitted, all items are standard tasks.",
+          "additionalProperties": {
+            "$ref": "#/definitions/typeEntry"
+          },
+          "examples": [
+            {
+              "epic": {
+                "idPrefix": "epic",
+                "completable": false,
+                "schema": "https://brainfile.md/v1/examples/epic.json"
+              },
+              "adr": {
+                "idPrefix": "adr",
+                "completable": false,
+                "schema": "https://brainfile.md/v1/examples/adr.json"
+              }
+            }
+          ]
+        },
+        "strict": {
+          "type": "boolean",
+          "description": "Enables strict validation for CLI operations. When true, add rejects unknown task types and move rejects unknown columns. When false (default), unknown types and columns are allowed for backward compatibility. The task type is always implicitly valid even if not listed in types.",
+          "default": false
+        },
         "statsConfig": {
           "type": "object",
           "description": "Configuration for statistics calculation",
@@ -43,7 +70,8 @@
         },
         "archive": {
           "type": "array",
-          "description": "Archived tasks removed from active columns",
+          "description": "Deprecated in v2. In v1, holds archived tasks removed from active columns. In v2, completed tasks live as individual files in .brainfile/logs/.",
+          "x-brainfile-deprecated": true,
           "items": {
             "$ref": "#/definitions/task"
           }
@@ -53,13 +81,46 @@
     }
   ],
   "definitions": {
+    "typeEntry": {
+      "type": "object",
+      "description": "Configuration for a custom document type. Defines how items of this type behave within the board.",
+      "required": [
+        "idPrefix"
+      ],
+      "properties": {
+        "idPrefix": {
+          "type": "string",
+          "description": "Prefix for auto-generated IDs of this type (e.g., 'epic' produces 'epic-1', 'epic-2'). Must be unique across all type entries.",
+          "pattern": "^[a-z]+(-[a-z]+)*$",
+          "minLength": 1
+        },
+        "completable": {
+          "type": "boolean",
+          "description": "Whether items of this type can be completed (moved to completion columns and logs/). Defaults to true. Set to false for reference documents like ADRs or epics that are not completable tasks.",
+          "default": true
+        },
+        "schema": {
+          "type": "string",
+          "description": "Optional JSON Schema URL for validating the extended fields of this type. Can be a remote URI (https://) or a local file path relative to the project root.",
+          "format": "uri-reference",
+          "examples": [
+            "https://brainfile.md/v1/examples/epic.json",
+            ".brainfile/schemas/adr.json"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
     "column": {
       "type": "object",
-      "required": ["id", "title", "tasks"],
+      "required": [
+        "id",
+        "title"
+      ],
       "properties": {
         "id": {
           "type": "string",
-          "description": "Unique column identifier in kebab-case (e.g., 'todo', 'in-progress')",
+          "description": "Unique column identifier in kebab-case (e.g., 'todo', 'in-progress'). Referenced by task.column in per-task files.",
           "pattern": "^[a-z]+(-[a-z]+)*$",
           "minLength": 1
         },
@@ -80,7 +141,8 @@
         },
         "tasks": {
           "type": "array",
-          "description": "Tasks in this column",
+          "description": "Deprecated in v2. In v1, holds tasks embedded in this column. In v2, task membership is declared via the column field in each task's frontmatter (see task.json).",
+          "x-brainfile-deprecated": true,
           "items": {
             "$ref": "#/definitions/task"
           }
@@ -90,12 +152,18 @@
     },
     "task": {
       "type": "object",
-      "required": ["id", "title"],
+      "description": "Deprecated in v2. Inline task definition for v1 backward compatibility. In v2, use the standalone task.json schema instead.",
+      "x-brainfile-deprecated": true,
+      "x-brainfile-see": "https://brainfile.md/v1/task.json",
+      "required": [
+        "id",
+        "title"
+      ],
       "properties": {
         "id": {
           "type": "string",
-          "description": "Unique task identifier following pattern 'task-N'",
-          "pattern": "^task-[0-9]+$"
+          "description": "Unique identifier following pattern '{type}-N'",
+          "pattern": "^[a-z][a-z0-9]*-[0-9]+$"
         },
         "title": {
           "type": "string",
@@ -120,19 +188,30 @@
         "priority": {
           "type": "string",
           "description": "Optional task priority",
-          "enum": ["low", "medium", "high", "critical"]
+          "enum": [
+            "low",
+            "medium",
+            "high",
+            "critical"
+          ]
         },
         "effort": {
           "type": "string",
           "description": "Optional effort estimation for AI planning",
-          "enum": ["trivial", "small", "medium", "large", "xlarge"]
+          "enum": [
+            "trivial",
+            "small",
+            "medium",
+            "large",
+            "xlarge"
+          ]
         },
         "blockedBy": {
           "type": "array",
-          "description": "Optional list of task IDs that block this task",
+          "description": "Optional list of item IDs that block this task",
           "items": {
             "type": "string",
-            "pattern": "^task-[0-9]+$"
+            "pattern": "^[a-z][a-z0-9]*-[0-9]+$"
           }
         },
         "dueDate": {
@@ -165,7 +244,11 @@
         "template": {
           "type": "string",
           "description": "Optional task template type",
-          "enum": ["bug", "feature", "refactor"]
+          "enum": [
+            "bug",
+            "feature",
+            "refactor"
+          ]
         },
         "contract": {
           "$ref": "https://brainfile.md/v1/contract.json"
@@ -175,7 +258,11 @@
     },
     "subtask": {
       "type": "object",
-      "required": ["id", "title", "completed"],
+      "required": [
+        "id",
+        "title",
+        "completed"
+      ],
       "properties": {
         "id": {
           "type": "string",
@@ -195,4 +282,4 @@
       "additionalProperties": true
     }
   }
-}
+}

package/dist/utils/v2-detect.d.ts

@@ -9,16 +9,16 @@
  */
 export { type V2Dirs, getV2Dirs, isV2, ensureV2Dirs, getTaskFilePath, getLogFilePath, findV2Task, extractDescription, extractLog, composeBody, readV2BoardConfig, buildBoardFromV2, } from '@brainfile/core';
 /**
- * Check whether we should show the one-time v2 migration suggestion.
+ * Check whether we should show the one-time migration suggestion.
  *
  * Returns true when ALL of these hold:
- *   a. The brainfile is v1 format (no board/ directory next to it)
- *   b. The brainfile has at least one task in any column
- *   c. This process has not already shown the hint for this brainfile path
+ *   a. The workspace appears to be in a legacy or mixed layout, OR this file
+ *      itself looks like a legacy board file.
+ *   b. This process has not already shown the hint for this brainfile path.
  */
 export declare function shouldSuggestV2Migration(brainfilePath: string): boolean;
 /**
- * Record that the v2 migration hint has been shown so it won't appear again.
+ * Record that the migration hint has been shown so it won't appear again.
  *
  * This is intentionally in-memory only; Brainfile no longer persists state.json.
  */

package/dist/utils/v2-detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2-detect.d.ts","sourceRoot":"","sources":["../../src/utils/v2-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EACL,KAAK,MAAM,EACX,SAAS,EACT,IAAI,EACJ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAQzB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAsBvE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,4BAA4B;AAC5B,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}
+{"version":3,"file":"v2-detect.d.ts","sourceRoot":"","sources":["../../src/utils/v2-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EACL,KAAK,MAAM,EACX,SAAS,EACT,IAAI,EACJ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAYzB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAuBvE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,4BAA4B;AAC5B,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/utils/v2-detect.js

@@ -64,38 +64,41 @@ Object.defineProperty(exports, "readV2BoardConfig", { enumerable: true, get: fun
 Object.defineProperty(exports, "buildBoardFromV2", { enumerable: true, get: function () { return core_2.buildBoardFromV2; } });
 // ── CLI-specific migration hint helpers ──────────────────────────────
 const core_3 = require("@brainfile/core");
+const workspace_format_1 = require("./workspace-format");
 const v2MigrationHintShown = new Set();
 /**
- * Check whether we should show the one-time v2 migration suggestion.
+ * Check whether we should show the one-time migration suggestion.
  *
  * Returns true when ALL of these hold:
- *   a. The brainfile is v1 format (no board/ directory next to it)
- *   b. The brainfile has at least one task in any column
- *   c. This process has not already shown the hint for this brainfile path
+ *   a. The workspace appears to be in a legacy or mixed layout, OR this file
+ *      itself looks like a legacy board file.
+ *   b. This process has not already shown the hint for this brainfile path.
  */
 function shouldSuggestV2Migration(brainfilePath) {
     const resolved = path.resolve(brainfilePath);
-    // (a) Must be v1 format
-    if ((0, core_3.isV2)(resolved))
-        return false;
-    // (c) One-time guard for this process
     if (v2MigrationHintShown.has(resolved))
         return false;
-    // (b) Parse brainfile and check for at least one task
-    try {
-        const content = fs.readFileSync(resolved, 'utf-8');
-        const result = core_1.Brainfile.parseWithErrors(content);
-        if (!result.board)
-            return false;
-        const hasTasks = result.board.columns.some((col) => col.tasks && col.tasks.length > 0);
-        return hasTasks;
+    const probe = (0, workspace_format_1.probeWorkspaceForBrainfile)(resolved);
+    if ((0, workspace_format_1.shouldSuggestMigration)(probe)) {
+        return true;
     }
-    catch {
-        return false;
+    // Fallback: explicit non-standard board files (e.g. fixtures/test-board.md)
+    // should still receive a migration suggestion when they parse as v1 board files.
+    if (!(0, core_3.isV2)(resolved) && fs.existsSync(resolved)) {
+        try {
+            const content = fs.readFileSync(resolved, 'utf-8');
+            const parsed = core_1.Brainfile.parseWithErrors(content);
+            if (parsed.board)
+                return true;
+        }
+        catch {
+            // Ignore parse/read errors and suppress hint.
+        }
     }
+    return false;
 }
 /**
- * Record that the v2 migration hint has been shown so it won't appear again.
+ * Record that the migration hint has been shown so it won't appear again.
  *
  * This is intentionally in-memory only; Brainfile no longer persists state.json.
  */

package/dist/utils/v2-detect.js.map

@@ -1 +1 @@
-{"version":3,"file":"v2-detect.js","sourceRoot":"","sources":["../../src/utils/v2-detect.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCH,4DAsBC;AAOD,4DAEC;AAGD,kEAEC;AAvED,uCAAyB;AACzB,2CAA6B;AAC7B,0CAA4C;AAE5C,wEAAwE;AAExE,wCAayB;AAXvB,iGAAA,SAAS,OAAA;AACT,4FAAA,IAAI,OAAA;AACJ,oGAAA,YAAY,OAAA;AACZ,uGAAA,eAAe,OAAA;AACf,sGAAA,cAAc,OAAA;AACd,kGAAA,UAAU,OAAA;AACV,0GAAA,kBAAkB,OAAA;AAClB,kGAAA,UAAU,OAAA;AACV,mGAAA,WAAW,OAAA;AACX,yGAAA,iBAAiB,OAAA;AACjB,wGAAA,gBAAgB,OAAA;AAGlB,wEAAwE;AAExE,0CAAuC;AAEvC,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/C;;;;;;;GAOG;AACH,SAAgB,wBAAwB,CAAC,aAAqB;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE7C,wBAAwB;IACxB,IAAI,IAAA,WAAI,EAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAEjC,sCAAsC;IACtC,IAAI,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAErD,sDAAsD;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,gBAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAEhC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CACxC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAC3C,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,aAAqB;IAC5D,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,4BAA4B;AAC5B,SAAgB,2BAA2B;IACzC,oBAAoB,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"v2-detect.js","sourceRoot":"","sources":["../../src/utils/v2-detect.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCH,4DAuBC;AAOD,4DAEC;AAGD,kEAEC;AA5ED,uCAAyB;AACzB,2CAA6B;AAC7B,0CAA4C;AAE5C,wEAAwE;AAExE,wCAayB;AAXvB,iGAAA,SAAS,OAAA;AACT,4FAAA,IAAI,OAAA;AACJ,oGAAA,YAAY,OAAA;AACZ,uGAAA,eAAe,OAAA;AACf,sGAAA,cAAc,OAAA;AACd,kGAAA,UAAU,OAAA;AACV,0GAAA,kBAAkB,OAAA;AAClB,kGAAA,UAAU,OAAA;AACV,mGAAA,WAAW,OAAA;AACX,yGAAA,iBAAiB,OAAA;AACjB,wGAAA,gBAAgB,OAAA;AAGlB,wEAAwE;AAExE,0CAAuC;AACvC,yDAG4B;AAE5B,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/C;;;;;;;GAOG;AACH,SAAgB,wBAAwB,CAAC,aAAqB;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE7C,IAAI,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAErD,MAAM,KAAK,GAAG,IAAA,6CAA0B,EAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,IAAA,yCAAsB,EAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,iFAAiF;IACjF,IAAI,CAAC,IAAA,WAAI,EAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,gBAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,aAAqB;IAC5D,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,4BAA4B;AAC5B,SAAgB,2BAA2B;IACzC,oBAAoB,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC"}

package/dist/utils/workspace-format.d.ts

@@ -0,0 +1,25 @@
+export type WorkspaceFormat = 'v2' | 'legacy-root' | 'legacy-dotbrainfile' | 'mixed' | 'empty';
+export interface WorkspacePaths {
+    rootDir: string;
+    rootBrainfilePath: string;
+    dotDir: string;
+    dotBrainfilePath: string;
+    boardDir: string;
+    logsDir: string;
+}
+export interface WorkspacePresence {
+    rootBrainfile: boolean;
+    dotBrainfile: boolean;
+    boardDir: boolean;
+    logsDir: boolean;
+}
+export interface WorkspaceProbe {
+    format: WorkspaceFormat;
+    paths: WorkspacePaths;
+    presence: WorkspacePresence;
+}
+export declare function workspaceRootFromBrainfilePath(brainfilePath: string): string;
+export declare function probeWorkspaceFormat(rootDir?: string): WorkspaceProbe;
+export declare function probeWorkspaceForBrainfile(brainfilePath: string): WorkspaceProbe;
+export declare function shouldSuggestMigration(probe: WorkspaceProbe): boolean;
+//# sourceMappingURL=workspace-format.d.ts.map

package/dist/utils/workspace-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-format.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-format.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GACvB,IAAI,GACJ,aAAa,GACb,qBAAqB,GACrB,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAkBD,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,MAAsB,GAAG,cAAc,CAqCpF;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAEhF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAErE"}

package/dist/utils/workspace-format.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workspaceRootFromBrainfilePath = workspaceRootFromBrainfilePath;
+exports.probeWorkspaceFormat = probeWorkspaceFormat;
+exports.probeWorkspaceForBrainfile = probeWorkspaceForBrainfile;
+exports.shouldSuggestMigration = shouldSuggestMigration;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function existsFile(filePath) {
+    try {
+        return fs.statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function existsDir(dirPath) {
+    try {
+        return fs.statSync(dirPath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function workspaceRootFromBrainfilePath(brainfilePath) {
+    const absolute = path.resolve(brainfilePath);
+    const dir = path.dirname(absolute);
+    return path.basename(dir) === '.brainfile' ? path.dirname(dir) : dir;
+}
+function probeWorkspaceFormat(rootDir = process.cwd()) {
+    const resolvedRoot = path.resolve(rootDir);
+    const dotDir = path.join(resolvedRoot, '.brainfile');
+    const paths = {
+        rootDir: resolvedRoot,
+        rootBrainfilePath: path.join(resolvedRoot, 'brainfile.md'),
+        dotDir,
+        dotBrainfilePath: path.join(dotDir, 'brainfile.md'),
+        boardDir: path.join(dotDir, 'board'),
+        logsDir: path.join(dotDir, 'logs'),
+    };
+    const presence = {
+        rootBrainfile: existsFile(paths.rootBrainfilePath),
+        dotBrainfile: existsFile(paths.dotBrainfilePath),
+        boardDir: existsDir(paths.boardDir),
+        logsDir: existsDir(paths.logsDir),
+    };
+    const hasAnyV2Artifacts = presence.boardDir || presence.logsDir;
+    const hasFullV2 = presence.dotBrainfile && presence.boardDir && presence.logsDir;
+    let format;
+    if (!presence.rootBrainfile && !presence.dotBrainfile && !hasAnyV2Artifacts) {
+        format = 'empty';
+    }
+    else if (hasFullV2 && !presence.rootBrainfile) {
+        format = 'v2';
+    }
+    else if (presence.rootBrainfile && !presence.dotBrainfile && !hasAnyV2Artifacts) {
+        format = 'legacy-root';
+    }
+    else if (!presence.rootBrainfile && presence.dotBrainfile && !hasAnyV2Artifacts) {
+        format = 'legacy-dotbrainfile';
+    }
+    else {
+        format = 'mixed';
+    }
+    return { format, paths, presence };
+}
+function probeWorkspaceForBrainfile(brainfilePath) {
+    return probeWorkspaceFormat(workspaceRootFromBrainfilePath(brainfilePath));
+}
+function shouldSuggestMigration(probe) {
+    return probe.format === 'legacy-root' || probe.format === 'legacy-dotbrainfile' || probe.format === 'mixed';
+}
+//# sourceMappingURL=workspace-format.js.map

package/dist/utils/workspace-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-format.js","sourceRoot":"","sources":["../../src/utils/workspace-format.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainfile/cli",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "Command-line interface for Brainfile task management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",