epismo 0.20.0 → 1.0.2

package/dist/program.js

@@ -1,161 +1,20 @@
-import { Argument, Command, Option } from "commander";
+import { Command, Option } from "commander";
 import { clearWorkspace, getCurrentWorkspace, listAvailableWorkspaces, login, logout, useWorkspace, whoami } from "./auth.js";
 import { resolveExecutionContext } from "./context.js";
-import { mergeDefined, parseJsonArrayOption, parseJsonObjectOption, parseOptionalPositiveInteger, parseStringArrayInput, readJsonObjectInput } from "./input.js";
+import { mergeDefined, parseStringArrayInput, readJsonObjectInput } from "./input.js";
 import { printJson, printWarning } from "./output.js";
-import { applyTracks, createTrack, deleteTrack, getTrack, reviewTracks, searchTracks, updateTrack } from "./tracks.js";
-import { createLogForTrack, deleteLog, listLogs } from "./logs.js";
-import { createPack, deletePack, getPack, likePack, ratePack, runPack, searchPacks, updatePack } from "./packs.js";
-import { createSuggestion, getSuggestion, listSuggestions, resolveSuggestion, updateSuggestion } from "./suggestions.js";
-import { deleteAlias, getAlias, listAliases, upsertAlias } from "./aliases.js";
 import { creditBalance, creditCheckout } from "./credits.js";
 import { CliError } from "./errors.js";
-import { addAgents, listAgents, removeAgents } from "./agents.js";
 import { createWorkspace, deleteWorkspaceMembers, getWorkspaceCheckout, listWorkspaceMembers, updateWorkspace, upsertWorkspaceMembers } from "./workspaces.js";
 import { addProjectMembers, createProject, deleteProjectMembers, listProjectMembers, listProjects, updateProject } from "./projects.js";
 import { createToken } from "./token.js";
-const TRACK_TYPES = ["task", "goal"];
-const LOG_ORDERS = ["asc", "desc"];
-const PACK_TYPES = ["workflow", "context"];
-const ALIAS_NAMESPACES = ["personal", "workspace"];
-const PACK_VISIBILITIES = ["public", "private"];
-const SUGGESTION_STATUSES = ["open", "applied", "declined", "archived"];
+import { registerPlaybookProgram } from "./playbook-program.js";
 // centralize warning codes so wording is consistent everywhere
 const WARNING_ENV_TOKEN_WORKSPACE_IGNORED = "EPISMO_TOKEN_WORKSPACE_IGNORED";
-function collectOption(value, previous = []) {
-    return [...previous, value];
-}
 async function resolveInput(options, overrides) {
     const base = await readJsonObjectInput(options.input);
     return mergeDefined(base, overrides);
 }
