@corners/cli 0.0.4 → 0.0.6

package/dist/skills.js

@@ -0,0 +1,160 @@
+/**
+ * Skill management for Corners CLI.
+ * Handles bundled skill discovery, installation, auto-sync, and state resolution.
+ */
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildPlannedEdit, readOptionalUtf8, writePlannedEdits, } from "./support.js";
+export const BUNDLED_SKILLS = [
+    { name: "corners-ask", dirName: "corners-ask", fileName: "SKILL.md" },
+    { name: "corners-plan", dirName: "corners-plan", fileName: "SKILL.md" },
+    { name: "corners-push", dirName: "corners-push", fileName: "SKILL.md" },
+    { name: "corners-sync", dirName: "corners-sync", fileName: "SKILL.md" },
+];
+export function getBundledSkillsDir() {
+    return fileURLToPath(new URL("../skills", import.meta.url));
+}
+export function getBundledSkillPath(skill) {
+    return join(getBundledSkillsDir(), skill.dirName, skill.fileName);
+}
+export function getInstalledSkillPath(rootDir, skill) {
+    return join(rootDir, ".claude", "skills", skill.dirName, skill.fileName);
+}
+export function parseSkillFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match) {
+        return null;
+    }
+    const block = match[1];
+    const nameMatch = block.match(/^name:\s*(.+)$/m);
+    const versionMatch = block.match(/^version:\s*(.+)$/m);
+    if (!nameMatch || !versionMatch) {
+        return null;
+    }
+    let description = "";
+    const descBlockMatch = block.match(/^description:\s*\|\s*\r?\n([\s\S]*?)(?=\n[a-z][\w-]*:|\s*$)/m);
+    if (descBlockMatch) {
+        description = descBlockMatch[1]
+            .split(/\r?\n/)
+            .map((line) => line.replace(/^ {2}/, "").trim())
+            .filter(Boolean)
+            .join(" ");
+    }
+    else {
+        const descInlineMatch = block.match(/^description:\s*(.+)$/m);
+        if (descInlineMatch) {
+            description = descInlineMatch[1].trim();
+        }
+    }
+    return {
+        name: nameMatch[1].trim(),
+        version: versionMatch[1].trim(),
+        description,
+    };
+}
+export function computeSkillHash(content) {
+    return createHash("sha256")
+        .update(content, "utf8")
+        .digest("hex")
+        .slice(0, 16);
+}
+export async function resolveSkillsState(rootDir, config) {
+    const skills = [];
+    let hasStale = false;
+    for (const skill of BUNDLED_SKILLS) {
+        const bundledContent = await readFile(getBundledSkillPath(skill), "utf8");
+        const bundledFrontmatter = parseSkillFrontmatter(bundledContent);
+        const installedPath = getInstalledSkillPath(rootDir, skill);
+        const installedContent = await readOptionalUtf8(installedPath);
+        if (installedContent === null) {
+            hasStale = true;
+            skills.push({
+                name: skill.name,
+                state: "missing",
+                installedVersion: null,
+                bundledVersion: bundledFrontmatter?.version ?? "unknown",
+                installedPath,
+            });
+            continue;
+        }
+        const bundledHash = computeSkillHash(bundledContent);
+        const installedHash = computeSkillHash(installedContent);
+        const installedFrontmatter = parseSkillFrontmatter(installedContent);
+        if (bundledHash === installedHash) {
+            skills.push({
+                name: skill.name,
+                state: "current",
+                installedVersion: installedFrontmatter?.version ?? "unknown",
+                bundledVersion: bundledFrontmatter?.version ?? "unknown",
+                installedPath,
+            });
+        }
+        else {
+            hasStale = true;
+            skills.push({
+                name: skill.name,
+                state: "stale",
+                installedVersion: installedFrontmatter?.version ?? "unknown",
+                bundledVersion: bundledFrontmatter?.version ?? "unknown",
+                installedPath,
+            });
+        }
+    }
+    return {
+        stale: hasStale,
+        lastSyncedAt: config.skills?.syncedAt ?? null,
+        skills,
+    };
+}
+export async function buildSkillPlannedEdits(rootDir) {
+    const edits = [];
+    for (const skill of BUNDLED_SKILLS) {
+        const bundledContent = await readFile(getBundledSkillPath(skill), "utf8");
+        const installedPath = getInstalledSkillPath(rootDir, skill);
+        const edit = await buildPlannedEdit(installedPath, bundledContent);
+        if (edit) {
+            edits.push(edit);
+        }
+    }
+    return edits;
+}
+export async function buildInstalledSkillReferences(syncedAt) {
+    const refs = [];
+    for (const skill of BUNDLED_SKILLS) {
+        const content = await readFile(getBundledSkillPath(skill), "utf8");
+        const frontmatter = parseSkillFrontmatter(content);
+        refs.push({
+            name: skill.name,
+            version: frontmatter?.version ?? "unknown",
+            contentHash: computeSkillHash(content),
+            installedAt: syncedAt,
+        });
+    }
+    return refs;
+}
+export function withUpdatedSkillsConfig(config, installedSkills, syncedAt) {
+    return {
+        ...config,
+        skills: {
+            installedSkills,
+            syncedAt,
+        },
+    };
+}
+export async function syncSkillsIfNeeded(rootDir, config, writeConfig) {
+    if (!config.skills) {
+        return;
+    }
+    const edits = await buildSkillPlannedEdits(rootDir);
+    if (edits.length === 0) {
+        return;
+    }
+    await writePlannedEdits(edits);
+    const syncedAt = new Date().toISOString();
+    const refs = await buildInstalledSkillReferences(syncedAt);
+    const nextConfig = withUpdatedSkillsConfig(config, refs, syncedAt);
+    await writeConfig(rootDir, nextConfig);
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/support.d.ts

@@ -15,7 +15,16 @@ export declare function printLine(stream: NodeJS.WritableStream, value: string):
 export declare function readTextFromStdin(stdin: NodeJS.ReadableStream): Promise<string | null>;
 export declare function openUrlInBrowser(url: string): Promise<boolean>;
 export declare function toGraphQLWorkstreamUpdateType(value: string): string;
+export declare function toGraphQLWorkstreamStatus(value: string): string;
 export declare function toGraphQLAttachmentKind(value: string): string;
 export declare function toIsoString(value?: Date): string;
 export declare function sleep(ms: number): Promise<void>;
+export type PlannedEdit = {
+    path: string;
+    action: "create" | "update";
+    content: string;
+};
+export declare function readOptionalUtf8(path: string): Promise<string | null>;
+export declare function buildPlannedEdit(path: string, nextContent: string): Promise<PlannedEdit | null>;
+export declare function writePlannedEdits(edits: PlannedEdit[]): Promise<void>;
 //# sourceMappingURL=support.d.ts.map

package/dist/support.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../src/support.ts"],"names":[],"mappings":"AAKA,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB;CAQJ;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQ7D;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAE7E;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,CAAC,cAAc,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBpE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAenE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB7D;AAED,wBAAgB,WAAW,CAAC,KAAK,GAAE,IAAiB,GAAG,MAAM,CAE5D;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C"}
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../src/support.ts"],"names":[],"mappings":"AAOA,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB;CAQJ;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQ7D;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAE7E;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,CAAC,cAAc,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBpE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAenE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB/D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoB7D;AAED,wBAAgB,WAAW,CAAC,KAAK,GAAE,IAAiB,GAAG,MAAM,CAE5D;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS3E;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAW7B;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3E"}

package/dist/support.js

@@ -1,5 +1,7 @@
 import { spawn } from "node:child_process";
 import { readFileSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
 let cachedVersion = null;
 export class CLIError extends Error {
     exitCode;
@@ -79,6 +81,21 @@ export function toGraphQLWorkstreamUpdateType(value) {
             throw new CLIError(`Invalid update type: ${value}. Expected status, blocker, learning, or outcome.`);
     }
 }
+export function toGraphQLWorkstreamStatus(value) {
+    switch (value.trim().toLowerCase()) {
+        case "scoping":
+            return "SCOPING";
+        case "in_progress":
+        case "in-progress":
+            return "IN_PROGRESS";
+        case "blocked":
+            return "BLOCKED";
+        case "done":
+            return "DONE";
+        default:
+            throw new CLIError(`Invalid workstream status: ${value}. Expected scoping, in_progress, blocked, or done.`);
+    }
+}
 export function toGraphQLAttachmentKind(value) {
     switch (value.trim().toLowerCase()) {
         case "thread":
@@ -90,8 +107,12 @@ export function toGraphQLAttachmentKind(value) {
         case "calendar-event":
         case "calendar_event":
             return "CALENDAR_EVENT";
+        case "todolist":
+        case "todo_list":
+        case "todo-list":
+            return "TODOLIST";
         default:
-            throw new CLIError(`Invalid attachment kind: ${value}. Expected thread, document, datatable, or calendar_event.`);
+            throw new CLIError(`Invalid attachment kind: ${value}. Expected thread, document, datatable, calendar_event, or todolist.`);
     }
 }
 export function toIsoString(value = new Date()) {
@@ -102,4 +123,32 @@ export function sleep(ms) {
         setTimeout(resolve, ms);
     });
 }
+export async function readOptionalUtf8(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function buildPlannedEdit(path, nextContent) {
+    const existing = await readOptionalUtf8(path);
+    if (existing === nextContent) {
+        return null;
+    }
+    return {
+        path,
+        action: existing === null ? "create" : "update",
+        content: nextContent,
+    };
+}
+export async function writePlannedEdits(edits) {
+    for (const edit of edits) {
+        await mkdir(dirname(edit.path), { recursive: true });
+        await writeFile(edit.path, edit.content, "utf8");
+    }
+}
 //# sourceMappingURL=support.js.map

package/dist/support.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corners/cli",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -9,7 +9,8 @@
     "corners": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "publishConfig": {
     "access": "public"

package/skills/corners-ask/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: corners-ask
+version: 0.1.0
+description: |
+  Post a durable question to a workstream for team input.
+  Offers structured templates and auto-generates rationale from code context.
+allowed-tools:
+  - Bash
+  - Read
+  - AskUserQuestion
+---
+
+# /corners-ask — "I need the team's input"
+
+Post a well-structured question to your workstream. The question is visible to the
+whole team in corner chat. When they answer, skill continuation can auto-resume
+your work if configured.
+
+---
+
+## Step 0: Preamble
+
+Run these commands to check auth and resolve context:
+
+```bash
+corners auth status --json 2>/dev/null || echo "CORNERS_CLI_MISSING"
+```
+
+```bash
+corners workstream current --json 2>/dev/null
+```
+
+```bash
+_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
+echo "BRANCH: $_BRANCH"
+```
+
+**Error handling — check in this order:**
+
+1. If `CORNERS_CLI_MISSING` or `command not found`: tell user to install (`npm install -g @corners/cli`) and **STOP**.
+2. If `loggedIn=false` OR `remoteValid=false`: tell user to run `corners auth login` and **STOP**.
+3. If `resolvedCorner` is null: tell user to run `corners corner use <id>` and **STOP**.
+4. If `connectedWorkstreamIds` is empty: tell user to run `/corners-sync` first and **STOP**.
+
+Use the first connected workstream ID for all subsequent steps.
+
+---
+
+## Step 1: Gather Code Context
+
+Run:
+
+```bash
+git diff --stat 2>/dev/null | head -10
+```
+
+```bash
+git log --oneline -5 2>/dev/null
+```
+
+Note the current branch, recently modified files, and recent commit messages.
+This context will be used to auto-generate the question's rationale.
+
+---
+
+## Step 2: Choose Question Template
+
+Use AskUserQuestion:
+- Re-ground: "Workstream question on branch {branch}."
+- Question: "What kind of question do you need to ask the team?"
+- Options:
+  - **A) Architecture decision** — "We need to choose between technical approaches. I'll help you frame the options and tradeoffs."
+  - **B) Scope clarification** — "Something might be in or out of scope. I'll help you ask clearly."
+  - **C) Blocker escalation** — "You're blocked and need someone to unblock you. I'll help frame the urgency."
+  - **D) Freeform** — "Custom question — I'll help you sharpen it."
+
+Note the selected template for Step 3.
+
+---
+
+## Step 3: Formulate the Question
+
+Based on the selected template, guide the user through formulation.
+
+### Template A: Architecture Decision
+
+Use AskUserQuestion:
+- Question: "What's the technical decision you're facing? Describe the options you see."
+- Options: freeform text
+
+Then draft the question in this structure:
+```
+We need to decide: {user's decision}
+
+Options:
+A) {option 1} — {tradeoff}
+B) {option 2} — {tradeoff}
+C) {option 3 if applicable}
+
+Context: Currently working on branch {branch}. Recent changes: {summary from git context}.
+```
+
+### Template B: Scope Clarification
+
+Use AskUserQuestion:
+- Question: "What's the scope question? What might be in or out?"
+- Options: freeform text
+
+Draft:
+```
+Scope question: {user's question}
+
+Current context: Working on {branch}. This came up while {brief context from git}.
+If in scope: {implication}
+If out of scope: {implication}
+```
+
+### Template C: Blocker Escalation
+
+Use AskUserQuestion:
+- Question: "What are you blocked on? Who or what can unblock you?"
+- Options: freeform text
+
+Draft:
+```
+Blocked: {user's blocker description}
+
+Impact: {what can't proceed until this is resolved}
+Needed from: {person or team if known}
+Branch: {branch}
+```
+
+### Template D: Freeform
+
+Use AskUserQuestion:
+- Question: "What do you want to ask the team?"
+- Options: freeform text
+
+Use the user's text directly.
+
+---
+
+## Step 4: Refine and Confirm
+
+Present the drafted question to the user via AskUserQuestion:
+- Show the full question text
+- Show the auto-generated rationale (derived from git context: "This question arose while
+  working on branch {branch}, which modifies {files}. Recent commits: {summary}.")
+- Show 2-3 suggested answers (derived from the template — for architecture decisions,
+  the options become suggested answers; for scope, "In scope" / "Out of scope" / "Defer";
+  for blockers, "I can help" / "Escalate to {person}" / "Deprioritize")
+- Options: "Post as-is" / "Edit question" / "Edit rationale" / "Cancel"
+
+If the user wants to edit, use AskUserQuestion for the specific field and re-present.
+
+---
+
+## Step 5: Post the Question
+
+Post via heredoc for shell safety:
+
+```bash
+corners workstream question ask <workstreamId> \
+  --question "$(cat <<'CORNERS_MSG'
+<final question text>
+CORNERS_MSG
+)" \
+  --rationale "$(cat <<'CORNERS_MSG'
+<final rationale text>
+CORNERS_MSG
+)" \
+  --suggested-answer "<answer 1>" \
+  --suggested-answer "<answer 2>" \
+  --json
+```
+
+Parse the response to confirm success and extract the question ID.
+
+---
+
+## Step 6: Blocker Follow-up (Template C only)
+
+If the user selected "Blocker escalation" in Step 2, also push a blocker update:
+
+```bash
+corners workstream push <workstreamId> --type blocker --message "$(cat <<'CORNERS_MSG'
+<brief blocker description from the question>
+CORNERS_MSG
+)" --json
+```
+
+---
+
+## Step 7: Confirm
+
+Display:
+
+```
+Posted question to workstream {name} ({id}):
+  "{first 80 chars of question}..."
+  Suggested answers: {list}
+  {If blocker also posted: "Also posted blocker update."}
+
+The team will see this in corner chat.
+When they answer, skill continuation will auto-resume if configured.
+```
+
+---
+
+## Manual Equivalent
+
+```bash
+# Post a question
+corners workstream question ask <wsId> \
+  --question "What should we do about X?" \
+  --rationale "This came up while working on Y" \
+  --suggested-answer "Option A" \
+  --suggested-answer "Option B" \
+  --json
+
+# Also post a blocker (if applicable)
+corners workstream push <wsId> --type blocker --message "Blocked on X" --json
+```