@repo-os/repoos 0.5.45

package/dist/commands/docs.d.ts

@@ -0,0 +1,2 @@
+/** `repoos new-doc "<description>"` or `repoos new-doc --path docs/foo.md --content-file x.md` */
+export declare function cmdNewDoc(args: string[]): Promise<void>;

package/dist/commands/docs.js

@@ -0,0 +1,70 @@
+/**
+ * Document creation commands for the CLI.
+ */
+import { readFileSync } from "node:fs";
+import { createDocument, createFreeformDocument, docFreeformPrompt, parseGeneratedDocument, } from "../core/docs.js";
+import { loadConfig } from "../core/config.js";
+import { c } from "../cli/colors.js";
+import { resolvePmAgent, runPrompt, recordOneShotSession } from "../server/agents.js";
+/** `repoos new-doc "<description>"` or `repoos new-doc --path docs/foo.md --content-file x.md` */
+export async function cmdNewDoc(args) {
+    const flags = {};
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a.startsWith("--"))
+            flags[a.slice(2)] = args[++i];
+        else
+            positional.push(a);
+    }
+    const config = loadConfig();
+    const description = positional.join(" ").trim();
+    const pathArg = flags.path;
+    const contentFileArg = flags["content-file"];
+    if (description) {
+        // Freeform mode: description -> PM agent
+        const pm = resolvePmAgent(config);
+        if (!pm) {
+            console.error(c.red("  No PM agent is configured"));
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const docResult = await createFreeformDocument(config, description, async (desc) => {
+                const result = await runPrompt(pm, docFreeformPrompt(desc), {
+                    cwd: config.root,
+                });
+                // Freeform doc authoring is real PM spend that belongs to no task (0311).
+                recordOneShotSession(config.root, pm, result, { sessionType: "pm", taskId: null });
+                if (!result.ok || !result.output) {
+                    throw new Error(result.error ?? "the PM agent returned no usable output");
+                }
+                return parseGeneratedDocument(result.output);
+            });
+            console.log("  " + c.green("created ") + c.cyan(docResult.path) + c.dim("  → " + docResult.absPath));
+        }
+        catch (err) {
+            console.error(c.red("  " + err.message));
+            process.exitCode = 1;
+        }
+    }
+    else if (pathArg && contentFileArg) {
+        // Manual mode: --path and --content-file
+        try {
+            const content = readFileSync(contentFileArg, "utf8");
+            const docResult = createDocument(config, {
+                path: pathArg,
+                content,
+            });
+            console.log("  " + c.green("created ") + c.cyan(docResult.path) + c.dim("  → " + docResult.absPath));
+        }
+        catch (err) {
+            console.error(c.red("  " + err.message));
+            process.exitCode = 1;
+        }
+    }
+    else {
+        console.error(c.red('  Usage: repoos new-doc "description"  or  repoos new-doc --path <path> --content-file <file>'));
+        process.exitCode = 1;
+    }
+}

package/dist/commands/gc.d.ts

@@ -0,0 +1 @@
+export declare function cmdGc(argv: string[]): void;

package/dist/commands/gc.js

@@ -0,0 +1,57 @@
+/**
+ * `repoos gc` — collect leaked task worktrees and branches.
+ *
+ * Runs against the MAIN checkout (via `boardRoot()`), never a linked worktree.
+ *
+ *   repoos gc              prune `repoos/integrate/*` candidates + stale metadata
+ *                          now, and PREVIEW the feature worktrees `--yes` would take
+ *   repoos gc --yes        also remove feature worktrees/branches for done/absent
+ *                          tasks (skips any with uncommitted or unmerged work)
+ *   repoos gc --dry-run    show everything that would be collected, touch nothing
+ */
+import { createRepoOS } from "../core/repoos.js";
+import { boardRoot } from "../core/config.js";
+import { c } from "../cli/colors.js";
+import { sweepStaleWorktrees } from "../core/worktree-gc.js";
+function printReport(report, title) {
+    console.log(c.bold(`  ${title}`));
+    if (report.removedWorktrees.length === 0 &&
+        report.keptDirty.length === 0 &&
+        report.errors.length === 0) {
+        console.log(c.dim("    nothing to collect"));
+    }
+    for (const w of report.removedWorktrees) {
+        const verb = report.dryRun ? "would remove" : "removed";
+        console.log(`    ${c.green(verb)} ${w.branch || c.dim("(detached)")} ${c.dim(w.path)}`);
+    }
+    for (const k of report.keptDirty) {
+        console.log(`    ${c.yellow("kept")}    ${k.branch || c.dim("(detached)")} ${c.dim(`— ${k.reason}`)}`);
+    }
+    for (const e of report.errors) {
+        console.log(`    ${c.red("error")}   ${e}`);
+    }
+    if (report.prunedMetadata)
+        console.log(c.dim("    ran git worktree prune"));
+}
+export function cmdGc(argv) {
+    const dryRun = argv.includes("--dry-run") || argv.includes("-n");
+    const yes = argv.includes("--yes") || argv.includes("-y");
+    const { root } = boardRoot();
+    const { config } = createRepoOS(root);
+    if (dryRun) {
+        printReport(sweepStaleWorktrees(config, { mode: "full", dryRun: true }), "gc — dry run");
+        return;
+    }
+    if (yes) {
+        printReport(sweepStaleWorktrees(config, { mode: "full" }), "gc");
+        return;
+    }
+    // Default: do the safe part for real, preview the rest.
+    printReport(sweepStaleWorktrees(config, { mode: "integrate-only" }), "gc — candidates + stale metadata");
+    const preview = sweepStaleWorktrees(config, { mode: "full", dryRun: true });
+    const pendingFeature = preview.removedWorktrees.filter((w) => !w.branch.startsWith("repoos/integrate/"));
+    if (pendingFeature.length || preview.keptDirty.length) {
+        console.log();
+        printReport({ ...preview, removedWorktrees: pendingFeature }, "feature worktrees — run `repoos gc --yes` to apply");
+    }
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,9 @@
+type ScaffoldLayout = "root" | "repoos";
+/** Which starter task to seed beyond 0001 — a blank project or an existing repo. */
+type ScaffoldKind = "new" | "existing";
+export declare function scaffoldInto(root: string, description: string, layout?: ScaffoldLayout, kind?: ScaffoldKind): {
+    created: string[];
+    skipped: string[];
+};
+export declare function cmdInit(args: string[]): Promise<void>;
+export {};