implto-tos-axi 0.1.1

package/dist/src/cli.js

@@ -0,0 +1,183 @@
+import { runAxiCli } from "axi-sdk-js";
+import { encode as toon } from "@toon-format/toon";
+import { isTosError } from "./errors.js";
+import { VERSION } from "./version.js";
+import { homeView } from "./commands/home.js";
+import { guideCommand, guideHelp } from "./commands/guide.js";
+import { loginCommand, LOGIN_FLAGS } from "./commands/login.js";
+import { whoamiCommand, logoutCommand, PROFILE_FLAGS } from "./commands/whoami.js";
+import { initCommand, INIT_FLAGS } from "./commands/init.js";
+import { contextCommand } from "./commands/context.js";
+import { tasksCommand, SEARCH_FLAGS, CREATE_FLAGS, UPDATE_FLAGS } from "./commands/tasks.js";
+import { componentsCommand, COMPONENTS_LIST_FLAGS, COMPONENTS_CREATE_FLAGS, COMPONENTS_UPDATE_FLAGS, } from "./commands/components.js";
+import { toolsCommand, LIST_FLAGS, CALL_FLAGS } from "./commands/tools.js";
+import { renderFlagHelp } from "./flags.js";
+export const DESCRIPTION = "Work with Transformation OS from a repository - tasks, deliverables, and the rest of the workspace";
+/**
+ * Top-level help.
+ *
+ * Terse by design: this block plus `<command> --help` is what an agent reads,
+ * and every line costs tokens. Anything longer lives behind `guide <topic>` so
+ * it is pulled one topic at a time.
+ */
+const TOP_LEVEL_HELP = `${[
+    `usage: implto-tos-axi <command> [args] [flags]`,
+    ``,
+    `commands:`,
+    `  login                 Sign in through the browser, or --token to paste a key`,
+    `  logout                Forget this machine's credential`,
+    `  whoami                Who this credential acts as, and what it can reach`,
+    `  init                  Bind this directory to a workspace and project`,
+    `  context               Project, statuses, types and who you are. Run this first`,
+    `  tasks search <words>  Find tasks. --open for work in flight, --mine for yours`,
+    `  tasks show <key>      One task in full`,
+    `  tasks mine            Your tasks`,
+    `  tasks create <title>  File one. --assign me by default`,
+    `  tasks update <key>    Change status, assignee, title, description, due date`,
+    `  tasks comment <key>   Leave a note on it`,
+    `  components list       The deliverables, as a tree. show|create|update too`,
+    `  tools                 Every area the server has, and what this key holds`,
+    `  tools call <name>     Run any tool. Everything not covered above`,
+    `  guide [topic]         Topic-sized guidance. Run bare to list topics`,
+    ``,
+    `flags must come after the command. \`--version\`, \`--help\` excepted.`,
+].join("\n")}\n`;
+function commandHelp(name, description, usage, specs) {
+    const flags = renderFlagHelp(specs);
+    return `${[
+        `command: ${name}`,
+        `description: ${description}`,
+        ``,
+        `usage:`,
+        ...usage.map((u) => `  ${u}`),
+        ...(flags.length > 0 ? [``, `flags:`, ...flags] : []),
+    ].join("\n")}\n`;
+}
+const COMMAND_HELP = {
+    guide: guideHelp(),
+    login: commandHelp("login", "Sign in to a deployment. Opens a browser unless you paste a key", [
+        "implto-tos-axi login",
+        "implto-tos-axi login --profile dev",
+        "implto-tos-axi login --token tos_…        Headless, no browser",
+        "implto-tos-axi login --scopes tasks       Ask for less",
+    ], LOGIN_FLAGS),
+    logout: commandHelp("logout", "Remove this machine's credential", ["implto-tos-axi logout"], PROFILE_FLAGS),
+    whoami: commandHelp("whoami", "Who this credential acts as, which workspaces it reaches, and how to assign to yourself", ["implto-tos-axi whoami"], PROFILE_FLAGS),
+    init: commandHelp("init", "Bind this directory to a workspace and project. Run bare to list what you can reach", ["implto-tos-axi init", 'implto-tos-axi init --workspace "Implemented Today" --project DT'], INIT_FLAGS),
+    context: commandHelp("context", "The project, its statuses and types, and who you are. The first call of a session", ["implto-tos-axi context"], PROFILE_FLAGS),
+    components: `${[
+        "command: components",
+        "description: The deliverables of the workspace, in a tree",
+        "",
+        "usage:",
+        "  implto-tos-axi components list --tree",
+        '  implto-tos-axi components show "Billing API"',
+        '  implto-tos-axi components create "Billing API" --parent Platform --estimate 40',
+        '  implto-tos-axi components update "Billing API" --parent "Payments"',
+        '  implto-tos-axi components update "Billing API" --parent none   # to the top level',
+        "",
+        "list flags:",
+        ...renderFlagHelp(COMPONENTS_LIST_FLAGS),
+        "",
+        "create flags:",
+        ...renderFlagHelp(COMPONENTS_CREATE_FLAGS),
+        "",
+        "update flags:",
+        ...renderFlagHelp(COMPONENTS_UPDATE_FLAGS),
+    ].join("\n")}\n`,
+    tools: `${[
+        "command: tools",
+        "description: The MCP server itself - its areas, its tools, and a way to call one",
+        "",
+        "usage:",
+        "  implto-tos-axi tools                        The areas, and which you hold",
+        "  implto-tos-axi tools domains process_maps   One area, and its rules",
+        "  implto-tos-axi tools list --domain organization",
+        "  implto-tos-axi tools show create_person",
+        '  implto-tos-axi tools call create_person name="Ann Lee" email=ann@acme.com',
+        "  implto-tos-axi tools call update_process_nodes --json-file nodes.json",
+        "",
+        "arguments are name=value. `key=@file` reads a value from a file, `key=@-`",
+        "from stdin, and `--json` passes the whole object. workspaceId is filled in",
+        "from the binding when you leave it out.",
+        "",
+        "list flags:",
+        ...renderFlagHelp(LIST_FLAGS),
+        "",
+        "call flags:",
+        ...renderFlagHelp(CALL_FLAGS),
+    ].join("\n")}\n`,
+    tasks: `${[
+        "command: tasks",
+        "description: Find, read and change tasks in the bound project",
+        "",
+        "usage:",
+        '  implto-tos-axi tasks search "login redirect" --open',
+        "  implto-tos-axi tasks mine --open",
+        "  implto-tos-axi tasks show TO-112",
+        '  implto-tos-axi tasks create "Fix the import guard" --assign me',
+        '  implto-tos-axi tasks update TO-112 --status "In Progress"',
+        '  implto-tos-axi tasks comment TO-112 "Shipped in #204"',
+        "",
+        "search flags:",
+        ...renderFlagHelp(SEARCH_FLAGS),
+        "",
+        "create flags:",
+        ...renderFlagHelp(CREATE_FLAGS),
+        "",
+        "update flags:",
+        ...renderFlagHelp(UPDATE_FLAGS),
+    ].join("\n")}\n`,
+};
+/**
+ * Our errors, rendered the way every successful payload is.
+ *
+ * The `help` list is the same field a success carries, so recovering from a
+ * failure reads like reading a result - an agent does not have to learn a
+ * second shape for the unhappy path.
+ *
+ * VALIDATION_ERROR is the only code that exits 2, so a script can tell a
+ * mistake it made from work that ran and failed.
+ */
+function formatError(error) {
+    if (isTosError(error)) {
+        return {
+            output: `${toon({
+                error: error.message,
+                code: error.code,
+                ...(error.suggestions.length > 0 ? { help: error.suggestions } : {}),
+            })}\n`,
+            exitCode: error.code === "VALIDATION_ERROR" ? 2 : 1,
+        };
+    }
+    return {
+        output: `${toon({
+            error: error instanceof Error ? error.message : String(error),
+            code: "UNKNOWN",
+        })}\n`,
+        exitCode: 1,
+    };
+}
+export async function main(argv) {
+    await runAxiCli({
+        formatError,
+        description: DESCRIPTION,
+        version: VERSION,
+        topLevelHelp: TOP_LEVEL_HELP,
+        ...(argv ? { argv } : {}),
+        home: () => homeView(),
+        commands: {
+            login: (args) => loginCommand(args),
+            logout: (args) => logoutCommand(args),
+            whoami: (args) => whoamiCommand(args),
+            init: (args) => initCommand(args),
+            context: (args) => contextCommand(args),
+            tasks: (args) => tasksCommand(args),
+            components: (args) => componentsCommand(args),
+            tools: (args) => toolsCommand(args),
+            guide: (args) => guideCommand(args),
+        },
+        getCommandHelp: (command) => COMMAND_HELP[command],
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/commands/components.d.ts

@@ -0,0 +1,40 @@
+import { type FlagSpecs } from "../flags.js";
+import type { AxiRenderable } from "../output.js";
+export declare const COMPONENTS_LIST_FLAGS: FlagSpecs;
+export declare const COMPONENTS_SHOW_FLAGS: FlagSpecs;
+export declare const COMPONENTS_WRITE_FLAGS: FlagSpecs;
+export declare const COMPONENTS_CREATE_FLAGS: FlagSpecs;
+export declare const COMPONENTS_UPDATE_FLAGS: FlagSpecs;
+interface Component {
+    id: string;
+    name: string;
+    type?: string | null;
+    importance?: string | null;
+    shortDescription?: string | null;
+    description?: string | null;
+    originalEstimateSecs?: number | null;
+    parentComponentId?: string | null;
+    parentComponentName?: string | null;
+    projectId?: string | null;
+    projectName?: string | null;
+    workspaceSystemId?: string | null;
+    workspaceSystemName?: string | null;
+    responsibleUserIds?: string[];
+    phaseEstimates?: {
+        phaseId: string;
+        phaseName: string;
+        estimateSecs: number;
+    }[];
+    issuesCount?: number;
+    processStepsCount?: number;
+}
+export declare function componentsCommand(argv: readonly string[]): Promise<AxiRenderable>;
+/**
+ * The hierarchy as text.
+ *
+ * A flat list with a `parent` column is fine for filtering and useless for
+ * seeing where a new component belongs, which is the question somebody asks
+ * right before creating one.
+ */
+export declare function drawTree(components: readonly Component[]): string;
+export {};

package/dist/src/commands/components.js

@@ -0,0 +1,417 @@
+import { readFileSync } from "node:fs";
+import { parseFlags } from "../flags.js";
+import { openSession, resolveWorkspaceId } from "../session.js";
+import { TosError } from "../errors.js";
+import { isClearing, looksLikeId, pick } from "../resolve.js";
+import { PROFILE_FLAGS } from "./whoami.js";
+/**
+ * The deliverables of a workspace: what is being built, as a tree.
+ *
+ * First-class rather than left to `tools call` because it is the other half of
+ * what a coding agent does in a repository. A change belongs to a task, and a
+ * task belongs to a component - and the component for the thing being built is
+ * as often missing as the task is. Creating one, and hanging it under the
+ * right parent, should cost one line.
+ */
+const COMMON = PROFILE_FLAGS;
+const WORKSPACE_FLAG = {
+    workspace: {
+        kind: "string",
+        description: "Which workspace, by name or id (default: the binding)",
+        placeholder: "name",
+    },
+};
+export const COMPONENTS_LIST_FLAGS = {
+    ...COMMON,
+    ...WORKSPACE_FLAG,
+    tree: { kind: "boolean", description: "Draw the hierarchy instead of a flat list" },
+    parent: { kind: "string", description: "Only children of this one", placeholder: "name" },
+    project: { kind: "string", description: "Only ones linked to this project", placeholder: "key" },
+    search: { kind: "string", description: "Only names matching this word", placeholder: "word" },
+};
+export const COMPONENTS_SHOW_FLAGS = { ...COMMON, ...WORKSPACE_FLAG };
+export const COMPONENTS_WRITE_FLAGS = {
+    ...COMMON,
+    ...WORKSPACE_FLAG,
+    parent: {
+        kind: "string",
+        description: "Hang it under this component, or none for the top level",
+        placeholder: "name",
+    },
+    short: { kind: "string", description: "One-line summary shown in lists", placeholder: "text" },
+    description: { kind: "string", description: "Markdown documentation", placeholder: "text" },
+    "description-file": {
+        kind: "string",
+        description: "Read the documentation from a file, or - for stdin",
+        placeholder: "path",
+    },
+    type: {
+        kind: "string",
+        description: "SERVICE, MODULE, UI, API, INTEGRATION, DATABASE, INFRASTRUCTURE, OTHER",
+        placeholder: "type",
+        example: "SERVICE",
+    },
+    importance: { kind: "string", description: "Business criticality", placeholder: "level" },
+    estimate: {
+        kind: "number",
+        description: "Overall estimate, in hours",
+        placeholder: "hours",
+        min: 0,
+    },
+    system: {
+        kind: "string",
+        description: "Link to a workspace system, by name or id, or none",
+        placeholder: "name",
+    },
+    project: {
+        kind: "string",
+        description: "Link to a project, by key or id, or none (default: the bound project)",
+        placeholder: "key",
+    },
+    responsible: {
+        kind: "string",
+        description: "me, user ids, or none",
+        placeholder: "who",
+        example: "me",
+    },
+};
+export const COMPONENTS_CREATE_FLAGS = { ...COMPONENTS_WRITE_FLAGS };
+export const COMPONENTS_UPDATE_FLAGS = {
+    ...COMPONENTS_WRITE_FLAGS,
+    name: { kind: "string", description: "Rename it", placeholder: "text" },
+};
+const HOUR = 3600;
+const hours = (secs) => typeof secs === "number" ? Math.round((secs / HOUR) * 10) / 10 : "";
+export async function componentsCommand(argv) {
+    // A leading flag is a missing subcommand, not a subcommand named `--profile`.
+    const leads = argv[0];
+    const named = leads !== undefined && !leads.startsWith("-");
+    const sub = named ? leads : undefined;
+    const rest = named ? argv.slice(1) : argv;
+    switch (sub) {
+        case "list":
+            return list(rest);
+        case "show":
+            return show(rest);
+        case "create":
+            return create(rest);
+        case "update":
+            return update(rest);
+        default:
+            throw new TosError(sub ? `Unknown subcommand "${sub}".` : "components needs a subcommand.", "VALIDATION_ERROR", ["components list|show|create|update", "implto-tos-axi components --help"]);
+    }
+}
+function sessionFor(flags) {
+    return openSession({
+        profile: flags["profile"],
+        url: flags["url"],
+        mcpUrl: flags["mcp-url"],
+    });
+}
+async function allComponents(session, workspaceId) {
+    const rows = (await session.call("list_components", { workspaceId }));
+    return Array.isArray(rows) ? rows : [];
+}
+/** One component by id or name, resolved against the workspace's own list. */
+function find(components, wanted) {
+    if (looksLikeId(wanted)) {
+        const byId = components.find((c) => c.id === wanted);
+        if (byId)
+            return byId;
+    }
+    return pick(components, wanted, (c) => [c.id, c.name], "No component here");
+}
+/**
+ * The hierarchy as text.
+ *
+ * A flat list with a `parent` column is fine for filtering and useless for
+ * seeing where a new component belongs, which is the question somebody asks
+ * right before creating one.
+ */
+export function drawTree(components) {
+    const children = new Map();
+    for (const c of components) {
+        const key = c.parentComponentId ?? null;
+        children.set(key, [...(children.get(key) ?? []), c]);
+    }
+    // A component whose parent is outside the filtered set would otherwise
+    // vanish, so anything unreachable from the roots is drawn at the top level.
+    const known = new Set(components.map((c) => c.id));
+    const roots = components.filter((c) => !c.parentComponentId || !known.has(c.parentComponentId));
+    const lines = [];
+    const walk = (node, depth, seen) => {
+        if (seen.has(node.id))
+            return;
+        seen.add(node.id);
+        const estimate = hours(node.originalEstimateSecs);
+        const tail = [
+            node.type && node.type !== "OTHER" ? node.type : "",
+            estimate ? `${estimate}h` : "",
+        ]
+            .filter(Boolean)
+            .join(", ");
+        lines.push(`${"  ".repeat(depth)}${node.name}${tail ? `  (${tail})` : ""}`);
+        for (const child of children.get(node.id) ?? [])
+            walk(child, depth + 1, seen);
+    };
+    const seen = new Set();
+    for (const root of roots)
+        walk(root, 0, seen);
+    // A cycle has no root, so nothing above would have drawn it. The server
+    // refuses to create one, but a tree that silently loses rows is worse than
+    // one that draws a cycle flat.
+    for (const node of components)
+        if (!seen.has(node.id))
+            walk(node, 0, seen);
+    return lines.join("\n");
+}
+async function list(argv) {
+    const { flags } = parseFlags(argv, COMPONENTS_LIST_FLAGS);
+    const session = sessionFor(flags);
+    const workspaceId = await resolveWorkspaceId(session, flags["workspace"]);
+    const all = await allComponents(session, workspaceId);
+    const parent = flags["parent"];
+    const parentId = parent ? find(all, parent).id : undefined;
+    const project = flags["project"];
+    const search = flags["search"]?.toLowerCase();
+    const matched = all
+        .filter((c) => !parentId || c.parentComponentId === parentId)
+        .filter((c) => !project ||
+        c.projectId === project ||
+        (c.projectName ?? "").toLowerCase().includes(project.toLowerCase()))
+        .filter((c) => !search || c.name.toLowerCase().includes(search));
+    if (flags["tree"]) {
+        // The shape is the answer here, so it is printed as a shape. TOON would
+        // render it as one string with \n in it, which is the format fighting the
+        // content.
+        const drawn = drawTree(matched);
+        return `${drawn || "(no components yet)"}\n\n${matched.length} components. implto-tos-axi components show <name>\n`;
+    }
+    return {
+        count: matched.length,
+        components: matched.map((c) => ({
+            name: c.name,
+            type: c.type ?? "",
+            parent: c.parentComponentName ?? "",
+            project: c.projectName ?? "",
+            system: c.workspaceSystemName ?? "",
+            tasks: c.issuesCount ?? 0,
+            estimate_h: hours(c.originalEstimateSecs),
+        })),
+        help: [
+            "implto-tos-axi components list --tree",
+            "implto-tos-axi components show <name>",
+            'implto-tos-axi components create "<name>" --parent "<parent>"',
+        ],
+    };
+}
+async function show(argv) {
+    const { positionals, flags } = parseFlags(argv, COMPONENTS_SHOW_FLAGS);
+    const wanted = positionals.join(" ").trim();
+    if (!wanted) {
+        throw new TosError("Name the component to show.", "VALIDATION_ERROR", [
+            'implto-tos-axi components show "Billing API"',
+        ]);
+    }
+    const session = sessionFor(flags);
+    const workspaceId = await resolveWorkspaceId(session, flags["workspace"]);
+    const found = find(await allComponents(session, workspaceId), wanted);
+    const component = (await session.call("get_component", { id: found.id }));
+    return {
+        name: component.name,
+        type: component.type ?? "",
+        importance: component.importance ?? "",
+        parent: component.parentComponentName ?? "",
+        project: component.projectName ?? "",
+        system: component.workspaceSystemName ?? "",
+        estimate_h: hours(component.originalEstimateSecs),
+        tasks: component.issuesCount ?? 0,
+        process_steps: component.processStepsCount ?? 0,
+        phases: (component.phaseEstimates ?? []).map((e) => ({
+            phase: e.phaseName,
+            hours: hours(e.estimateSecs),
+        })),
+        summary: component.shortDescription ?? "",
+        description: component.description ?? "",
+        id: component.id,
+        help: [
+            `implto-tos-axi components update "${component.name}" --parent "<parent>"`,
+            "implto-tos-axi tools call search_tasks componentId=" + component.id,
+        ],
+    };
+}
+function bodyFrom(flags) {
+    const file = flags["description-file"];
+    if (file)
+        return file === "-" ? readFileSync(0, "utf8") : readFileSync(file, "utf8");
+    return flags["description"];
+}
+/**
+ * A workspace system by name.
+ *
+ * Systems are only listed by a process-maps tool, so a credential narrowed to
+ * delivery planning can pass an id but cannot look one up by name. That is
+ * what the refusal says, rather than "not found".
+ */
+async function systemId(session, workspaceId, wanted) {
+    if (looksLikeId(wanted))
+        return wanted;
+    let systems;
+    try {
+        const context = (await session.call("get_process_map_workspace_context", { workspaceId }));
+        systems = context.systems ?? context.workspaceSystems ?? [];
+    }
+    catch (error) {
+        throw new TosError(`Cannot look up a system by name with this credential: ${error instanceof Error ? error.message : String(error)}`, "FORBIDDEN", [
+            "Pass the system id instead, or sign in again with the process_maps area.",
+            "implto-tos-axi tools domains",
+        ]);
+    }
+    return pick(systems, wanted, (s) => [s.id, s.localName ?? s.name], "No system here").id;
+}
+async function projectId(session, wanted) {
+    if (looksLikeId(wanted))
+        return wanted;
+    const me = (await session.call("get_current_user"));
+    const projects = (me.workspaces ?? []).flatMap((w) => w.projects ?? []);
+    return pick(projects, wanted, (p) => [p.id, p.key, p.name], "No project you can reach").id;
+}
+/**
+ * The fields a create and an update share.
+ *
+ * `undefined` leaves a field alone and `null` clears it, which is the server's
+ * own contract - so `--parent none` un-nests a component and omitting
+ * `--parent` does not touch it.
+ */
+async function writableFields(session, workspaceId, flags, siblings) {
+    const fields = {};
+    const parent = flags["parent"];
+    if (parent !== undefined) {
+        fields["parentComponentId"] = isClearing(parent) ? null : find(siblings, parent).id;
+    }
+    const system = flags["system"];
+    if (system !== undefined) {
+        fields["workspaceSystemId"] = isClearing(system)
+            ? null
+            : await systemId(session, workspaceId, system);
+    }
+    const project = flags["project"];
+    if (project !== undefined) {
+        fields["projectId"] = isClearing(project) ? null : await projectId(session, project);
+    }
+    const responsible = flags["responsible"];
+    if (responsible !== undefined) {
+        if (isClearing(responsible)) {
+            fields["responsibleUserIds"] = [];
+        }
+        else if (responsible === "me") {
+            const me = (await session.call("get_current_user"));
+            fields["responsibleUserIds"] = [me.id];
+        }
+        else {
+            fields["responsibleUserIds"] = responsible.split(",").map((id) => id.trim());
+        }
+    }
+    const short = flags["short"];
+    if (short !== undefined)
+        fields["shortDescription"] = isClearing(short) ? null : short;
+    const body = bodyFrom(flags);
+    if (body !== undefined)
+        fields["description"] = isClearing(body) ? null : body;
+    // Types are upper-case in the schema; importance is deliberately lower-case,
+    // so only one of the two can be normalised. Anything the server does not
+    // know comes back naming everything it does.
+    const type = flags["type"];
+    if (type !== undefined)
+        fields["type"] = type.toUpperCase();
+    const importance = flags["importance"];
+    if (importance !== undefined) {
+        fields["importance"] = isClearing(importance) ? null : importance;
+    }
+    const estimate = flags["estimate"];
+    if (estimate !== undefined)
+        fields["originalEstimateSecs"] = Math.round(estimate * HOUR);
+    return fields;
+}
+async function create(argv) {
+    const { positionals, flags } = parseFlags(argv, COMPONENTS_CREATE_FLAGS);
+    const name = positionals.join(" ").trim();
+    if (!name) {
+        throw new TosError("A component needs a name.", "VALIDATION_ERROR", [
+            'implto-tos-axi components create "Billing API" --parent Platform',
+        ]);
+    }
+    const session = sessionFor(flags);
+    const workspaceId = await resolveWorkspaceId(session, flags["workspace"]);
+    const existing = await allComponents(session, workspaceId);
+    const fields = await writableFields(session, workspaceId, flags, existing);
+    // A duplicate is the same name in the same place. The same name elsewhere in
+    // the tree is ordinary - two subtrees each have their "Docs" - so refusing
+    // that would block a legitimate create with no way around it.
+    const parentId = fields["parentComponentId"] ?? null;
+    const clash = existing.find((c) => c.name.toLowerCase() === name.toLowerCase() && (c.parentComponentId ?? null) === parentId);
+    if (clash) {
+        throw new TosError(`"${clash.name}" already exists ${clash.parentComponentName ? `under "${clash.parentComponentName}"` : "at the top level"}.`, "VALIDATION_ERROR", [
+            `implto-tos-axi components show "${clash.name}"`,
+            `implto-tos-axi components update "${clash.name}" --parent "<parent>"`,
+        ]);
+    }
+    // A component filed from a bound checkout belongs to that checkout's project
+    // unless it is told otherwise, which is what --project none is for.
+    if (fields["projectId"] === undefined && session.binding) {
+        fields["projectId"] = session.binding.projectId;
+    }
+    const created = (await session.call("create_component", {
+        workspaceId,
+        name,
+        ...fields,
+    }));
+    return {
+        created: created.name,
+        parent: created.parentComponentName ?? "(top level)",
+        project: created.projectName ?? "",
+        type: created.type ?? "",
+        id: created.id,
+        help: [
+            `implto-tos-axi components show "${created.name}"`,
+            "implto-tos-axi components list --tree",
+        ],
+    };
+}
+async function update(argv) {
+    const { positionals, flags } = parseFlags(argv, COMPONENTS_UPDATE_FLAGS);
+    const wanted = positionals.join(" ").trim();
+    if (!wanted) {
+        throw new TosError("Name the component to update.", "VALIDATION_ERROR", [
+            'implto-tos-axi components update "Billing API" --parent Platform',
+        ]);
+    }
+    const session = sessionFor(flags);
+    const workspaceId = await resolveWorkspaceId(session, flags["workspace"]);
+    const all = await allComponents(session, workspaceId);
+    const component = find(all, wanted);
+    const fields = await writableFields(session, workspaceId, flags, all);
+    const rename = flags["name"];
+    if (rename)
+        fields["name"] = rename;
+    if (Object.keys(fields).length === 0) {
+        throw new TosError("Nothing to change.", "VALIDATION_ERROR", [
+            "implto-tos-axi components update --help",
+        ]);
+    }
+    if (fields["parentComponentId"] === component.id) {
+        throw new TosError("A component cannot be its own parent.", "VALIDATION_ERROR");
+    }
+    const updated = (await session.call("update_component", {
+        id: component.id,
+        ...fields,
+    }));
+    return {
+        updated: updated.name,
+        parent: updated.parentComponentName ?? "(top level)",
+        project: updated.projectName ?? "",
+        changed: Object.keys(fields).join(", "),
+        help: [`implto-tos-axi components show "${updated.name}"`],
+    };
+}
+//# sourceMappingURL=components.js.map