@corners/cli 0.0.1 → 0.0.3

package/dist/cli.js

@@ -1,31 +1,11 @@
-import { readFile } from "node:fs/promises";
+import { mkdir, readFile, realpath, writeFile } from "node:fs/promises";
 import { hostname } from "node:os";
-import { basename } from "node:path";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { parseArgs } from "node:util";
 import { CornersApiClient as DefaultCornersApiClient, } from "./client.js";
-import { ConfigStore } from "./config.js";
-import { CLIError, getPackageVersion, openUrlInBrowser, printJson, printLine, readTextFromStdin, sleep, toGraphQLAttachmentKind, toGraphQLWorkstreamUpdateType, toIsoString, } from "./support.js";
-const LIST_WORKSTREAMS_QUERY = `
-  query CliListWorkstreams {
-    workstreams(filter: { status: ACTIVE }, first: 100) {
-      edges {
-        node {
-          id
-          cornerId
-          name
-          summary
-          category
-          status
-          updatedAt
-          topic {
-            id
-            name
-          }
-        }
-      }
-    }
-  }
-`;
+import { ConfigStore, LOCAL_ROOT_CONFIG_RELATIVE_PATH, } from "./config.js";
+import { createPromptApi } from "./prompts.js";
+import { CLIError, getPackageVersion, normalizeApiUrl, openUrlInBrowser, printJson, printLine, readTextFromStdin, sleep, toGraphQLAttachmentKind, toGraphQLWorkstreamUpdateType, toIsoString, } from "./support.js";
 const WORKSTREAM_LOOKUP_QUERY = `
   query CliWorkstreamLookup($id: ID!) {
     workstream(id: $id) {
@@ -308,6 +288,47 @@ const REVOKE_MCP_SESSION_MUTATION = `
     revokeMCPSession(id: $id)
   }
 `;
+const WHOAMI_QUERY = `
+  query CliWhoAmI {
+    me {
+      id
+      handle
+      account {
+        id
+        workspace
+      }
+    }
+  }
+`;
+const LIST_MEMBER_CORNERS_QUERY = `
+  query CliMemberCorners {
+    memberCorners(first: 50) {
+      edges {
+        node {
+          id
+          name
+        }
+      }
+    }
+  }
+`;
+const CREATE_WORKSTREAM_MUTATION = `
+  mutation CliCreateWorkstream($input: CreateWorkstreamInput!) {
+    createWorkstream(input: $input) {
+      id
+      cornerId
+      name
+      summary
+      category
+      status
+      updatedAt
+      topic {
+        id
+        name
+      }
+    }
+  }
+`;
 function createRuntime() {
     return {
         config: new ConfigStore(),
@@ -315,6 +336,7 @@ function createRuntime() {
         stderr: process.stderr,
         stdin: process.stdin,
         cwd: process.cwd(),
+        prompts: undefined,
         openUrl: openUrlInBrowser,
         createClient: (input) => new DefaultCornersApiClient(input),
         getVersion: getPackageVersion,
@@ -329,7 +351,10 @@ function printMainHelp(runtime) {
         "",
         "Commands:",
         "  auth login|logout|status",
-        "  workstream (ws) list|use|current|pull|push|question|attach|reply-thread",
+        "  init",
+        "  corner use",
+        "  whoami",
+        "  workstream (ws) list|use|current|create|pull|push|question|attach|reply-thread",
         "  help",
         "  version",
         "",
@@ -342,6 +367,14 @@ function printMainHelp(runtime) {
         "  --no-browser",
     ].join("\n"));
 }
+function printInitHelp(runtime) {
+    printLine(runtime.stdout, [
+        "corners init",
+        "",
+        "Usage:",
+        "  corners init [--profile <name>] [--api-url <url>] [--json]",
+    ].join("\n"));
+}
 function printAuthHelp(runtime) {
     printLine(runtime.stdout, [
         "corners auth",
@@ -352,6 +385,22 @@ function printAuthHelp(runtime) {
         "  corners auth status [--profile <name>] [--json]",
     ].join("\n"));
 }
+function printCornerHelp(runtime) {
+    printLine(runtime.stdout, [
+        "corners corner",
+        "",
+        "Usage:",
+        "  corners corner use <cornerNameOrId> [--path <path>] [--json]",
+    ].join("\n"));
+}
+function printWhoamiHelp(runtime) {
+    printLine(runtime.stdout, [
+        "corners whoami",
+        "",
+        "Usage:",
+        "  corners whoami [--profile <name>] [--api-url <url>] [--json]",
+    ].join("\n"));
+}
 function printWorkstreamHelp(runtime) {
     printLine(runtime.stdout, [
         "corners workstream",
@@ -360,12 +409,13 @@ function printWorkstreamHelp(runtime) {
         "  corners workstream list [--json]",
         "  corners workstream use <workstreamId> [--json]",
         "  corners workstream current [--json]",
-        "  corners workstream pull [workstreamId] [--json]",
-        "  corners workstream push [workstreamId] [--type <type>] [--message <text>] [--summary <text>] [--file <path>] [--title <title>] [--json]",
-        "  corners workstream question list [workstreamId] [--json]",
-        "  corners workstream question ask [workstreamId] [--question <text>] [--rationale <text>] [--suggested-answer <text>]... [--json]",
+        "  corners workstream create <name> [--summary <text>] [--corner <cornerNameOrId>] [--json]",
+        "  corners workstream pull <workstreamId> [--json]",
+        "  corners workstream push <workstreamId> [--type <type>] [--message <text>] [--summary <text>] [--file <path>] [--title <title>] [--json]",
+        "  corners workstream question list <workstreamId> [--json]",
+        "  corners workstream question ask <workstreamId> [--question <text>] [--rationale <text>] [--suggested-answer <text>]... [--json]",
         "  corners workstream question answer <questionId> [--text <text>] [--json]",
-        "  corners workstream attach [workstreamId] --kind <kind> --entity-id <id> [--json]",
+        "  corners workstream attach <workstreamId> --kind <kind> --entity-id <id> [--json]",
         "  corners workstream reply-thread <threadId> [--text <text>] [--json]",
         "",
         "Update types:",
@@ -462,6 +512,83 @@ async function requireStoredProfile(runtime, common) {
         }),
     };
 }
+async function fetchCurrentIdentity(client) {
+    const data = await client.graphql(WHOAMI_QUERY);
+    return {
+        userId: data.me.id,
+        handle: data.me.handle ?? null,
+        accountId: data.me.account?.id ?? null,
+        workspace: data.me.account?.workspace ?? null,
+    };
+}
+async function maybeRefreshStoredProfileIdentity(input) {
+    try {
+        const identity = await fetchCurrentIdentity(input.client);
+        const nextProfile = {
+            ...input.profile,
+            userId: identity.userId,
+            handle: identity.handle,
+            accountId: identity.accountId,
+            workspace: identity.workspace,
+        };
+        if (nextProfile.userId !== input.profile.userId ||
+            nextProfile.handle !== (input.profile.handle ?? null) ||
+            nextProfile.accountId !== input.profile.accountId ||
+            nextProfile.workspace !== input.profile.workspace) {
+            await input.runtime.config.saveProfile(input.profileName, nextProfile, {
+                setActive: false,
+            });
+        }
+        return nextProfile;
+    }
+    catch {
+        return input.profile;
+    }
+}
+async function resolveAuthStatus(runtime, common) {
+    const selected = await runtime.config.getProfile(common.profile ?? null);
+    if (!selected) {
+        return {
+            loggedIn: false,
+            profile: common.profile ?? null,
+        };
+    }
+    const apiUrl = common.apiUrl ?? selected.profile.apiUrl;
+    const client = runtime.createClient({
+        apiUrl,
+        accessToken: selected.profile.accessToken,
+    });
+    let remote;
+    try {
+        remote = await client.validateSession();
+    }
+    catch (error) {
+        remote = {
+            valid: false,
+            error: error.message,
+        };
+    }
+    const profile = remote.valid
+        ? await maybeRefreshStoredProfileIdentity({
+            runtime,
+            profileName: selected.name,
+            profile: selected.profile,
+            client,
+        })
+        : selected.profile;
+    return {
+        loggedIn: true,
+        profile: selected.name,
+        apiUrl,
+        sessionId: profile.sessionId,
+        workspace: profile.workspace,
+        handle: profile.handle ?? null,
+        accountId: profile.accountId,
+        userId: profile.userId,
+        remoteValid: remote.valid,
+        remoteError: remote.valid ? null : (remote.error ?? null),
+    };
+}
 async function pollForDeviceToken(input) {
     const deadline = Date.now() + input.device.expires_in * 1000;
     let intervalMs = input.device.interval * 1000;
@@ -489,36 +616,281 @@ async function pollForDeviceToken(input) {
     printLine(input.stderr, "Device code expired before authorization completed.");
     throw new CLIError("Device code expired");
 }
-async function resolveExplicitOrBoundWorkstream(runtime, common, client, profileName, explicitWorkstreamId) {
-    const workstreamId = explicitWorkstreamId ||
-        (await resolveBoundWorkstreamId(runtime, profileName));
+async function withPrompts(runtime, run) {
+    if (runtime.prompts) {
+        return run(runtime.prompts);
+    }
+    if (runtime.stdin.isTTY === false) {
+        throw new CLIError("`corners init` requires an interactive terminal.");
+    }
+    const prompts = createPromptApi(runtime.stdin, runtime.stderr);
+    try {
+        return await run(prompts);
+    }
+    finally {
+        await prompts.close();
+    }
+}
+async function readOptionalUtf8(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+function ensureTrailingNewline(value) {
+    return value.endsWith("\n") ? value : `${value}\n`;
+}
+function normalizeCornerLookupValue(value) {
+    const normalized = value.trim();
+    return normalized.startsWith("#") ? normalized.slice(1) : normalized;
+}
+function normalizeStoredRelativePath(rootDir, targetPath) {
+    const relativePath = relative(rootDir, targetPath);
+    if (!relativePath) {
+        return ".";
+    }
+    if (relativePath === ".." ||
+        relativePath.startsWith(`..${sep}`) ||
+        relativePath.includes(`${sep}..${sep}`)) {
+        throw new CLIError("The target path must stay within the initialized root.");
+    }
+    return relativePath.split(sep).join("/");
+}
+function resolvePathWithinRoot(rootDir, cwd, inputPath) {
+    const targetPath = inputPath ? resolve(cwd, inputPath) : resolve(cwd);
+    normalizeStoredRelativePath(rootDir, targetPath);
+    return targetPath;
+}
+function resolveCornerForRelativePath(config, relativePath) {
+    let selected = config.defaultCorner;
+    let selectedLength = 0;
+    for (const override of config.cornerOverrides) {
+        const matches = relativePath === override.path ||
+            relativePath.startsWith(`${override.path}/`);
+        if (!matches) {
+            continue;
+        }
+        if (override.path.length > selectedLength) {
+            selected = {
+                id: override.cornerId,
+                name: override.cornerName,
+            };
+            selectedLength = override.path.length;
+        }
+    }
+    return selected;
+}
+function resolveCornerForCwd(root, cwd) {
+    const absolutePath = resolvePathWithinRoot(root.rootDir, cwd);
+    const relativePath = normalizeStoredRelativePath(root.rootDir, absolutePath);
+    return {
+        relativePath,
+        corner: resolveCornerForRelativePath(root.config, relativePath),
+    };
+}
+async function requireLocalRoot(runtime, common) {
+    const root = await runtime.config.findLocalRoot(runtime.cwd);
+    if (!root) {
+        throw new CLIError("No local Corners CLI root found. Run `corners init` from your project root first.", { json: common.json });
+    }
+    return root;
+}
+async function requirePinnedRootProfile(runtime, common, root) {
+    if (common.profile && common.profile !== root.config.profile) {
+        throw new CLIError(`This initialized root is pinned to profile ${root.config.profile}.`, { json: common.json });
+    }
+    const selected = await runtime.config.getProfile(root.config.profile);
+    if (!selected) {
+        throw new CLIError(`The pinned profile ${root.config.profile} is not available. Run \`corners auth login --profile ${root.config.profile}\` first.`, { json: common.json });
+    }
+    const pinnedApiUrl = normalizeApiUrl(root.config.apiUrl);
+    const requestedApiUrl = common.apiUrl ? normalizeApiUrl(common.apiUrl) : null;
+    if (requestedApiUrl && requestedApiUrl !== pinnedApiUrl) {
+        throw new CLIError(`This initialized root is pinned to API ${pinnedApiUrl}.`, { json: common.json });
+    }
+    if (root.config.workspace &&
+        selected.profile.workspace &&
+        root.config.workspace !== selected.profile.workspace) {
+        throw new CLIError(`The pinned profile ${root.config.profile} is now on workspace ${selected.profile.workspace}. Re-run \`corners init\` to refresh this root.`, { json: common.json });
+    }
+    const profile = {
+        ...selected.profile,
+        apiUrl: pinnedApiUrl,
+    };
+    return {
+        root,
+        profileName: selected.name,
+        profile,
+        client: runtime.createClient({
+            apiUrl: profile.apiUrl,
+            accessToken: profile.accessToken,
+        }),
+    };
+}
+async function requireCommandProfile(runtime, common) {
+    const root = await runtime.config.findLocalRoot(runtime.cwd);
+    if (root) {
+        return requirePinnedRootProfile(runtime, common, root);
+    }
+    const selected = await requireStoredProfile(runtime, common);
+    return {
+        root: null,
+        ...selected,
+    };
+}
+async function listMemberCorners(client) {
+    const data = await client.graphql(LIST_MEMBER_CORNERS_QUERY);
+    return data.memberCorners.edges.map((edge) => edge.node);
+}
+function findMemberCorner(corners, value) {
+    const normalized = normalizeCornerLookupValue(value);
+    return (corners.find((corner) => corner.id === normalized) ??
+        corners.find((corner) => corner.name.toLowerCase() === normalized.toLowerCase()) ??
+        null);
+}
+async function resolveMemberCorner(client, common, value) {
+    const corners = await listMemberCorners(client);
+    const corner = findMemberCorner(corners, value);
+    if (!corner) {
+        throw new CLIError("Corner not found in your joined corners.", {
+            json: common.json,
+        });
+    }
+    return corner;
+}
+async function resolveExplicitWorkstream(client, common, workstreamId) {
     const data = await client.graphql(WORKSTREAM_LOOKUP_QUERY, { id: workstreamId });
     if (!data.workstream) {
         throw new CLIError("Workstream not found", { json: common.json });
     }
     return data.workstream;
 }
