@alwaysmeticulous/cli 2.326.0 → 2.327.0

package/dist/commands/onboard/launch-agent.d.ts

@@ -0,0 +1,65 @@
+/** Agents we can launch to actually run the install. */
+export type LaunchableAgent = "claude" | "codex";
+/** Tools that can apply the install (Cursor is not offered in the picker). */
+export type OnboardTool = LaunchableAgent;
+export type OnboardAgentChoice = OnboardTool | "auto";
+/**
+ * The install prompt. Headless runs have nobody to approve the plan, so they
+ * post it and keep going instead of waiting.
+ */
+export declare const defaultOnboardPrompt: (options: {
+    headless: boolean;
+}) => string;
+/**
+ * Printed before the tool picker so the time cost and scope of the run are
+ * known before the user commits to a tool.
+ */
+export declare const printPreLaunchNotice: (options: {
+    selectedAppLabel: string;
+}) => void;
+export declare const isToolInstalled: (tool: OnboardTool) => boolean;
+/**
+ * Interactively asks which tool to open the workspace in, defaulting to the
+ * first installed option. Installed tools are listed first; missing ones are
+ * shown disabled with an install hint. Returns null when the terminal is not
+ * interactive (caller should fall back to printed instructions).
+ */
+export declare const promptForTool: () => Promise<OnboardTool | null>;
+/**
+ * Resolves the requested `--agent` choice to a concrete tool. `auto` prompts
+ * when interactive, otherwise falls back to the first installed agent. Returns
+ * null when no agent can be launched (caller prints manual instructions).
+ */
+export declare const resolveOnboardTool: (requested: OnboardAgentChoice) => Promise<OnboardTool | null>;
+export declare const launchOnboardTool: (options: {
+    workspaceDir: string;
+    projectRoot: string;
+    tool: OnboardTool;
+    model: string | undefined;
+    prompt: string;
+    headless: boolean;
+    auto: boolean;
+}) => number;
+export declare const printNextSteps: (options: {
+    tool: OnboardTool;
+    context: {
+        orgAndProject: string | null;
+        meticulousSideSetupPath: string;
+        meticulousTokensUrl: string | null;
+        secretsUrl: string | null;
+        secretsUrlLabel: string | null;
+        githubConfigureProjectsUrl: string | null;
+        gitlabConfigureProjectsUrl: string | null;
+        bitbucketConfigureProjectsUrl: string | null;
+        isGitHubIntegrationActive: boolean | null;
+        isGitLabIntegrationActive: boolean | null;
+        isBitbucketIntegrationActive: boolean | null;
+        ciProvider: "github-actions" | "gitlab-ci" | "bitbucket-pipelines" | "unknown";
+    };
+}) => void;
+export declare const printManualLaunchInstructions: (options: {
+    workspaceDir: string;
+    projectRoot: string;
+    prompt: string;
+}) => void;
+//# sourceMappingURL=launch-agent.d.ts.map

package/dist/commands/onboard/launch-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-agent.d.ts","sourceRoot":"","sources":["../../../src/commands/onboard/launch-agent.ts"],"names":[],"mappings":"AAUA,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AACjD,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAC1C,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,CAAC;AA0DtD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,YAAa;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,KAAG,MAG7C,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,oBAAoB,YAAa;IAC5C,gBAAgB,EAAE,MAAM,CAAC;CAC1B,KAAG,IAcH,CAAC;AAmBF,eAAO,MAAM,eAAe,SAAU,WAAW,KAAG,OAOnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,WAAW,GAAG,IAAI,CA8BhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,cAClB,kBAAkB,KAC5B,OAAO,CAAC,WAAW,GAAG,IAAI,CAsB5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,YAAa;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf,KAAG,MAsBH,CAAC;AAiDF,eAAO,MAAM,cAAc,YAAa;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,uBAAuB,EAAE,MAAM,CAAC;QAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1C,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1C,6BAA6B,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7C,yBAAyB,EAAE,OAAO,GAAG,IAAI,CAAC;QAC1C,yBAAyB,EAAE,OAAO,GAAG,IAAI,CAAC;QAC1C,4BAA4B,EAAE,OAAO,GAAG,IAAI,CAAC;QAC7C,UAAU,EACN,gBAAgB,GAChB,WAAW,GACX,qBAAqB,GACrB,SAAS,CAAC;KACf,CAAC;CACH,KAAG,IAyBH,CAAC;AA2DF,eAAO,MAAM,6BAA6B,YAAa;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,IAoCH,CAAC"}

package/dist/commands/onboard/launch-agent.js

