botmux 2.111.0 → 2.112.0

package/dist/cli/workflow-migration.js

@@ -0,0 +1,302 @@
+/** `botmux template migrate-v3`: dry-run first, explicit commit second. */
+import { loadBotConfigs } from '../bot-registry.js';
+import { resolve } from 'node:path';
+import { resolveBotmuxDataDir } from '../core/data-dir.js';
+import { commitLegacyWorkflowMigration, LegacyWorkflowConversionError, } from '../workflows/migration/v2-migration-service.js';
+import { findLegacyMigration, legacyDefinitionIdentity, migratedSavedWorkflowId, } from '../workflows/migration/v2-ledger.js';
+import { scanLegacyWorkflowCandidates } from '../workflows/migration/v2-scanner.js';
+import { convertLegacyWorkflowDefinition, } from '../workflows/migration/v2-to-v3.js';
+const VALUE_FLAGS = new Set([
+    '--owner-open-id',
+    '--lark-app-id',
+    '--scope',
+    '--chat-id',
+    '--chat-type',
+    '--data-dir',
+]);
+const BOOLEAN_FLAGS = new Set([
+    '--all',
+    '--commit',
+    '--json',
+    '--ack-warnings',
+    '--supersede-pending',
+]);
+function parseRawFlags(args) {
+    const refs = [];
+    const values = new Map();
+    const booleans = new Set();
+    for (let index = 0; index < args.length; index++) {
+        const token = args[index];
+        if (!token.startsWith('--')) {
+            refs.push(token);
+            continue;
+        }
+        const equals = token.indexOf('=');
+        const flag = equals >= 0 ? token.slice(0, equals) : token;
+        if (BOOLEAN_FLAGS.has(flag)) {
+            if (equals >= 0)
+                throw new Error(`${flag} does not accept a value`);
+            if (booleans.has(flag))
+                throw new Error(`duplicate flag ${flag}`);
+            booleans.add(flag);
+            continue;
+        }
+        if (!VALUE_FLAGS.has(flag))
+            throw new Error(`unknown flag ${flag}`);
+        if (values.has(flag))
+            throw new Error(`duplicate flag ${flag}`);
+        const value = equals >= 0 ? token.slice(equals + 1) : args[++index];
+        if (!value || value.startsWith('--'))
+            throw new Error(`${flag} requires a value`);
+        values.set(flag, value);
+    }
+    return { refs, values, booleans };
+}
+export function parseWorkflowMigrationCliOptions(args, defaultDataDir = resolveBotmuxDataDir()) {
+    const raw = parseRawFlags(args);
+    const all = raw.booleans.has('--all');
+    if (all && raw.refs.length > 0)
+        throw new Error('--all cannot be combined with explicit workflow ids/paths');
+    const ownerOpenId = raw.values.get('--owner-open-id');
+    const larkAppId = raw.values.get('--lark-app-id');
+    const scopeKind = raw.values.get('--scope');
+    const chatId = raw.values.get('--chat-id');
+    const chatTypeRaw = raw.values.get('--chat-type');
+    const anyTargetFlag = !!ownerOpenId || !!larkAppId || !!scopeKind || !!chatId || !!chatTypeRaw;
+    let owner;
+    let scope;
+    let chatType;
+    if (anyTargetFlag) {
+        if (!ownerOpenId || !larkAppId || !scopeKind) {
+            throw new Error('target metadata requires --owner-open-id, --lark-app-id, and --scope together');
+        }
+        owner = { openId: ownerOpenId, larkAppId };
+        if (scopeKind === 'global') {
+            if (chatId || chatTypeRaw)
+                throw new Error('--scope global cannot include --chat-id/--chat-type');
+            scope = { kind: 'global' };
+        }
+        else if (scopeKind === 'chat') {
+            if (!chatId || (chatTypeRaw !== 'group' && chatTypeRaw !== 'p2p')) {
+                throw new Error('--scope chat requires --chat-id and --chat-type group|p2p');
+            }
+            scope = { kind: 'chat', chatId };
+            chatType = chatTypeRaw;
+        }
+        else {
+            throw new Error('--scope must be global or chat');
+        }
+    }
+    const commit = raw.booleans.has('--commit');
+    if (commit && (!owner || !scope)) {
+        throw new Error('--commit never infers ownership/scope; provide explicit owner, app, and scope flags');
+    }
+    const supersedePending = raw.booleans.has('--supersede-pending');
+    if (supersedePending && !commit) {
+        throw new Error('--supersede-pending is a commit-only recovery action');
+    }
+    return {
+        refs: raw.refs,
+        all,
+        commit,
+        json: raw.booleans.has('--json'),
+        acknowledgeWarnings: raw.booleans.has('--ack-warnings'),
+        supersedePending,
+        dataDir: resolve(raw.values.get('--data-dir') ?? defaultDataDir),
+        ...(owner ? { owner } : {}),
+        ...(scope ? { scope } : {}),
+        ...(chatType ? { chatType } : {}),
+    };
+}
+function issueFromError(code, path, err) {
+    return {
+        severity: 'error',
+        code,
+        path,
+        message: err instanceof Error ? err.message : String(err),
+        hint: 'Fix the source asset and run the dry-run again.',
+    };
+}
+function targetContext(options) {
+    if (!options.owner || !options.scope)
+        return undefined;
+    return {
+        owner: options.owner,
+        scope: options.scope,
+        ...(options.chatType ? { chatType: options.chatType } : {}),
+    };
+}
+function printHumanReport(reports) {
+    for (const report of reports) {
+        const target = report.targetWorkflowId
+            ? ` -> ${report.targetWorkflowId}${report.targetRevisionId ? `@${report.targetRevisionId}` : ''}`
+            : '';
+        console.log(`[${report.status}] ${report.workflowId}  ${report.path}${target}`);
+        if (report.shadowedBy)
+            console.log(`  shadowed by: ${report.shadowedBy}`);
+        if (report.error)
+            console.log(`  error: ${report.error}`);
+        for (const item of report.issues) {
+            console.log(`  - ${item.severity.toUpperCase()} ${item.code} ${item.path}: ${item.message}`);
+            console.log(`    hint: ${item.hint}`);
+        }
+    }
+    const counts = new Map();
+    reports.forEach((report) => counts.set(report.status, (counts.get(report.status) ?? 0) + 1));
+    console.log(`summary: ${reports.length} definition(s)` +
+        [...counts.entries()].map(([status, count]) => `, ${status}=${count}`).join(''));
+}
+export async function runWorkflowMigrationCli(options, deps = {}) {
+    let bots;
+    let botLoadError;
+    try {
+        bots = (deps.loadBots ?? loadBotConfigs)();
+    }
+    catch (err) {
+        bots = [];
+        botLoadError = err instanceof Error ? err.message : String(err);
+    }
+    const candidates = await (deps.scanCandidates ?? scanLegacyWorkflowCandidates)({
+        ...(options.refs.length > 0 ? { refs: options.refs } : {}),
+    });
+    const reports = [];
+    for (const candidate of candidates) {
+        if (candidate.kind === 'invalid') {
+            reports.push({
+                path: candidate.path,
+                workflowId: candidate.inferredWorkflowId,
+                status: 'invalid',
+                issues: [issueFromError('LEGACY_DEFINITION_INVALID', candidate.path, candidate.error)],
+                error: candidate.error,
+            });
+            continue;
+        }
+        if (candidate.kind === 'shadowed') {
+            reports.push({
+                path: candidate.path,
+                workflowId: candidate.definition.workflowId,
+                status: 'shadowed',
+                shadowedBy: candidate.shadowedBy,
+                issues: [{
+                        severity: 'error',
+                        code: 'LEGACY_DEFINITION_SHADOWED',
+                        path: candidate.path,
+                        message: 'A higher-priority definition with the same workflowId wins v2 resolution.',
+                        hint: 'Migrate the winner, or pass this exact path explicitly after resolving the duplicate.',
+                    }],
+            });
+            continue;
+        }
+        let identity;
+        try {
+            identity = legacyDefinitionIdentity(candidate.path, candidate.definition);
+        }
+        catch (err) {
+            reports.push({
+                path: candidate.path,
+                workflowId: candidate.definition.workflowId,
+                status: 'invalid',
+                issues: [issueFromError('LEGACY_SOURCE_INVALID', candidate.path, err)],
+                error: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        const conversion = convertLegacyWorkflowDefinition({
+            definition: candidate.definition,
+            bots,
+            ...(targetContext(options) ? { target: targetContext(options) } : {}),
+        });
+        const botConfigIssue = botLoadError &&
+            Object.values(candidate.definition.nodes).some((node) => node.type === 'subagent')
+            ? [{
+                    severity: 'error',
+                    code: 'BOTS_CONFIG_LOAD_FAILED',
+                    path: 'bots.json',
+                    message: botLoadError,
+                    hint: 'Repair bots.json, then rerun the migration dry-run.',
+                }]
+            : [];
+        const targetWorkflowId = migratedSavedWorkflowId(identity);
+        if (!conversion.ok || botConfigIssue.length > 0) {
+            reports.push({
+                path: identity.path,
+                workflowId: identity.workflowId,
+                contentHash: identity.contentHash,
+                targetWorkflowId,
+                status: 'unsupported',
+                issues: [
+                    ...botConfigIssue,
+                    ...conversion.issues.filter((item) => !(botConfigIssue.length > 0 && item.code === 'BOT_NOT_FOUND')),
+                ],
+            });
+            continue;
+        }
+        const lookup = findLegacyMigration(options.dataDir, identity);
+        if (!options.commit) {
+            reports.push({
+                path: identity.path,
+                workflowId: identity.workflowId,
+                contentHash: identity.contentHash,
+                targetWorkflowId,
+                ...(lookup.kind === 'exact' ? { targetRevisionId: lookup.revision.targetRevisionId } : {}),
+                status: lookup.kind === 'exact'
+                    ? lookup.revision.state === 'committed' ? 'migrated' : 'pending'
+                    : lookup.kind === 'changed_after_migration' ? 'update_required' : 'convertible',
+                issues: conversion.issues,
+            });
+            continue;
+        }
+        try {
+            const result = await commitLegacyWorkflowMigration({
+                dataDir: options.dataDir,
+                sourcePath: identity.path,
+                bots,
+                owner: options.owner,
+                scope: options.scope,
+                ...(options.chatType ? { chatType: options.chatType } : {}),
+                acknowledgeWarnings: options.acknowledgeWarnings,
+                supersedePending: options.supersedePending,
+            });
+            reports.push({
+                path: result.identity.path,
+                workflowId: result.identity.workflowId,
+                contentHash: result.identity.contentHash,
+                targetWorkflowId: result.metadata.workflowId,
+                targetRevisionId: result.revision.revisionId,
+                status: 'committed',
+                issues: result.issues,
+            });
+        }
+        catch (err) {
+            const issues = err instanceof LegacyWorkflowConversionError
+                ? err.issues
+                : [issueFromError('MIGRATION_COMMIT_FAILED', identity.path, err)];
+            reports.push({
+                path: identity.path,
+                workflowId: identity.workflowId,
+                contentHash: identity.contentHash,
+                targetWorkflowId,
+                status: 'failed',
+                issues,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    const ok = reports.every((report) => report.status === 'convertible' ||
+        report.status === 'update_required' ||
+        report.status === 'pending' ||
+        report.status === 'migrated' ||
+        report.status === 'committed');
+    return { reports, ok };
+}
+export async function cmdWorkflowMigration(args) {
+    const options = parseWorkflowMigrationCliOptions(args);
+    const result = await runWorkflowMigrationCli(options);
+    if (options.json)
+        console.log(JSON.stringify(result, null, 2));
+    else
+        printHumanReport(result.reports);
+    if (!result.ok)
+        process.exitCode = 1;
+}
+//# sourceMappingURL=workflow-migration.js.map

package/dist/cli/workflow-migration.js.map

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

package/dist/cli/workflow-run-archive.d.ts

@@ -0,0 +1,29 @@
+/** `botmux template archive-runs`: private, content-addressed v2 run archive. */
+export interface WorkflowRunArchiveCliOptions {
+    mode: 'plan' | 'commit' | 'verify' | 'retire';
+    json: boolean;
+    runsDir: string;
+    archiveBaseDir: string;
+    archiveRef?: string;
+    daemonStoppedAcknowledged: boolean;
+}
+export interface WorkflowRunArchiveCliReport {
+    mode: WorkflowRunArchiveCliOptions['mode'];
+    archiveId?: string;
+    runCount: number;
+    residualCount: number;
+    fileCount: number;
+    totalBytes: number;
+    warningCodes: string[];
+    archiveDir?: string;
+    reused?: boolean;
+    staticVerified?: boolean;
+    sourceVerified?: boolean;
+    retirementStatus?: 'retired' | 'already_retired' | 'nothing_to_retire';
+    quarantineDir?: string;
+    receiptPath?: string;
+}
+export declare function parseWorkflowRunArchiveCliOptions(args: string[], dataDir?: string, env?: NodeJS.ProcessEnv): WorkflowRunArchiveCliOptions;
+export declare function runWorkflowRunArchiveCli(options: WorkflowRunArchiveCliOptions): Promise<WorkflowRunArchiveCliReport>;
+export declare function cmdWorkflowRunArchive(args: string[]): Promise<void>;
+//# sourceMappingURL=workflow-run-archive.d.ts.map

package/dist/cli/workflow-run-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-run-archive.d.ts","sourceRoot":"","sources":["../../src/cli/workflow-run-archive.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAmBjF,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC9C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,MAA+B,EACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,4BAA4B,CA8C9B;AA8CD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAsDtC;AA2BD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE"}

package/dist/cli/workflow-run-archive.js

@@ -0,0 +1,183 @@
+/** `botmux template archive-runs`: private, content-addressed v2 run archive. */
+import { lstatSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { resolveBotmuxDataDir } from '../core/data-dir.js';
+import { commitV2RunArchive, planV2RunArchive, retireV2RunSource, verifyV2RunArchive, } from '../workflows/migration/v2-run-archive.js';
+import { archiveDirectoryName, v2RunArchiveId, } from '../workflows/migration/v2-run-archive-schema.js';
+const VALUE_FLAGS = new Set(['--verify', '--retire', '--runs-dir', '--archive-dir']);
+const BOOLEAN_FLAGS = new Set(['--commit', '--json', '--ack-daemon-stopped']);
+export function parseWorkflowRunArchiveCliOptions(args, dataDir = resolveBotmuxDataDir(), env = process.env) {
+    const values = new Map();
+    const booleans = new Set();
+    for (let index = 0; index < args.length; index++) {
+        const token = args[index];
+        if (!token.startsWith('--'))
+            throw new Error(`unexpected positional argument ${JSON.stringify(token)}`);
+        const equals = token.indexOf('=');
+        const flag = equals >= 0 ? token.slice(0, equals) : token;
+        if (BOOLEAN_FLAGS.has(flag)) {
+            if (equals >= 0)
+                throw new Error(`${flag} does not accept a value`);
+            if (booleans.has(flag))
+                throw new Error(`duplicate flag ${flag}`);
+            booleans.add(flag);
+            continue;
+        }
+        if (!VALUE_FLAGS.has(flag))
+            throw new Error(`unknown flag ${flag}`);
+        if (values.has(flag))
+            throw new Error(`duplicate flag ${flag}`);
+        const value = equals >= 0 ? token.slice(equals + 1) : args[++index];
+        if (!value || value.startsWith('--'))
+            throw new Error(`${flag} requires a value`);
+        values.set(flag, value);
+    }
+    const commit = booleans.has('--commit');
+    const verifyRef = values.get('--verify');
+    const retireRef = values.get('--retire');
+    const selectedModes = Number(commit) + Number(verifyRef !== undefined) + Number(retireRef !== undefined);
+    if (selectedModes > 1)
+        throw new Error('--commit, --verify, and --retire are mutually exclusive');
+    const archiveRef = verifyRef ?? retireRef;
+    const daemonStoppedAcknowledged = booleans.has('--ack-daemon-stopped');
+    if (daemonStoppedAcknowledged && !retireRef) {
+        throw new Error('--ack-daemon-stopped is only valid with --retire');
+    }
+    const runsDir = resolve(values.get('--runs-dir') ??
+        env.BOTMUX_WORKFLOW_RUNS_DIR ??
+        join(dataDir, 'workflow-runs'));
+    const archiveBaseDir = resolve(values.get('--archive-dir') ?? join(dataDir, 'workflow-archives', 'v2-runs'));
+    return {
+        mode: retireRef ? 'retire' : verifyRef ? 'verify' : commit ? 'commit' : 'plan',
+        json: booleans.has('--json'),
+        runsDir,
+        archiveBaseDir,
+        daemonStoppedAcknowledged,
+        ...(archiveRef ? { archiveRef } : {}),
+    };
+}
+function resolveArchiveRef(baseDir, ref) {
+    if (isAbsolute(ref) || ref.includes('/') || ref.includes('\\'))
+        return resolve(ref);
+    if (/^sha256:[0-9a-f]{64}$/.test(ref))
+        return join(baseDir, archiveDirectoryName(ref));
+    if (/^sha256-[0-9a-f]{64}$/.test(ref))
+        return join(baseDir, ref);
+    throw new Error('--verify/--retire expects an absolute/relative archive path or sha256 archive id');
+}
+function warningCodes(plan) {
+    return [...new Set(plan.content.runs.flatMap((run) => run.warnings.map((warning) => warning.code)))].sort();
+}
+function reportFromPlan(mode, plan) {
+    return {
+        mode,
+        archiveId: v2RunArchiveId(plan.content),
+        runCount: plan.runCount,
+        residualCount: plan.residualCount,
+        fileCount: plan.content.payloadFiles.length,
+        totalBytes: plan.totalPayloadBytes,
+        warningCodes: warningCodes(plan),
+    };
+}
+function reportFromVerification(verification) {
+    const manifest = verification.manifest;
+    return {
+        mode: 'verify',
+        archiveId: manifest.archiveId,
+        runCount: manifest.content.runs.length,
+        residualCount: manifest.content.residuals.length,
+        fileCount: verification.fileCount,
+        totalBytes: verification.totalBytes,
+        warningCodes: [...new Set(manifest.content.runs.flatMap((run) => run.warnings.map((warning) => warning.code)))].sort(),
+        archiveDir: verification.archiveDir,
+        staticVerified: verification.staticVerified,
+        sourceVerified: verification.sourceVerified,
+    };
+}
+export async function runWorkflowRunArchiveCli(options) {
+    if (options.mode === 'verify') {
+        let sourceRunsDir;
+        try {
+            // ENOENT after a successful retirement is the one legitimate reason to
+            // perform static-only verification. Existing but unreadable/unsafe or
+            // changed sources must still fail loudly in the source-aware verifier.
+            lstatSync(options.runsDir);
+            sourceRunsDir = options.runsDir;
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+        return reportFromVerification(await verifyV2RunArchive({
+            archiveDir: resolveArchiveRef(options.archiveBaseDir, options.archiveRef),
+            ...(sourceRunsDir ? { sourceRunsDir } : {}),
+        }));
+    }
+    if (options.mode === 'retire') {
+        const retired = await retireV2RunSource({
+            runsDir: options.runsDir,
+            archiveBaseDir: options.archiveBaseDir,
+            archiveDir: resolveArchiveRef(options.archiveBaseDir, options.archiveRef),
+            daemonStoppedAcknowledged: options.daemonStoppedAcknowledged,
+        });
+        if (retired.status === 'nothing_to_retire') {
+            return {
+                mode: 'retire',
+                runCount: 0,
+                residualCount: 0,
+                fileCount: 0,
+                totalBytes: 0,
+                warningCodes: [],
+                retirementStatus: retired.status,
+            };
+        }
+        return {
+            ...reportFromVerification(retired.verification),
+            mode: 'retire',
+            retirementStatus: retired.status,
+            quarantineDir: retired.quarantineDir,
+            receiptPath: retired.receiptPath,
+        };
+    }
+    const plan = await planV2RunArchive({ runsDir: options.runsDir });
+    if (options.mode === 'plan')
+        return reportFromPlan('plan', plan);
+    const committed = await commitV2RunArchive({
+        runsDir: options.runsDir,
+        archiveBaseDir: options.archiveBaseDir,
+    });
+    return {
+        ...reportFromVerification(committed.verification),
+        mode: 'commit',
+        reused: committed.reused,
+    };
+}
+function printHuman(report) {
+    const mib = (report.totalBytes / (1024 * 1024)).toFixed(2);
+    console.log(`[${report.mode}] archive=${report.archiveId ?? 'none'} runs=${report.runCount} ` +
+        `residuals=${report.residualCount} files=${report.fileCount} bytes=${report.totalBytes} (${mib} MiB)`);
+    if (report.warningCodes.length > 0) {
+        console.log(`warnings=${report.warningCodes.join(',')}`);
+    }
+    if (report.mode === 'plan') {
+        console.log('dry-run only; add --commit to publish the private archive');
+    }
+    else if (report.mode === 'retire') {
+        console.log(`retirementStatus=${report.retirementStatus}` +
+            (report.quarantineDir ? ` quarantineDir=${report.quarantineDir}` : '') +
+            (report.receiptPath ? ` receiptPath=${report.receiptPath}` : ''));
+    }
+    else {
+        console.log(`staticVerified=${report.staticVerified === true} sourceVerified=${report.sourceVerified === true}` +
+            (report.reused !== undefined ? ` reused=${report.reused}` : ''));
+    }
+}
+export async function cmdWorkflowRunArchive(args) {
+    const options = parseWorkflowRunArchiveCliOptions(args);
+    const report = await runWorkflowRunArchiveCli(options);
+    if (options.json)
+        console.log(JSON.stringify(report, null, 2));
+    else
+        printHuman(report);
+}
+//# sourceMappingURL=workflow-run-archive.js.map

package/dist/cli/workflow-run-archive.js.map

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

package/dist/cli/workflow.d.ts

@@ -1,13 +1,8 @@
+/** Workflow command dispatch after the v2 runtime retirement. */
+export declare function cmdWorkflow(sub: string, rest: string[]): Promise<void>;
 /**
- * `botmux workflow <sub>` CLI subcommand handlers.
- *
- * v0 offline-runner: load a workflow definition, drive `runLoop` against
- * a stub spawn, and print events to stdout.  No daemon / no IM
- * integration — used for smoke-testing the orchestrator end-to-end.
- *
- * The on-daemon path (with lark fan-out, real worker spawn) lives in
- * the `/workflow run` Skill (Slice E-2).  This module deliberately
- * keeps the CLI route the simplest possible smoke test.
+ * `template` is now an offline retirement namespace only. It never reads or
+ * drives legacy run state except through the explicit migration/archive tools.
  */
-export declare function cmdWorkflow(sub: string, rest: string[]): Promise<void>;
+export declare function cmdTemplate(sub: string, rest: string[]): Promise<void>;
 //# sourceMappingURL=workflow.d.ts.map

package/dist/cli/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/cli/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmEH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC5E"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/cli/workflow.ts"],"names":[],"mappings":"AAAA,iEAAiE;AA4BjE,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5E;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5E"}