@bosun-sh/logbook 1.0.0 → 2.0.0

package/dist/workspace/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/workspace/status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B,QAAA,MAAM,aAAa,2GAST,CAAA;AAGV,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;CAC3C,CAAA;AAED,KAAK,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAChD,KAAK,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5F,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;KAC9C,CAAA;IACD,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAA;QACvC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAA;KACrC,CAAA;IACD,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;KAC3C,CAAA;CACF,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;CAC9C,CAAA;AAgBD,eAAO,MAAM,kBAAkB,GAC7B,QAAO,oBAAyB,KAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,KAAK,CAI2B,CAAA"}

package/dist/workspace/status.js

@@ -0,0 +1,345 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { Effect } from "effect";
+import { TaskRepository } from "./repositories.js";
+import { resolveWorkspacePaths, StoragePaths } from "./storage-layout.js";
+const MAX_CONFIG_JSON_BYTES = 65_536;
+const MAX_HOOK_CONFIG_FILES = 200;
+const TASK_STATUSES = [
+    "backlog",
+    "todo",
+    "in_progress",
+    "need_info",
+    "blocked",
+    "pending_review",
+    "done",
+    "canceled",
+];
+const textEncoder = new TextEncoder();
+export const getWorkspaceStatus = (input = {}) => Effect.tryPromise({
+    try: () => getWorkspaceStatusUnsafe(input),
+    catch: normalizeWorkspaceError,
+}).pipe(Effect.catchAll((error) => Effect.succeed({ ok: false, error })));
+const getWorkspaceStatusUnsafe = async (input) => {
+    const workspacePath = resolve(input.path ?? process.cwd());
+    const layout = resolveWorkspacePaths(workspacePath);
+    const warnings = [];
+    const configResult = await readWorkspaceConfig(layout.config);
+    if (!configResult.ok) {
+        return { ok: false, error: configResult.error };
+    }
+    const metadataResult = await readWorkspaceMetadata(layout.metadata);
+    if (!metadataResult.ok) {
+        return { ok: false, error: metadataResult.error };
+    }
+    const missingCanonicalPaths = await findMissingCanonicalPaths(workspacePath);
+    if (missingCanonicalPaths.length > 0) {
+        return {
+            ok: false,
+            error: storageError("Canonical workspace storage is incomplete.", {
+                missingPaths: missingCanonicalPaths,
+            }),
+        };
+    }
+    const tasksResult = await readTaskStatusCounts(workspacePath);
+    if (!tasksResult.ok) {
+        return { ok: false, error: tasksResult.error };
+    }
+    const hooks = await readHookStatus(workspacePath, configResult.value, warnings);
+    const linear = await readLinearStatus(configResult.value, warnings);
+    const status = {
+        path: workspacePath,
+        initialized: true,
+        schemaVersion: metadataResult.schemaVersion,
+        tasks: tasksResult.value,
+        storage: {
+            canonicalFilesPresent: true,
+            duckdbIndexPresent: await hasDuckDbIndex(workspacePath),
+        },
+        hooks,
+        providers: {
+            ...(linear === undefined ? {} : { linear }),
+        },
+    };
+    return {
+        ok: true,
+        data: {
+            status,
+            ...(warnings.length === 0 ? {} : { warnings }),
+        },
+    };
+};
+const readWorkspaceConfig = async (path) => {
+    const json = await readBoundedJson(path, StoragePaths.config);
+    if (!json.ok) {
+        return json;
+    }
+    if (!isRecord(json.value) || json.value.schemaVersion !== "2") {
+        return {
+            ok: false,
+            error: workspaceError("Workspace config is not compatible with v2.", {
+                path: StoragePaths.config,
+            }),
+        };
+    }
+    return { ok: true, value: json.value };
+};
+const readWorkspaceMetadata = async (path) => {
+    const json = await readBoundedJson(path, StoragePaths.metadata);
+    if (!json.ok) {
+        return json;
+    }
+    if (!isRecord(json.value) || json.value.schemaVersion !== "2") {
+        return {
+            ok: false,
+            error: workspaceError("Workspace metadata is not compatible with v2.", {
+                path: StoragePaths.metadata,
+            }),
+        };
+    }
+    return { ok: true, schemaVersion: 2 };
+};
+const readBoundedJson = async (path, relativePath) => {
+    const entry = await stat(path).catch((cause) => {
+        if (isEnoent(cause)) {
+            return null;
+        }
+        throw cause;
+    });
+    if (entry === null) {
+        return {
+            ok: false,
+            error: workspaceError("Workspace JSON file is missing.", { path: relativePath }),
+        };
+    }
+    if (!entry.isFile()) {
+        return {
+            ok: false,
+            error: workspaceError("Workspace JSON path is incompatible with the v2 layout.", {
+                path: relativePath,
+                expected: "json_file",
+            }),
+        };
+    }
+    if (entry.size > MAX_CONFIG_JSON_BYTES) {
+        return oversizedConfigError(relativePath, entry.size);
+    }
+    const content = await readFile(path, "utf8");
+    const actualBytes = byteLength(content);
+    if (actualBytes > MAX_CONFIG_JSON_BYTES) {
+        return oversizedConfigError(relativePath, actualBytes);
+    }
+    try {
+        return { ok: true, value: JSON.parse(content) };
+    }
+    catch {
+        return {
+            ok: false,
+            error: workspaceError("Workspace JSON file is not valid JSON.", { path: relativePath }),
+        };
+    }
+};
+const oversizedConfigError = (path, actualBytes) => ({
+    ok: false,
+    error: workspaceError(`Workspace config JSON exceeds ${MAX_CONFIG_JSON_BYTES} bytes.`, {
+        path,
+        actualBytes,
+        maxBytes: MAX_CONFIG_JSON_BYTES,
+    }),
+});
+const findMissingCanonicalPaths = async (workspacePath) => {
+    const layout = resolveWorkspacePaths(workspacePath);
+    const canonicalFiles = [
+        [layout.epics, StoragePaths.epics],
+        [layout.stories, StoragePaths.stories],
+        [layout.tasks, StoragePaths.tasks],
+        [layout.contextEntries, StoragePaths.contextEntries],
+        [layout.externalLinks, StoragePaths.externalLinks],
+        [layout.syncEvents, StoragePaths.syncEvents],
+        [layout.syncConflicts, StoragePaths.syncConflicts],
+    ];
+    const missing = [];
+    for (const [absolutePath, relativePath] of canonicalFiles) {
+        const entry = await stat(absolutePath).catch((cause) => {
+            if (isEnoent(cause)) {
+                return null;
+            }
+            throw cause;
+        });
+        if (entry === null || !entry.isFile()) {
+            missing.push(relativePath);
+        }
+    }
+    return missing;
+};
+const readTaskStatusCounts = async (workspacePath) => {
+    const repository = new TaskRepository({ workspaceRoot: workspacePath });
+    const result = await Effect.runPromiseExit(repository.list());
+    if (result._tag === "Failure") {
+        return {
+            ok: false,
+            error: storageError("Failed to read canonical task storage.", {
+                cause: String(result.cause),
+            }),
+        };
+    }
+    return { ok: true, value: countTasksByStatus(result.value) };
+};
+const countTasksByStatus = (tasks) => {
+    const byStatus = Object.fromEntries(TASK_STATUSES.map((status) => [status, 0]));
+    for (const task of tasks) {
+        byStatus[task.status] += 1;
+    }
+    return {
+        total: tasks.length,
+        byStatus,
+    };
+};
+const readHookStatus = async (workspacePath, config, warnings) => {
+    const configuredDirectory = isRecord(config.hooks) && config.hooks.directory === ".logbook/hooks"
+        ? ".logbook/hooks"
+        : StoragePaths.hooksRoot;
+    const hooksRoot = join(workspacePath, configuredDirectory);
+    const entries = await readdir(hooksRoot, { withFileTypes: true }).catch((cause) => {
+        if (isEnoent(cause)) {
+            warnings.push({
+                code: "missing_optional_integration",
+                message: "Hook directory is not present.",
+                details: { path: StoragePaths.hooksRoot },
+            });
+            return [];
+        }
+        throw cause;
+    });
+    const files = entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+        .map((entry) => entry.name)
+        .sort((left, right) => left.localeCompare(right));
+    const scanned = files.slice(0, MAX_HOOK_CONFIG_FILES);
+    if (files.length > MAX_HOOK_CONFIG_FILES) {
+        warnings.push({
+            code: "has_more",
+            message: "Additional hook config files were not scanned.",
+            details: {
+                path: StoragePaths.hooksRoot,
+                hasMore: true,
+                scanned: MAX_HOOK_CONFIG_FILES,
+                total: files.length,
+            },
+        });
+    }
+    let configured = 0;
+    let enabled = 0;
+    for (const fileName of scanned) {
+        const hookPath = join(hooksRoot, fileName);
+        const content = await readFile(hookPath, "utf8").catch((cause) => {
+            warnings.push(invalidHookWarning(fileName, `Failed to read hook config: ${String(cause)}`));
+            return null;
+        });
+        if (content === null) {
+            continue;
+        }
+        let value;
+        try {
+            value = JSON.parse(content);
+        }
+        catch {
+            warnings.push(invalidHookWarning(fileName, "Hook config is not valid JSON."));
+            continue;
+        }
+        if (!isHookConfig(value)) {
+            warnings.push(invalidHookWarning(fileName, "Hook config is not compatible with v2."));
+            continue;
+        }
+        configured += 1;
+        if (value.enabled) {
+            enabled += 1;
+        }
+    }
+    return { configured, enabled };
+};
+const readLinearStatus = async (config, warnings) => {
+    if (!isRecord(config.linear)) {
+        return undefined;
+    }
+    const apiTokenEnv = typeof config.linear.apiTokenEnv === "string" && config.linear.apiTokenEnv.length > 0
+        ? config.linear.apiTokenEnv
+        : "LINEAR_API_KEY";
+    const authenticated = typeof process.env[apiTokenEnv] === "string" && (process.env[apiTokenEnv]?.length ?? 0) > 0;
+    const providerWarnings = [];
+    if (!authenticated) {
+        const warning = {
+            code: "provider_warning",
+            message: "Linear is configured but its API token environment variable is not set.",
+            details: {
+                provider: "linear",
+                apiTokenEnv,
+            },
+        };
+        providerWarnings.push(warning);
+        warnings.push(warning);
+    }
+    return {
+        configured: true,
+        authenticated,
+        pendingConflicts: 0,
+        ...(providerWarnings.length === 0 ? {} : { warnings: providerWarnings }),
+    };
+};
+const hasDuckDbIndex = async (workspacePath) => {
+    const candidates = [
+        ".logbook/storage/logbook.duckdb",
+        ".logbook/storage/index.duckdb",
+        ".logbook/logbook.duckdb",
+        ".logbook/index.duckdb",
+    ];
+    for (const relativePath of candidates) {
+        const entry = await stat(join(workspacePath, relativePath)).catch((cause) => {
+            if (isEnoent(cause)) {
+                return null;
+            }
+            throw cause;
+        });
+        if (entry?.isFile()) {
+            return true;
+        }
+    }
+    return false;
+};
+const isHookConfig = (value) => isRecord(value) &&
+    typeof value.id === "string" &&
+    typeof value.enabled === "boolean" &&
+    typeof value.event === "string" &&
+    Array.isArray(value.command) &&
+    value.command.every((entry) => typeof entry === "string");
+const invalidHookWarning = (fileName, message) => ({
+    code: "hook_warning",
+    message,
+    details: {
+        path: `${StoragePaths.hooksRoot}${basename(fileName)}`,
+    },
+});
+const normalizeWorkspaceError = (cause) => {
+    if (isRecord(cause) && typeof cause.code === "string" && typeof cause.message === "string") {
+        return {
+            code: cause.code,
+            message: cause.message,
+            ...(isRecord(cause.details) ? { details: cause.details } : {}),
+        };
+    }
+    return workspaceError("Failed to read workspace status.", { cause: String(cause) });
+};
+const workspaceError = (message, details) => ({
+    code: "workspace_error",
+    message,
+    ...(details === undefined ? {} : { details }),
+});
+const storageError = (message, details) => ({
+    code: "storage_error",
+    message,
+    ...(details === undefined ? {} : { details }),
+});
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isEnoent = (error) => isRecord(error) && "code" in error && error.code === "ENOENT";
+const byteLength = (value) => textEncoder.encode(value).length;
+//# sourceMappingURL=status.js.map