@@ -0,0 +1,311 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cc77314d-aba3-5b50-b3e3-23beaef7d1ef")}catch(e){}}();
+
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printManualLaunchInstructions = exports.printNextSteps = exports.launchOnboardTool = exports.resolveOnboardTool = exports.promptForTool = exports.isToolInstalled = exports.printPreLaunchNotice = exports.defaultOnboardPrompt = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const docs_urls_1 = require("./docs-urls");
+const ONBOARD_PROMPT_BASE = "install meticulous (https://meticulous.ai) into this repository. " +
+    "first read `.meticulous-onboard/.claude/CLAUDE.md` and " +
+    "`.meticulous-onboard/.claude/onboard-context.json` — they define the workflow, the " +
+    "customer-facing specialist agents in `.claude/agents/`, and the project context. " +
+    "stay scoped to `selectedAppPath` from onboard-context.json (the cli already asked which " +
+    "monorepo app to use when needed). if review finds ssr that is not next.js pages router " +
+    "ssr, say so and let the user decide before you apply anything — the cli already asked the " +
+    "user whether to continue despite its ssr warning, so validate it and do not abort on your " +
+    "own guess. " +
+    "steps: (1) run the reviewer agent first (scoped to the selected app) and wait for its " +
+    "structured summary; " +
+    "(2) if `isMonorepo` is true but `selectedAppPath` is missing, ask which app to onboard " +
+    "and wait; otherwise do not re-ask; " +
+    "(3) dispatch every applicable specialist (recorder-installation, ci-setup, " +
+    "false-positive-prevention, local-simulation-verification, plus any conditional ones the " +
+    "reviewer flags) in a single parallel task message; " +
+    "(4) post a short plan (recorder approach, ci change, each conditional fix and the file it " +
+    "touches, anything needing meticulous-side setup, how you will split the prs, manual " +
+    "follow-ups) and wait for the user to approve or amend it before editing any repo file; " +
+    "(5) apply the approved plan in the real repo with small, correct diffs — install the " +
+    "recorder under the selected app, add the ci job at the repo root (monorepo-aware when " +
+    "needed), and only the conditional fixes the review says are needed. " +
+    "if anything needs work on the meticulous side rather than in the repo (websockets, unusual " +
+    "auth, central network mocking), write the file at the absolute path in " +
+    "`onboard-context.json` → `meticulousSideSetupPath` (never a relative path — your cwd is the " +
+    "onboard workspace, not the repo) describing what you found and what you need from " +
+    "meticulous, and tell the user to send that file to their meticulous contact, quoting its " +
+    "absolute path — do not commit it. " +
+    "the specialist playbooks cite docs as `.claude/docs/<path>.ts`; those files are bundled in " +
+    "this workspace — read them locally (they are the authoritative recorder snippet and ci yaml, " +
+    "including gitlab and bitbucket). only if one is missing, fetch " +
+    `\`${docs_urls_1.METICULOUS_DOCS_BASE_URL}/<path>\` (\`${docs_urls_1.METICULOUS_DOCS_HOST}\` is pre-approved for ` +
+    "webfetch), knowing fetched pages omit client-rendered snippet and non-default ci tab content " +
+    "— see the reference docs section of CLAUDE.md. " +
+    "this is a single pass: run the reviewer once and the specialists once, then apply and open " +
+    "the pr. after applying do not re-dispatch the reviewer or specialists to double-check, and " +
+    "do not build, run, or `meticulous simulate` the app yourself — verification (local " +
+    "simulation, first test run) is a post-merge step for the customer and goes only in the pr " +
+    "next steps. confirm edits with static read-backs, not by executing the app. " +
+    "the cli has already added project-scoped meticulous skills (for claude code, codex, and " +
+    "cursor), mcp configuration, and a `.gitignore` entry. you must include every path in " +
+    "`onboard-context.json` → `agentIntegrationPaths` in the onboarding pr (skills + mcp). " +
+    "the required final output is a pull request: create a new branch, commit your install " +
+    "changes plus those agent integration files " +
+    "(never the .meticulous-onboard workspace and never secrets), push to origin, and open a pr " +
+    "with `gh pr create` (or `glab mr create` on gitlab). default to one pr; only split into " +
+    "several (recorder + ci + skills first, compatibility fixes after, each cross-linked) if the " +
+    "user approved that split in the plan. the pr description must list what was " +
+    "installed first, then end with next steps for the reviewer (recording token and project " +
+    "api token from `meticulousTokensUrl` in onboard-context.json; recording token is a public " +
+    "read-only token suitable for build-time frontend env vars; api token stored in " +
+    "`secretsUrl` / `{secretsUrlLabel}`, and any remaining manual steps). if the pr cli is missing or " +
+    "unauthenticated, still commit and push the branch, then print the exact `gh pr create` " +
+    "command and compare url. finish by printing the pr url (or the branch name + command).";
+/**
+ * The install prompt. Headless runs have nobody to approve the plan, so they
+ * post it and keep going instead of waiting.
+ */
+const defaultOnboardPrompt = (options) => options.headless
+    ? `${ONBOARD_PROMPT_BASE} this run is non-interactive: post the plan in step 4 for the record and continue without waiting for approval.`
+    : ONBOARD_PROMPT_BASE;
+exports.defaultOnboardPrompt = defaultOnboardPrompt;
+/**
+ * Printed before the tool picker so the time cost and scope of the run are
+ * known before the user commits to a tool.
+ */
+const printPreLaunchNotice = (options) => {
+    console.log(chalk_1.default.bold("What happens next"));
+    console.log(`  An agent reviews ${chalk_1.default.cyan(options.selectedAppLabel)}, applies the Meticulous install, and opens a pull request.`);
+    console.log(`  ${chalk_1.default.yellow("This usually takes 15–30 minutes")} depending on the size of the project — keep this terminal open.`);
+    console.log(chalk_1.default.dim("  Model usage is billed to your own Claude Code / Codex account."));
+    console.log("");
+};
+exports.printPreLaunchNotice = printPreLaunchNotice;
+const TOOL_LABEL = {
+    claude: "Claude Code",
+    codex: "Codex",
+};
+const TOOL_COMMAND = {
+    claude: "claude",
+    codex: "codex",
+};
+const INSTALL_HINT = {
+    claude: "Install: npm install -g @anthropic-ai/claude-code — https://docs.anthropic.com/en/docs/claude-code/setup",
+    codex: "Install: npm install -g @openai/codex — https://github.com/openai/codex",
+};
+const isToolInstalled = (tool) => {
+    try {
+        (0, child_process_1.execSync)(`which ${TOOL_COMMAND[tool]}`, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+exports.isToolInstalled = isToolInstalled;
+/**
+ * Interactively asks which tool to open the workspace in, defaulting to the
+ * first installed option. Installed tools are listed first; missing ones are
+ * shown disabled with an install hint. Returns null when the terminal is not
+ * interactive (caller should fall back to printed instructions).
+ */
+const promptForTool = async () => {
+    if (!process.stdin.isTTY) {
+        return null;
+    }
+    // Cursor is intentionally omitted from the picker — Claude Code / Codex can
+    // drive the install end-to-end; Cursor still gets skills + MCP in the PR.
+    const order = ["claude", "codex"];
+    const installed = order.filter(exports.isToolInstalled);
+    const choices = order.map((tool) => {
+        const ready = installed.includes(tool);
+        return {
+            name: ready
+                ? TOOL_LABEL[tool]
+                : `${TOOL_LABEL[tool]} ${chalk_1.default.dim("(not installed)")}`,
+            value: tool,
+        };
+    });
+    const { tool } = await inquirer_1.default.prompt([
+        {
+            type: "list",
+            name: "tool",
+            message: "Which tool should apply the Meticulous install? (15–30 min run)",
+            choices,
+            default: installed[0] ?? "claude",
+        },
+    ]);
+    return tool;
+};
+exports.promptForTool = promptForTool;
+/**
+ * Resolves the requested `--agent` choice to a concrete tool. `auto` prompts
+ * when interactive, otherwise falls back to the first installed agent. Returns
+ * null when no agent can be launched (caller prints manual instructions).
+ */
+const resolveOnboardTool = async (requested) => {
+    if (requested !== "auto") {
+        return requested;
+    }
+    const picked = await (0, exports.promptForTool)();
+    if (picked) {
+        return picked;
+    }
+    if ((0, exports.isToolInstalled)("claude")) {
+        return "claude";
+    }
+    if ((0, exports.isToolInstalled)("codex")) {
+        return "codex";
+    }
+    console.log(chalk_1.default.yellow("Neither Claude Code nor Codex CLI found on PATH — printing manual instructions."));
+    return null;
+};
+exports.resolveOnboardTool = resolveOnboardTool;
+const launchOnboardTool = (options) => {
+    const { tool, projectRoot, workspaceDir } = options;
+    if (!(0, exports.isToolInstalled)(tool)) {
+        console.error(chalk_1.default.red(`${TOOL_LABEL[tool]} is not installed (\`which ${TOOL_COMMAND[tool]}\` failed).`));
+        console.error(INSTALL_HINT[tool]);
+        return 1;
+    }
+    return launchAgent({
+        tool,
+        workspaceDir,
+        projectRoot,
+        model: options.model,
+        prompt: options.prompt,
+        headless: options.headless,
+        auto: options.auto,
+    });
+};
+exports.launchOnboardTool = launchOnboardTool;
+const launchAgent = (options) => {
+    const { tool, workspaceDir, projectRoot, headless, auto, prompt } = options;
+    const model = options.model ?? (tool === "claude" ? "opus" : undefined);
+    const args = buildAgentArgs({
+        tool,
+        model,
+        prompt,
+        headless,
+        auto,
+        projectRoot,
+    });
+    console.log(chalk_1.default.bold(`Launching ${TOOL_LABEL[tool]}${headless ? " (headless)" : ""}…`));
+    console.log(chalk_1.default.dim(`  Inference uses your local ${tool === "claude" ? "Anthropic" : "OpenAI"} credentials — Meticulous does not proxy the model.`));
+    console.log("");
+    const result = (0, child_process_1.spawnSync)(TOOL_COMMAND[tool], args, {
+        cwd: workspaceDir,
+        stdio: "inherit",
+        env: { ...process.env },
+    });
+    if (result.error) {
+        console.error(`Failed to launch ${TOOL_LABEL[tool]}: ${result.error.message}`);
+        return 1;
+    }
+    return result.status ?? 1;
+};
+const printNextSteps = (options) => {
+    const { tool, context } = options;
+    const projectLabel = context.orgAndProject ?? "your Meticulous project";
+    const tokensUrl = context.meticulousTokensUrl ??
+        "https://app.meticulous.ai (Project → Settings → Tokens)";
+    const secretsLabel = context.secretsUrlLabel ?? "your CI secrets";
+    const steps = [
+        `In ${TOOL_LABEL[tool]}, authenticate the Meticulous MCP when prompted (browser OAuth).`,
+        `Grab the recording token and project API token from ${chalk_1.default.cyan(tokensUrl)}.`,
+        `Put the recording token in a build-time frontend env var (it is a public, read-only token), and put the API token in ${secretsLabel}${context.secretsUrl ? ` (${chalk_1.default.cyan(context.secretsUrl)})` : ""} for ${chalk_1.default.cyan(projectLabel)}.`,
+        unresolvedVcsLinkStep(context),
+        meticulousSideSetupStep(context.meticulousSideSetupPath),
+        "Merge the PR, then confirm sessions appear in the Meticulous dashboard.",
+    ].filter((step) => step !== null);
+    console.log("");
+    console.log(chalk_1.default.bold("Next steps"));
+    steps.forEach((step, index) => {
+        console.log(`  ${index + 1}. ${step}`);
+    });
+    console.log("");
+};
+exports.printNextSteps = printNextSteps;
+/** Surfaces the hand-back file when the agent found work for us to do. */
+const meticulousSideSetupStep = (setupPath) => {
+    if (!(0, fs_1.existsSync)(setupPath)) {
+        return null;
+    }
+    return (`Send ${chalk_1.default.cyan(setupPath)} to your Meticulous contact (or support@meticulous.ai) — ` +
+        "it lists setup this project needs on the Meticulous side.");
+};
+const unresolvedVcsLinkStep = (context) => {
+    switch (context.ciProvider) {
+        case "github-actions":
+            return linkStepFor(context.isGitHubIntegrationActive, docs_urls_1.GITHUB_ACTIONS_DOCS_URL);
+        case "gitlab-ci":
+            return linkStepFor(context.isGitLabIntegrationActive, context.gitlabConfigureProjectsUrl);
+        case "bitbucket-pipelines":
+            return linkStepFor(context.isBitbucketIntegrationActive, context.bitbucketConfigureProjectsUrl);
+        default:
+            return null;
+    }
+};
+const linkStepFor = (linked, configureUrl) => {
+    if (linked !== false) {
+        return null;
+    }
+    return configureUrl
+        ? `Link the repo to Meticulous at ${chalk_1.default.cyan(configureUrl)}.`
+        : "Link the repo to Meticulous in your project settings.";
+};
+const printManualLaunchInstructions = (options) => {
+    const { workspaceDir, projectRoot, prompt } = options;
+    const escapedPrompt = prompt.replace(/"/g, '\\"');
+    console.log("");
+    console.log(chalk_1.default.bold.green("Onboard workspace ready!"));
+    console.log("");
+    console.log(`  ${chalk_1.default.cyan("Workspace:")} ${workspaceDir}`);
+    console.log(`  ${chalk_1.default.cyan("Repo:")}      ${projectRoot}`);
+    console.log("");
+    console.log(chalk_1.default.bold("  Open in your preferred tool:"));
+    console.log("");
+    console.log(chalk_1.default.dim("  This can take 15–30 minutes depending on the size of the project."));
+    console.log("");
+    console.log(`    ${chalk_1.default.cyan("Claude Code:")}  cd "${workspaceDir}" && claude "${escapedPrompt}" --add-dir "${projectRoot}"`);
+    console.log(`    ${chalk_1.default.cyan("Codex:")}        cd "${workspaceDir}" && codex "${escapedPrompt}" --sandbox workspace-write --add-dir "${projectRoot}"`);
+    console.log("");
+    console.log(chalk_1.default.dim("  The agent applies the install and opens a pull request with the changes."));
+    console.log(chalk_1.default.dim("  Model usage is billed to your own Claude Code / Codex account."));
+    console.log("");
+};
+exports.printManualLaunchInstructions = printManualLaunchInstructions;
+/**
+ * `--add-dir <directories...>` is variadic in both CLIs, so the prompt must
+ * never follow it — it would be parsed as another directory (and a long prompt
+ * then fails with ENAMETOOLONG). Keep the prompt first and `--add-dir` last.
+ */
+const buildAgentArgs = (options) => {
+    const { tool, model, prompt, headless, auto, projectRoot } = options;
+    const modelArgs = model ? ["--model", model] : [];
+    const addDir = ["--add-dir", projectRoot];
+    if (tool === "claude") {
+        const autoArgs = auto ? ["--permission-mode", "acceptEdits"] : [];
+        if (headless) {
+            return ["-p", prompt, ...modelArgs, ...autoArgs, ...addDir];
+        }
+        return [prompt, ...modelArgs, ...autoArgs, ...addDir];
+    }
+    // Codex. The primary workspace is `.meticulous-onboard`, so the repo itself
+    // is only writable via `--add-dir` — and Codex silently ignores that flag
+    // under its default read-only sandbox. workspace-write is therefore required,
+    // not just an `--auto` nicety; approvals still gate what actually runs.
+    const sandboxArgs = ["--sandbox", "workspace-write"];
+    if (headless) {
+        // `codex exec` is non-interactive and takes no approval policy.
+        return ["exec", prompt, ...modelArgs, ...sandboxArgs, ...addDir];
+    }
+    const autoArgs = auto ? ["--ask-for-approval", "on-request"] : [];
+    return [prompt, ...modelArgs, ...sandboxArgs, ...autoArgs, ...addDir];
+};
+//# sourceMappingURL=launch-agent.js.map
+//# debugId=cc77314d-aba3-5b50-b3e3-23beaef7d1ef

package/dist/commands/onboard/launch-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-agent.js","sources":["../../../src/commands/onboard/launch-agent.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"cc77314d-aba3-5b50-b3e3-23beaef7d1ef"}

package/dist/commands/onboard/materialize-workspace.d.ts

@@ -0,0 +1,68 @@
+export declare const ONBOARD_WORKDIR = ".meticulous-onboard";
+/**
+ * Written by the install agent (not the CLI) when something needs setup on the
+ * Meticulous side, e.g. WebSocket support. The customer sends it back to us.
+ */
+export declare const METICULOUS_SIDE_SETUP_FILE = "meticulous-side-setup.md";
+export interface OnboardContextJson {
+    orgAndProject: string | null;
+    projectRoot: string;
+    /**
+     * Absolute path the agent must use for METICULOUS_SIDE_SETUP_FILE. The agent
+     * runs with the onboard workspace as its cwd rather than the repo, so a
+     * relative path lands somewhere neither it nor the user expects.
+     */
+    meticulousSideSetupPath: string;
+    repoUrl: string | null;
+    ciProvider: "github-actions" | "gitlab-ci" | "bitbucket-pipelines" | "unknown";
+    isGitHubIntegrationActive: boolean | null;
+    isGitLabIntegrationActive: boolean | null;
+    isBitbucketIntegrationActive: boolean | null;
+    meticulousSettingsUrl: string | null;
+    /** Recording token + project API token live on this Tokens settings page. */
+    meticulousTokensUrl: string | null;
+    meticulousSessionsUrl: string | null;
+    /** Org page to link/map the GitHub repo to this Meticulous project. */
+    githubConfigureProjectsUrl: string | null;
+    /** Project settings page where the GitLab access token is entered. */
+    gitlabConfigureProjectsUrl: string | null;
+    /** Project settings page where the Bitbucket access token is entered. */
+    bitbucketConfigureProjectsUrl: string | null;
+    secretsUrl: string | null;
+    secretsUrlLabel: string | null;
+    /**
+     * Repo-relative paths the CLI installed for skills/MCP. The agent MUST stage
+     * and commit these in the onboarding PR (when they exist).
+     */
+    agentIntegrationPaths: string[];
+    /** Whether the repo is a monorepo with multiple frontend apps. */
+    isMonorepo: boolean;
+    /** Repo-relative path of the selected frontend app (`.` if single-package). */
+    selectedAppPath: string;
+    selectedAppName: string;
+    selectedAppAbsolutePath: string;
+    frameworkDetection: {
+        framework: string;
+        rendering: string;
+        isUnsupportedSsr: boolean;
+        /** `"high"` or `"ambiguous"`; null unless `isUnsupportedSsr` is true. */
+        unsupportedSsrConfidence: string | null;
+        details: string[];
+    } | null;
+}
+/**
+ * Materializes a Claude Code workspace under `<projectRoot>/.meticulous-onboard`
+ * with CLAUDE.md, settings, customer-facing agents, and onboard-context.json.
+ * The customer repo is edited via `--add-dir` when launching the agent.
+ */
+export declare const materializeOnboardWorkspace: (options: {
+    projectRoot: string;
+    context: OnboardContextJson;
+}) => string;
+/** Rewrites onboard-context.json in the materialized workspace (e.g. after skills/MCP install). */
+export declare const updateOnboardContext: (options: {
+    projectRoot: string;
+    workspaceDir: string;
+    context: OnboardContextJson;
+}) => void;
+//# sourceMappingURL=materialize-workspace.d.ts.map

package/dist/commands/onboard/materialize-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/onboard/materialize-workspace.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EACN,gBAAgB,GAChB,WAAW,GACX,qBAAqB,GACrB,SAAS,CAAC;IACd,yBAAyB,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,yBAAyB,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,4BAA4B,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,6EAA6E;IAC7E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,uEAAuE;IACvE,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,sEAAsE;IACtE,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,yEAAyE;IACzE,6BAA6B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,yEAAyE;QACzE,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;QACxC,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,IAAI,CAAC;CACV;AA+DD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,YAAa;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,KAAG,MAiGH,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,oBAAoB,YAAa;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,KAAG,IAaH,CAAC"}

package/dist/commands/onboard/materialize-workspace.js

@@ -0,0 +1,177 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d487abf0-d680-53cb-9665-4e716c731c92")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateOnboardContext = exports.materializeOnboardWorkspace = exports.METICULOUS_SIDE_SETUP_FILE = exports.ONBOARD_WORKDIR = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const customer_agents_1 = require("./customer-agents");
+const customer_docs_1 = require("./customer-docs");
+const inline_doc_constants_1 = require("./inline-doc-constants");
+const safe_repo_fs_1 = require("./safe-repo-fs");
+exports.ONBOARD_WORKDIR = ".meticulous-onboard";
+/**
+ * Written by the install agent (not the CLI) when something needs setup on the
+ * Meticulous side, e.g. WebSocket support. The customer sends it back to us.
+ */
+exports.METICULOUS_SIDE_SETUP_FILE = "meticulous-side-setup.md";
+const templatesDir = () => (0, path_1.join)(__dirname, "templates");
+const agentsDir = () => {
+    const bundled = (0, path_1.join)(templatesDir(), "agents");
+    // Prefer the postbuild-copied agents only when they actually contain files —
+    // an empty `templates/agents/` directory (e.g. from a partial local setup)
+    // must not block the source-mode fallback.
+    if ((0, fs_1.existsSync)(bundled) &&
+        (0, fs_1.readdirSync)(bundled).some((file) => file.endsWith(".md"))) {
+        return bundled;
+    }
+    // Source-mode fallback (`pnpm cli:dev`), which reads the canonical agents
+    // directly. That directory also holds internal-only agents, so the copy below
+    // is driven by CUSTOMER_AGENT_NAMES rather than by its contents. Published
+    // builds get the same subset pre-filtered into dist by
+    // scripts/copy-onboard-templates.mjs.
+    return (0, path_1.join)(__dirname, "..", "..", "..", "..", "..", "packages", "admin-cli", "src", "cli", "onboard", "templates", "agents");
+};
+const webappFrontendDir = () => (0, path_1.join)(__dirname, "..", "..", "..", "..", "..", "packages", "webapp-frontend");
+const docsSrcDir = () => {
+    const bundled = (0, path_1.join)(templatesDir(), "docs");
+    if ((0, fs_1.existsSync)(bundled) && (0, fs_1.readdirSync)(bundled).length > 0) {
+        return bundled;
+    }
+    // Source-mode fallback: read the canonical docs content straight from
+    // webapp-frontend. Published builds get the CUSTOMER_DOC_FILES/DIRS subset
+    // pre-copied into dist by scripts/copy-onboard-templates.mjs.
+    return (0, path_1.join)(webappFrontendDir(), "src", "components", "docs", "content");
+};
+/**
+ * Root the docs' `src/...` imports resolve against while inlining constants.
+ * Published builds only ship the CUSTOMER_DOC_IMPORT_FILES subset, mirrored at
+ * the same paths so both modes resolve identically.
+ */
+const docImportsRoot = () => {
+    const bundled = (0, path_1.join)(templatesDir(), "docs-imports");
+    return (0, fs_1.existsSync)(bundled) ? bundled : webappFrontendDir();
+};
+/**
+ * Materializes a Claude Code workspace under `<projectRoot>/.meticulous-onboard`
+ * with CLAUDE.md, settings, customer-facing agents, and onboard-context.json.
+ * The customer repo is edited via `--add-dir` when launching the agent.
+ */
+const materializeOnboardWorkspace = (options) => {
+    const { projectRoot } = options;
+    const workspaceRelative = exports.ONBOARD_WORKDIR;
+    const claudeRelative = (0, path_1.join)(exports.ONBOARD_WORKDIR, ".claude");
+    const agentsRelative = (0, path_1.join)(claudeRelative, "agents");
+    const docsRelative = (0, path_1.join)(claudeRelative, "docs");
+    (0, safe_repo_fs_1.mkdirSafeSync)(projectRoot, agentsRelative);
+    const workspaceAbsolute = (0, safe_repo_fs_1.resolveSafeWritePath)(projectRoot, workspaceRelative);
+    (0, safe_repo_fs_1.writeFileSafeSync)(projectRoot, (0, path_1.join)(workspaceRelative, ".gitignore"), "*\n");
+    const templates = templatesDir();
+    (0, safe_repo_fs_1.writeFileSafeSync)(projectRoot, (0, path_1.join)(claudeRelative, "CLAUDE.md"), (0, fs_1.readFileSync)((0, path_1.join)(templates, "CLAUDE.md"), "utf8"));
+    (0, safe_repo_fs_1.copyFileSafeSync)(projectRoot, (0, path_1.join)(claudeRelative, "settings.json"), (0, path_1.join)(templates, "settings.json"));
+    const agentsSrc = agentsDir();
+    const missing = [];
+    for (const agentName of customer_agents_1.CUSTOMER_AGENT_NAMES) {
+        const file = `${agentName}.md`;
+        const src = (0, path_1.join)(agentsSrc, file);
+        if (!(0, fs_1.existsSync)(src)) {
+            missing.push(file);
+            continue;
+        }
+        (0, safe_repo_fs_1.copyFileSafeSync)(projectRoot, (0, path_1.join)(agentsRelative, file), src);
+    }
+    if (missing.length > 0) {
+        throw new Error(`Missing onboard agent template(s) in ${agentsSrc}: ${missing.join(", ")}. ` +
+            `Update customer-agents.json if these agents were renamed or removed.`);
+    }
+    // The agent playbooks cite these docs as `.claude/docs/<path>`; the live docs
+    // pages render the recorder snippets and non-default CI tabs client-side, so
+    // the files must be present locally rather than fetched.
+    const docsSrc = docsSrcDir();
+    const webappRoot = docImportsRoot();
+    const missingDocs = [];
+    for (const docPath of customer_docs_1.CUSTOMER_DOC_FILES) {
+        const src = (0, path_1.join)(docsSrc, docPath);
+        if (!(0, fs_1.existsSync)(src)) {
+            missingDocs.push(docPath);
+            continue;
+        }
+        const destRelative = (0, path_1.join)(docsRelative, docPath);
+        (0, safe_repo_fs_1.mkdirSafeSync)(projectRoot, (0, path_1.join)(destRelative, ".."));
+        copyDocIntoWorkspace(projectRoot, src, destRelative, webappRoot);
+    }
+    for (const docDir of customer_docs_1.CUSTOMER_DOC_DIRS) {
+        const srcDir = (0, path_1.join)(docsSrc, docDir);
+        if (!(0, fs_1.existsSync)(srcDir)) {
+            missingDocs.push(`${docDir}/`);
+            continue;
+        }
+        copyDocsDirIntoWorkspace(projectRoot, srcDir, (0, path_1.join)(docsRelative, docDir), webappRoot);
+    }
+    if (missingDocs.length > 0) {
+        throw new Error(`Missing onboard doc file(s) in ${docsSrc}: ${missingDocs.join(", ")}. ` +
+            `Update customer-docs.json if these docs were moved or renamed.`);
+    }
+    const contextPayload = JSON.stringify(options.context, null, 2) + "\n";
+    (0, safe_repo_fs_1.writeFileSafeSync)(projectRoot, (0, path_1.join)(claudeRelative, "onboard-context.json"), contextPayload);
+    // Convenience copy at workspace root for prompts that say "read onboard-context.json".
+    (0, safe_repo_fs_1.writeFileSafeSync)(projectRoot, (0, path_1.join)(workspaceRelative, "onboard-context.json"), contextPayload);
+    ensureGitignoreEntry(projectRoot, exports.ONBOARD_WORKDIR);
+    return workspaceAbsolute;
+};
+exports.materializeOnboardWorkspace = materializeOnboardWorkspace;
+/** Rewrites onboard-context.json in the materialized workspace (e.g. after skills/MCP install). */
+const updateOnboardContext = (options) => {
+    (0, safe_repo_fs_1.assertWorkspaceInsideProject)(options.projectRoot, options.workspaceDir);
+    const payload = JSON.stringify(options.context, null, 2) + "\n";
+    (0, safe_repo_fs_1.writeFileSafeSync)(options.projectRoot, (0, path_1.join)(exports.ONBOARD_WORKDIR, ".claude", "onboard-context.json"), payload);
+    (0, safe_repo_fs_1.writeFileSafeSync)(options.projectRoot, (0, path_1.join)(exports.ONBOARD_WORKDIR, "onboard-context.json"), payload);
+};
+exports.updateOnboardContext = updateOnboardContext;
+/** Recursively copies a trusted docs dir into a repo-relative destination. */
+const copyDocsDirIntoWorkspace = (projectRoot, srcDir, destRelative, webappRoot) => {
+    (0, safe_repo_fs_1.mkdirSafeSync)(projectRoot, destRelative);
+    for (const entry of (0, fs_1.readdirSync)(srcDir, { withFileTypes: true })) {
+        const src = (0, path_1.join)(srcDir, entry.name);
+        const dest = (0, path_1.join)(destRelative, entry.name);
+        if (entry.isDirectory()) {
+            copyDocsDirIntoWorkspace(projectRoot, src, dest, webappRoot);
+        }
+        else if (entry.isFile()) {
+            copyDocIntoWorkspace(projectRoot, src, dest, webappRoot);
+        }
+    }
+};
+/**
+ * Copies one doc, inlining the constants it imports from other doc modules so
+ * the agent reads the same content the docs site renders.
+ */
+const copyDocIntoWorkspace = (projectRoot, src, destRelative, webappRoot) => {
+    (0, safe_repo_fs_1.writeFileSafeSync)(projectRoot, destRelative, (0, inline_doc_constants_1.inlineImportedDocConstants)({
+        source: (0, fs_1.readFileSync)(src, "utf8"),
+        docPath: src,
+        webappRoot,
+    }));
+};
+const ensureGitignoreEntry = (projectRoot, entry) => {
+    const relativeGitignore = ".gitignore";
+    const line = `${entry}/`;
+    let content = "";
+    let existedAsSafeFile = false;
+    const gitignorePath = (0, safe_repo_fs_1.resolveSafeWritePath)(projectRoot, relativeGitignore);
+    if ((0, fs_1.existsSync)(gitignorePath)) {
+        content = (0, fs_1.readFileSync)(gitignorePath, "utf8");
+        existedAsSafeFile = true;
+    }
+    if (!existedAsSafeFile) {
+        (0, safe_repo_fs_1.writeFileSafeSync)(projectRoot, relativeGitignore, `${line}\n`);
+        return;
+    }
+    if (content.split(/\r?\n/).some((l) => l.trim() === line || l.trim() === entry)) {
+        return;
+    }
+    const suffix = content.endsWith("\n") ? "" : "\n";
+    (0, safe_repo_fs_1.writeFileSafeSync)(projectRoot, relativeGitignore, `${content}${suffix}\n# Meticulous AI onboard workspace\n${line}\n`);
+};
+//# sourceMappingURL=materialize-workspace.js.map
+//# debugId=d487abf0-d680-53cb-9665-4e716c731c92