@doriandev/devcc 0.1.2 → 0.3.0

package/dist/devcc/index.js

@@ -6,16 +6,25 @@
  * git parsing) without the UI.
  */
 export { App } from "./app/App.js";
+export { createControlPlaneCommands } from "./app/controlPlaneCommands.js";
+export { AgentManager, BUILTIN_AGENTS, createAgentAdapters, } from "./agents/agents.js";
+export { configCheckCommand, envCommand, initCommand, verifyCommand, worktreeListCommand, } from "./automation.js";
+export { detectProject, renderStarterConfig, starterConfig } from "./init/detect.js";
+export { buildSetupPrompt, extractConfigFromOutput } from "./init/prompt.js";
 export { createBuiltinCommands, createConfigCommands, createScriptCommands } from "./app/builtinCommands.js";
 export { HELP_SECTIONS, VIEW_SHORTCUTS } from "./app/keymap.js";
 export { theme, glyphs, processStatusStyle, serviceStateStyle } from "./app/theme.js";
 export { CommandRegistry } from "./core/commands.js";
-export { defineConfig, loadConfig, validateConfig, findConfigFile, CONFIG_FILENAMES, DEFAULT_REFRESH, } from "./core/config.js";
+export { defineConfig, loadConfig, validateConfig, findConfigFile, loadConfigFile, CONFIG_FILENAMES, DEFAULT_REFRESH, } from "./core/config.js";
 export { TypedEmitter, Subscriptions } from "./core/events.js";
 export { Store, VIEW_IDS, createInitialState, } from "./core/state.js";
 export { DependencyService, updateArgs } from "./deps/DependencyService.js";
 export { outdatedArgs, parseOutdated, severityBetween, sortOutdated, summariseOutdated, supportsOutdatedJson, } from "./deps/parse.js";
+export { EnvironmentService } from "./environment/EnvironmentService.js";
+export { parseDirenvStatus, parseMiseLs, } from "./environment/integrations.js";
+export { DEFAULT_TOOLS, detectTool, findExecutable, } from "./environment/tools.js";
 export { GitService } from "./git/GitService.js";
+export { defaultWorktreePath, parseWorktreeList, removalBlocker, validateBranchName, worktreeAddArgs, worktreeRemoveArgs, } from "./git/worktrees.js";
 export { parseCommits, parsePorcelainV2, summariseStatus, summariseTracking, } from "./git/parse.js";
 export { LogBuffer, LogStore, MAX_LOG_LINES, } from "./logs/LogBuffer.js";
 export { canTransition, crashBackoffDelay, shouldAutoRestart, DEFAULT_CRASH_POLICY, createManagedProcess, describeCommand, isActive, } from "./processes/ManagedProcess.js";