-async function resolveBoundWorkstreamId(runtime, profileName) {
-    const binding = await runtime.config.getBinding(runtime.cwd);
-    if (!binding) {
-        throw new CLIError("This directory is not bound to a workstream. Run `corners workstream use <workstreamId>` first.");
+function connectWorkstream(config, workstreamId) {
+    if (config.connectedWorkstreams.some((entry) => entry.id === workstreamId)) {
+        return config;
     }
-    if (binding.profile && binding.profile !== profileName) {
-        throw new CLIError(`This directory is bound to profile ${binding.profile}. Switch profiles or rebind the directory.`);
-    }
-    return binding.workstreamId;
+    return {
+        ...config,
+        connectedWorkstreams: [
+            ...config.connectedWorkstreams,
+            {
+                id: workstreamId,
+                connectedAt: toIsoString(),
+            },
+        ],
+    };
 }
-function maybeTakeWorkstreamId(positionals) {
-    if (positionals[0]?.startsWith("ws_")) {
+function upsertCornerOverride(config, relativePath, corner) {
+    if (relativePath === ".") {
         return {
-            workstreamId: positionals[0],
-            rest: positionals.slice(1),
+            ...config,
+            defaultCorner: corner,
         };
     }
+    const overrides = config.cornerOverrides.filter((entry) => entry.path !== relativePath);
+    overrides.push({
+        path: relativePath,
+        cornerId: corner.id,
+        cornerName: corner.name,
+        updatedAt: toIsoString(),
+    });
+    overrides.sort((left, right) => left.path.localeCompare(right.path));
     return {
-        rest: positionals,
+        ...config,
+        cornerOverrides: overrides,
     };
 }
+const GUIDANCE_SECTION_START = "<!-- corners-cli:start -->";
+const GUIDANCE_SECTION_END = "<!-- corners-cli:end -->";
+function buildGuidanceSection() {
+    return [
+        "## Corners CLI",
+        "",
+        "Corners CLI usage is local to each user. These shared instructions describe how AI should use the CLI, not which corners or workstreams a user has selected locally.",
+        "",
+        "- Only assume Corners CLI is initialized when `.corners/config.json` exists locally in the current repo root or an ancestor folder.",
+        "- The current folder selects the default corner through local path rules managed by `corners corner use`.",
+        "- Create new workstreams with `corners workstream create`.",
+        "- Connect existing workstreams to the local environment with `corners workstream use <workstreamId>`.",
+        "- Pass explicit workstream IDs to `corners workstream pull`, `push`, `question`, and `attach` commands.",
+        "- `corners workstream list` shows the workstreams connected for the current local environment.",
+        "",
+        "If `.corners/config.json` is absent, do not assume the repo is initialized for the current user.",
+    ].join("\n");
+}
+function upsertManagedSection(existing, section) {
+    const block = `${GUIDANCE_SECTION_START}\n${section}\n${GUIDANCE_SECTION_END}`;
+    const startIndex = existing.indexOf(GUIDANCE_SECTION_START);
+    const endIndex = existing.indexOf(GUIDANCE_SECTION_END);
+    if (startIndex >= 0 && endIndex > startIndex) {
+        return ensureTrailingNewline(`${existing.slice(0, startIndex).trimEnd()}\n\n${block}\n${existing
+            .slice(endIndex + GUIDANCE_SECTION_END.length)
+            .trimStart()}`.trim());
+    }
+    const trimmed = existing.trim();
+    if (!trimmed) {
+        return ensureTrailingNewline(block);
+    }
+    return ensureTrailingNewline(`${trimmed}\n\n${block}`);
+}
+function buildGuidanceFileContent(target, existing) {
+    const section = buildGuidanceSection();
+    if (target === "cursor") {
+        const base = existing?.trim()
+            ? existing
+            : [
+                "---",
+                "description: Corners CLI guidance",
+                "alwaysApply: true",
+                "---",
+                "",
+            ].join("\n");
+        return upsertManagedSection(base, section);
+    }
+    return upsertManagedSection(existing ?? "", section);
+}
+async function buildPlannedEdit(path, nextContent) {
+    const existing = await readOptionalUtf8(path);
+    if (existing === nextContent) {
+        return null;
+    }
+    return {
+        path,
+        action: existing === null ? "create" : "update",
+        content: nextContent,
+    };
+}
+function ensureGitignoreEntry(existing) {
+    const content = existing ?? "";
+    const lines = content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (lines.includes(".corners") ||
+        lines.includes(".corners/") ||
+        lines.includes(LOCAL_ROOT_CONFIG_RELATIVE_PATH)) {
+        return ensureTrailingNewline(content);
+    }
+    const trimmed = content.trimEnd();
+    if (!trimmed) {
+        return `${LOCAL_ROOT_CONFIG_RELATIVE_PATH}\n`;
+    }
+    return `${trimmed}\n${LOCAL_ROOT_CONFIG_RELATIVE_PATH}\n`;
+}
+async function writePlannedEdits(edits) {
+    for (const edit of edits) {
+        await mkdir(dirname(edit.path), { recursive: true });
+        await writeFile(edit.path, edit.content, "utf8");
+    }
+}
+function formatWorkstreamLine(workstream) {
+    return `${workstream.id}  ${workstream.name}  ${workstream.status.toLowerCase()}${workstream.summary ? `  ${workstream.summary}` : ""}`;
+}
 async function handleAuth(args, runtime, inherited) {
     const subcommand = args[0];
     if (!subcommand || subcommand === "help" || subcommand === "--help") {
@@ -579,15 +951,32 @@ async function handleAuth(args, runtime, inherited) {
             if (!token.access_token) {
                 throw new CLIError("Login completed without an access token");
             }
-            const profile = {
+            let profile = {
                 apiUrl: client.apiUrl,
                 accessToken: token.access_token,
                 sessionId: token.session_id ?? null,
                 workspace: token.workspace ?? null,
                 accountId: token.account_id ?? null,
                 userId: token.user_id ?? null,
+                handle: null,
                 createdAt: toIsoString(),
             };
+            try {
+                const identity = await fetchCurrentIdentity(runtime.createClient({
+                    apiUrl: profile.apiUrl,
+                    accessToken: profile.accessToken,
+                }));
+                profile = {
+                    ...profile,
+                    workspace: identity.workspace,
+                    accountId: identity.accountId,
+                    userId: identity.userId,
+                    handle: identity.handle,
+                };
+            }
+            catch {
+                // Best-effort profile enrichment. Authentication already succeeded.
+            }
             await runtime.config.saveProfile(profileName, profile, {
                 setActive: true,
             });
@@ -598,6 +987,7 @@ async function handleAuth(args, runtime, inherited) {
                     apiUrl: profile.apiUrl,
                     sessionId: profile.sessionId,
                     workspace: profile.workspace,
+                    handle: profile.handle,
                     accountId: profile.accountId,
                     userId: profile.userId,
                 });
@@ -693,12 +1083,8 @@ async function handleAuth(args, runtime, inherited) {
                 printAuthHelp(runtime);
                 return 0;
             }
-            const selected = await runtime.config.getProfile(common.profile ?? null);
-            if (!selected) {
-                const status = {
-                    loggedIn: false,
-                    profile: common.profile ?? null,
-                };
+            const status = await resolveAuthStatus(runtime, common);
+            if (!status.loggedIn) {
                 if (common.json) {
                     printJson(runtime.stdout, status);
                 }
@@ -707,31 +1093,6 @@ async function handleAuth(args, runtime, inherited) {
                 }
                 return 0;
             }
-            const client = runtime.createClient({
-                apiUrl: common.apiUrl ?? selected.profile.apiUrl,
-                accessToken: selected.profile.accessToken,
-            });
-            let remote;
-            try {
-                remote = await client.validateSession();
-            }
-            catch (error) {
-                remote = {
-                    valid: false,
-                    error: error.message,
-                };
-            }
-            const status = {
-                loggedIn: true,
-                profile: selected.name,
-                apiUrl: common.apiUrl ?? selected.profile.apiUrl,
-                sessionId: selected.profile.sessionId,
-                workspace: selected.profile.workspace,
-                accountId: selected.profile.accountId,
-                userId: selected.profile.userId,
-                remoteValid: remote.valid,
-                remoteError: remote.valid ? null : (remote.error ?? null),
-            };
             if (common.json) {
                 printJson(runtime.stdout, status);
             }
@@ -740,6 +1101,7 @@ async function handleAuth(args, runtime, inherited) {
                     `Profile: ${status.profile}`,
                     `API URL: ${status.apiUrl}`,
                     `Workspace: ${status.workspace ?? "-"}`,
+                    `Handle: ${status.handle ? `@${status.handle}` : "-"}`,
                     `Account: ${status.accountId ?? "-"}`,
                     `User: ${status.userId ?? "-"}`,
                     `Session: ${status.sessionId ?? "-"}`,
@@ -752,6 +1114,259 @@ async function handleAuth(args, runtime, inherited) {
             throw new CLIError(`Unknown auth command: ${subcommand}`);
     }
 }
+async function handleWhoAmI(args, runtime, inherited) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: false,
+        options: {
+            json: { type: "boolean" },
+            help: { type: "boolean", short: "h" },
+            profile: { type: "string" },
+            "api-url": { type: "string" },
+        },
+    });
+    const common = mergeCommonOptions(inherited, {
+        json: parsed.values.json,
+        profile: parsed.values.profile,
+        apiUrl: parsed.values["api-url"],
+    });
+    if (parsed.values.help) {
+        printWhoamiHelp(runtime);
+        return 0;
+    }
+    const status = await resolveAuthStatus(runtime, common);
+    if (!status.loggedIn) {
+        if (common.json) {
+            printJson(runtime.stdout, status);
+        }
+        else {
+            printLine(runtime.stdout, "Not logged in.");
+        }
+        return 0;
+    }
+    if (common.json) {
+        printJson(runtime.stdout, status);
+    }
+    else {
+        const identity = status.handle
+            ? `@${status.handle}`
+            : (status.userId ?? status.profile);
+        const workspaceSuffix = status.workspace ? ` (${status.workspace})` : "";
+        printLine(runtime.stdout, `${identity}${workspaceSuffix}`);
+    }
+    return 0;
+}
+async function handleInit(args, runtime, inherited) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: false,
+        options: {
+            json: { type: "boolean" },
+            help: { type: "boolean", short: "h" },
+            profile: { type: "string" },
+            "api-url": { type: "string" },
+        },
+    });
+    const common = mergeCommonOptions(inherited, {
+        json: parsed.values.json,
+        profile: parsed.values.profile,
+        apiUrl: parsed.values["api-url"],
+    });
+    if (parsed.values.help) {
+        printInitHelp(runtime);
+        return 0;
+    }
+    const currentRootPath = await realpath(runtime.cwd);
+    const existingRoot = await runtime.config.findLocalRoot(runtime.cwd);
+    if (existingRoot && existingRoot.rootDir !== currentRootPath) {
+        throw new CLIError(`This directory is already inside initialized root ${existingRoot.rootDir}. Run \`corners init\` there.`, { json: common.json });
+    }
+    const { profileName, profile, client } = await requireStoredProfile(runtime, common);
+    const joinedCorners = await listMemberCorners(client);
+    if (joinedCorners.length === 0) {
+        throw new CLIError("No joined corners are available for this profile.", {
+            json: common.json,
+        });
+    }
+    const rootDir = existingRoot?.rootDir ?? currentRootPath;
+    const existingConfig = existingRoot?.config ?? null;
+    return withPrompts(runtime, async (prompts) => {
+        const guidanceTargets = [
+            {
+                key: "agents",
+                label: "Manage AGENTS.md guidance",
+                relativePath: "AGENTS.md",
+            },
+            {
+                key: "claude",
+                label: "Manage CLAUDE.md guidance",
+                relativePath: "CLAUDE.md",
+            },
+            {
+                key: "cursor",
+                label: "Manage Cursor rule guidance",
+                relativePath: ".cursor/rules/corners-cli.mdc",
+            },
+            {
+                key: "copilot",
+                label: "Manage Copilot instructions",
+                relativePath: ".github/copilot-instructions.md",
+            },
+        ];
+        const selectedTargets = [];
+        for (const target of guidanceTargets) {
+            const include = await prompts.confirm(target.label, {
+                defaultValue: true,
+            });
+            if (include) {
+                selectedTargets.push(target);
+            }
+        }
+        const selectedCornerId = await prompts.select("Choose the default corner for this local root.", joinedCorners.map((corner) => ({
+            label: `${corner.name} (${corner.id})`,
+            value: corner.id,
+        })), {
+            defaultValue: existingConfig?.defaultCorner.id ?? joinedCorners[0]?.id,
+        });
+        const defaultCorner = joinedCorners.find((corner) => corner.id === selectedCornerId) ??
+            joinedCorners[0];
+        const nextLocalConfig = {
+            version: 1,
+            profile: profileName,
+            workspace: profile.workspace,
+            apiUrl: profile.apiUrl,
+            defaultCorner: {
+                id: defaultCorner.id,
+                name: defaultCorner.name,
+            },
+            cornerOverrides: existingConfig?.cornerOverrides ?? [],
+            connectedWorkstreams: existingConfig?.connectedWorkstreams ?? [],
+        };
+        const plannedEdits = [];
+        const gitignorePath = join(rootDir, ".gitignore");
+        const gitignoreContent = ensureGitignoreEntry(await readOptionalUtf8(gitignorePath));
+        const gitignoreEdit = await buildPlannedEdit(gitignorePath, gitignoreContent);
+        if (gitignoreEdit) {
+            plannedEdits.push(gitignoreEdit);
+        }
+        const localConfigPath = runtime.config.getLocalConfigPath(rootDir);
+        const localConfigEdit = await buildPlannedEdit(localConfigPath, `${JSON.stringify(nextLocalConfig, null, 2)}\n`);
+        if (localConfigEdit) {
+            plannedEdits.push(localConfigEdit);
+        }
+        for (const target of selectedTargets) {
+            const targetPath = join(rootDir, target.relativePath);
+            const nextContent = buildGuidanceFileContent(target.key, await readOptionalUtf8(targetPath));
+            const edit = await buildPlannedEdit(targetPath, nextContent);
+            if (edit) {
+                plannedEdits.push(edit);
+            }
+        }
+        if (plannedEdits.length > 0 && !common.json) {
+            printLine(runtime.stderr, [
+                "Planned changes:",
+                ...plannedEdits.map((edit) => `  ${edit.action} ${relative(rootDir, edit.path) || "."}`),
+            ].join("\n"));
+        }
+        if (plannedEdits.length > 0) {
+            const confirmed = await prompts.confirm("Proceed with these changes?", {
+                defaultValue: true,
+            });
+            if (!confirmed) {
+                if (common.json) {
+                    printJson(runtime.stdout, {
+                        ok: false,
+                        root: rootDir,
+                        aborted: true,
+                    });
+                }
+                else {
+                    printLine(runtime.stdout, "Aborted. No files were changed.");
+                }
+                return 0;
+            }
+            await writePlannedEdits(plannedEdits);
+        }
+        const payload = {
+            ok: true,
+            root: rootDir,
+            profile: profileName,
+            workspace: profile.workspace,
+            defaultCorner,
+            files: plannedEdits.map((edit) => ({
+                action: edit.action,
+                path: relative(rootDir, edit.path) || ".",
+            })),
+        };
+        if (common.json) {
+            printJson(runtime.stdout, payload);
+        }
+        else {
+            printLine(runtime.stdout, `Initialized Corners CLI at ${rootDir} with default corner ${defaultCorner.name}.`);
+        }
+        return 0;
+    });
+}
+async function handleCorner(args, runtime, inherited) {
+    const subcommand = args[0];
+    if (!subcommand || subcommand === "help" || subcommand === "--help") {
+        printCornerHelp(runtime);
+        return 0;
+    }
+    switch (subcommand) {
+        case "use": {
+            const parsed = parseArgs({
+                args: args.slice(1),
+                allowPositionals: true,
+                options: {
+                    json: { type: "boolean" },
+                    help: { type: "boolean", short: "h" },
+                    profile: { type: "string" },
+                    "api-url": { type: "string" },
+                    path: { type: "string" },
+                },
+            });
+            const common = mergeCommonOptions(inherited, {
+                json: parsed.values.json,
+                profile: parsed.values.profile,
+                apiUrl: parsed.values["api-url"],
+            });
+            if (parsed.values.help) {
+                printCornerHelp(runtime);
+                return 0;
+            }
+            const cornerNameOrId = parsed.positionals[0];
+            if (!cornerNameOrId) {
+                throw new CLIError("Usage: corners corner use <cornerNameOrId> [--path <path>]", { json: common.json });
+            }
+            const root = await requireLocalRoot(runtime, common);
+            const { client } = await requirePinnedRootProfile(runtime, common, root);
+            const corner = await resolveMemberCorner(client, common, cornerNameOrId);
+            const cwdPath = await realpath(runtime.cwd);
+            const targetAbsolutePath = resolvePathWithinRoot(root.rootDir, cwdPath, parsed.values.path);
+            const relativePath = normalizeStoredRelativePath(root.rootDir, targetAbsolutePath);
+            const nextConfig = upsertCornerOverride(root.config, relativePath, {
+                id: corner.id,
+                name: corner.name,
+            });
+            await runtime.config.writeLocalConfig(root.rootDir, nextConfig);
+            if (common.json) {
+                printJson(runtime.stdout, {
+                    ok: true,
+                    root: root.rootDir,
+                    path: relativePath,
+                    corner,
+                });
+            }
+            else {
+                printLine(runtime.stdout, `Set default corner for ${relativePath} to ${corner.name}.`);
+            }
+            return 0;
+        }
+        default:
+            throw new CLIError(`Unknown corner command: ${subcommand}`);
+    }
+}
 async function handleWorkstream(args, runtime, inherited) {
     const subcommand = args[0];
     if (!subcommand || subcommand === "help" || subcommand === "--help") {
@@ -779,16 +1394,44 @@ async function handleWorkstream(args, runtime, inherited) {
                 printWorkstreamHelp(runtime);
                 return 0;
             }
-            const { client } = await requireStoredProfile(runtime, common);
-            const data = await client.graphql(LIST_WORKSTREAMS_QUERY);
-            const workstreams = data.workstreams.edges.map((edge) => edge.node);
+            const root = await requireLocalRoot(runtime, common);
+            const { client } = await requirePinnedRootProfile(runtime, common, root);
+            const hydrated = await Promise.all(root.config.connectedWorkstreams.map(async (entry) => {
+                try {
+                    return {
+                        entry,
+                        workstream: await resolveExplicitWorkstream(client, common, entry.id),
+                    };
+                }
+                catch {
+                    return {
+                        entry,
+                        workstream: null,
+                    };
+                }
+            }));
+            const workstreams = hydrated
+                .filter((entry) => entry.workstream !== null)
+                .map((entry) => entry.workstream);
+            const missingWorkstreamIds = hydrated
+                .filter((entry) => entry.workstream === null)
+                .map((entry) => entry.entry.id);
             if (common.json) {
-                printJson(runtime.stdout, workstreams);
+                printJson(runtime.stdout, {
+                    root: root.rootDir,
+                    workstreams,
+                    missingWorkstreamIds,
+                });
             }
             else {
-                printLine(runtime.stdout, workstreams
-                    .map((workstream) => `${workstream.id}  ${workstream.name}  ${workstream.status.toLowerCase()}${workstream.summary ? `  ${workstream.summary}` : ""}`)
-                    .join("\n"));
+                if (missingWorkstreamIds.length > 0) {
+                    printLine(runtime.stderr, missingWorkstreamIds
+                        .map((workstreamId) => `Warning: connected workstream ${workstreamId} is missing or inaccessible.`)
+                        .join("\n"));
+                }
+                printLine(runtime.stdout, workstreams.length > 0
+                    ? workstreams.map(formatWorkstreamLine).join("\n")
+                    : "No workstreams are connected to this local environment.");
             }
             return 0;
         }
@@ -818,26 +1461,22 @@ async function handleWorkstream(args, runtime, inherited) {
                     json: common.json,
                 });
             }
-            const { profileName, profile, client } = await requireStoredProfile(runtime, common);
-            const workstream = await resolveExplicitOrBoundWorkstream(runtime, common, client, profileName, workstreamId);
-            await runtime.config.setBinding(runtime.cwd, {
-                profile: profileName,
-                workspace: profile.workspace ?? "",
-                workstreamId: workstream.id,
-                cornerId: workstream.cornerId,
-                boundAt: toIsoString(),
-            });
+            const root = await requireLocalRoot(runtime, common);
+            const { client } = await requirePinnedRootProfile(runtime, common, root);
+            const workstream = await resolveExplicitWorkstream(client, common, workstreamId);
+            const nextConfig = connectWorkstream(root.config, workstream.id);
+            if (nextConfig !== root.config) {
+                await runtime.config.writeLocalConfig(root.rootDir, nextConfig);
+            }
             if (common.json) {
                 printJson(runtime.stdout, {
                     ok: true,
-                    cwd: runtime.cwd,
-                    profile: profileName,
-                    workspace: profile.workspace,
+                    root: root.rootDir,
                     workstream,
                 });
             }
             else {
-                printLine(runtime.stdout, `Bound ${runtime.cwd} to ${workstream.id} (${workstream.name}).`);
+                printLine(runtime.stdout, `Connected ${workstream.id} (${workstream.name}) to ${root.rootDir}.`);
             }
             return 0;
         }