package/dist/workspace/status.js.map

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

package/dist/workspace/storage-layout.d.ts

@@ -0,0 +1,19 @@
+export { StoragePaths } from "./storage-paths.js";
+interface ResolvedStorageLayout {
+    readonly workspaceRoot: string;
+    readonly logbookRoot: string;
+    readonly config: string;
+    readonly metadata: string;
+    readonly storageRoot: string;
+    readonly hooksRoot: string;
+    readonly epics: string;
+    readonly stories: string;
+    readonly tasks: string;
+    readonly contextEntries: string;
+    readonly externalLinks: string;
+    readonly syncEvents: string;
+    readonly syncConflicts: string;
+}
+export declare const resolveWorkspacePaths: (workspaceRoot: string) => ResolvedStorageLayout;
+export declare const ensureStorageLayout: (layout: ResolvedStorageLayout) => ResolvedStorageLayout;
+//# sourceMappingURL=storage-layout.d.ts.map

package/dist/workspace/storage-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-layout.d.ts","sourceRoot":"","sources":["../../src/workspace/storage-layout.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMjD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,eAAO,MAAM,qBAAqB,GAAI,eAAe,MAAM,KAAG,qBAG7D,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,QAAQ,qBAAqB,KAAG,qBAInE,CAAA"}

package/dist/workspace/storage-layout.js