-function getExplicitOptionOverride(command, optionName, value) {
-    const source = command.getOptionValueSource(optionName);
-    if (source === undefined || source === "default") {
-        return undefined;
-    }
-    return value;
-}
-function buildScopeOption(command, options) {
-    const personalExplicit = getExplicitOptionOverride(command, "personal", options.personal);
-    const projectsExplicit = getExplicitOptionOverride(command, "projects", parseStringArrayInput(options.projects, "--projects"));
-    if (personalExplicit !== undefined && projectsExplicit !== undefined) {
-        throw new CliError({
-            code: "INVALID_INPUT",
-            message: "--personal and --projects cannot be combined."
-        });
-    }
-    if (personalExplicit === true) {
-        return { type: "personal" };
-    }
-    if (projectsExplicit !== undefined) {
-        const ids = projectsExplicit;
-        if (ids.length === 0) {
-            throw new CliError({
-                code: "INVALID_INPUT",
-                message: "--projects requires at least one project id."
-            });
-        }
-        return { type: "projects", ids };
-    }
-    return undefined;
-}
-function buildSharedWithOption(command, options) {
-    const values = getExplicitOptionOverride(command, "shareWith", parseStringArrayInput(options.shareWith, "--share-with"));
-    if (values === undefined) {
-        return undefined;
-    }
-    const emails = [];
-    const userIds = [];
-    for (const value of values) {
-        if (value.includes("@")) {
-            emails.push(value);
-        }
-        else {
-            userIds.push(value);
-        }
-    }
-    const result = {};
-    if (userIds.length > 0) {
-        result.userIds = userIds;
-    }
-    if (emails.length > 0) {
-        result.emails = emails;
-    }
-    return result;
-}
-function buildSearchScopes(command, options) {
-    const personalExplicit = getExplicitOptionOverride(command, "personal", options.personal);
-    const projectsExplicit = getExplicitOptionOverride(command, "projects", parseStringArrayInput(options.projects, "--projects"));
-    const scopes = [];
-    if (personalExplicit === true) {
-        scopes.push({ type: "personal" });
-    }
-    if (projectsExplicit !== undefined) {
-        const ids = projectsExplicit;
-        if (ids.length === 0) {
-            throw new CliError({
-                code: "INVALID_INPUT",
-                message: "--projects requires at least one project id."
-            });
-        }
-        scopes.push({ type: "projects", ids });
-    }
-    return scopes.length > 0 ? scopes : undefined;
-}
-// TODO(remove-legacy-search-targets): delete this helper and the hidden
-// `--project-ids` / `--self` options once users have migrated to `--personal`
-// / `--projects`.
-function buildLegacySearchTargets(command, options) {
-    const projectIdsExplicit = getExplicitOptionOverride(command, "projectIds", parseStringArrayInput(options.projectIds, "--project-ids"));
-    const selfExplicit = getExplicitOptionOverride(command, "self", parseOptionalBooleanText(options.self, "--self"));
-    const targets = {};
-    if (projectIdsExplicit !== undefined) {
-        targets.projectIds = projectIdsExplicit;
-    }
-    if (selfExplicit !== undefined) {
-        targets.self = selfExplicit;
-    }
-    return Object.keys(targets).length > 0 ? targets : undefined;
-}
-// TODO(remove-legacy-search-targets): delete with the helpers above.
-function parseOptionalBooleanText(value, optionName) {
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value === "boolean") {
-        return value;
-    }
-    if (typeof value === "string") {
-        const normalized = value.trim().toLowerCase();
-        if (normalized === "true")
-            return true;
-        if (normalized === "false")
-            return false;
-    }
-    throw new CliError({
-        code: "INVALID_INPUT",
-        message: `Invalid ${optionName}: expected true or false.`
-    });
-}
-// TODO(remove-legacy-search-targets): inline back into action handlers
-// once legacy `--project-ids` / `--self` are removed.
-function buildSearchSelection(command, options) {
-    const scopes = buildSearchScopes(command, options);
-    const targets = buildLegacySearchTargets(command, options);
-    if (scopes !== undefined && targets !== undefined) {
-        throw new CliError({
-            code: "INVALID_INPUT",
-            message: "--personal/--projects cannot be combined with the legacy --self/--project-ids flags."
-        });
-    }
-    const result = {};
-    if (scopes !== undefined)
-        result.scopes = scopes;
-    if (targets !== undefined)
-        result.targets = targets;
-    return result;
-}
 async function resolveContext() {
     const context = await resolveExecutionContext();
     if (context.warning) {
@@ -169,7 +28,7 @@ export function buildProgram(version) {
     const program = new Command();
     program
         .name("epismo")
-        .description("Epismo CLI")
+        .description("Agent-first CLI for discovering, authoring, and coordinating reusable AI Playbooks.")
         .version(version)
         .showHelpAfterError(false)
         .showSuggestionAfterError(false)
@@ -187,15 +46,7 @@ Workspace resolution:
 Examples:
   epismo login
   epismo whoami
-  epismo workspace list
-  epismo alias list
-  epismo track search --query "bug"
-  epismo pack search --query "meeting notes"
-  epismo suggestion list --owner --status open
-  epismo suggestion create @market-research --title "Add review step" --content "Add a final human review."
-  epismo pack get <id> --block-id b001
-  epismo pack get @myproject
-  epismo pack get @handle/myproject`);
+  epismo workspace list`);
     program
         .command("login")
         .description("log in through a browser, or use email with automatic SSO discovery")
@@ -329,7 +180,7 @@ Examples:
         .option("--input <input>", "JSON object, @file, or - for stdin")
         .option("--name <name>", "updated workspace name")
         .action(async (workspaceId, options) => {
-        const payload = await resolveInput({ input: options.input }, { name: options.name });
+        const payload = await resolveInput(options, { name: options.name });
         const context = await resolveContext();
         printJson(await updateWorkspace(context, workspaceId, payload));
     });
@@ -456,646 +307,6 @@ Examples:
         const context = await resolveContext();
         printJson(await deleteProjectMembers(context, options.projectId, userIds));
     });
