@confiqure/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 confiqure.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# @confiqure/cli
+
+The official CLI for [confiqure.ai](https://confiqure.ai) — push `@Confiqure`-annotated classes to your workspace.
+
+## Install
+
+```bash
+npm install -g @confiqure/cli
+# or run without installing:
+npx @confiqure/cli <command>
+```
+
+## Quick start
+
+```bash
+confiqure login       # paste an API key from https://confiqure.ai/dashboard
+confiqure init        # scaffold confiqure.config.json in the project root
+confiqure diff        # preview which classes will be added / changed / deleted
+confiqure push        # upload the changeset; backend generates the chat playbook
+confiqure status      # check the most recent push result
+```
+
+## How the scan works
+
+`confiqure push` parses each `@Confiqure`-annotated class with tree-sitter, walks the field-type graph, and ships every file transitively reachable from a root — not just the file with the annotation on it. This means nested configuration classes (e.g. `EmailPreferences` referenced from a root `NotificationPreferences`) come along automatically, without needing their own `@Confiqure` tag.
+
+Sample push output:
+
+```
+Scanned 10 files; 1 @Confiqure root.
+
+⏵ Root: NotificationPreferences — 10 reachable files
+    ├─ src/main/java/com/example/notifications/NotificationPreferences.java  root
+    ├─ src/main/java/com/example/notifications/EmailPreferences.java         referenced
+    ├─ src/main/java/com/example/notifications/AlertPreferences.java         referenced
+    ├─ src/main/java/com/example/model/Channel.java                          referenced
+    └─ … (6 more)
+```
+
+## Supported languages
+
+V1 ships tree-sitter parsing for **Java**. The other 8 languages (Kotlin, Scala, Python, TypeScript, C#, Rust, PHP, Swift) use a keyword-scan fallback until their grammars are wired in. Track progress at [github.com/Omer-Ozturk-SJSU/confiqure-cli/issues](https://github.com/Omer-Ozturk-SJSU/confiqure-cli/issues).
+
+## Configuration
+
+`confiqure init` writes `confiqure.config.json`:
+
+```json
+{
+  "scanPaths": ["src/main/java"],
+  "ignore": ["target", ".git", ".idea"],
+  "languages": {
+    "java": { "extensions": [".java"], "tokenPattern": "@Confiqure" }
+  }
+}
+```
+
+## Environment variables
+
+Override the file-based credentials for CI:
+
+- `CONFIQURE_API_KEY` — workspace API key (`cqai_…`)
+- `CONFIQURE_WORKSPACE_KEY` — workspace URL key
+- `CONFIQURE_API_BASE` — backend URL (defaults to `https://api.confiqure.ai`)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/api.js

@@ -0,0 +1,106 @@
+export class ApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+/**
+ * Resolve an API token to its workspace identity without requiring the
+ * caller to know the workspaceKey upfront. Used by `confiqure login` so
+ * the user only has to paste the token.
+ */
+export async function getWhoami(apiBase, token) {
+    const res = await fetch(`${apiBase}/api/cli/whoami`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok) {
+        throw new ApiError(res.status, `GET /api/cli/whoami failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+export async function getPushStatus(creds, pushHistoryId) {
+    const res = await fetch(`${creds.apiBase}/api/${creds.workspaceKey}/upload/status/${pushHistoryId}`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    if (!res.ok) {
+        throw new ApiError(res.status, `GET /upload/status/${pushHistoryId} failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+export async function getRegistry(creds) {
+    const res = await fetch(`${creds.apiBase}/api/${creds.workspaceKey}/upload`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    if (!res.ok) {
+        throw new ApiError(res.status, `GET /upload failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+export async function getWorkspace(creds) {
+    const res = await fetch(`${creds.apiBase}/api/${creds.workspaceKey}/cli/workspace`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    if (!res.ok) {
+        throw new ApiError(res.status, `GET /cli/workspace failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+export async function updateWorkspace(creds, changes) {
+    const res = await fetch(`${creds.apiBase}/api/${creds.workspaceKey}/cli/workspace`, {
+        method: "PUT",
+        headers: {
+            Authorization: `Bearer ${creds.token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(changes),
+    });
+    if (!res.ok) {
+        throw new ApiError(res.status, `PUT /cli/workspace failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+export async function listTools(creds) {
+    const res = await fetch(`${creds.apiBase}/api/${creds.workspaceKey}/cli/tools`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    if (!res.ok) {
+        throw new ApiError(res.status, `GET /cli/tools failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+export async function upsertTool(creds, name, url, instructions) {
+    const res = await fetch(`${creds.apiBase}/api/${creds.workspaceKey}/cli/tools/${encodeURIComponent(name)}`, {
+        method: "PUT",
+        headers: {
+            Authorization: `Bearer ${creds.token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ url, instructions: instructions ?? null }),
+    });
+    if (!res.ok) {
+        throw new ApiError(res.status, `PUT /cli/tools/${name} failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+export async function deleteTool(creds, name) {
+    const res = await fetch(`${creds.apiBase}/api/${creds.workspaceKey}/cli/tools/${encodeURIComponent(name)}`, {
+        method: "DELETE",
+        headers: { Authorization: `Bearer ${creds.token}` },
+    });
+    if (!res.ok && res.status !== 404) {
+        throw new ApiError(res.status, `DELETE /cli/tools/${name} failed: ${res.status} ${await res.text()}`);
+    }
+}
+export async function postUpload(creds, manifest, files) {
+    const form = new FormData();
+    form.append("manifest", JSON.stringify(manifest));
+    // Paths can contain slashes; URL-encode for the filename slot so the server
+    // can decode without the multipart parser dropping directory components.
+    for (const [path, content] of files) {
+        const blob = new Blob([content], { type: "text/plain;charset=utf-8" });
+        form.append("sources", blob, encodeURIComponent(path));
+    }
+    const res = await fetch(`${creds.apiBase}/api/${creds.workspaceKey}/upload`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${creds.token}` },
+        body: form,
+    });
+    if (!res.ok) {
+        throw new ApiError(res.status, `POST /upload failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/classTree.js

@@ -0,0 +1,280 @@
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { readFile } from "node:fs/promises";
+import Parser from "web-tree-sitter";
+/**
+ * Tree-sitter-driven reachability for `@Confiqure`-rooted class graphs.
+ *
+ * The classic confiqure scan was "does this file contain `@Confiqure`?" — which
+ * silently dropped every nested class the AI needs to understand. This module
+ * parses each candidate source file into an AST, then walks the field-type
+ * graph from each annotated root so we send the backend exactly the files that
+ * matter (root + everything transitively referenced), not the whole scanPath.
+ *
+ * V1 supports Java. The factory wires `web-tree-sitter` + a bundled `.wasm`
+ * grammar; adding Kotlin/Scala/etc. is a matter of registering another grammar
+ * here and providing matching node-type extractors.
+ */
+const require = createRequire(import.meta.url);
+function resolveGrammarWasm(grammarFile) {
+    const pkgJson = require.resolve("tree-sitter-wasms/package.json");
+    return join(dirname(pkgJson), "out", grammarFile);
+}
+let parserReady = null;
+let javaLanguage = null;
+async function ensureJavaParser() {
+    if (!parserReady) {
+        parserReady = Parser.init();
+    }
+    await parserReady;
+    if (!javaLanguage) {
+        javaLanguage = await Parser.Language.load(resolveGrammarWasm("tree-sitter-java.wasm"));
+    }
+    const parser = new Parser();
+    parser.setLanguage(javaLanguage);
+    return parser;
+}
+/** Parse every Java file in `allFiles`. Non-Java files are skipped silently. */
+export async function parseJavaFiles(allFiles) {
+    const javaPaths = Array.from(allFiles.keys()).filter((p) => p.endsWith(".java"));
+    if (javaPaths.length === 0)
+        return [];
+    const parser = await ensureJavaParser();
+    const result = [];
+    try {
+        for (const filePath of javaPaths) {
+            const source = allFiles.get(filePath);
+            if (source == null)
+                continue;
+            const tree = parser.parse(source);
+            if (!tree)
+                continue;
+            result.push(extractFile(filePath, tree.rootNode));
+        }
+    }
+    finally {
+        parser.delete();
+    }
+    return result;
+}
+/** Parse a single Java file from disk. */
+export async function parseJavaFile(filePath) {
+    const parser = await ensureJavaParser();
+    try {
+        const source = await readFile(filePath, "utf8");
+        const tree = parser.parse(source);
+        if (!tree)
+            return null;
+        return extractFile(filePath, tree.rootNode);
+    }
+    finally {
+        parser.delete();
+    }
+}
+function extractFile(filePath, root) {
+    let packageName = null;
+    const declarations = [];
+    for (const child of root.namedChildren) {
+        if (!child)
+            continue;
+        if (child.type === "package_declaration") {
+            packageName = extractPackageName(child);
+        }
+        else if (isTypeDeclaration(child.type)) {
+            const decl = extractDeclaration(child);
+            if (decl)
+                declarations.push(decl);
+        }
+    }
+    return { filePath, packageName, declarations };
+}
+function isTypeDeclaration(type) {
+    return (type === "class_declaration" ||
+        type === "interface_declaration" ||
+        type === "enum_declaration" ||
+        type === "record_declaration");
+}
+function extractPackageName(node) {
+    for (const child of node.namedChildren) {
+        if (!child)
+            continue;
+        if (child.type === "scoped_identifier" || child.type === "identifier") {
+            return child.text;
+        }
+    }
+    return null;
+}
+function extractDeclaration(node) {
+    const kind = node.type === "class_declaration"
+        ? "class"
+        : node.type === "interface_declaration"
+            ? "interface"
+            : node.type === "enum_declaration"
+                ? "enum"
+                : "record";
+    const nameNode = node.childForFieldName("name");
+    if (!nameNode)
+        return null;
+    const name = nameNode.text;
+    const hasConfiqureAnnotation = declarationHasConfiqure(node);
+    const body = node.childForFieldName("body");
+    const fields = [];
+    if (body && (kind === "class" || kind === "record")) {
+        let pendingDoc = null;
+        for (const child of body.namedChildren) {
+            if (!child)
+                continue;
+            if (child.type === "block_comment" || child.type === "line_comment") {
+                pendingDoc = pendingDoc ? `${pendingDoc}\n${child.text}` : child.text;
+                continue;
+            }
+            if (child.type === "field_declaration") {
+                const extracted = extractFields(child, pendingDoc);
+                fields.push(...extracted);
+            }
+            pendingDoc = null;
+        }
+    }
+    return { kind, name, hasConfiqureAnnotation, fields };
+}
+function declarationHasConfiqure(node) {
+    for (const child of node.children) {
+        if (!child)
+            continue;
+        if (child.type !== "modifiers")
+            continue;
+        for (const mod of child.namedChildren) {
+            if (!mod)
+                continue;
+            if (mod.type !== "marker_annotation" && mod.type !== "annotation")
+                continue;
+            const annName = mod.childForFieldName("name");
+            if (!annName)
+                continue;
+            const simple = lastSegment(annName.text);
+            if (simple === "Confiqure")
+                return true;
+        }
+    }
+    return false;
+}
+function lastSegment(name) {
+    const dot = name.lastIndexOf(".");
+    return dot === -1 ? name : name.slice(dot + 1);
+}
+function extractFields(fieldDecl, doc) {
+    const typeNode = fieldDecl.childForFieldName("type");
+    if (!typeNode)
+        return [];
+    const typeText = typeNode.text;
+    const typeNames = collectTypeIdentifiers(typeNode);
+    const out = [];
+    for (const child of fieldDecl.namedChildren) {
+        if (!child)
+            continue;
+        if (child.type !== "variable_declarator")
+            continue;
+        const nameNode = child.childForFieldName("name");
+        if (!nameNode)
+            continue;
+        out.push({
+            name: nameNode.text,
+            typeText,
+            typeNames,
+            doc,
+            hasConfiqureTag: doc != null && /@confiqure\b/i.test(doc),
+        });
+    }
+    return out;
+}
+/**
+ * Walk a `type` subtree and return every type identifier we see — the wrapper
+ * type plus every generic argument. E.g. `Map<String, List<Channel>>` →
+ * ["Map", "String", "List", "Channel"]. The resolver later filters these
+ * against the in-project class index, so non-project types (String, etc.)
+ * fall away naturally.
+ */
+function collectTypeIdentifiers(node) {
+    const out = [];
+    const visit = (n) => {
+        if (!n)
+            return;
+        if (n.type === "type_identifier") {
+            out.push(n.text);
+        }
+        else if (n.type === "scoped_type_identifier") {
+            out.push(lastSegment(n.text));
+        }
+        for (const c of n.namedChildren)
+            visit(c);
+    };
+    visit(node);
+    return out;
+}
+/**
+ * From the set of parsed files, build one ClassTree per `@Confiqure` root.
+ * If a `@Confiqure` class is reachable from another root, it's marked
+ * subsumed instead of producing its own tree — that's how nested
+ * configuration classes (e.g. PushPreferences inside NotificationPreferences)
+ * stop showing up as duplicate endpoints.
+ */
+export function buildClassTrees(parsed) {
+    const classNameToDecl = new Map();
+    for (const pf of parsed) {
+        for (const decl of pf.declarations) {
+            if (!classNameToDecl.has(decl.name)) {
+                classNameToDecl.set(decl.name, { file: pf.filePath, decl });
+            }
+        }
+    }
+    const rootCandidates = [];
+    for (const pf of parsed) {
+        for (const decl of pf.declarations) {
+            if (decl.hasConfiqureAnnotation)
+                rootCandidates.push({ file: pf.filePath, decl });
+        }
+    }
+    const rawTrees = rootCandidates.map(({ file, decl }) => {
+        const reachableFiles = new Set();
+        const visitedClasses = [];
+        const stack = [decl.name];
+        while (stack.length > 0) {
+            const className = stack.pop();
+            const found = classNameToDecl.get(className);
+            if (!found)
+                continue;
+            if (reachableFiles.has(found.file))
+                continue;
+            reachableFiles.add(found.file);
+            visitedClasses.push(className);
+            if (found.decl.kind === "class" || found.decl.kind === "record") {
+                for (const field of found.decl.fields) {
+                    for (const t of field.typeNames)
+                        stack.push(t);
+                }
+            }
+        }
+        return {
+            rootFile: file,
+            rootClass: decl.name,
+            reachableFiles,
+            visitedClasses,
+            subsumedConfiqureClasses: [],
+        };
+    });
+    const rootClassNames = new Set(rawTrees.map((t) => t.rootClass));
+    const subsumed = new Map();
+    for (const tree of rawTrees) {
+        for (const cls of tree.visitedClasses) {
+            if (cls === tree.rootClass)
+                continue;
+            if (rootClassNames.has(cls)) {
+                tree.subsumedConfiqureClasses.push(cls);
+                subsumed.set(cls, tree.rootClass);
+            }
+        }
+    }
+    const trees = rawTrees.filter((t) => !subsumed.has(t.rootClass));
+    return { trees, subsumed };
+}
+//# sourceMappingURL=classTree.js.map

package/dist/classTree.js.map

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

package/dist/commands/diff.js

@@ -0,0 +1,27 @@
+import chalk from "chalk";
+import { requireCredentials } from "../credentials.js";
+import { loadConfig } from "../config.js";
+import { scanProject } from "../scan.js";
+import { diffAgainstRegistry, renderDiff } from "../diff.js";
+import { getRegistry } from "../api.js";
+export function registerDiff(program) {
+    program
+        .command("diff")
+        .description("Compute the change-file vs the backend without uploading")
+        .action(async () => {
+        const cwd = process.cwd();
+        const creds = await requireCredentials();
+        const config = await loadConfig(cwd);
+        const scan = await scanProject(cwd, config);
+        console.log(chalk.dim(`Scanned ${scan.allFiles.size} files; ${scan.annotated.length} annotated.`));
+        const registry = await getRegistry(creds);
+        console.log(chalk.dim(`Backend registry: ${registry.length} class${registry.length === 1 ? "" : "es"}.`));
+        const diff = diffAgainstRegistry(scan.annotated, registry);
+        console.log();
+        console.log(renderDiff(diff, {
+            allScannedPaths: Array.from(scan.allFiles.keys()),
+            annotatedPaths: scan.annotated.map((c) => c.filePath),
+        }));
+    });
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,kBAAkB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QAErC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC;QAEnG,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,QAAQ,CAAC,MAAM,SAAS,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAE1G,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE;YAC3B,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjD,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACtD,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,49 @@
+import { confirm, input } from "@inquirer/prompts";
+import chalk from "chalk";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { CONFIG_FILE, DEFAULT_CONFIG, loadConfig, saveConfig, } from "../config.js";
+export function registerInit(program) {
+    program
+        .command("init")
+        .description(`Generate or update ${CONFIG_FILE} in the current directory`)
+        .option("-y, --yes", "accept defaults without prompting")
+        .action(async (opts) => {
+        const cwd = process.cwd();
+        const path = join(cwd, CONFIG_FILE);
+        const exists = existsSync(path);
+        if (exists && !opts.yes) {
+            const overwrite = await confirm({
+                message: `${CONFIG_FILE} already exists. Update it?`,
+                default: true,
+            });
+            if (!overwrite) {
+                console.log(chalk.yellow("Aborted."));
+                return;
+            }
+        }
+        const existing = exists ? await loadConfig(cwd) : DEFAULT_CONFIG;
+        let config = existing;
+        if (!opts.yes) {
+            const scanPathsRaw = await input({
+                message: "Scan paths (comma-separated globs):",
+                default: existing.scanPaths.join(", "),
+            });
+            const ignoreRaw = await input({
+                message: "Directories to ignore (comma-separated):",
+                default: existing.ignore.join(", "),
+            });
+            config = {
+                ...existing,
+                scanPaths: scanPathsRaw.split(",").map((s) => s.trim()).filter(Boolean),
+                ignore: ignoreRaw.split(",").map((s) => s.trim()).filter(Boolean),
+            };
+        }
+        await saveConfig(cwd, config);
+        console.log(chalk.green("✓"), `Wrote ${path}`);
+        console.log(chalk.dim(`  scanPaths: ${config.scanPaths.join(", ")}`));
+        console.log(chalk.dim(`  ignore: ${config.ignore.join(", ")}`));
+        console.log(chalk.dim(`  languages: ${Object.keys(config.languages).join(", ")}`));
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/login.js

@@ -0,0 +1,60 @@
+import { input, password } from "@inquirer/prompts";
+import chalk from "chalk";
+import { credentialsPath, loadCredentials, saveCredentials, } from "../credentials.js";
+import { ApiError, getWhoami } from "../api.js";
+export function registerLogin(program) {
+    program
+        .command("login")
+        .description("Save a workspace API key for the CLI to use")
+        .option("--api-base <url>", "confiqure API base URL")
+        .option("--workspace <key>", "workspace key (6-letter) — skips the whoami lookup; useful for offline/scripted setup")
+        .option("--token <token>", "API token (cqai_…)")
+        .action(async (opts) => {
+        const existing = await loadCredentials();
+        const apiBase = opts.apiBase ??
+            (await input({
+                message: "API base URL:",
+                default: existing?.apiBase ?? "https://api.confiqure.ai",
+            }));
+        const token = opts.token ??
+            (await password({
+                message: "API token (cqai_…):",
+                mask: "*",
+                validate: (v) => v.startsWith("cqai_") && v.length >= 16 ? true : "Token must start with cqai_",
+            }));
+        // Resolve workspaceKey. Manual override skips the network call (useful
+        // for CI / offline setup); otherwise we ask the backend.
+        let workspaceKey;
+        let workspaceName = null;
+        if (opts.workspace) {
+            workspaceKey = opts.workspace;
+        }
+        else {
+            try {
+                const me = await getWhoami(apiBase, token);
+                workspaceKey = me.workspaceKey;
+                workspaceName = me.workspaceName;
+            }
+            catch (e) {
+                if (e instanceof ApiError && e.status === 401) {
+                    console.error(chalk.red("✗"), "Invalid token — the server rejected this key.");
+                }
+                else if (e instanceof ApiError) {
+                    console.error(chalk.red("✗"), `whoami failed (${e.status}): ${e.message}`);
+                }
+                else {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    console.error(chalk.red("✗"), `Couldn't reach ${apiBase}: ${msg}`);
+                }
+                process.exit(1);
+            }
+        }
+        const creds = { apiBase, workspaceKey, token };
+        await saveCredentials(creds);
+        const who = workspaceName ? `${workspaceName} (${workspaceKey})` : workspaceKey;
+        console.log(chalk.green("✓"), `Logged in as ${who}`);
+        console.log(chalk.dim(`  apiBase: ${apiBase}`));
+        console.log(chalk.dim(`  saved:   ${credentialsPath()}`));
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

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