@@ -0,0 +1,55 @@
+import { join } from "node:path";
+export { StoragePaths } from "./storage-paths.js";
+import { StoragePaths } from "./storage-paths.js";
+const MAX_PATH_BYTES = 4096;
+export const resolveWorkspacePaths = (workspaceRoot) => {
+    validateWorkspaceRoot(workspaceRoot);
+    return buildStorageLayout(workspaceRoot);
+};
+export const ensureStorageLayout = (layout) => {
+    validateWorkspaceRoot(layout.workspaceRoot);
+    validateResolvedLayout(layout);
+    return layout;
+};
+const buildStorageLayout = (workspaceRoot) => ({
+    workspaceRoot,
+    logbookRoot: join(workspaceRoot, StoragePaths.root),
+    config: join(workspaceRoot, StoragePaths.config),
+    metadata: join(workspaceRoot, StoragePaths.metadata),
+    storageRoot: join(workspaceRoot, StoragePaths.storageRoot),
+    hooksRoot: join(workspaceRoot, StoragePaths.hooksRoot),
+    epics: join(workspaceRoot, StoragePaths.epics),
+    stories: join(workspaceRoot, StoragePaths.stories),
+    tasks: join(workspaceRoot, StoragePaths.tasks),
+    contextEntries: join(workspaceRoot, StoragePaths.contextEntries),
+    externalLinks: join(workspaceRoot, StoragePaths.externalLinks),
+    syncEvents: join(workspaceRoot, StoragePaths.syncEvents),
+    syncConflicts: join(workspaceRoot, StoragePaths.syncConflicts),
+});
+const validateResolvedLayout = (layout) => {
+    const expected = buildStorageLayout(layout.workspaceRoot);
+    for (const key of Object.keys(expected)) {
+        validatePathBytes(layout[key], key);
+        if (layout[key] !== expected[key]) {
+            throw validationError(`non-canonical storage path for ${String(key)}`, layout[key]);
+        }
+    }
+};
+const validateWorkspaceRoot = (workspaceRoot) => {
+    validatePathBytes(workspaceRoot, "workspaceRoot");
+    if (workspaceRoot.length === 0) {
+        throw validationError("workspaceRoot must be a non-empty string", workspaceRoot);
+    }
+};
+const validatePathBytes = (path, label) => {
+    if (byteLength(path) > MAX_PATH_BYTES) {
+        throw validationError(`${label} exceeds ${MAX_PATH_BYTES} bytes`, path);
+    }
+};
+const byteLength = (value) => new TextEncoder().encode(value).length;
+const validationError = (message, path) => ({
+    _tag: "validation_error",
+    message,
+    path,
+});
+//# sourceMappingURL=storage-layout.js.map