-    const track = program.command("track").description("manage project tracks (tasks and goals)");
-    track
-        .command("create")
-        .description("create a new project track (task or goal)")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .addOption(new Option("--type <type>", "task | goal").choices(TRACK_TYPES))
-        .option("--title <title>", "title")
-        .option("--content <content>", "markdown content")
-        .option("--personal", "keep private to the current user (mutually exclusive with --projects)")
-        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
-        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
-        .option("--sources <sources>", 'JSON array or comma-separated source references: bare entry_ids, or pack origins as "workflow:<id>" / "context:<id>"')
-        .option("--task <task>", 'task-specific fields as JSON object e.g. \'{"status":"todo","dueDate":"2025-12-31"}\'')
-        .option("--goal <goal>", 'goal-specific fields as JSON object e.g. \'{"status":"on_track","dueDate":"2025-12-31"}\'')
-        .action(async (options, command) => {
-        const payload = await resolveInput(options, {
-            type: options.type,
-            title: options.title,
-            content: options.content,
-            scope: buildScopeOption(command, options),
-            sharedWith: buildSharedWithOption(command, options),
-            sources: parseStringArrayInput(options.sources, "--sources"),
-            task: parseJsonObjectOption(options.task, "--task"),
-            goal: parseJsonObjectOption(options.goal, "--goal")
-        });
-        const context = await resolveContext();
-        printJson(await createTrack(context, payload));
-    });
-    track.commands.at(-1)?.addHelpText("after", `
-Notes:
-  Use --task or --goal to pass type-specific fields.
-
-Examples:
-  epismo track create --type task --title "Fix bug" --content "Details..."
-  epismo track create --input @task.json
-  epismo track create --type goal --title "Launch" --goal '{"status":"on_track"}'`);
-    track
-        .command("update")
-        .description("update an existing project track (PATCH — omitted fields are unchanged)")
-        .argument("<reference>", "task/goal UUID or URL containing it")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--title <title>", "updated title")
-        .option("--content <content>", "updated markdown content")
-        .option("--personal", "set scope to personal (mutually exclusive with --projects)")
-        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
-        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
-        .option("--sources <sources>", 'JSON array or comma-separated source references: bare entry_ids, or pack origins as "workflow:<id>" / "context:<id>"')
-        .option("--task <task>", 'task-specific fields as partial JSON object e.g. \'{"status":"done"}\'')
-        .option("--goal <goal>", "goal-specific fields as partial JSON object e.g. '{\"progress\":50}'")
-        .option("--note <note>", 'optional status note as JSON, e.g. \'{"kind":"review","content":"Tests passed"}\'')
-        .action(async (reference, options, command) => {
-        const payload = await resolveInput(options, {
-            title: options.title,
-            content: options.content,
-            scope: buildScopeOption(command, options),
-            sharedWith: buildSharedWithOption(command, options),
-            sources: parseStringArrayInput(options.sources, "--sources"),
-            task: parseJsonObjectOption(options.task, "--task"),
-            goal: parseJsonObjectOption(options.goal, "--goal"),
-            note: parseJsonObjectOption(options.note, "--note")
-        });
-        const context = await resolveContext();
-        printJson(await updateTrack(context, reference, payload));
-    });
-    track.commands.at(-1)?.addHelpText("after", `
-Notes:
-  Omitted fields keep their existing value.
-  Completing a task or completing/postponing a goal may return review.recommendations
-  for an outcome log or a detailed review.
-
-Examples:
-  epismo track update <track-reference> --title "Updated title"
-  epismo track update <track-reference> --task '{"status":"done"}'
-  epismo track update <track-reference> --task '{"status":"done"}' --note '{"kind":"review","content":"Tests passed"}'
-  epismo track update <track-reference> --goal '{"progress":75}'`);
-    track
-        .command("get")
-        .description("fetch one project track")
-        .argument("<reference>", "task/goal UUID or URL containing it")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .action(async (reference) => {
-        const context = await resolveContext();
-        printJson(await getTrack(context, reference));
-    });
-    track.commands.at(-1)?.addHelpText("after", `
-Example:
-  epismo track get <track-reference>`);
-    track
-        .command("review")
-        .description("generate a detailed review for one or more task/goal tracks")
-        .argument("<references...>", "one or more task/goal UUIDs or URLs containing them")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--instruction <instruction>", "optional instruction to steer the review")
-        .action(async (references, options) => {
-        const payload = await resolveInput(options, {
-            targetIds: references,
-            instruction: options.instruction
-        });
-        const context = await resolveContext();
-        printJson(await reviewTracks(context, payload));
-    });
-    track.commands.at(-1)?.addHelpText("after", `
-Notes:
-  Review output is displayed only; it does not create or update packs automatically.
-
-Example:
-  epismo track review <track-reference>
-  epismo track review <track-reference> <related-track-reference>`);
-    track
-        .command("search")
-        .description("search project tracks")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .addOption(new Option("--type <type>", "task | goal").choices(TRACK_TYPES))
-        .option("--query <query>", "free-text query")
-        .addOption(new Option("--search-mode <mode>", "keyword (default) or semantic; semantic blends keyword and vector relevance").choices(["keyword", "semantic"]))
-        .option("--page <page>", "1-based page number")
-        .option("--personal", "search personal/private-to-user items")
-        .option("--projects <projects>", "JSON array or comma-separated project ids to search")
-        // TODO(remove-legacy-search-targets): drop these two hidden options.
-        .addOption(new Option("--project-ids <projectIds>", "deprecated; use --projects").hideHelp())
-        .addOption(new Option("--self <self>", "deprecated; use --personal").hideHelp())
-        .option("--filter <filter>", 'filter as JSON object; each value is an array of accepted values e.g. \'{"status":["todo","in_progress"]}\' (use --input @file.json for complex filters)')
-        .action(async (options, command) => {
-        const selection = buildSearchSelection(command, options);
-        const payload = await resolveInput(options, {
-            type: getExplicitOptionOverride(command, "type", options.type),
-            query: getExplicitOptionOverride(command, "query", options.query),
-            searchMode: getExplicitOptionOverride(command, "searchMode", options.searchMode),
-            page: getExplicitOptionOverride(command, "page", parseOptionalPositiveInteger(options.page, "--page")),
-            scopes: selection.scopes,
-            targets: selection.targets,
-            filter: getExplicitOptionOverride(command, "filter", parseJsonObjectOption(options.filter, "--filter"))
-        });
-        const context = await resolveContext();
-        printJson(await searchTracks(context, payload));
-    });
-    track.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo track search --query "bug"
-  epismo track search --type task --query "bug"
-  epismo track search --query "auth rollout plan" --search-mode semantic
-  epismo track search --type task --projects proj1
-  epismo track search --type task --personal --projects proj1
-  epismo track search --type task --filter '{"status":["todo"]}'
-  epismo track search --type goal --query "roadmap"`);
-    track
-        .command("delete")
-        .description("delete one project track")
-        .argument("<reference>", "task/goal UUID or URL containing it")
-        .action(async (reference) => {
-        const context = await resolveContext();
-        printJson(await deleteTrack(context, reference));
-    });
-    track.commands.at(-1)?.addHelpText("after", `
-Example:
-  epismo track delete <track-reference>`);
-    track
-        .command("apply")
-        .description("create, update, and delete multiple tracks in a single request")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--personal", "set scope to personal (mutually exclusive with --projects)")
-        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
-        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
-        .action(async (options, command) => {
-        const payload = await resolveInput(options, {
-            scope: buildScopeOption(command, options),
-            sharedWith: buildSharedWithOption(command, options)
-        });
-        const context = await resolveContext();
-        printJson(await applyTracks(context, payload));
-    });
-    track.commands.at(-1)?.addHelpText("after", `
-Notes:
-  upserts: use a non-UUID string as id (e.g. "t001") to create a new track, or a UUID to update an existing one.
-  Labels in task.parentId, task.dependsOn, and task.goalId are resolved by the server, so you can wire
-  up dependencies between new entries in the same request.
-  deletes: provide UUIDs of tracks to delete.
-
-Examples:
-  epismo track apply --input @batch.json
-  epismo track apply --input '{"upserts":[{"id":"t001","title":"Task A","task":{"status":"todo"}},{"id":"t002","title":"Task B","task":{"status":"todo","dependsOn":["t001"]}}]}'`);
-    const log = program.command("log").description("manage track logs");
-    log.command("create")
-        .description("append a log/comment to a track")
-        .argument("<reference>", "task/goal UUID or URL containing it")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--kind <kind>", "comment | update | review (default: comment)")
-        .option("--content <content>", "log content")
-        .option("--metadata <metadata>", "machine-readable metadata as JSON object")
-        .option("--idempotency-key <idempotencyKey>", "optional UUID for idempotent retry")
-        .action(async (trackId, options, command) => {
-        const payload = await resolveInput(options, {
-            kind: getExplicitOptionOverride(command, "kind", options.kind),
-            content: getExplicitOptionOverride(command, "content", options.content),
-            metadata: getExplicitOptionOverride(command, "metadata", parseJsonObjectOption(options.metadata, "--metadata")),
-            idempotencyKey: getExplicitOptionOverride(command, "idempotencyKey", options.idempotencyKey)
-        });
-        const context = await resolveContext();
-        printJson(await createLogForTrack(context, trackId, payload));
-    });
-    log.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo log create <track-reference> --content "Evaluator failed because tests are missing."
-  epismo log create <track-reference> --kind review --content "Tests failed" --metadata '{"verdict":"fail"}'`);
-    log.command("list")
-        .description("list logs — for one track, or across every track you can see")
-        .argument("[reference]", "task/goal UUID or URL containing it (omit for the cross-track activity feed)")
-        .option("--author-id <userId>", "narrow to logs authored by this user id")
-        .addOption(new Option("--order <order>", "desc = newest first (default), asc = oldest first").choices(LOG_ORDERS))
-        .option("--cursor <logId>", "continue past this log id in the chosen order (nextCursor)")
-        .action(async (trackId, options) => {
-        const context = await resolveContext();
-        printJson(await listLogs(context, trackId, {
-            authorId: options.authorId,
-            order: options.order,
-            cursor: options.cursor
-        }));
-    });
-    log.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo log list <track-reference>                       # newest logs first for one track
-  epismo log list <track-reference> --cursor <logId>      # older history
-  epismo log list <track-reference> --order asc           # chronological from the start
-  epismo log list                                          # every log you can see, newest first
-  epismo log list --author-id <userId>                     # only logs one user wrote`);
-    log.command("delete")
-        .description("delete one log")
-        .argument("<logId>", "log id")
-        .action(async (logId) => {
-        const context = await resolveContext();
-        printJson(await deleteLog(context, logId));
-    });
-    log.commands.at(-1)?.addHelpText("after", `
-Example:
-  epismo log delete <logId>`);
-    const pack = program.command("pack").description("manage agent packs (workflows and contexts)");
-    pack.command("create")
-        .description("create a new agent pack")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .addOption(new Option("--type <type>", "workflow | context (required unless provided in --input)").choices(PACK_TYPES))
-        .option("--title <title>", "title")
-        .option("--content <content>", "markdown content")
-        .option("--category <category>", "pack category")
-        .addOption(new Option("--visibility <visibility>", "public | private").choices(PACK_VISIBILITIES))
-        .option("--personal", "keep private to the current user (mutually exclusive with --projects)")
-        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
-        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
-        .option("--steps <steps>", "workflow steps as JSON array (use --input @file.json for complex payloads)")
-        .option("--blocks <blocks>", "context blocks as JSON array (for type=context; use --input @file.json for complex payloads)")
-        .action(async (options, command) => {
-        const payload = await resolveInput(options, {
-            type: options.type,
-            title: options.title,
-            content: options.content,
-            category: options.category,
-            visibility: options.visibility,
-            scope: buildScopeOption(command, options),
-            sharedWith: buildSharedWithOption(command, options),
-            steps: parseJsonArrayOption(options.steps, "--steps"),
-            blocks: parseJsonArrayOption(options.blocks, "--blocks")
-        });
-        if (payload.type !== "workflow" && payload.type !== "context") {
-            throw new CliError({
-                code: "INVALID_INPUT",
-                message: "Pack type is required.",
-                hint: 'Pass --type workflow|context or include {"type":"workflow"} / {"type":"context"} in --input.'
-            });
-        }
-        const context = await resolveContext();
-        printJson(await createPack(context, payload));
-    });
-    pack.commands.at(-1)?.addHelpText("after", `
-Notes:
-  type is required for pack create. Pass --type or include it in --input.
-
-Examples:
-  epismo pack create --type workflow --title "My workflow" --input @workflow.json
-  epismo pack create --type workflow --title "My workflow" --steps '[{"title":"Step 1","content":"..."}]'
-  epismo pack create --type context --title "My context" --input @context.json
-  epismo pack create --type context --title "My context" --blocks '[{"title":"Block 1","content":"..."}]'`);
-    pack.command("update")
-        .description("update an existing agent pack (PATCH semantics — omitted fields are unchanged)")
-        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--title <title>", "updated title")
-        .option("--content <content>", "updated markdown content")
-        .option("--category <category>", "updated pack category")
-        .addOption(new Option("--visibility <visibility>", "public | private").choices(PACK_VISIBILITIES))
-        .option("--personal", "set scope to personal (mutually exclusive with --projects)")
-        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
-        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
-        .option("--steps <steps>", 'step operations as JSON array with op field: [{"op":"add","title":"...","beforeId":"s002"},{"op":"move","id":"s003","afterId":"s001"},{"op":"update","id":"s001","content":"..."},{"op":"remove","id":"s002"}]')
-        .option("--blocks <blocks>", 'block operations as JSON array with op field: [{"op":"add","title":"...","beforeId":"b002"},{"op":"move","id":"b003","afterId":"b001"},{"op":"update","id":"b001","content":"..."},{"op":"remove","id":"b002"}]')
-        .action(async (reference, options, command) => {
-        const payload = await resolveInput(options, {
-            title: options.title,
-            content: options.content,
-            category: options.category,
-            visibility: options.visibility,
-            scope: buildScopeOption(command, options),
-            sharedWith: buildSharedWithOption(command, options),
-            steps: parseJsonArrayOption(options.steps, "--steps"),
-            blocks: parseJsonArrayOption(options.blocks, "--blocks")
-        });
-        const context = await resolveContext();
-        printJson(await updatePack(context, reference, payload));
-    });
-    pack.commands.at(-1)?.addHelpText("after", `
-Notes:
-  Omitted fields keep their existing value.
-  steps/blocks use operation objects with an "op" field (add | update | move | remove).
-  add/move accept beforeId or afterId. Workflow move keeps dependsOn unchanged.
-  Omitting steps/blocks keeps them unchanged. Passing an empty array [] is a no-op.
-  To remove all items, send a remove op for each existing item ID.
-
-Examples:
-  epismo pack update <id> --category ""
-  epismo pack update @myproject --visibility public
-  epismo pack update <id> --visibility public --category productivity
-  epismo pack update <id> --steps '[{"op":"move","id":"s003","afterId":"s001"}]'
-  epismo pack update <id> --blocks '[{"op":"add","title":"New Block","content":"..."}]'
-  epismo pack update <id> --blocks '[{"op":"move","id":"b003","beforeId":"b001"}]'
-  epismo pack update <id> --blocks '[{"op":"update","id":"b001","content":"updated..."}]'
-  epismo pack update <id> --blocks '[{"op":"remove","id":"b002"}]'
-  epismo pack update <id> --input @changes.json`);
-    pack.command("run")
-        .description("materialize a workflow pack into a track (a root goal plus one task per step); fetch the run later with track search by goal id")
-        .argument("<reference>", "workflow pack reference: id, alias, share URL, or hub URL")
-        .option("--title <title>", "objective for the run's root goal (defaults to the pack title)")
-        .option("--content <content>", "root goal content in Markdown (defaults to the pack content)")
-        .option("--due-date <date>", "YYYY-MM-DD absolute due date for the root goal")
-        .option("--context <reference>", "context pack reference (id, alias, share URL, or hub URL) to record as a source on the goal; comma-separated or repeatable", collectOption)
-        .option("--assignee <token=id>", "map a pack assignee token to a track assignee id, e.g. human=<user-id>; comma-separated or repeatable", collectOption)
-        .option("--personal", "keep created tracks private to the current user (mutually exclusive with --projects)")
-        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
-        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
-        .action(async (reference, options, command) => {
-        const body = {
-            reference,
-            title: options.title,
-            content: options.content,
-            goalDueDate: options.dueDate,
-            context: options.context,
-            assignees: options.assignee,
-            scope: buildScopeOption(command, options),
-            sharedWith: buildSharedWithOption(command, options)
-        };
-        const context = await resolveContext();
-        printJson(await runPack(context, body));
-    });
-    pack.commands.at(-1)?.addHelpText("after", `
-Notes:
-  Creates the track immediately. Review the returned warnings; delete and re-run to fix mistakes.
-  --assignee maps pack tokens to track assignees; map human to a user id (agent ids resolve as-is).
-
-Examples:
-  epismo pack run @small-feature-ship
-  epismo pack run @small-feature-ship --assignee human=<user-id>
-  epismo pack run @small-feature-ship --title "Ship CSV export" --projects <project-id> --context <context-pack-id>`);
-    pack.command("get")
-        .description("fetch one agent pack")
-        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--full", "include nested item content")
-        .option("--share-url", "create or return a share URL for this pack")
-        .option("--block-id <blockId>", "context block id to extract; comma-separated or repeatable (type=context only)", collectOption)
-        .option("--step-id <stepId>", "workflow step id to extract; comma-separated or repeatable (type=workflow only)", collectOption)
-        .addOption(new Option("--namespace <namespace>", "resolve a bare/`@alias` reference in personal or workspace (omit to try personal first, then workspace)").choices(ALIAS_NAMESPACES))
-        .action(async (reference, options) => {
-        const payload = await resolveInput(options, {
-            full: options.full ? true : undefined
-        });
-        const context = await resolveContext();
-        printJson(await getPack(context, reference, payload, {
-            blockIds: options.blockId,
-            stepIds: options.stepId,
-            namespace: options.namespace,
-            shareUrl: options.shareUrl
-        }));
-    });
-    pack.commands.at(-1)?.addHelpText("after", `
-	Examples:
-	  epismo pack get <id>
-	  epismo pack get @myproject
-	  epismo pack get @handle/myproject
-	  epismo pack get https://epismo.ai/share/<token>
-	  epismo pack get https://epismo.ai/hub/workflows/<id>
-	  epismo pack get <id> --share-url
-	  epismo pack get <id> --full
-	  epismo pack get <id> --block-id b001
-	  epismo pack get <id> --block-id b001 --block-id b002
-	  epismo pack get <id> --step-id s001,s002`);
-    pack.command("search")
-        .description("search agent packs")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .addOption(new Option("--type <type>", "workflow | context").choices(PACK_TYPES))
-        .option("--query <query>", "free-text query")
-        .addOption(new Option("--search-mode <mode>", "keyword (default) or semantic; semantic blends keyword and vector relevance").choices(["keyword", "semantic"]))
-        .option("--page <page>", "1-based page number")
-        .option("--personal", "search personal/private-to-user packs")
-        .option("--projects <projects>", "JSON array or comma-separated project ids to search")
-        // TODO(remove-legacy-search-targets): drop these two hidden options.
-        .addOption(new Option("--project-ids <projectIds>", "deprecated; use --projects").hideHelp())
-        .addOption(new Option("--self <self>", "deprecated; use --personal").hideHelp())
-        .option("--filter <filter>", 'filter as JSON object; each value is an array of accepted values e.g. \'{"visibility":["public"]}\' (use --input @file.json for complex filters)')
-        .action(async (options, command) => {
-        const selection = buildSearchSelection(command, options);
-        const payload = await resolveInput(options, {
-            type: getExplicitOptionOverride(command, "type", options.type),
-            query: getExplicitOptionOverride(command, "query", options.query),
-            searchMode: getExplicitOptionOverride(command, "searchMode", options.searchMode),
-            page: getExplicitOptionOverride(command, "page", parseOptionalPositiveInteger(options.page, "--page")),
-            scopes: selection.scopes,
-            targets: selection.targets,
-            filter: getExplicitOptionOverride(command, "filter", parseJsonObjectOption(options.filter, "--filter"))
-        });
-        const context = await resolveContext();
-        printJson(await searchPacks(context, payload));
-    });
-    pack.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo pack search --type workflow --query "onboarding"
-  epismo pack search --query "meeting notes"
-  epismo pack search --type workflow --projects proj1
-  epismo pack search --query "customer onboarding ideas" --search-mode semantic
-  epismo pack search --type workflow --personal --projects proj1
-  epismo pack search --type workflow --filter '{"visibility":["public"]}'
-  epismo pack search --type context --query "meeting notes"`);
-    pack.command("like")
-        .description("like or unlike an agent pack")
-        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--liked", "mark as liked")
-        .option("--no-liked", "remove like")
-        .action(async (reference, options) => {
-        const payload = await resolveInput(options, {
-            liked: options.liked
-        });
-        if (typeof payload.liked !== "boolean") {
-            throw new CliError({
-                code: "INVALID_INPUT",
-                message: "Either --liked or --no-liked must be specified.",
-                hint: "Use --liked to add a like, or --no-liked to remove one."
-            });
-        }
-        const context = await resolveContext();
-        printJson(await likePack(context, reference, payload));
-    });
-    pack.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo pack like <id> --liked
-  epismo pack like @myproject --liked
-  epismo pack like <id> --no-liked`);
-    pack.command("rate")
-        .description("rate whether a pack worked when you used it")
-        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
-        .addArgument(new Argument("<outcome>", "success | failure").choices(["success", "failure"]))
-        .action(async (reference, outcome) => {
-        const context = await resolveContext();
-        printJson(await ratePack(context, reference, { outcome }));
-    });
-    pack.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo pack rate <id> success
-  epismo pack rate @myproject failure`);
-    pack.command("delete")
-        .description("delete one agent pack and any of your aliases that point to it")
-        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
-        .action(async (reference) => {
-        const context = await resolveContext();
-        printJson(await deletePack(context, reference));
-    });
-    pack.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo pack delete <id>   # also removes your aliases for that pack
-  epismo pack delete @myproject
-  epismo pack delete https://epismo.ai/share/<token>`);
-    const suggestion = program.command("suggestion").description("manage improvement suggestions");
-    suggestion
-        .command("create")
-        .description("send an improvement suggestion for a pack")
-        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--title <title>", "short summary")
-        .option("--content <content>", "suggestion content")
-        .action(async (reference, options) => {
-        const payload = await resolveInput(options, {
-            reference,
-            title: options.title,
-            content: options.content
-        });
-        const context = await resolveContext();
-        printJson(await createSuggestion(context, payload));
-    });
-    suggestion.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo suggestion create @market-research --title "Add review step" --content "A final human review step would reduce hallucinated findings."
-  epismo suggestion create <id> --input @suggestion.json`);
-    suggestion
-        .command("get")
-        .description("fetch one suggestion")
-        .argument("<id>", "suggestion id")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--include-snapshot", "include the pack snapshot captured with the suggestion")
-        .action(async (id, options) => {
-        const payload = await resolveInput(options, {
-            includeSnapshot: options.includeSnapshot ? true : undefined
-        });
-        const context = await resolveContext();
-        printJson(await getSuggestion(context, id, payload));
-    });
-    suggestion.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo suggestion get <suggestion-id>
-  epismo suggestion get <suggestion-id> --include-snapshot`);
-    suggestion
-        .command("list")
-        .description("list suggestions")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--reference <reference>", "filter by pack reference")
-        .option("--author <author>", "filter by author account id")
-        .option("--owner", "list suggestions for packs you own")
-        .option("--status <status>", "comma-separated statuses or JSON array")
-        .option("--page <page>", "1-based page number")
-        .option("--include-snapshots", "include captured snapshots")
-        .action(async (options, command) => {
-        const payload = await resolveInput(options, {
-            reference: getExplicitOptionOverride(command, "reference", options.reference),
-            author: getExplicitOptionOverride(command, "author", options.author),
-            owner: getExplicitOptionOverride(command, "owner", options.owner),
-            statuses: getExplicitOptionOverride(command, "status", parseStringArrayInput(options.status, "--status")),
-            page: getExplicitOptionOverride(command, "page", parseOptionalPositiveInteger(options.page, "--page")),
-            includeSnapshots: options.includeSnapshots ? true : undefined
-        });
-        const statuses = payload.statuses;
-        if (Array.isArray(statuses) &&
-            statuses.some((status) => !SUGGESTION_STATUSES.includes(status))) {
-            throw new CliError({
-                code: "INVALID_INPUT",
-                message: `Invalid --status: expected one of ${SUGGESTION_STATUSES.join(", ")}.`
-            });
-        }
-        const context = await resolveContext();
-        printJson(await listSuggestions(context, payload));
-    });
-    suggestion.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo suggestion list --reference @market-research
-  epismo suggestion list --owner --status open
-  epismo suggestion list --status open,declined`);
-    suggestion
-        .command("resolve")
-        .description("update a suggestion status")
-        .argument("<id>", "suggestion id")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .addOption(new Option("--status <status>", "open | applied | declined | archived").choices(SUGGESTION_STATUSES))
-        .action(async (id, options) => {
-        const payload = await resolveInput(options, {
-            status: options.status
-        });
-        if (!payload.status) {
-            throw new CliError({
-                code: "INVALID_INPUT",
-                message: "--status is required."
-            });
-        }
-        const context = await resolveContext();
-        printJson(await resolveSuggestion(context, id, payload));
-    });
-    suggestion.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo suggestion resolve <suggestion-id> --status applied
-  epismo suggestion resolve <suggestion-id> --status declined`);
-    suggestion
-        .command("update")
-        .description("update a suggestion title or content")
-        .argument("<id>", "suggestion id")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--title <title>", "updated suggestion title")
-        .option("--content <content>", "updated suggestion content")
-        .action(async (id, options) => {
-        const payload = await resolveInput(options, {
-            title: options.title,
-            content: options.content
-        });
-        if (!payload.title || !payload.content) {
-            throw new CliError({
-                code: "INVALID_INPUT",
-                message: "--title and --content are required."
-            });
-        }
-        const context = await resolveContext();
-        printJson(await updateSuggestion(context, id, payload));
-    });
-    suggestion.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo suggestion update <suggestion-id> --title "Add review step" --content "Please add a reviewer approval step."`);
-    const agent = program.command("agent").description("manage agent availability");
-    agent
-        .command("list")
-        .description("list AI teammates and whether they appear in the assignee roster")
-        .action(async () => {
-        const context = await resolveContext();
-        printJson(await listAgents(context));
-    });
-    agent.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo agent list`);
-    agent
-        .command("add")
-        .description("add AI teammates to the assignee roster")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--agent-ids <agentIds>", "JSON array or comma-separated agent ids")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            agentIds: parseStringArrayInput(options.agentIds, "--agent-ids")
-        });
-        const context = await resolveContext();
-        printJson(await addAgents(context, payload));
-    });
-    agent.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo agent add --agent-ids agent_a
-  epismo agent add --agent-ids '["agent_a","agent_b"]'`);
-    agent
-        .command("remove")
-        .description("remove AI teammates from the assignee roster")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--agent-ids <agentIds>", "JSON array or comma-separated agent ids")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            agentIds: parseStringArrayInput(options.agentIds, "--agent-ids")
-        });
-        const context = await resolveContext();
-        printJson(await removeAgents(context, payload));
-    });
-    agent.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo agent remove --agent-ids agent_a
-  epismo agent remove --agent-ids '["agent_a","agent_b"]'`);
     const credit = program.command("credit").description("view balance and purchase credits");
     credit
         .command("balance")