@@ -857,30 +1496,85 @@ async function handleWorkstream(args, runtime, inherited) {
                 printWorkstreamHelp(runtime);
                 return 0;
             }
-            const binding = await runtime.config.getBinding(runtime.cwd);
-            if (!binding) {
-                if (common.json) {
-                    printJson(runtime.stdout, { cwd: runtime.cwd, binding: null });
-                }
-                else {
-                    printLine(runtime.stdout, "No workstream is bound to this directory.");
-                }
+            const root = await requireLocalRoot(runtime, common);
+            const cwdPath = await realpath(runtime.cwd);
+            const resolvedCorner = resolveCornerForCwd(root, cwdPath);
+            const payload = {
+                cwd: runtime.cwd,
+                root: root.rootDir,
+                profile: root.config.profile,
+                workspace: root.config.workspace,
+                resolvedCorner,
+                connectedWorkstreamIds: root.config.connectedWorkstreams.map((entry) => entry.id),
+            };
+            if (common.json) {
+                printJson(runtime.stdout, payload);
+            }
+            else {
+                printLine(runtime.stdout, [
+                    `Root: ${payload.root}`,
+                    `Directory: ${payload.cwd}`,
+                    `Profile: ${payload.profile}`,
+                    `Workspace: ${payload.workspace ?? "-"}`,
+                    `Resolved corner: ${payload.resolvedCorner.corner.name} (${payload.resolvedCorner.corner.id})`,
+                    `Connected workstreams: ${payload.connectedWorkstreamIds.length}`,
+                ].join("\n"));
+            }
+            return 0;
+        }
+        case "create": {
+            const parsed = parseArgs({
+                args: args.slice(1),
+                allowPositionals: true,
+                options: {
+                    json: { type: "boolean" },
+                    help: { type: "boolean", short: "h" },
+                    profile: { type: "string" },
+                    "api-url": { type: "string" },
+                    summary: { type: "string" },
+                    corner: { type: "string" },
+                },
+            });
+            const common = mergeCommonOptions(inherited, {
+                json: parsed.values.json,
+                profile: parsed.values.profile,
+                apiUrl: parsed.values["api-url"],
+            });
+            if (parsed.values.help) {
+                printWorkstreamHelp(runtime);
                 return 0;
             }
+            const name = parsed.positionals.join(" ").trim();
+            if (!name) {
+                throw new CLIError("Usage: corners workstream create <name> [--summary <text>] [--corner <cornerNameOrId>]", { json: common.json });
+            }
+            const root = await requireLocalRoot(runtime, common);
+            const { client } = await requirePinnedRootProfile(runtime, common, root);
+            const cwdPath = await realpath(runtime.cwd);
+            const corner = parsed.values.corner
+                ? await resolveMemberCorner(client, common, parsed.values.corner)
+                : resolveCornerForCwd(root, cwdPath).corner;
+            const result = await client.graphql(CREATE_WORKSTREAM_MUTATION, {
+                input: {
+                    cornerId: corner.id,
+                    name,
+                    summary: parsed.values.summary,
+                },
+            });
+            const nextConfig = connectWorkstream(root.config, result.createWorkstream.id);
+            if (nextConfig !== root.config) {
+                await runtime.config.writeLocalConfig(root.rootDir, nextConfig);
+            }
             if (common.json) {
                 printJson(runtime.stdout, {
-                    cwd: runtime.cwd,
-                    binding,
+                    ok: true,
+                    root: root.rootDir,
+                    corner,
+                    workstream: result.createWorkstream,
                 });
             }
             else {
-                printLine(runtime.stdout, [
-                    `Directory: ${runtime.cwd}`,
-                    `Profile: ${binding.profile ?? "-"}`,
-                    `Workspace: ${binding.workspace || "-"}`,
-                    `Workstream: ${binding.workstreamId}`,
-                    `Corner: ${binding.cornerId}`,
-                ].join("\n"));
+                printLine(runtime.stdout, `Created ${result.createWorkstream.id} (${result.createWorkstream.name}) in ${corner.name}.`);
             }
             return 0;
         }
