brainfile 0.18.0

package/dist/utils/linear-auth.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * Linear Authentication for Brainfile CLI
+ *
+ * Supports:
+ * 1. OAuth Device Flow (browser-based)
+ * 2. API Key (manual entry)
+ *
+ * @packageDocumentation
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLinearAuthenticated = isLinearAuthenticated;
+exports.getLinearToken = getLinearToken;
+exports.authenticateLinear = authenticateLinear;
+exports.getLinearTeams = getLinearTeams;
+exports.createLinearIssue = createLinearIssue;
+exports.logoutLinear = logoutLinear;
+const chalk_1 = __importDefault(require("chalk"));
+const auth_store_1 = require("./auth-store");
+// ============================================================================
+// Constants
+// ============================================================================
+const LINEAR_API_URL = 'https://api.linear.app/graphql';
+// ============================================================================
+// Linear Auth Functions
+// ============================================================================
+/**
+ * Check if Linear is already authenticated
+ */
+async function isLinearAuthenticated() {
+    return await auth_store_1.authStore.isAuthenticated('linear');
+}
+/**
+ * Get the current Linear token
+ */
+async function getLinearToken() {
+    return await auth_store_1.authStore.get('linear');
+}
+/**
+ * Authenticate with Linear using API key
+ */
+async function authenticateLinear(options) {
+    const { token, silent } = options;
+    if (!token) {
+        if (!silent) {
+            console.log('');
+            console.log('To authenticate with Linear, you need an API key.');
+            console.log('');
+            console.log(`Get your API key from: ${chalk_1.default.underline('https://linear.app/settings/api')}`);
+            console.log('');
+        }
+        return { success: false, error: 'Linear API key required. Use --token flag.' };
+    }
+    // Verify the token
+    const viewer = await getLinearViewer(token);
+    if (!viewer) {
+        return { success: false, error: 'Invalid API key or API key lacks required permissions' };
+    }
+    // Get organization info
+    const org = await getLinearOrganization(token);
+    const workspace = org?.name || 'Unknown';
+    await auth_store_1.authStore.set('linear', token, {
+        username: viewer.name,
+        workspace,
+    });
+    if (!silent) {
+        console.log(chalk_1.default.green('✓') + ' API key verified');
+        console.log(chalk_1.default.green('✓') + ` Authenticated as ${chalk_1.default.cyan(viewer.name)} in ${chalk_1.default.cyan(workspace)}`);
+    }
+    return { success: true, workspace };
+}
+/**
+ * Get Linear user info
+ */
+async function getLinearViewer(token) {
+    try {
+        const response = await fetch(LINEAR_API_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: token,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                query: `
+          query {
+            viewer {
+              id
+              name
+              email
+            }
+          }
+        `,
+            }),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const json = await response.json();
+        return json.data?.viewer || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get Linear organization info
+ */
+async function getLinearOrganization(token) {
+    try {
+        const response = await fetch(LINEAR_API_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: token,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                query: `
+          query {
+            organization {
+              id
+              name
+            }
+          }
+        `,
+            }),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const json = await response.json();
+        return json.data?.organization || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get Linear teams
+ */
+async function getLinearTeams() {
+    const token = await getLinearToken();
+    if (!token) {
+        return [];
+    }
+    try {
+        const response = await fetch(LINEAR_API_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: token,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                query: `
+          query {
+            teams {
+              nodes {
+                id
+                name
+                key
+              }
+            }
+          }
+        `,
+            }),
+        });
+        if (!response.ok) {
+            return [];
+        }
+        const json = await response.json();
+        return json.data?.teams?.nodes || [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Create a Linear issue
+ */
+async function createLinearIssue(options) {
+    const token = await getLinearToken();
+    if (!token) {
+        return { success: false, error: 'Not authenticated with Linear. Run: brainfile auth linear' };
+    }
+    try {
+        // First, get the "Done" state ID if stateName is specified
+        let stateId;
+        if (options.stateName) {
+            stateId = await getStateId(token, options.teamId, options.stateName);
+        }
+        // Create the issue
+        const response = await fetch(LINEAR_API_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: token,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                query: `
+          mutation CreateIssue($input: IssueCreateInput!) {
+            issueCreate(input: $input) {
+              success
+              issue {
+                id
+                identifier
+                url
+              }
+            }
+          }
+        `,
+                variables: {
+                    input: {
+                        teamId: options.teamId,
+                        title: options.title,
+                        description: options.description,
+                        priority: options.priority,
+                        stateId,
+                    },
+                },
+            }),
+        });
+        if (!response.ok) {
+            return { success: false, error: `Linear API error: ${response.status}` };
+        }
+        const json = await response.json();
+        if (json.errors) {
+            return { success: false, error: json.errors[0]?.message || 'Unknown error' };
+        }
+        const result = json.data?.issueCreate;
+        if (!result?.success) {
+            return { success: false, error: 'Failed to create issue' };
+        }
+        return {
+            success: true,
+            issueId: result.issue.identifier,
+            issueUrl: result.issue.url,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: err instanceof Error ? err.message : 'Unknown error creating issue',
+        };
+    }
+}
+/**
+ * Get state ID by name
+ */
+async function getStateId(token, teamId, stateName) {
+    try {
+        const response = await fetch(LINEAR_API_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: token,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                query: `
+          query GetStates($teamId: String!) {
+            team(id: $teamId) {
+              states {
+                nodes {
+                  id
+                  name
+                  type
+                }
+              }
+            }
+          }
+        `,
+                variables: { teamId },
+            }),
+        });
+        if (!response.ok) {
+            return undefined;
+        }
+        const json = await response.json();
+        const states = json.data?.team?.states?.nodes || [];
+        // Find state by name (case-insensitive)
+        const state = states.find((s) => s.name.toLowerCase() === stateName.toLowerCase());
+        return state?.id;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Logout from Linear
+ */
+async function logoutLinear() {
+    await auth_store_1.authStore.clear('linear');
+}
+//# sourceMappingURL=linear-auth.js.map