package/dist/workspace/storage-layout.js.map

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

package/dist/workspace/storage-paths.d.ts

@@ -0,0 +1,16 @@
+export declare const StoragePaths: {
+    readonly root: ".logbook";
+    readonly config: ".logbook/config.json";
+    readonly metadata: ".logbook/workspace.json";
+    readonly storageRoot: ".logbook/storage";
+    readonly hooksRoot: ".logbook/hooks/";
+    readonly epics: ".logbook/storage/epics.jsonl";
+    readonly stories: ".logbook/storage/stories.jsonl";
+    readonly tasks: ".logbook/storage/tasks.jsonl";
+    readonly contextEntries: ".logbook/storage/context-entries.jsonl";
+    readonly externalLinks: ".logbook/storage/external-links.jsonl";
+    readonly syncEvents: ".logbook/storage/sync-events.jsonl";
+    readonly syncConflicts: ".logbook/storage/sync-conflicts.jsonl";
+};
+export type StoragePathName = keyof typeof StoragePaths;
+//# sourceMappingURL=storage-paths.d.ts.map

package/dist/workspace/storage-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-paths.d.ts","sourceRoot":"","sources":["../../src/workspace/storage-paths.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAaf,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,YAAY,CAAA"}

package/dist/workspace/storage-paths.js