@@ -904,9 +1598,14 @@ async function handleWorkstream(args, runtime, inherited) {
                 printWorkstreamHelp(runtime);
                 return 0;
             }
-            const { workstreamId } = maybeTakeWorkstreamId(parsed.positionals);
-            const { profileName, client } = await requireStoredProfile(runtime, common);
-            const workstream = await resolveExplicitOrBoundWorkstream(runtime, common, client, profileName, workstreamId);
+            const workstreamId = parsed.positionals[0];
+            if (!workstreamId) {
+                throw new CLIError("Usage: corners workstream pull <workstreamId>", {
+                    json: common.json,
+                });
+            }
+            const { client } = await requireCommandProfile(runtime, common);
+            const workstream = await resolveExplicitWorkstream(client, common, workstreamId);
             const data = await client.graphql(WORKSTREAM_PULL_QUERY, {
                 id: workstream.id,
                 attachmentsFirst: 50,
@@ -953,16 +1652,21 @@ async function handleWorkstream(args, runtime, inherited) {
                 printWorkstreamHelp(runtime);
                 return 0;
             }
-            const { workstreamId, rest } = maybeTakeWorkstreamId(parsed.positionals);
+            const workstreamId = parsed.positionals[0];
+            if (!workstreamId) {
+                throw new CLIError("Usage: corners workstream push <workstreamId>", {
+                    json: common.json,
+                });
+            }
             const message = parsed.values.message ??
-                (rest.length > 0
-                    ? rest.join(" ")
+                (parsed.positionals.length > 1
+                    ? parsed.positionals.slice(1).join(" ")
                     : await readTextFromStdin(runtime.stdin));
             if (!message) {
                 throw new CLIError("Workstream updates need a message. Use --message or pipe text on stdin.", { json: common.json });
             }
-            const { profileName, client } = await requireStoredProfile(runtime, common);
-            const workstream = await resolveExplicitOrBoundWorkstream(runtime, common, client, profileName, workstreamId);
+            const { client } = await requireCommandProfile(runtime, common);
+            const workstream = await resolveExplicitWorkstream(client, common, workstreamId);
             let createdDocument = null;
             if (parsed.values.file) {
                 const documentContent = await readFile(parsed.values.file, "utf8");
@@ -1026,9 +1730,12 @@ async function handleWorkstream(args, runtime, inherited) {
                         printWorkstreamHelp(runtime);
                         return 0;
                     }
-                    const { workstreamId } = maybeTakeWorkstreamId(parsed.positionals);
-                    const { profileName, client } = await requireStoredProfile(runtime, common);
-                    const workstream = await resolveExplicitOrBoundWorkstream(runtime, common, client, profileName, workstreamId);
+                    const workstreamId = parsed.positionals[0];
+                    if (!workstreamId) {
+                        throw new CLIError("Usage: corners workstream question list <workstreamId>", { json: common.json });
+                    }
+                    const { client } = await requireCommandProfile(runtime, common);
+                    const workstream = await resolveExplicitWorkstream(client, common, workstreamId);
                     const data = await client.graphql(WORKSTREAM_QUESTION_LIST_QUERY, {
                         id: workstream.id,
                     });
@@ -1071,16 +1778,19 @@ async function handleWorkstream(args, runtime, inherited) {
                         printWorkstreamHelp(runtime);
                         return 0;
                     }
-                    const { workstreamId, rest } = maybeTakeWorkstreamId(parsed.positionals);
+                    const workstreamId = parsed.positionals[0];
+                    if (!workstreamId) {
+                        throw new CLIError("Usage: corners workstream question ask <workstreamId> [--question <text>]", { json: common.json });
+                    }
                     const question = parsed.values.question ??
-                        (rest.length > 0
-                            ? rest.join(" ")
+                        (parsed.positionals.length > 1
+                            ? parsed.positionals.slice(1).join(" ")
                             : await readTextFromStdin(runtime.stdin));
                     if (!question) {
                         throw new CLIError("Question text is required. Use --question or pipe text on stdin.", { json: common.json });
                     }
-                    const { profileName, client } = await requireStoredProfile(runtime, common);
-                    const workstream = await resolveExplicitOrBoundWorkstream(runtime, common, client, profileName, workstreamId);
+                    const { client } = await requireCommandProfile(runtime, common);
+                    const workstream = await resolveExplicitWorkstream(client, common, workstreamId);
                     const result = await client.graphql(CREATE_WORKSTREAM_QUESTION_MUTATION, {
                         input: {
                             workstreamId: workstream.id,
@@ -1131,7 +1841,7 @@ async function handleWorkstream(args, runtime, inherited) {
                             json: common.json,
                         });
                     }
-                    const { client } = await requireStoredProfile(runtime, common);
+                    const { client } = await requireCommandProfile(runtime, common);
                     const result = await client.graphql(ANSWER_WORKSTREAM_QUESTION_MUTATION, {
                         questionId,
                         answerText: answer,
@@ -1170,14 +1880,14 @@ async function handleWorkstream(args, runtime, inherited) {
                 printWorkstreamHelp(runtime);
                 return 0;
             }
-            const { workstreamId } = maybeTakeWorkstreamId(parsed.positionals);
+            const workstreamId = parsed.positionals[0];
             const kind = parsed.values.kind;
             const entityId = parsed.values["entity-id"];
-            if (!kind || !entityId) {
-                throw new CLIError("Usage: corners workstream attach [workstreamId] --kind <kind> --entity-id <id>", { json: common.json });
+            if (!workstreamId || !kind || !entityId) {
+                throw new CLIError("Usage: corners workstream attach <workstreamId> --kind <kind> --entity-id <id>", { json: common.json });
             }
-            const { profileName, client } = await requireStoredProfile(runtime, common);
-            const workstream = await resolveExplicitOrBoundWorkstream(runtime, common, client, profileName, workstreamId);
+            const { client } = await requireCommandProfile(runtime, common);
+            const workstream = await resolveExplicitWorkstream(client, common, workstreamId);
             const result = await client.graphql(ADD_WORKSTREAM_ATTACHMENT_MUTATION, {
                 workstreamId: workstream.id,
                 kind: toGraphQLAttachmentKind(kind),
@@ -1220,7 +1930,7 @@ async function handleWorkstream(args, runtime, inherited) {
             if (!threadId || !text) {
                 throw new CLIError("Usage: corners workstream reply-thread <threadId> [--text <text>]", { json: common.json });
             }
-            const { client } = await requireStoredProfile(runtime, common);
+            const { client } = await requireCommandProfile(runtime, common);
             const result = await client.graphql(REPLY_ARTIFACT_THREAD_MUTATION, {
                 id: threadId,
                 input: {
@@ -1260,6 +1970,15 @@ export async function runCli(argv, runtime = createRuntime()) {
             if (parsed.rest[1] === "auth") {
                 printAuthHelp(runtime);
             }
+            else if (parsed.rest[1] === "init") {
+                printInitHelp(runtime);
+            }
+            else if (parsed.rest[1] === "corner") {
+                printCornerHelp(runtime);
+            }
+            else if (parsed.rest[1] === "whoami") {
+                printWhoamiHelp(runtime);
+            }
             else if (parsed.rest[1] === "workstream" || parsed.rest[1] === "ws") {
                 printWorkstreamHelp(runtime);
             }
@@ -1270,8 +1989,14 @@ export async function runCli(argv, runtime = createRuntime()) {
         case "version":
             printLine(runtime.stdout, runtime.getVersion());
             return 0;
+        case "init":
+            return handleInit(parsed.rest.slice(1), runtime, parsed.common);
         case "auth":
             return handleAuth(parsed.rest.slice(1), runtime, parsed.common);
+        case "corner":
+            return handleCorner(parsed.rest.slice(1), runtime, parsed.common);
+        case "whoami":
+            return handleWhoAmI(parsed.rest.slice(1), runtime, parsed.common);
         case "workstream":
         case "ws":
             return handleWorkstream(parsed.rest.slice(1), runtime, parsed.common);