@@ -25,7 +34,9 @@ export { buildProjectList, discoverProjects, isProjectDirectory, readRecents, re
 export { ServiceManager } from "./services/ServiceManager.js";
 export { DockerService, findComposeFile, parseComposePs } from "./services/docker.js";
 export { PortService, detectNodeServices } from "./services/node.js";
-export { OllamaService } from "./services/ollama.js";
+export { mergeOllamaModels, OllamaService } from "./services/ollama.js";
+export { parseTailscaleStatus, RemoteMachineService, TailscaleService, } from "./services/remote.js";
+export { editorCommand, launchDetached, sshCommand, terminalCommand } from "./platform/launch.js";
 export { PostgresService, parsePostgresUrl } from "./services/postgres.js";
 export { RedisService, parseRedisUrl } from "./services/redis.js";
 export { SystemMonitor, cpuUsageBetween, sampleCpu } from "./system/SystemMonitor.js";
@@ -33,4 +44,5 @@ export { DevccError, errorMessage, toDevccError } from "./utils/errors.js";
 export { Logger, createLogger } from "./utils/logger.js";
 export { detectPackageManager, readPackageJson, readScripts, runScriptArgs, } from "./utils/packageManager.js";
 export { findProjectRoot } from "./utils/paths.js";
+export { createSpawnExecutor, resolveVerifySteps, runVerification, } from "./verify/verify.js";
 //# sourceMappingURL=index.js.map

package/dist/devcc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/devcc/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAmB,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC5G,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAErF,OAAO,EAAE,eAAe,EAA+C,MAAM,oBAAoB,CAAA;AACjG,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,GAKhB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAoB,MAAM,kBAAkB,CAAA;AAChF,OAAO,EACL,KAAK,EACL,QAAQ,EACR,kBAAkB,GAMnB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAA2B,MAAM,6BAA6B,CAAA;AACpG,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GAGrB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,UAAU,EAAoB,MAAM,qBAAqB,CAAA;AAClE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAIlB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,GAId,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,QAAQ,GAKT,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAkB,MAAM,sBAAsB,CAAA;AACnF,OAAO,EAAE,cAAc,EAA8B,MAAM,+BAA+B,CAAA;AAE1F,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,YAAY,GAEb,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAsB,MAAM,2BAA2B,CAAA;AAEzG,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAiB,MAAM,mBAAmB,CAAA;AACvE,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,aAAa,GAEd,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/devcc/index.ts"],"names":[],"mappings":"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"}

package/dist/devcc/init/detect.d.ts

@@ -0,0 +1,55 @@
+import type { ProcessDefinition } from "../processes/ManagedProcess.js";
+import { type PackageManagerDetection, type PackageScript } from "../utils/packageManager.js";
+import type { VerifyEntry } from "../verify/verify.js";
+/**
+ * Project detection for `devcc init` and the agent setup prompt.
+ *
+ * Only facts that can be read from the repository are collected - nothing is
+ * executed and nothing is guessed. The starter config built from them is
+ * deliberately conservative: a script is only used when it exists.
+ */
+export interface ProjectFacts {
+    rootDir: string;
+    name: string;
+    /** Existing config file, if any. */
+    configPath: string | null;
+    hasGit: boolean;
+    /** Null when there is no package.json. */
+    packageManager: PackageManagerDetection | null;
+    scripts: PackageScript[];
+    frameworks: {
+        name: string;
+        dependency: string;
+        port: number;
+    }[];
+    /** Script chosen to run the app in development. */
+    devScript?: string;
+    /** Scripts suitable for `verify`, in the order they should run. */
+    verifyScripts: string[];
+    /** Scripts that look like verification but were left out, with the reason. */
+    skippedScripts: {
+        name: string;
+        reason: string;
+    }[];
+    monorepo: string | null;
+    languages: ("node" | "rust" | "go" | "python")[];
+    /** Notable files present at the root (compose file, .envrc, mise.toml, Makefile, ...). */
+    files: string[];
+}
+type Exists = (path: string) => boolean;
+/** Why a script cannot be a verify step, or null when it can. */
+export declare function unsuitableForVerify(command: string): string | null;
+export declare function detectProject(rootDir: string, exists?: Exists): ProjectFacts;
+export interface StarterConfig {
+    processes: ProcessDefinition[];
+    verify: VerifyEntry[];
+}
+export declare function starterConfig(facts: ProjectFacts): StarterConfig;
+/** Render the starter as a `.devcc.ts` file. Plain object: no dependency on devcc is required. */
+export declare function renderStarterConfig(facts: ProjectFacts, date?: Date): string;
+/** A TypeScript object literal: identifier keys unquoted, values JSON-encoded. */
+export declare function literal(value: unknown, indent?: number): string;
+/** Short file contents for the prompt, so the agent starts from real data. */
+export declare function readSnippet(path: string, maxLength?: number): string | null;
+export {};
+//# sourceMappingURL=detect.d.ts.map

package/dist/devcc/init/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/devcc/init/detect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEvE,OAAO,EAML,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,OAAO,CAAA;IACf,0CAA0C;IAC1C,cAAc,EAAE,uBAAuB,GAAG,IAAI,CAAA;IAC9C,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAChE,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,8EAA8E;IAC9E,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAA;IAChD,0FAA0F;IAC1F,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;AAqCvC,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAmB,GAAG,YAAY,CAgExF;AAsBD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,iBAAiB,EAAE,CAAA;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAchE;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,OAAa,GAAG,MAAM,CAmClF;AAED,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,MAAM,CAoB1D;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,MAAM,GAAG,IAAI,CAO1E"}

package/dist/devcc/init/detect.js

@@ -0,0 +1,207 @@
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { findConfigFile } from "../core/config.js";
+import { detectFrameworks } from "../services/node.js";
+import { detectPackageManager, readPackageJson, readScripts, runScriptArgs, } from "../utils/packageManager.js";
+const DEV_SCRIPTS = ["dev", "start:dev", "develop", "serve"];
+/** Verify categories in run order; the first matching script name in each wins. */
+const VERIFY_CATEGORIES = [
+    ["format:check", "format-check", "fmt:check", "prettier:check", "check:format", "lint:format"],
+    ["lint"],
+    ["typecheck", "type-check", "check-types", "types:check", "tsc"],
+    ["test:ci", "test:run", "test:unit", "test"],
+    ["build"],
+];
+/** Aggregate scripts used only when no individual checks exist. */
+const AGGREGATE_SCRIPTS = ["verify", "ci", "check", "validate"];
+const NOTABLE_FILES = [
+    "compose.yaml",
+    "compose.yml",
+    "docker-compose.yml",
+    "docker-compose.yaml",
+    ".envrc",
+    "mise.toml",
+    ".mise.toml",
+    ".tool-versions",
+    ".env.example",
+    "Makefile",
+    "turbo.json",
+    "nx.json",
+    "pnpm-workspace.yaml",
+    "Cargo.toml",
+    "go.mod",
+    "pyproject.toml",
+    "AGENTS.md",
+    "CLAUDE.md",
+];
+/** Why a script cannot be a verify step, or null when it can. */
+export function unsuitableForVerify(command) {
+    if (/--watch\b|\bwatch\b/u.test(command))
+        return "runs in watch mode";
+    if (/no test specified/u.test(command))
+        return "is npm's placeholder";
+    if (/--fix\b|--write\b/u.test(command))
+        return "modifies files";
+    return null;
+}
+export function detectProject(rootDir, exists = existsSync) {
+    const packageJson = readPackageJson(rootDir);
+    const scripts = readScripts(packageJson);
+    const byName = new Map(scripts.map((script) => [script.name, script.command]));
+    const verifyScripts = [];
+    const skippedScripts = [];
+    for (const category of VERIFY_CATEGORIES) {
+        for (const name of category) {
+            const command = byName.get(name);
+            if (command === undefined)
+                continue;
+            const reason = unsuitableForVerify(command);
+            if (reason) {
+                skippedScripts.push({ name, reason });
+                continue;
+            }
+            verifyScripts.push(name);
+            break;
+        }
+    }
+    if (verifyScripts.length === 0) {
+        const aggregate = AGGREGATE_SCRIPTS.find((name) => {
+            const command = byName.get(name);
+            return command !== undefined && unsuitableForVerify(command) === null;
+        });
+        if (aggregate)
+            verifyScripts.push(aggregate);
+    }
+    const files = NOTABLE_FILES.filter((file) => exists(join(rootDir, file)));
+    const languages = [];
+    if (packageJson)
+        languages.push("node");
+    if (files.includes("Cargo.toml"))
+        languages.push("rust");
+    if (files.includes("go.mod"))
+        languages.push("go");
+    if (files.includes("pyproject.toml"))
+        languages.push("python");
+    const monorepo = files.includes("pnpm-workspace.yaml")
+        ? "pnpm workspaces"
+        : files.includes("turbo.json")
+            ? "Turborepo"
+            : files.includes("nx.json")
+                ? "Nx"
+                : packageJson?.workspaces
+                    ? "package.json workspaces"
+                    : null;
+    return {
+        rootDir,
+        name: typeof packageJson?.name === "string" ? packageJson.name : basename(rootDir),
+        configPath: findConfigFile(rootDir, exists),
+        hasGit: exists(join(rootDir, ".git")),
+        packageManager: packageJson ? detectPackageManager({ rootDir, packageJson, fileExists: exists }) : null,
+        scripts,
+        frameworks: detectFrameworks(packageJson).map((hint) => ({
+            name: hint.name,
+            dependency: hint.dependency,
+            port: hint.port,
+        })),
+        devScript: DEV_SCRIPTS.find((name) => byName.has(name)),
+        verifyScripts,
+        skippedScripts,
+        monorepo,
+        languages,
+        files,
+    };
+}
+/** Inline verify steps for non-Node projects, using each toolchain's standard commands. */
+function toolchainVerify(facts) {
+    if (facts.verifyScripts.length > 0)
+        return facts.verifyScripts;
+    if (facts.languages.includes("rust")) {
+        return [
+            { id: "fmt", name: "cargo fmt", command: "cargo", args: ["fmt", "--check"] },
+            { id: "clippy", name: "cargo clippy", command: "cargo", args: ["clippy", "--all-targets"] },
+            { id: "test", name: "cargo test", command: "cargo", args: ["test"] },
+        ];
+    }
+    if (facts.languages.includes("go")) {
+        return [
+            { id: "vet", name: "go vet", command: "go", args: ["vet", "./..."] },
+            { id: "test", name: "go test", command: "go", args: ["test", "./..."] },
+            { id: "build", name: "go build", command: "go", args: ["build", "./..."] },
+        ];
+    }
+    return [];
+}
+export function starterConfig(facts) {
+    const processes = [];
+    const manager = facts.packageManager?.manager;
+    if (manager && facts.devScript) {
+        const framework = facts.frameworks[0];
+        processes.push({
+            id: "dev",
+            name: framework?.name ?? `${manager} ${facts.devScript}`,
+            command: manager,
+            args: runScriptArgs(manager, facts.devScript),
+            ...(framework ? { url: `localhost:${framework.port}`, readiness: { port: framework.port } } : {}),
+        });
+    }
+    return { processes, verify: toolchainVerify(facts) };
+}
+/** Render the starter as a `.devcc.ts` file. Plain object: no dependency on devcc is required. */
+export function renderStarterConfig(facts, date = new Date()) {
+    const starter = starterConfig(facts);
+    const lines = [
+        `/**`,
+        ` * devcc configuration for ${facts.name}, generated by \`devcc init\` on ${date.toISOString().slice(0, 10)}.`,
+        ` *`,
+        ` * Everything here is optional. Check it with \`devcc config check\`; refine it with`,
+        ` * \`devcc init --agent claude\` (or codex). Reference: https://www.npmjs.com/package/@doriandev/devcc`,
+        ` */`,
+        `export default {`,
+    ];
+    if (starter.processes.length > 0) {
+        lines.push(`  processes: ${literal(starter.processes, 2)},`, ``);
+    }
+    else {
+        lines.push(`  // processes: [{ id: "web", command: "pnpm", args: ["dev"], readiness: { port: 3000 } }],`, ``);
+    }
+    if (starter.verify.length > 0) {
+        lines.push(`  // \`devcc verify\` runs these in order and exits 0 only if all pass.`);
+        lines.push(`  verify: ${literal(starter.verify, 2)},`, ``);
+    }
+    else {
+        lines.push(`  // verify: ["lint", "test"],`, ``);
+    }
+    lines.push(`  // editor: { command: "code" },`, `  // agents: { claude: { args: ["--permission-mode", "acceptEdits"] } },`, `}`, ``);
+    return lines.join("\n");
+}
+/** A TypeScript object literal: identifier keys unquoted, values JSON-encoded. */
+export function literal(value, indent = 0) {
+    const pad = " ".repeat(indent);
+    const inner = " ".repeat(indent + 2);
+    if (Array.isArray(value)) {
+        if (value.every((item) => typeof item !== "object" || item === null)) {
+            return `[${value.map((item) => literal(item)).join(", ")}]`;
+        }
+        return `[\n${value.map((item) => `${inner}${literal(item, indent + 2)},`).join("\n")}\n${pad}]`;
+    }
+    if (typeof value === "object" && value !== null) {
+        const entries = Object.entries(value).filter(([, entry]) => entry !== undefined);
+        const rendered = entries.map(([key, entry]) => `${/^[A-Za-z_$][\w$]*$/u.test(key) ? key : JSON.stringify(key)}: ${literal(entry, indent + 2)}`);
+        const oneLine = `{ ${rendered.join(", ")} }`;
+        if (oneLine.length + indent <= 100 && !oneLine.includes("\n"))
+            return oneLine;
+        return `{\n${rendered.map((entry) => `${inner}${entry},`).join("\n")}\n${pad}}`;
+    }
+    return JSON.stringify(value);
+}
+/** Short file contents for the prompt, so the agent starts from real data. */
+export function readSnippet(path, maxLength = 2_000) {
+    try {
+        const text = readFileSync(path, "utf8");
+        return text.length > maxLength ? `${text.slice(0, maxLength)}\n…` : text;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/devcc/init/detect.js.map

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

package/dist/devcc/init/prompt.d.ts

@@ -0,0 +1,25 @@
+import { type ProjectFacts } from "./detect.js";
+/**
+ * The prompt that lets a coding agent set up devcc for a project.
+ *
+ * It carries what devcc already detected (so the agent verifies rather than
+ * rediscovers), a draft to start from, the config reference, and firm rules:
+ * never invent commands, never guess hosts, keep verify non-interactive.
+ *
+ * Two delivery modes:
+ * - `write`: an interactive agent edits `.devcc.ts` itself and checks its work
+ *   with `devcc config check` (used by `devcc init --agent`).
+ * - `print`: a headless agent prints the file between markers; devcc validates
+ *   it and asks before writing (used from the dashboard, where the agent has no
+ *   permission to edit files).
+ */
+export type SetupPromptMode = "write" | "print";
+export declare const CONFIG_BEGIN_MARKER = "----- BEGIN .devcc.ts -----";
+export declare const CONFIG_END_MARKER = "----- END .devcc.ts -----";
+export declare function buildSetupPrompt(facts: ProjectFacts, mode: SetupPromptMode): string;
+/**
+ * Pull the config out of a headless agent's output: the last block between the
+ * markers, with a surrounding code fence removed. Null when there is none.
+ */
+export declare function extractConfigFromOutput(output: string): string | null;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/devcc/init/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/devcc/init/prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAEjF;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,CAAA;AAE/C,eAAO,MAAM,mBAAmB,gCAAgC,CAAA;AAChE,eAAO,MAAM,iBAAiB,8BAA8B,CAAA;AA4D5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAgFnF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrE"}

package/dist/devcc/init/prompt.js

@@ -0,0 +1,156 @@
+import { basename } from "node:path";
+import { readSnippet, renderStarterConfig } from "./detect.js";
+export const CONFIG_BEGIN_MARKER = "----- BEGIN .devcc.ts -----";
+export const CONFIG_END_MARKER = "----- END .devcc.ts -----";
+const REFERENCE = `
+## .devcc.ts reference (all fields optional)
+
+export default {
+  name?: string,                       // header label
+  processes?: [{                       // long-running things devcc starts/stops
+    id, name?, command, args?: string[], cwd?, env?: Record<string, string>,
+    kind?: "service" | "task", autoStart?: boolean, url?: string, port?: number,
+    dependsOn?: string[],              // ids that must be ready first
+    readiness?: { port?: number, host?: string, logPattern?: string, timeoutMs?: number },
+    restartOnCrash?: boolean,
+  }],
+  commands?: [{                        // palette actions
+    id, title, category?, command, args?, cwd?, keywords?: string[],
+    confirm?: true | { title, message }, // REQUIRED for anything destructive
+  }],
+  verify?: (string | { id, name?, command, args?, cwd? })[],
+                                       // strings = command ids, then package.json script names
+  services?: [                         // extra things to watch
+    { id, name?, port, host?, healthPath? } |
+    { id, name?, type: "ollama", baseUrl: "http://host:11434" },
+  ],
+  agents?: { claude?: { command?, args? }, codex?: { command?, args? } },
+  editor?: { command: "code" | "zed" | "cursor" | "webstorm" } | { application: "WebStorm" },
+  terminal?: { application: "iTerm" } | { command, args?, execArgs? },
+  worktrees?: { directory?: string },  // relative to the main worktree, default ".."
+  remoteMachines?: [{ id, name?, host, transport: "ssh", port?, user?, services?: string[] }],
+  refresh?: { system?, services?, git?, clock? },
+}
+
+Everything is spawned as command + args with no shell: never put pipes, &&, env assignments or
+quotes inside a single string. \`command: "pnpm", args: ["run", "dev"]\` is right;
+\`command: "pnpm run dev"\` is wrong.`;
+function factsSection(facts) {
+    const lines = [
+        `- root: ${facts.rootDir}`,
+        `- name: ${facts.name}`,
+        `- git repository: ${facts.hasGit ? "yes" : "no"}`,
+        `- languages: ${facts.languages.join(", ") || "none detected"}`,
+        `- package manager: ${facts.packageManager ? `${facts.packageManager.manager} (from ${facts.packageManager.source})` : "none (no package.json)"}`,
+        `- monorepo: ${facts.monorepo ?? "no"}`,
+        `- frameworks (by dependency): ${facts.frameworks.map((framework) => `${framework.name} (default port ${framework.port})`).join(", ") || "none recognised"}`,
+        `- notable files: ${facts.files.join(", ") || "none"}`,
+        `- existing devcc config: ${facts.configPath ? basename(facts.configPath) : "none"}`,
+    ];
+    if (facts.scripts.length > 0) {
+        lines.push(`- package.json scripts:`);
+        for (const script of facts.scripts)
+            lines.push(`  - ${script.name}: ${script.command}`);
+    }
+    if (facts.skippedScripts.length > 0) {
+        lines.push(`- left out of verify: ${facts.skippedScripts.map((script) => `${script.name} (${script.reason})`).join(", ")}`);
+    }
+    return lines.join("\n");
+}
+export function buildSetupPrompt(facts, mode) {
+    const existing = facts.configPath ? readSnippet(facts.configPath, 6_000) : null;
+    const draft = renderStarterConfig(facts);
+    const output = mode === "write"
+        ? `## Deliver
+
+1. ${facts.configPath ? `Update \`${basename(facts.configPath)}\` in place, keeping anything the user wrote that is still correct.` : "Create `.devcc.ts` in the project root."}
+2. Run \`devcc config check\` and fix every issue it reports. Do not stop until it exits 0.
+3. If you added \`verify\`, run \`devcc verify\`. A step that fails because the project itself is broken
+   stays in the list - report it; do not delete checks to make the gate pass.
+4. Finish with a short summary: what you configured, what you deliberately left out, and why.`
+        : `## Deliver
+
+You cannot edit files in this session. Print the complete file, and nothing else between the markers,
+exactly like this:
+
+${CONFIG_BEGIN_MARKER}
+export default {
+  ...
+}
+${CONFIG_END_MARKER}
+
+devcc validates it and asks the user before writing it${facts.configPath ? ` over \`${basename(facts.configPath)}\`` : ""}. After the markers, add
+a short summary: what you configured, what you left out, and why.`;
+    return `Set up devcc for this project: produce a solid .devcc.ts.
+
+devcc (@doriandev/devcc) is a keyboard-driven terminal dashboard for local development. Its config
+tells it which dev processes it may start, which checks \`devcc verify\` runs as the quality gate, and
+which commands appear in its palette. You are configuring it for the repository in your working
+directory.
+
+## What devcc already detected
+
+${factsSection(facts)}
+
+## Draft from \`devcc init\`
+
+Start from this, but verify every line against the repository - it only knows script names.
+
+\`\`\`ts
+${draft.trimEnd()}
+\`\`\`
+${existing ? `\n## Current config (${basename(facts.configPath ?? "")})\n\n\`\`\`ts\n${existing.trimEnd()}\n\`\`\`\n` : ""}
+## Investigate before writing
+
+- Read package.json (every workspace package in a monorepo), the README, CONTRIBUTING, AGENTS.md or
+  CLAUDE.md, CI workflows (.github/workflows), Makefile/justfile, docker compose files, framework
+  configs (next.config.*, vite.config.*, etc.) and .env.example.
+- Find the real dev servers and their ports. Ports come from scripts, framework config or
+  .env.example - not from defaults when the project overrides them.
+- CI shows what the team treats as the quality gate; mirror it in \`verify\` where it can run locally.
+
+## Rules
+
+- Only use commands that exist in this repository or are the standard CLI of a toolchain it uses. Never
+  invent scripts, binaries or ports.
+- \`processes\`: long-running dev servers, watchers and local infra the developer starts by hand. Use
+  \`readiness\` with the real port (or a \`logPattern\` from the server's actual output) and \`dependsOn\`
+  when one service needs another. In a monorepo, one process per app with \`cwd\`. Do not set
+  \`autoStart\` unless the README says the project is always run that way.
+- \`verify\`: fast to slow (format check, lint, typecheck, tests, build). Every step must be
+  non-interactive, exit on its own, and not modify files (no --watch, --fix or --write). Prefer
+  package.json script names over inline steps.
+- \`commands\`: useful project tasks that are not already scripts devcc shows (migrations, seeding,
+  codegen, docker compose profiles). Anything that deletes, resets, migrates or deploys needs
+  \`confirm: true\`.
+- Never add secrets, tokens, credentials or values from .env files. Never add \`remoteMachines\`,
+  hostnames or IP addresses unless the repository documents them for local development.
+- Leave out \`editor\`, \`terminal\` and \`agents\` unless the repository states a preference; they are
+  personal. Leave out anything you are unsure of rather than guessing - a small correct config beats a
+  large wrong one.
+- Use a plain \`export default { ... }\` object. Import \`defineConfig\` from "@doriandev/devcc" only if that
+  package is already a dependency of this project.
+${REFERENCE}
+
+${output}
+`;
+}
+/**
+ * Pull the config out of a headless agent's output: the last block between the
+ * markers, with a surrounding code fence removed. Null when there is none.
+ */
+export function extractConfigFromOutput(output) {
+    const end = output.lastIndexOf(CONFIG_END_MARKER);
+    if (end === -1)
+        return null;
+    const begin = output.lastIndexOf(CONFIG_BEGIN_MARKER, end);
+    if (begin === -1)
+        return null;
+    const body = output
+        .slice(begin + CONFIG_BEGIN_MARKER.length, end)
+        .replace(/^\s*```[a-z]*\s*\n/u, "")
+        .replace(/\n\s*```\s*$/u, "")
+        .trim();
+    return body === "" ? null : `${body}\n`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/devcc/init/prompt.js.map

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

package/dist/devcc/platform/launch.d.ts

@@ -0,0 +1,30 @@
+import type { EditorConfig, RemoteMachineConfig, TerminalConfig } from "../core/config.js";
+/**
+ * Opening things outside devcc: editors, terminals, SSH sessions.
+ *
+ * Every launch is an executable plus an argv array, detached from devcc so
+ * closing the dashboard never closes your editor. macOS conventions (`open`,
+ * `open -a`) are used only when running on macOS; elsewhere a configured
+ * command is required.
+ */
+export interface LaunchCommand {
+    command: string;
+    args: string[];
+}
+export type Platform = NodeJS.Platform;
+/** Replace `{path}` inside individual arguments. Never joins arguments into a string. */
+export declare function substitutePath(args: readonly string[], path: string): string[];
+export declare function editorCommand(path: string, editor: EditorConfig | undefined, platform?: Platform): LaunchCommand;
+export declare function terminalCommand(path: string, terminal: TerminalConfig | undefined, platform?: Platform): LaunchCommand;
+/**
+ * An interactive SSH session needs a terminal. On macOS `open ssh://host`
+ * hands the URL to the default terminal, which runs `ssh` with the user's own
+ * config for that alias. Elsewhere the configured terminal runs `ssh`.
+ */
+export declare function sshCommand(machine: Pick<RemoteMachineConfig, "host" | "user" | "port">, terminal: TerminalConfig | undefined, platform?: Platform): LaunchCommand;
+/**
+ * Start a GUI or launcher process detached from devcc. Resolves once it has
+ * spawned (not when it exits); rejects with a readable error if it cannot start.
+ */
+export declare function launchDetached(launch: LaunchCommand, cwd?: string): Promise<void>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/devcc/platform/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/devcc/platform/launch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAI1F;;;;;;;GAOG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;AAEtC,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9E;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,QAAQ,GAAE,QAA2B,GACpC,aAAa,CAgBf;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,QAAQ,GAAE,QAA2B,GACpC,aAAa,CAaf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAC5D,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,QAAQ,GAAE,QAA2B,GACpC,aAAa,CAkBf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAejF"}