codiedev 0.2.1 → 0.3.2

package/dist/cli.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * CodieDev CLI dispatcher.
+ *
+ * Subcommands:
+ *   codiedev connect                   — link agent CLIs to your org
+ *   codiedev push <file>               — author/update a spec/review/decision/etc.
+ *   codiedev pull <key>                — fetch an artifact by filename key
+ *   codiedev ping <user> "<msg>"       — send a message (optionally --with <key>)
+ *   codiedev inbox                     — list pings (use --unread to filter)
+ *   codiedev read <ping-id>            — mark read + show full message
+ *   codiedev note "<text>"             — capture a thought
+ *   codiedev promote <artifact-id>     — promote an extracted artifact to authored
+ *   codiedev help                      — show this help
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CodieDev CLI dispatcher.
+ *
+ * Subcommands:
+ *   codiedev connect                   — link agent CLIs to your org
+ *   codiedev push <file>               — author/update a spec/review/decision/etc.
+ *   codiedev pull <key>                — fetch an artifact by filename key
+ *   codiedev ping <user> "<msg>"       — send a message (optionally --with <key>)
+ *   codiedev inbox                     — list pings (use --unread to filter)
+ *   codiedev read <ping-id>            — mark read + show full message
+ *   codiedev note "<text>"             — capture a thought
+ *   codiedev promote <artifact-id>     — promote an extracted artifact to authored
+ *   codiedev help                      — show this help
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const connect_1 = require("./connect");
+const push_1 = require("./commands/push");
+const pull_1 = require("./commands/pull");
+const ping_1 = require("./commands/ping");
+const inbox_1 = require("./commands/inbox");
+const note_1 = require("./commands/note");
+const promote_1 = require("./commands/promote");
+const HELP = `
+CodieDev CLI
+
+Connect:
+  codiedev connect                       Link Claude Code / Codex to your org
+
+Artifacts:
+  codiedev push <file.md>                Author or update an artifact
+  codiedev pull <key> [--version N] [--out path]
+                                         Fetch an artifact (stdout by default)
+  codiedev promote <artifact-id>         Promote an auto-extracted artifact
+                                         to an authored one
+
+Messaging:
+  codiedev ping <user> "<msg>" [--with <key>]
+                                         Send a message to a teammate
+  codiedev inbox [--unread] [--limit N]  Show messages
+  codiedev read <ping-id>                Mark read + show full message
+
+Capture:
+  codiedev note "<text>"                 Capture a passing thought
+
+Other:
+  codiedev help                          Show this help
+  codiedev version                       Show version
+
+Backend: ${process.env.CODIEDEV_URL ?? "https://codiedev.com"}
+`.trim();
+async function main() {
+    const [, , command, ...rest] = process.argv;
+    if (!command || command === "help" || command === "--help" || command === "-h") {
+        console.log(HELP);
+        return;
+    }
+    if (command === "version" || command === "--version" || command === "-v") {
+        // Package version is replaced at publish via tsc — for now, print the source-of-truth.
+        console.log("codiedev cli");
+        return;
+    }
+    try {
+        switch (command) {
+            case "connect":
+                await (0, connect_1.runConnect)();
+                return;
+            case "push":
+                await (0, push_1.runPush)(rest);
+                return;
+            case "pull":
+                await (0, pull_1.runPull)(rest);
+                return;
+            case "ping":
+                await (0, ping_1.runPing)(rest);
+                return;
+            case "inbox":
+            case "check":
+                // Support `codiedev check inbox` as an alias.
+                if (command === "check" && rest[0] === "inbox") {
+                    await (0, inbox_1.runInbox)(rest.slice(1));
+                }
+                else {
+                    await (0, inbox_1.runInbox)(rest);
+                }
+                return;
+            case "read":
+                await (0, inbox_1.runRead)(rest);
+                return;
+            case "note":
+                await (0, note_1.runNote)(rest);
+                return;
+            case "promote":
+                await (0, promote_1.runPromote)(rest);
+                return;
+            default:
+                console.error(`Unknown command: ${command}`);
+                console.error(HELP);
+                process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error("Unexpected error:", err.message);
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error("Unexpected error:", err);
+    process.exit(1);
+});

package/dist/commands/inbox.d.ts

@@ -0,0 +1,2 @@
+export declare function runInbox(args: string[]): Promise<void>;
+export declare function runRead(args: string[]): Promise<void>;

package/dist/commands/inbox.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInbox = runInbox;
+exports.runRead = runRead;
+const shared_1 = require("./shared");
+function parseInboxArgs(args) {
+    let unreadOnly = false;
+    let limit;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--unread" || a === "-u")
+            unreadOnly = true;
+        else if ((a === "--limit" || a === "-n") && i + 1 < args.length) {
+            const n = Number(args[++i]);
+            if (Number.isInteger(n) && n > 0)
+                limit = n;
+        }
+        else if (a.startsWith("--limit=")) {
+            const n = Number(a.slice("--limit=".length));
+            if (Number.isInteger(n) && n > 0)
+                limit = n;
+        }
+    }
+    return { unreadOnly, limit };
+}
+async function runInbox(args) {
+    const { unreadOnly, limit } = parseInboxArgs(args);
+    const config = (0, shared_1.requireConfig)();
+    try {
+        const res = await (0, shared_1.apiRequest)("GET", "/api/cli/inbox", {
+            config,
+            query: {
+                unreadOnly: unreadOnly ? "1" : undefined,
+                limit,
+            },
+        });
+        const pings = res.pings;
+        const unreadCount = pings.filter((p) => !p.readAt).length;
+        if (pings.length === 0) {
+            console.log(unreadOnly ? "No unread messages." : "Inbox is empty.");
+            return;
+        }
+        console.log(`Inbox · ${pings.length} ${unreadOnly ? "unread" : "recent"}${unreadOnly ? "" : ` · ${unreadCount} unread`}`);
+        console.log();
+        for (const p of pings) {
+            const dot = p.readAt ? "·" : "●";
+            const from = p.from?.name ?? "unknown";
+            const when = (0, shared_1.timeAgo)(p.createdAt);
+            const where = p.subjectKey ? ` · on ${p.subjectKey}` : "";
+            const preview = p.preview || "(no body)";
+            console.log(`${dot}  ${from}${where} · ${when}`);
+            console.log(`    ${preview}`);
+            console.log(`    id: ${p.pingId}`);
+            console.log();
+        }
+        console.log(`Mark read: codiedev read <ping-id>`);
+    }
+    catch (err) {
+        console.error(`Inbox failed: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function runRead(args) {
+    const pingId = args.find((a) => !a.startsWith("--"));
+    if (!pingId) {
+        console.error("Usage: codiedev read <ping-id>");
+        process.exit(1);
+    }
+    const config = (0, shared_1.requireConfig)();
+    try {
+        // First, fetch inbox so we can show the full body (markRead endpoint
+        // doesn't return content).
+        const listRes = await (0, shared_1.apiRequest)("GET", "/api/cli/inbox", {
+            config,
+            query: { limit: 100 },
+        });
+        const ping = listRes.pings.find((p) => p.pingId === pingId);
+        if (!ping) {
+            console.error(`Ping not found: ${pingId}`);
+            process.exit(1);
+        }
+        await (0, shared_1.apiRequest)("POST", "/api/cli/markRead", {
+            config,
+            body: { pingId },
+        });
+        const from = ping.from?.name ?? "unknown";
+        const when = (0, shared_1.timeAgo)(ping.createdAt);
+        const where = ping.subjectKey ? ` · on ${ping.subjectKey}` : "";
+        console.log(`From: ${from} <${ping.from?.email ?? ""}>`);
+        console.log(`Sent: ${when}${where}`);
+        if (ping.subject?.title) {
+            console.log(`Subject: ${ping.subject.title} (${ping.subject.type}${ping.subject.version ? ` v${ping.subject.version}` : ""})`);
+        }
+        console.log();
+        console.log(ping.body || "(empty)");
+        console.log();
+        console.log("✓ Marked as read");
+        if (ping.subjectKey) {
+            console.log(`Pull:  codiedev pull ${ping.subjectKey}`);
+        }
+    }
+    catch (err) {
+        console.error(`Read failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/commands/note.d.ts

@@ -0,0 +1 @@
+export declare function runNote(args: string[]): Promise<void>;

package/dist/commands/note.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runNote = runNote;
+const shared_1 = require("./shared");
+async function runNote(args) {
+    const positional = args.filter((a) => !a.startsWith("--"));
+    if (positional.length === 0) {
+        console.error('Usage: codiedev note "<text>"');
+        process.exit(1);
+    }
+    const body = (0, shared_1.stripQuotes)(positional.join(" ")).trim();
+    if (!body) {
+        console.error("Note body is empty.");
+        process.exit(1);
+    }
+    const config = (0, shared_1.requireConfig)();
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/note", {
+            config,
+            body: { body },
+        });
+        console.log(`✓ Noted (${res.key})`);
+    }
+    catch (err) {
+        console.error(`Note failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/commands/ping.d.ts

@@ -0,0 +1 @@
+export declare function runPing(args: string[]): Promise<void>;

package/dist/commands/ping.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPing = runPing;
+const shared_1 = require("./shared");
+function parseArgs(args) {
+    let to;
+    const positional = [];
+    let subjectKey;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if ((a === "--with" || a === "-w") && i + 1 < args.length) {
+            subjectKey = args[++i];
+        }
+        else if (a.startsWith("--with=")) {
+            subjectKey = a.slice("--with=".length);
+        }
+        else if (!a.startsWith("--")) {
+            positional.push(a);
+        }
+    }
+    if (positional.length < 2) {
+        console.error("Usage: codiedev ping <user> \"<message>\" [--with <artifact-key>]");
+        process.exit(1);
+    }
+    to = positional[0];
+    // Join remaining positionals in case the shell split the message on spaces
+    // despite quoting (happens with some escape sequences).
+    const body = (0, shared_1.stripQuotes)(positional.slice(1).join(" "));
+    return { to, body, subjectKey };
+}
+async function runPing(args) {
+    const { to, body, subjectKey } = parseArgs(args);
+    const config = (0, shared_1.requireConfig)();
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/ping", {
+            config,
+            body: { to, body, subjectKey },
+        });
+        console.log(`✓ Pinged ${res.recipient.name} <${res.recipient.email}>${subjectKey ? ` on ${subjectKey}` : ""}`);
+    }
+    catch (err) {
+        const e = err;
+        if (e.status === 409 && e.body?.candidates?.length) {
+            console.error(`${e.message}: multiple matches for "${to}":`);
+            for (const c of e.body.candidates) {
+                console.error(`  - ${c.name} <${c.email}>`);
+            }
+            console.error(`Try a more specific name or email.`);
+        }
+        else {
+            console.error(`Ping failed: ${e.message}`);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/promote.d.ts

@@ -0,0 +1 @@
+export declare function runPromote(args: string[]): Promise<void>;

package/dist/commands/promote.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPromote = runPromote;
+const shared_1 = require("./shared");
+function parseArgs(args) {
+    let artifactId;
+    let keyOverride;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if ((a === "--key" || a === "-k") && i + 1 < args.length) {
+            keyOverride = args[++i];
+        }
+        else if (a.startsWith("--key=")) {
+            keyOverride = a.slice("--key=".length);
+        }
+        else if (!a.startsWith("--") && !artifactId) {
+            artifactId = a;
+        }
+    }
+    if (!artifactId) {
+        console.error("Usage: codiedev promote <extracted-artifact-id> [--key spec-foo.md]");
+        process.exit(1);
+    }
+    return { artifactId, keyOverride };
+}
+async function runPromote(args) {
+    const { artifactId, keyOverride } = parseArgs(args);
+    const config = (0, shared_1.requireConfig)();
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/promote", {
+            config,
+            body: { artifactId, keyOverride },
+        });
+        console.log(`✓ Promoted to authored artifact ${res.key}`);
+        console.log(`  id: ${res.artifactId}`);
+    }
+    catch (err) {
+        console.error(`Promote failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/commands/pull.d.ts

@@ -0,0 +1 @@
+export declare function runPull(args: string[]): Promise<void>;

package/dist/commands/pull.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPull = runPull;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const shared_1 = require("./shared");
+function parseArgs(args) {
+    let key;
+    let version;
+    let out;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if ((a === "--version" || a === "-v") && i + 1 < args.length) {
+            const n = Number(args[++i]);
+            if (Number.isInteger(n) && n > 0)
+                version = n;
+        }
+        else if (a.startsWith("--version=")) {
+            const n = Number(a.slice("--version=".length));
+            if (Number.isInteger(n) && n > 0)
+                version = n;
+        }
+        else if ((a === "--out" || a === "-o") && i + 1 < args.length) {
+            out = args[++i];
+        }
+        else if (a.startsWith("--out=")) {
+            out = a.slice("--out=".length);
+        }
+        else if (!a.startsWith("--") && !key) {
+            key = a;
+        }
+    }
+    if (!key) {
+        console.error("Usage: codiedev pull <key> [--version N] [--out path.md]");
+        process.exit(1);
+    }
+    return { key, version, out };
+}
+async function runPull(args) {
+    const { key, version, out } = parseArgs(args);
+    const config = (0, shared_1.requireConfig)();
+    try {
+        const res = await (0, shared_1.apiRequest)("GET", "/api/cli/pull", {
+            config,
+            query: { key, version },
+        });
+        const a = res.artifact;
+        if (out) {
+            const absolute = path.isAbsolute(out) ? out : path.resolve(process.cwd(), out);
+            fs.writeFileSync(absolute, a.markdown, "utf8");
+            console.log(`✓ Pulled ${a.key} v${a.version ?? 1} (${a.type}) → ${absolute}`);
+            console.log(`  title:     ${a.title}`);
+            console.log(`  lifecycle: ${a.lifecycle ?? "draft"}`);
+            console.log(`  updated:   ${(0, shared_1.timeAgo)(a.updatedAt ?? a.createdAt)}`);
+        }
+        else {
+            // Stream to stdout — preserves shell pipes like `codiedev pull spec-214.md | less`.
+            process.stdout.write(a.markdown);
+            if (!a.markdown.endsWith("\n"))
+                process.stdout.write("\n");
+        }
+    }
+    catch (err) {
+        const e = err;
+        if (e.status === 404) {
+            console.error(`Not found: ${key}${version ? ` v${version}` : ""}`);
+        }
+        else {
+            console.error(`Pull failed: ${e.message}`);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/push.d.ts

@@ -0,0 +1 @@
+export declare function runPush(args: string[]): Promise<void>;

package/dist/commands/push.js

@@ -0,0 +1,104 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPush = runPush;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const shared_1 = require("./shared");
+const VALID_TYPES = new Set([
+    "spec",
+    "bugfix",
+    "decision",
+    "proposal",
+    "review",
+    "note",
+]);
+function parseArgs(args) {
+    let file;
+    let type;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--type" && i + 1 < args.length) {
+            type = args[++i];
+        }
+        else if (a.startsWith("--type=")) {
+            type = a.slice("--type=".length);
+        }
+        else if (!a.startsWith("--") && !file) {
+            file = a;
+        }
+    }
+    if (!file) {
+        console.error("Usage: codiedev push <file.md> [--type spec|bugfix|decision|proposal|review|note]");
+        process.exit(1);
+    }
+    if (type && !VALID_TYPES.has(type)) {
+        console.error(`Invalid --type. Valid types: ${[...VALID_TYPES].join(", ")}`);
+        process.exit(1);
+    }
+    return { file, type };
+}
+async function runPush(args) {
+    const { file, type } = parseArgs(args);
+    const config = (0, shared_1.requireConfig)();
+    let absolute = file;
+    if (!path.isAbsolute(absolute)) {
+        absolute = path.resolve(process.cwd(), file);
+    }
+    if (!fs.existsSync(absolute)) {
+        console.error(`File not found: ${absolute}`);
+        process.exit(1);
+    }
+    const markdown = fs.readFileSync(absolute, "utf8");
+    if (!markdown.trim()) {
+        console.error(`File is empty: ${absolute}`);
+        process.exit(1);
+    }
+    const filename = path.basename(absolute);
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/push", {
+            config,
+            body: { filename, markdown, type },
+        });
+        console.log(`✓ Pushed ${filename}`);
+        console.log(`  type:    ${res.type}`);
+        console.log(`  version: v${res.version}`);
+        console.log(`  id:      ${res.artifactId}`);
+    }
+    catch (err) {
+        console.error(`Push failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/commands/shared.d.ts

@@ -0,0 +1,24 @@
+import { CodiedevConfig } from "../utils";
+/**
+ * Require a connected CodieDev config. Exits the process with a helpful
+ * message if the user hasn't run `codiedev connect` yet.
+ */
+export declare function requireConfig(): CodiedevConfig;
+/**
+ * Perform an authenticated HTTP request against the CodieDev backend.
+ * Returns the parsed JSON response body. Throws on non-2xx.
+ */
+export declare function apiRequest<T = unknown>(method: "GET" | "POST", path: string, options: {
+    config: CodiedevConfig;
+    body?: Record<string, unknown>;
+    query?: Record<string, string | number | undefined>;
+}): Promise<T>;
+/**
+ * Relative-time formatter for inbox / listing output.
+ */
+export declare function timeAgo(ts: number): string;
+/**
+ * Strip surrounding quotes from a CLI argument if the user wrapped it.
+ * `codiedev ping maya "hey"` on some shells passes the quotes through.
+ */
+export declare function stripQuotes(s: string): string;