@@ -1122,73 +333,6 @@ Examples:
     credit.commands.at(-1)?.addHelpText("after", `
 Example:
   epismo credit checkout --quantity 500`);
-    const alias = program.command("alias").description("manage pack aliases");
-    alias
-        .command("upsert")
-        .description("create or update one alias")
-        .argument("<alias>", "alias name (`alias` or `@alias`; stored without `@`)")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--reference <reference>", "target pack reference: id, alias, share URL, or hub URL")
-        .addOption(new Option("--namespace <namespace>", "personal (default) or workspace (shared with the active workspace)").choices(ALIAS_NAMESPACES))
-        .action(async (aliasName, options) => {
-        const payload = await resolveInput(options, {
-            reference: options.reference,
-            alias: aliasName,
-            namespace: options.namespace
-        });
-        if (typeof payload.reference !== "string" || !payload.reference.trim()) {
-            throw new CliError({
-                code: "INVALID_INPUT",
-                message: "`reference` is required.",
-                hint: "Pass --reference <reference> or include reference in --input."
-            });
-        }
-        const context = await resolveContext();
-        printJson(await upsertAlias(context, payload));
-    });
-    alias.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo alias upsert @myproject --reference <pack-reference>
-  epismo alias upsert @deploy --reference <pack-reference> --namespace workspace`);
-    alias
-        .command("get")
-        .description("resolve one alias")
-        .argument("<alias>", "alias reference (`@alias` or `@handle/alias`)")
-        .addOption(new Option("--namespace <namespace>", "resolve a bare/`@alias` reference in personal or workspace (omit to try personal first, then workspace)").choices(ALIAS_NAMESPACES))
-        .action(async (aliasRef, options) => {
-        const context = await resolveContext();
-        printJson(await getAlias(context, { alias: aliasRef, namespace: options.namespace }));
-    });
-    alias.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo alias get @myproject
-  epismo alias get @deploy --namespace workspace
-  epismo alias get @handle/myproject`);
-    alias
-        .command("list")
-        .description("list your aliases")
-        .addOption(new Option("--type <type>", "workflow | context").choices(PACK_TYPES))
-        .action(async (options) => {
-        const context = await resolveContext();
-        printJson(await listAliases(context, { type: options.type }));
-    });
-    alias.commands.at(-1)?.addHelpText("after", `
-Example:
-  epismo alias list
-  epismo alias list --type workflow`);
-    alias
-        .command("delete")
-        .description("delete one alias")
-        .argument("<alias>", "alias name (`alias` or `@alias`; stored without `@`)")
-        .addOption(new Option("--namespace <namespace>", "personal (default) or workspace (the active workspace's shared alias)").choices(ALIAS_NAMESPACES))
-        .action(async (aliasName, options) => {
-        const context = await resolveContext();
-        printJson(await deleteAlias(context, { alias: aliasName, namespace: options.namespace }));
-    });
-    alias.commands.at(-1)?.addHelpText("after", `
-Examples:
-  epismo alias delete @myproject
-  epismo alias delete @deploy --namespace workspace`);
     const token = program.command("token").description("manage CLI tokens for CI/CD");
     token
         .command("create")
@@ -1209,6 +353,7 @@ Notes:
 Examples:
   epismo token create --workspace-id <workspace-id>
   epismo token create   # uses saved default workspace, or personal space if none`);
+    registerPlaybookProgram(program, { resolveInput, resolveContext });
     return program;
 }
 //# sourceMappingURL=program.js.map