@@ -0,0 +1,15 @@
+export const StoragePaths = {
+    root: ".logbook",
+    config: ".logbook/config.json",
+    metadata: ".logbook/workspace.json",
+    storageRoot: ".logbook/storage",
+    hooksRoot: ".logbook/hooks/",
+    epics: ".logbook/storage/epics.jsonl",
+    stories: ".logbook/storage/stories.jsonl",
+    tasks: ".logbook/storage/tasks.jsonl",
+    contextEntries: ".logbook/storage/context-entries.jsonl",
+    externalLinks: ".logbook/storage/external-links.jsonl",
+    syncEvents: ".logbook/storage/sync-events.jsonl",
+    syncConflicts: ".logbook/storage/sync-conflicts.jsonl",
+};
+//# sourceMappingURL=storage-paths.js.map

package/dist/workspace/storage-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-paths.js","sourceRoot":"","sources":["../../src/workspace/storage-paths.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,sBAAsB;IAC9B,QAAQ,EAAE,yBAAyB;IACnC,WAAW,EAAE,kBAAkB;IAC/B,SAAS,EAAE,iBAAiB;IAC5B,KAAK,EAAE,8BAA8B;IACrC,OAAO,EAAE,gCAAgC;IACzC,KAAK,EAAE,8BAA8B;IACrC,cAAc,EAAE,wCAAwC;IACxD,aAAa,EAAE,uCAAuC;IACtD,UAAU,EAAE,oCAAoC;IAChD,aAAa,EAAE,uCAAuC;CAC9C,CAAA"}

package/dist/workspace/v1-cli-aliases.d.ts

@@ -0,0 +1,18 @@
+import type { ToolResult } from "../shared/result.js";
+type ToolWarning = NonNullable<Extract<ToolResult<never>, {
+    ok: true;
+}>["warnings"]>[number];
+type V1CliTranslation = {
+    readonly toolId: string;
+    readonly input: Record<string, unknown>;
+    readonly warnings: readonly ToolWarning[];
+    readonly withCompatibilityOutput?: (<T>(envelope: ToolResult<T>) => ToolResult<T>) | undefined;
+};
+export declare const v1CliAliases: readonly {
+    alias: "create-task" | "list-tasks" | "current-task" | "update-task" | "edit-task" | "init";
+    toolId: "workspace.init" | "task.list" | "task.create" | "task.current" | "task.update" | "task.edit";
+    compatibility: "v1";
+}[];
+export declare const translateV1CliCommand: (alias: string, input: Record<string, unknown>) => V1CliTranslation | null;
+export {};
+//# sourceMappingURL=v1-cli-aliases.d.ts.map

package/dist/workspace/v1-cli-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-cli-aliases.d.ts","sourceRoot":"","sources":["../../src/workspace/v1-cli-aliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAW3D,KAAK,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5F,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IACzC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;CAC/F,CAAA;AAmBD,eAAO,MAAM,YAAY;;;;GAMQ,CAAA;AAEjC,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,gBAAgB,GAAG,IAkCrB,CAAA"}