package/dist/utils/linear-auth.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Logger interface for CLI output.
+ * Allows dependency injection for testability.
+ */
+export interface Logger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    log(...args: unknown[]): void;
+}
+/**
+ * Default logger implementation wrapping console.
+ */
+export declare const defaultLogger: Logger;
+/**
+ * Memory logger for testing - captures all output.
+ */
+export declare class MemoryLogger implements Logger {
+    readonly infos: unknown[][];
+    readonly warns: unknown[][];
+    readonly errors: unknown[][];
+    readonly logs: unknown[][];
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    log(...args: unknown[]): void;
+    /** Get all output as a single string (for assertions) */
+    getOutput(): string;
+    /** Get all error output as a single string */
+    getErrorOutput(): string;
+    /** Clear all captured output */
+    clear(): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACnB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAa,YAAW,MAAM;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAM;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAM;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAM;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAM;IAEhC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI7B,yDAAyD;IACzD,SAAS,IAAI,MAAM;IAMnB,8CAA8C;IAC9C,cAAc,IAAI,MAAM;IAMxB,gCAAgC;IAChC,KAAK,IAAI,IAAI;CAMhB"}

package/dist/utils/logger.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryLogger = exports.defaultLogger = void 0;
+/**
+ * Default logger implementation wrapping console.
+ */
+exports.defaultLogger = {
+    info: (...args) => console.log(...args),
+    warn: (...args) => console.warn(...args),
+    error: (...args) => console.error(...args),
+    log: (...args) => console.log(...args),
+};
+/**
+ * Memory logger for testing - captures all output.
+ */
+class MemoryLogger {
+    constructor() {
+        this.infos = [];
+        this.warns = [];
+        this.errors = [];
+        this.logs = [];
+    }
+    info(...args) {
+        this.infos.push(args);
+    }
+    warn(...args) {
+        this.warns.push(args);
+    }
+    error(...args) {
+        this.errors.push(args);
+    }
+    log(...args) {
+        this.logs.push(args);
+    }
+    /** Get all output as a single string (for assertions) */
+    getOutput() {
+        return [...this.logs, ...this.infos, ...this.warns]
+            .map(args => args.map(String).join(' '))
+            .join('\n');
+    }
+    /** Get all error output as a single string */
+    getErrorOutput() {
+        return this.errors
+            .map(args => args.map(String).join(' '))
+            .join('\n');
+    }
+    /** Clear all captured output */
+    clear() {
+        this.infos.length = 0;
+        this.warns.length = 0;
+        this.errors.length = 0;
+        this.logs.length = 0;
+    }
+}
+exports.MemoryLogger = MemoryLogger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;AAWA;;GAEG;AACU,QAAA,aAAa,GAAW;IACjC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACvC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC1C,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACzC,CAAC;AAEF;;GAEG;AACH,MAAa,YAAY;IAAzB;QACa,UAAK,GAAgB,EAAE,CAAC;QACxB,UAAK,GAAgB,EAAE,CAAC;QACxB,WAAM,GAAgB,EAAE,CAAC;QACzB,SAAI,GAAgB,EAAE,CAAC;IAuCpC,CAAC;IArCG,IAAI,CAAC,GAAG,IAAe;QACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAG,IAAe;QAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,yDAAyD;IACzD,SAAS;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;aAC9C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aACvC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,8CAA8C;IAC9C,cAAc;QACV,OAAO,IAAI,CAAC,MAAM;aACb,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aACvC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,gCAAgC;IAChC,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC;CACJ;AA3CD,oCA2CC"}

package/dist/utils/strict-validation.d.ts

@@ -0,0 +1,8 @@
+import type { Board } from '@brainfile/core';
+export interface BoardValidationResult {
+    valid: boolean;
+    error?: string;
+}
+export declare function validateType(board: Board, typeName: string): BoardValidationResult;
+export declare function validateColumn(board: Board, columnId: string): BoardValidationResult;
+//# sourceMappingURL=strict-validation.d.ts.map

package/dist/utils/strict-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-validation.d.ts","sourceRoot":"","sources":["../../src/utils/strict-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAsBlF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAkBpF"}

package/dist/utils/strict-validation.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateType = validateType;
+exports.validateColumn = validateColumn;
+const coreValidation = require('@brainfile/core');
+function validateType(board, typeName) {
+    if (typeof coreValidation.validateType === 'function') {
+        return coreValidation.validateType(board, typeName);
+    }
+    const strict = board.strict;
+    const types = board.types;
+    if (!strict || !types) {
+        return { valid: true };
+    }
+    if (typeName === 'task' || Object.prototype.hasOwnProperty.call(types, typeName)) {
+        return { valid: true };
+    }
+    const definedKeys = Object.keys(types);
+    const availableTypes = definedKeys.includes('task') ? definedKeys : ['task', ...definedKeys];
+    return {
+        valid: false,
+        error: `Type '${typeName}' is not defined. Available types: ${availableTypes.join(', ')}`,
+    };
+}
+function validateColumn(board, columnId) {
+    if (typeof coreValidation.validateColumn === 'function') {
+        return coreValidation.validateColumn(board, columnId);
+    }
+    if (!board.strict) {
+        return { valid: true };
+    }
+    const columnIds = board.columns.map(column => column.id);
+    if (columnIds.includes(columnId)) {
+        return { valid: true };
+    }
+    return {
+        valid: false,
+        error: `Column '${columnId}' is not defined. Available columns: ${columnIds.join(', ')}`,
+    };
+}
+//# sourceMappingURL=strict-validation.js.map

package/dist/utils/strict-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-validation.js","sourceRoot":"","sources":["../../src/utils/strict-validation.ts"],"names":[],"mappings":";;AAcA,oCAsBC;AAED,wCAkBC;AA5CD,MAAM,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAA0B,CAAC;AAE3E,SAAgB,YAAY,CAAC,KAAY,EAAE,QAAgB;IACzD,IAAI,OAAO,cAAc,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QACtD,OAAO,cAAc,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,MAAM,GAAI,KAAa,CAAC,MAAM,CAAC;IACrC,MAAM,KAAK,GAAI,KAAa,CAAC,KAA4C,CAAC;IAE1E,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QACjF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC;IAC7F,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,SAAS,QAAQ,sCAAsC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC1F,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAAC,KAAY,EAAE,QAAgB;IAC3D,IAAI,OAAO,cAAc,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACxD,OAAO,cAAc,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAE,KAAa,CAAC,MAAM,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,WAAW,QAAQ,wCAAwC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACzF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * V2 per-task file architecture detection, path resolution, and body helpers.
+ *
+ * Core owns these helpers (`@brainfile/core` workspace exports). This file
+ * re-exports them for existing CLI imports and retains CLI-only migration
+ * hint helpers.
+ *
+ * @packageDocumentation
+ */
+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 migration suggestion.
+ *
+ * Returns true when ALL of these hold:
+ *   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 migration hint has been shown so it won't appear again.
+ *
+ * This is intentionally in-memory only; Brainfile no longer persists state.json.
+ */
+export declare function markV2MigrationHintShown(brainfilePath: string): void;
+/** @internal test helper */
+export declare function __resetV2MigrationHintState(): void;
+//# sourceMappingURL=v2-detect.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * V2 per-task file architecture detection, path resolution, and body helpers.
+ *
+ * Core owns these helpers (`@brainfile/core` workspace exports). This file
+ * re-exports them for existing CLI imports and retains CLI-only migration
+ * hint helpers.
+ *
+ * @packageDocumentation
+ */
+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.buildBoardFromV2 = exports.readV2BoardConfig = exports.composeBody = exports.extractLog = exports.extractDescription = exports.findV2Task = exports.getLogFilePath = exports.getTaskFilePath = exports.ensureV2Dirs = exports.isV2 = exports.getV2Dirs = void 0;
+exports.shouldSuggestV2Migration = shouldSuggestV2Migration;
+exports.markV2MigrationHintShown = markV2MigrationHintShown;
+exports.__resetV2MigrationHintState = __resetV2MigrationHintState;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const core_1 = require("@brainfile/core");
+// ── Re-exports from core ─────────────────────────────────────────────
+var core_2 = require("@brainfile/core");
+Object.defineProperty(exports, "getV2Dirs", { enumerable: true, get: function () { return core_2.getV2Dirs; } });
+Object.defineProperty(exports, "isV2", { enumerable: true, get: function () { return core_2.isV2; } });
+Object.defineProperty(exports, "ensureV2Dirs", { enumerable: true, get: function () { return core_2.ensureV2Dirs; } });
+Object.defineProperty(exports, "getTaskFilePath", { enumerable: true, get: function () { return core_2.getTaskFilePath; } });
+Object.defineProperty(exports, "getLogFilePath", { enumerable: true, get: function () { return core_2.getLogFilePath; } });
+Object.defineProperty(exports, "findV2Task", { enumerable: true, get: function () { return core_2.findV2Task; } });
+Object.defineProperty(exports, "extractDescription", { enumerable: true, get: function () { return core_2.extractDescription; } });
+Object.defineProperty(exports, "extractLog", { enumerable: true, get: function () { return core_2.extractLog; } });
+Object.defineProperty(exports, "composeBody", { enumerable: true, get: function () { return core_2.composeBody; } });
+Object.defineProperty(exports, "readV2BoardConfig", { enumerable: true, get: function () { return core_2.readV2BoardConfig; } });
+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 migration suggestion.
+ *
+ * Returns true when ALL of these hold:
+ *   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);
+    if (v2MigrationHintShown.has(resolved))
+        return false;
+    const probe = (0, workspace_format_1.probeWorkspaceForBrainfile)(resolved);
+    if ((0, workspace_format_1.shouldSuggestMigration)(probe)) {
+        return true;
+    }
+    // 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 migration hint has been shown so it won't appear again.
+ *
+ * This is intentionally in-memory only; Brainfile no longer persists state.json.
+ */
+function markV2MigrationHintShown(brainfilePath) {
+    v2MigrationHintShown.add(path.resolve(brainfilePath));
+}
+/** @internal test helper */
+function __resetV2MigrationHintState() {
+    v2MigrationHintShown.clear();
+}
+//# sourceMappingURL=v2-detect.js.map

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

@@ -0,0 +1 @@
+{"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/v2-only.d.ts

@@ -0,0 +1,9 @@
+export declare const V1_UNSUPPORTED_MESSAGE = "Brainfile v1 is no longer supported by this command. Run `brainfile migrate` to convert this workspace to v2.";
+/**
+ * Require v2 per-task file architecture for normal runtime commands.
+ *
+ * `brainfile migrate` is the only command allowed to read or transform v1
+ * layouts. Runtime commands should call this after resolving the brainfile path.
+ */
+export declare function assertV2Brainfile(brainfilePath: string): void;
+//# sourceMappingURL=v2-only.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v2-only.d.ts","sourceRoot":"","sources":["../../src/utils/v2-only.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB,kHAC8E,CAAC;AAUlH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAQ7D"}