carrick 0.3.57 → 0.3.59

package/dist/init/projects.js

@@ -0,0 +1,137 @@
+// Listing and creating Carrick projects from the terminal (carrick#955).
+//
+// `carrick init --project <slug>` could only ever point at a browser: the
+// workspace read (`resolve-repos`) returns the projects the named repos are
+// already in, never the workspace's project list, and creation lived only in
+// the dashboard. These two actions are the terminal half.
+//
+// **The server may not have them.** They are a separate cloud change, so
+// every call here is a probe: a workspace whose API does not answer them gets
+// today's browser links and the same wait, and the release does not depend on
+// a deploy. "Absent" is deliberately wide, because it is not one status code:
+// an API that has never heard of an action answers a credential-kind gate
+// first (403 today, since the CLI credential is an MCP-scoped key and the
+// action is not on that key's read list), and a later one may answer 404. The
+// only status treated as fatal is 401, because the credential was already
+// proven by the workspace read that runs before this — a rejection here is a
+// real one and must not read as a missing feature.
+//
+// A refusal is separated from an absence by the pair (status, body): a 400 or
+// a 409 carrying an `error` string is the server stating why a create cannot
+// happen (slug taken, reserved, rate limited), and that sentence is the
+// user's to read. Everything else is an absence.
+import { z } from "zod";
+import { API_BASE } from "../auth/credentials.js";
+const project = z.object({
+    slug: z.string(),
+    name: z.string(),
+    archived: z.boolean(),
+    repo_count: z.number().int().nonnegative().nullable(),
+});
+const listResponse = z.object({
+    schema: z.literal("carrick.list-projects/0"),
+    projects: z.array(project),
+});
+const createResponse = z.object({
+    schema: z.literal("carrick.create-project/0"),
+    project,
+});
+const REJECTED = "Carrick rejected this credential. Run carrick login (unset CARRICK_TOKEN first if it overrides your login).";
+async function post(token, body, request, signal) {
+    try {
+        return await request(`${API_BASE}/types/check-or-upload`, {
+            method: "POST",
+            redirect: "error",
+            signal: AbortSignal.any([AbortSignal.timeout(30_000), ...(signal ? [signal] : [])]),
+            headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+    catch {
+        // A request that never reached the server says nothing about whether the
+        // action exists, and the workspace read that precedes this one already
+        // reports an unreachable API. Fall back rather than fail the run.
+        return null;
+    }
+}
+/** The `error` sentence a refusal carries, when it carries one. */
+async function refusal(result) {
+    if (result.status !== 400 && result.status !== 409)
+        return null;
+    try {
+        const payload = await result.json();
+        const message = payload?.error;
+        return typeof message === "string" && message.trim() !== "" ? message : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Every project in the signed-in workspace, or null when this API has no such
+ * action. Throws only on 401.
+ */
+export async function listProjects(token, request = fetch, signal) {
+    const result = await post(token, { action: "list-projects" }, request, signal);
+    if (!result)
+        return null;
+    if (result.status === 401)
+        throw new Error(REJECTED);
+    if (!result.ok)
+        return null;
+    let payload;
+    try {
+        payload = await result.json();
+    }
+    catch {
+        return null;
+    }
+    const parsed = listResponse.safeParse(payload);
+    // The schema tag is the handshake. An API that answers this action with
+    // some other shape is one this client cannot read, which is the same
+    // situation as not having it.
+    return parsed.success ? parsed.data.projects : null;
+}
+/**
+ * Create one project in the signed-in workspace.
+ *
+ * The slug is sent as given: `carrick init` validates it against the same
+ * shape the dashboard enforces before it ever reaches here, so a slug this
+ * client sends is one the server can accept or refuse on its own rules, never
+ * one it has to normalise silently into something the user did not ask for.
+ */
+export async function createProject(token, slug, name = slug, request = fetch, signal) {
+    const result = await post(token, { action: "create-project", slug, name }, request, signal);
+    if (!result)
+        return { kind: "absent" };
+    if (result.status === 401)
+        throw new Error(REJECTED);
+    if (!result.ok) {
+        const message = await refusal(result);
+        return message ? { kind: "refused", message } : { kind: "absent" };
+    }
+    let payload;
+    try {
+        payload = await result.json();
+    }
+    catch {
+        return { kind: "absent" };
+    }
+    const parsed = createResponse.safeParse(payload);
+    return parsed.success ? { kind: "created", project: parsed.data.project } : { kind: "absent" };
+}
+/** The list as init prints it: one line per project, active ones first. */
+export function projectLines(projects) {
+    const ordered = [...projects].sort((left, right) => left.archived === right.archived
+        ? left.slug.localeCompare(right.slug)
+        : Number(left.archived) - Number(right.archived));
+    return ordered.map((entry) => {
+        const repos = entry.repo_count === null
+            ? ""
+            : `  ${entry.repo_count} repo${entry.repo_count === 1 ? "" : "s"}`;
+        const archived = entry.archived ? "  (archived)" : "";
+        const named = entry.name === entry.slug ? "" : `  ${entry.name}`;
+        return `  ${entry.slug}${named}${repos}${archived}`;
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/init/projects.js.map

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

package/dist/init/repos.d.ts

@@ -1,19 +1,113 @@
-export type FindOptions = {
-    readdir?: (dir: string) => Array<{
-        name: string;
-        isDirectory: () => boolean;
-    }>;
-    exists?: (target: string) => boolean;
-};
-export declare function findRepos(workspace: string, options?: FindOptions): string[];
-/**
- * The workspace file to write: the repos already listed, in the order they were
- * listed, plus the ones found since. Re-running init updates rather than
- * duplicates, and never reorders or drops a path a user put there by hand —
- * including one pointing outside this folder.
- */
-export declare function mergeWorkspace(existing: string | null, found: string[]): {
-    body: string;
-    repos: string[];
-    added: string[];
-};
+import { z } from "zod";
+declare const proposal: z.ZodObject<{
+    schema: z.ZodLiteral<"carrick.derive/0">;
+    workspace: z.ZodString;
+    repos_detected_by: z.ZodString;
+    repos_added: z.ZodArray<z.ZodString, "many">;
+    repos_excluded: z.ZodArray<z.ZodString, "many">;
+    missing: z.ZodArray<z.ZodString, "many">;
+    parent_proposal: z.ZodNullable<z.ZodObject<{
+        directory: z.ZodString;
+        repos: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        repos: string[];
+        directory: string;
+    }, {
+        repos: string[];
+        directory: string;
+    }>>;
+    repos: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodString;
+        services: z.ZodArray<z.ZodObject<{
+            serviceName: z.ZodNullable<z.ZodString>;
+            directory: z.ZodOptional<z.ZodString>;
+            tsconfig: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            serviceName: z.ZodNullable<z.ZodString>;
+            directory: z.ZodOptional<z.ZodString>;
+            tsconfig: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            serviceName: z.ZodNullable<z.ZodString>;
+            directory: z.ZodOptional<z.ZodString>;
+            tsconfig: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        config: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        warnings: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        services: z.objectOutputType<{
+            serviceName: z.ZodNullable<z.ZodString>;
+            directory: z.ZodOptional<z.ZodString>;
+            tsconfig: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        path: string;
+        reason: string;
+        config: Record<string, unknown> | null;
+        warnings: string[];
+    }, {
+        services: z.objectInputType<{
+            serviceName: z.ZodNullable<z.ZodString>;
+            directory: z.ZodOptional<z.ZodString>;
+            tsconfig: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        path: string;
+        reason: string;
+        config: Record<string, unknown> | null;
+        warnings: string[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema: "carrick.derive/0";
+    workspace: string;
+    repos: {
+        services: z.objectOutputType<{
+            serviceName: z.ZodNullable<z.ZodString>;
+            directory: z.ZodOptional<z.ZodString>;
+            tsconfig: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        path: string;
+        reason: string;
+        config: Record<string, unknown> | null;
+        warnings: string[];
+    }[];
+    repos_detected_by: string;
+    repos_added: string[];
+    repos_excluded: string[];
+    missing: string[];
+    parent_proposal: {
+        repos: string[];
+        directory: string;
+    } | null;
+}, {
+    schema: "carrick.derive/0";
+    workspace: string;
+    repos: {
+        services: z.objectInputType<{
+            serviceName: z.ZodNullable<z.ZodString>;
+            directory: z.ZodOptional<z.ZodString>;
+            tsconfig: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        path: string;
+        reason: string;
+        config: Record<string, unknown> | null;
+        warnings: string[];
+    }[];
+    repos_detected_by: string;
+    repos_added: string[];
+    repos_excluded: string[];
+    missing: string[];
+    parent_proposal: {
+        repos: string[];
+        directory: string;
+    } | null;
+}>;
+export type WorkspaceProposal = z.infer<typeof proposal>;
+/** Rust owns service selection, tsconfig precedence and configuration validation. */
+export declare function deriveWorkspace(workspace: string): WorkspaceProposal;
+/** An explicit init may create a missing file once, including under a race. */
+export declare function writeConfigs(plan: WorkspaceProposal): Array<{
+    path: string;
+    created: boolean;
+}>;
+/** Only GitHub origin identities are sent to the workspace metadata read. */
+export declare function githubRemote(repo: string): string | null;
+export {};

package/dist/init/repos.js

@@ -1,46 +1,67 @@
-// Which directories in this folder are repos to index.
-//
-// A proposal, not a decision: the list goes into `carrick-workspace.json`,
-// which the scanner reads literally and a user can edit. There is no walk
-// deeper than one level and no search order to reason about (E20) — a repo is
-// a directory here with a `package.json` in it.
 import fs from "node:fs";
 import path from "node:path";
-/** Directories that are never a repo, whatever they hold. */
-const NEVER = new Set(["node_modules", "dist", "build", "out", "coverage", "target"]);
-export function findRepos(workspace, options = {}) {
-    const readdir = options.readdir ?? ((dir) => fs.readdirSync(dir, { withFileTypes: true }));
-    const exists = options.exists ?? ((target) => fs.existsSync(target));
-    const found = [];
-    for (const entry of readdir(workspace)) {
-        if (!entry.isDirectory())
-            continue;
-        if (entry.name.startsWith(".") || NEVER.has(entry.name))
-            continue;
-        if (!exists(path.join(workspace, entry.name, "package.json")))
-            continue;
-        found.push(`./${entry.name}`);
-    }
-    return found.sort();
+import { spawnSync } from "node:child_process";
+import { z } from "zod";
+import { nativeEnv, resolveNativeBinary } from "../native.js";
+const service = z.object({ serviceName: z.string().nullable(), directory: z.string().optional(), tsconfig: z.string().optional() }).passthrough();
+const proposal = z.object({
+    schema: z.literal("carrick.derive/0"), workspace: z.string(), repos_detected_by: z.string(),
+    repos_added: z.array(z.string()), repos_excluded: z.array(z.string()), missing: z.array(z.string()),
+    parent_proposal: z.object({ directory: z.string(), repos: z.array(z.string()) }).nullable(),
+    repos: z.array(z.object({ path: z.string(), reason: z.string(), services: z.array(service), config: z.record(z.unknown()).nullable(), warnings: z.array(z.string()) })),
+});
+/** Rust owns service selection, tsconfig precedence and configuration validation. */
+export function deriveWorkspace(workspace) {
+    const native = resolveNativeBinary();
+    if (!native.binary)
+        throw new Error(native.problem ?? "The Carrick scanner is not installed.");
+    const result = spawnSync(native.binary, ["derive", "--workspace", workspace, "--json"], {
+        encoding: "utf8", env: nativeEnv(), timeout: 30_000, maxBuffer: 8 * 1024 * 1024,
+    });
+    if (result.error)
+        throw new Error(`Could not derive the workspace: ${result.error.message}`);
+    if (result.status !== 0)
+        throw new Error(result.stderr.trim() || "The scanner could not derive the workspace.");
+    const parsed = proposal.safeParse(JSON.parse(result.stdout));
+    if (!parsed.success)
+        throw new Error("The scanner returned an unsupported workspace proposal. Install matching Carrick CLI and scanner versions.");
+    return parsed.data;
 }
-/**
- * The workspace file to write: the repos already listed, in the order they were
- * listed, plus the ones found since. Re-running init updates rather than
- * duplicates, and never reorders or drops a path a user put there by hand —
- * including one pointing outside this folder.
- */
-export function mergeWorkspace(existing, found) {
-    let listed = [];
-    if (existing) {
-        const parsed = JSON.parse(existing);
-        if (Array.isArray(parsed.repos)) {
-            listed = parsed.repos.filter((entry) => typeof entry === "string");
+/** An explicit init may create a missing file once, including under a race. */
+export function writeConfigs(plan) {
+    return plan.repos.map((repo) => {
+        const target = path.join(repo.path, "carrick.json");
+        if (repo.config === null)
+            return { path: target, created: false };
+        try {
+            fs.writeFileSync(target, `${JSON.stringify(repo.config, null, 2)}\n`, { flag: "wx" });
+            return { path: target, created: true };
+        }
+        catch (error) {
+            if (error.code === "EEXIST")
+                return { path: target, created: false };
+            throw error;
         }
+    });
+}
+/** Only GitHub origin identities are sent to the workspace metadata read. */
+export function githubRemote(repo) {
+    const result = spawnSync("git", ["-C", repo, "remote", "get-url", "origin"], { encoding: "utf8", timeout: 5000 });
+    if (result.status !== 0)
+        return null;
+    const remote = result.stdout.trim();
+    const scp = /^git@github\.com:([A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+?)(?:\.git)?$/.exec(remote);
+    if (scp)
+        return scp[1];
+    try {
+        const url = new URL(remote);
+        if (url.hostname.toLowerCase() !== "github.com" || !["https:", "ssh:"].includes(url.protocol))
+            return null;
+        const name = url.pathname.replace(/^\//, "").replace(/\.git$/, "");
+        return /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(name) ? name : null;
+    }
+    catch {
+        return null;
     }
-    const normal = (entry) => entry.replace(/^\.\//, "").replace(/\/$/, "");
-    const known = new Set(listed.map(normal));
-    const added = found.filter((entry) => !known.has(normal(entry)));
-    const repos = [...listed, ...added];
-    return { body: `${JSON.stringify({ repos }, null, 2)}\n`, repos, added };
 }
 //# sourceMappingURL=repos.js.map

package/dist/init/repos.js.map

@@ -1 +1 @@
-{"version":3,"file":"repos.js","sourceRoot":"","sources":["../../src/init/repos.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,8EAA8E;AAC9E,gDAAgD;AAEhD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,6DAA6D;AAC7D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAOtF,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,UAAuB,EAAE;IACpE,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAAE,SAAS;QACxE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAuB,EAAE,KAAe;IAKrE,IAAI,MAAM,GAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAwB,CAAC;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"repos.js","sourceRoot":"","sources":["../../src/init/repos.ts"],"names":[],"mappings":"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"}

package/dist/init/run.d.ts

@@ -1,11 +1,27 @@
 export type InitOptions = {
     workspace: string;
+    /** Require every proposed GitHub repo to belong to this project. */
+    project: string | null;
     /** Answer yes to the repo list rather than asking. */
     assumeYes: boolean;
     /** Write the files, print the lines, and do not build the index. */
     skipIndex: boolean;
 };
 export declare function parseArgs(argv: string[], cwd?: string): InitOptions | string;
+/**
+ * The editor lines, one line per editor that is on the machine.
+ *
+ * `--install-extension <id>` resolves the id against that editor's own gallery,
+ * and the three editors below read three different ones: VS Code the VS Code
+ * Marketplace, Cursor and Windsurf each their own. The extension is published
+ * to all three, so the id is a command every one of them can run
+ * (carrick#915). Any other editor gets the server's command and no claim about
+ * the editor: the per-editor results table in `plugin/TEST-PLAN.md` section 6
+ * is still empty.
+ *
+ * `onPath` is injected so a test can state each machine.
+ */
+export declare function editorLines(onPath: (command: string) => boolean): string[];
 export declare function init(argv: string[]): Promise<number>;
 /** `carrick templates <name>`, so the workflow above is one command. */
 export declare function templates(argv: string[]): number;