@popoverai/dotrequirements 0.24.3 → 0.26.0

package/dist/commands/ai-setup.js

@@ -13,9 +13,11 @@ function loadContextFileSection() {
     return loadTemplate("context-file-section.md");
 }
 /**
- * Install workflow guidance to the appropriate context file for a platform
+ * Install workflow guidance to the appropriate context file for a platform.
+ * With `yes` (the non-interactive --assistant path, AISETUP-1.0), both
+ * confirmations are auto-accepted — matching their interactive defaults.
  */
-async function installContextFileSection(platform) {
+async function installContextFileSection(platform, yes = false) {
     const fileName = getContextFileName(platform);
     if (!fileName) {
         console.error(`\n❌ Unknown platform: ${platform}`);
@@ -37,24 +39,26 @@ async function installContextFileSection(platform) {
             existingSection = section.content;
         }
     }
-    // Prompt user
+    // Prompt user (auto-accepted in non-interactive mode)
     const action = existingSection
         ? "Update"
         : existsSync(contextFilePath)
             ? "Add to"
             : "Create";
-    const response = await prompts({
-        type: "confirm",
-        name: "install",
-        message: `${action} ${fileName} with dotrequirements workflow guidance?`,
-        initial: true,
-    });
-    if (!response.install) {
-        console.log("");
-        return;
+    if (!yes) {
+        const response = await prompts({
+            type: "confirm",
+            name: "install",
+            message: `${action} ${fileName} with dotrequirements workflow guidance?`,
+            initial: true,
+        });
+        if (!response.install) {
+            console.log("");
+            return;
+        }
     }
-    // If updating, show what will change
-    if (existingSection) {
+    // If updating, show what will change (auto-accepted in non-interactive mode)
+    if (existingSection && !yes) {
         const confirmUpdate = await prompts({
             type: "confirm",
             name: "confirm",
@@ -80,12 +84,37 @@ async function installContextFileSection(platform) {
         console.log(`   Error: ${error instanceof Error ? error.message : String(error)}\n`);
     }
 }
+/**
+ * Assistant identifiers accepted by the non-interactive --assistant flag
+ * (AISETUP-1). "other" is interactive-only: it prompts for a custom path.
+ */
+export const SUPPORTED_ASSISTANTS = [
+    "claude-code",
+    "claude-desktop",
+    "cursor",
+    "antigravity",
+    "codex",
+    "github-copilot",
+];
 /**
  * AI setup command - configures the MCP server for AI assistants
+ *
+ * AISETUP-1: with --assistant <id>, setup runs without any interactive prompt
+ * (an AI assistant configuring itself knows which assistant it is).
  */
-export async function aiSetupCommand() {
+export async function aiSetupCommand(options = {}) {
     console.log(`🔧 Setting up ${brand} MCP server\n`);
-    // Interactive client selector
+    if (options.assistant) {
+        const id = options.assistant.toLowerCase();
+        if (!SUPPORTED_ASSISTANTS.includes(id)) {
+            // AISETUP-1.1: unsupported value → error listing supported identifiers
+            throw new Error(`Unsupported assistant "${options.assistant}". Supported: ${SUPPORTED_ASSISTANTS.join(", ")}`);
+        }
+        // AISETUP-1.0: no prompt; same setup path as the interactive selector
+        await dispatchSetup(id, true);
+        return;
+    }
+    // AISETUP-1.2: no flag → interactive selector, unchanged
     const response = await prompts({
         type: "select",
         name: "client",
@@ -105,34 +134,37 @@ export async function aiSetupCommand() {
         console.log("\nSetup cancelled.");
         return;
     }
-    switch (response.client) {
+    await dispatchSetup(response.client);
+}
+async function dispatchSetup(client, yes = false) {
+    switch (client) {
         case "claude-code":
-            await setupClaudeCode();
+            await setupClaudeCode(yes);
             break;
         case "claude-desktop":
             await setupClaudeDesktop();
             break;
         case "cursor":
-            await setupCursor();
+            await setupCursor(yes);
             break;
         case "antigravity":
-            await setupAntigravity();
+            await setupAntigravity(yes);
             break;
         case "codex":
-            await setupCodex();
+            await setupCodex(yes);
             break;
         case "github-copilot":
-            await setupGitHubCopilot();
+            await setupGitHubCopilot(yes);
             break;
         case "other":
             await setupOther();
             break;
         default:
-            console.log(`\n❌ ${response.client} is not yet supported.`);
+            console.log(`\n❌ ${client} is not yet supported.`);
             console.log("Please refer to the documentation for manual setup.");
     }
 }
-async function setupClaudeCode() {
+async function setupClaudeCode(yes = false) {
     console.log("\n📦 Configuring MCP for Claude Code...\n");
     const command = `claude mcp add-json dotrequirements '{"type":"stdio","command":"npx","args":["-y","@popoverai/dotrequirements","mcp"]}'`;
     let mcpConfigured = false;
@@ -162,7 +194,7 @@ async function setupClaudeCode() {
     if (mcpConfigured) {
         console.log("\n⚠️  Important: Restart Claude Code for changes to take effect.");
         console.log("\nYou can now ask your AI assistant to help write requirements!\n");
-        await installContextFileSection("claude-code");
+        await installContextFileSection("claude-code", yes);
     }
 }
 async function setupClaudeDesktop() {
@@ -237,7 +269,7 @@ async function setupClaudeDesktop() {
         console.log(JSON.stringify(manualConfig, null, 2));
     }
 }
-async function setupCursor() {
+async function setupCursor(yes = false) {
     console.log("\n📦 Configuring MCP for Cursor (project-specific)...\n");
     const configPath = join(process.cwd(), ".cursor", "mcp.json");
     const configDir = join(process.cwd(), ".cursor");
@@ -272,7 +304,7 @@ async function setupCursor() {
         console.log(`   Config file: ${configPath}\n`);
         console.log("⚠️  Important: Reload or restart Cursor for changes to take effect.");
         console.log("\nYou can now ask your AI assistant to help write requirements!\n");
-        await installContextFileSection("cursor");
+        await installContextFileSection("cursor", yes);
     }
     catch (error) {
         console.error("❌ Failed to configure MCP automatically.");
@@ -288,7 +320,7 @@ async function setupCursor() {
         console.log(JSON.stringify(manualConfig, null, 2));
     }
 }
-async function setupAntigravity() {
+async function setupAntigravity(yes = false) {
     console.log("\n📦 Configuring MCP for Google Antigravity...\n");
     const configPath = join(homedir(), ".gemini", "antigravity", "mcp_config.json");
     const configDir = join(homedir(), ".gemini", "antigravity");
@@ -367,7 +399,7 @@ async function setupAntigravity() {
         else {
             console.log("");
         }
-        await installContextFileSection("antigravity");
+        await installContextFileSection("antigravity", yes);
     }
     catch (error) {
         console.error("❌ Failed to configure MCP automatically.");
@@ -376,7 +408,7 @@ async function setupAntigravity() {
         console.log(`  ${configPath}`);
     }
 }
-async function setupCodex() {
+async function setupCodex(yes = false) {
     console.log("\n📦 Configuring MCP for OpenAI Codex...\n");
     const command = `codex mcp add dotrequirements -- npx -y @popoverai/dotrequirements mcp`;
     try {
@@ -384,7 +416,7 @@ async function setupCodex() {
         console.log("\n✅ MCP configured successfully for Codex!");
         console.log("\n⚠️  Important: Restart Codex for changes to take effect.");
         console.log("\nYou can now ask your AI assistant to help write requirements!\n");
-        await installContextFileSection("codex");
+        await installContextFileSection("codex", yes);
     }
     catch {
         console.error("\n❌ Failed to configure MCP automatically.");
@@ -396,12 +428,12 @@ async function setupCodex() {
         console.log('args = ["-y", "@popoverai/dotrequirements", "mcp"]');
     }
 }
-async function setupGitHubCopilot() {
+async function setupGitHubCopilot(yes = false) {
     console.log("\n📦 Configuring skills for GitHub Copilot...\n");
     console.log("ℹ️  GitHub Copilot discovers MCP servers from your IDE configuration.");
     console.log("   Please configure the MCP server in VS Code settings or GitHub settings.\n");
     console.log("   MCP server command: npx -y @popoverai/dotrequirements mcp\n");
-    await installContextFileSection("github-copilot");
+    await installContextFileSection("github-copilot", yes);
 }
 async function setupOther() {
     console.log("\n📦 Custom Context File Setup\n");

package/dist/commands/codebase-to-spec/dispatch-context.d.ts

@@ -2,11 +2,8 @@
  * `dotrequirements codebase-to-spec dispatch-context <dispatch-id>` subcommand.
  *
  * Returns the composed prompt for a worker dispatch as a JSON object on stdout.
- * Called by the cts-worker PreToolUse hook to compose the subagent's first-turn
- * prompt via `modifiedInput`.
- *
- * Requirements covered:
- * - CTSO-CLI-1: CLI exposes commands that return dispatch instructions
+ * Run by cts-worker subagents at the start of their turn to fetch the composed
+ * first-turn prompt for their dispatch-id (see the specify-codebase workflow).
  */
 export declare function dispatchContextCommand(dispatchId: string): Promise<void>;
 //# sourceMappingURL=dispatch-context.d.ts.map

package/dist/commands/codebase-to-spec/dispatch-context.js

@@ -2,11 +2,8 @@
  * `dotrequirements codebase-to-spec dispatch-context <dispatch-id>` subcommand.
  *
  * Returns the composed prompt for a worker dispatch as a JSON object on stdout.
- * Called by the cts-worker PreToolUse hook to compose the subagent's first-turn
- * prompt via `modifiedInput`.
- *
- * Requirements covered:
- * - CTSO-CLI-1: CLI exposes commands that return dispatch instructions
+ * Run by cts-worker subagents at the start of their turn to fetch the composed
+ * first-turn prompt for their dispatch-id (see the specify-codebase workflow).
  */
 import { composeDispatchContext } from "../../codebase-to-spec/dispatch.js";
 import { ExitCode } from "../../codebase-to-spec/exit-codes.js";

package/dist/commands/codebase-to-spec/dispatch-editor.d.ts

@@ -9,7 +9,6 @@
  * in outline.yaml stays where it is (the orchestrator manages it).
  *
  * Requirements covered:
- * - CTSO-CLI-1: CLI exposes commands that return dispatch instructions
  * - CTSO-CONV-3: orchestrator dispatches an editor when revisions are needed
  */
 export declare function dispatchEditorCommand(areaPrefix: string): Promise<void>;

package/dist/commands/codebase-to-spec/dispatch-editor.js

@@ -9,7 +9,6 @@
  * in outline.yaml stays where it is (the orchestrator manages it).
  *
  * Requirements covered:
- * - CTSO-CLI-1: CLI exposes commands that return dispatch instructions
  * - CTSO-CONV-3: orchestrator dispatches an editor when revisions are needed
  */
 import { existsSync, readFileSync } from "node:fs";

package/dist/commands/codebase-to-spec/dispatch-planner.d.ts

@@ -9,7 +9,6 @@
  * preserving the review section.
  *
  * Requirements covered:
- * - CTSO-CLI-1: CLI exposes commands that return dispatch instructions
  * - CTSO-CONV-2: orchestrator iterates on planner's outline until approved
  */
 export interface DispatchPlannerOptions {

package/dist/commands/codebase-to-spec/dispatch-planner.js

@@ -9,7 +9,6 @@
  * preserving the review section.
  *
  * Requirements covered:
- * - CTSO-CLI-1: CLI exposes commands that return dispatch instructions
  * - CTSO-CONV-2: orchestrator iterates on planner's outline until approved
  */
 import { existsSync, readFileSync } from "node:fs";

package/dist/commands/codebase-to-spec/dispatch-spec.d.ts

@@ -2,15 +2,12 @@
  * `dotrequirements codebase-to-spec dispatch-spec` subcommand.
  *
  * Returns an array of specifier dispatch payloads — one per area in the
- * approved outline. The conversational orchestrator reads this, fires N
- * background Task dispatches in parallel (one cts-worker per area), and
- * collects the resulting partials.
+ * approved outline. The specify-codebase workflow reads this, fires N
+ * cts-worker dispatches in parallel (one per area), and collects the
+ * resulting partials.
  *
  * Errors clearly if `outline.yaml`'s `review.result` isn't `"approved"` —
  * the orchestrator should approve the outline before fan-out.
- *
- * Requirements covered:
- * - CTSO-CLI-1: CLI exposes commands that return dispatch instructions
  */
 export declare function dispatchSpecCommand(): Promise<void>;
 //# sourceMappingURL=dispatch-spec.d.ts.map

package/dist/commands/codebase-to-spec/dispatch-spec.js

@@ -2,15 +2,12 @@
  * `dotrequirements codebase-to-spec dispatch-spec` subcommand.
  *
  * Returns an array of specifier dispatch payloads — one per area in the
- * approved outline. The conversational orchestrator reads this, fires N
- * background Task dispatches in parallel (one cts-worker per area), and
- * collects the resulting partials.
+ * approved outline. The specify-codebase workflow reads this, fires N
+ * cts-worker dispatches in parallel (one per area), and collects the
+ * resulting partials.
  *
  * Errors clearly if `outline.yaml`'s `review.result` isn't `"approved"` —
  * the orchestrator should approve the outline before fan-out.
- *
- * Requirements covered:
- * - CTSO-CLI-1: CLI exposes commands that return dispatch instructions
  */
 import { existsSync, readFileSync } from "node:fs";
 import { cachePaths } from "../../codebase-to-spec/cache.js";

package/dist/commands/codebase-to-spec/index.js

@@ -46,7 +46,8 @@ export function registerCodebaseToSpec(program) {
     cts
         .command("pack")
         .description("Pack the codebase (compressed and uncompressed views) into the cache")
-        .option("-s, --scope <path>", "Limit to files under this path (subdir of project root)")
+        .option("-s, --scope <path>", "Limit to files under this path (subdir of project root, or of the remote repo when --remote is set)")
+        .option("--remote <url>", "Pack a remote repository (GitHub URL or owner/repo) instead of the local project; repomix clones, packs, and cleans up. Combine with --scope to pack just a subdirectory.")
         .option("--fresh", "Clear the cache before running")
         .option("--budget <tokens>", "Override the working-context budget (in tokens)", (v) => parseInt(v, 10))
         .option("--ignore-requirements", "Exclude `.requirements/**` from the pack (use when testing cts against a codebase whose existing requirements should not influence the output)")
@@ -150,7 +151,7 @@ export function registerCodebaseToSpec(program) {
     });
     cts
         .command("dispatch-context <dispatch-id>", HIDDEN)
-        .description("Return the composed prompt for a worker dispatch as JSON on stdout (called by the cts-worker PreToolUse hook)")
+        .description("Return the composed prompt for a worker dispatch as JSON on stdout (run by cts-worker subagents to fetch their dispatch prompt)")
         .action((dispatchId) => dispatchContextCommand(dispatchId));
     cts
         .command("dispatch-planner", HIDDEN)

package/dist/commands/codebase-to-spec/pack.d.ts

@@ -7,10 +7,17 @@
  * - CTS-CLI-3: Pipeline refuses to spec a codebase that exceeds the working context budget
  * - CTS-PACK-1: Pack stage produces compressed and uncompressed views of the codebase
  * - CTS-PACK-2: Engineer can extend the ignore list per project
+ * - CTS-PACK-4: Pack surfaces when a newer CLI version is available
  * - CTS-OBSERVE-1: CLI emits structured progress as the pipeline runs
  */
+import { checkForNewerVersion } from "../../codebase-to-spec/version-check.js";
 export interface PackOptions {
     scope?: string;
+    /**
+     * Pack a remote repository (GitHub URL or `owner/repo`) instead of the local
+     * project. Combine with `scope` to pack just a subdirectory of the remote.
+     */
+    remote?: string;
     fresh?: boolean;
     budgetTokens?: number;
     /**
@@ -23,6 +30,8 @@ export interface PackOptions {
     progress?: import("../../codebase-to-spec/progress.js").ProgressEmitter;
     /** Override the project root, mainly for tests. */
     projectRoot?: string;
+    /** Override the registry version check, mainly for tests. */
+    checkVersion?: typeof checkForNewerVersion;
 }
 export declare function packCommand(rawOptions?: PackOptions): Promise<void>;
 //# sourceMappingURL=pack.d.ts.map

package/dist/commands/codebase-to-spec/pack.js

@@ -7,6 +7,7 @@
  * - CTS-CLI-3: Pipeline refuses to spec a codebase that exceeds the working context budget
  * - CTS-PACK-1: Pack stage produces compressed and uncompressed views of the codebase
  * - CTS-PACK-2: Engineer can extend the ignore list per project
+ * - CTS-PACK-4: Pack surfaces when a newer CLI version is available
  * - CTS-OBSERVE-1: CLI emits structured progress as the pipeline runs
  */
 import { resolve } from "node:path";
@@ -15,11 +16,16 @@ import { clearCache, ensureCacheDir } from "../../codebase-to-spec/cache.js";
 import { ExitCode } from "../../codebase-to-spec/exit-codes.js";
 import { runPack } from "../../codebase-to-spec/pack.js";
 import { StdoutProgress } from "../../codebase-to-spec/progress.js";
+import { checkForNewerVersion } from "../../codebase-to-spec/version-check.js";
 import { findProjectRoot } from "../../utils/project-settings.js";
 export async function packCommand(rawOptions = {}) {
     const progress = rawOptions.progress ?? new StdoutProgress();
     const projectRoot = rawOptions.projectRoot ?? findProjectRoot(process.cwd()) ?? process.cwd();
     const budgetTokens = rawOptions.budgetTokens ?? DEFAULT_BUDGET_TOKENS;
+    // Fail-soft staleness check (CTS-PACK-4), started now so the registry
+    // round-trip overlaps the pack work and adds no wall-clock on the happy
+    // path. Resolves to undefined on any failure or timeout.
+    const versionCheck = (rawOptions.checkVersion ?? checkForNewerVersion)();
     if (rawOptions.fresh) {
         progress.emit({
             stage: "pack",
@@ -35,14 +41,17 @@ export async function packCommand(rawOptions = {}) {
     progress.emit({
         stage: "pack",
         step: "start",
-        message: scope
-            ? `Packing codebase at ${scope}`
-            : `Packing codebase at ${projectRoot}`,
+        message: rawOptions.remote
+            ? `Packing remote ${rawOptions.remote}${rawOptions.scope ? ` (scope: ${rawOptions.scope})` : ""}`
+            : scope
+                ? `Packing codebase at ${scope}`
+                : `Packing codebase at ${projectRoot}`,
     });
     const packResult = await runPack({
         projectRoot,
         paths,
         scope: rawOptions.scope,
+        remote: rawOptions.remote,
         ignoreRequirements: rawOptions.ignoreRequirements,
     });
     progress.emit({
@@ -51,6 +60,17 @@ export async function packCommand(rawOptions = {}) {
         message: `Packed ${packResult.fileCount} files → ${paths.overview} (compressed), ${paths.source} (uncompressed)`,
         data: { fileCount: packResult.fileCount },
     });
+    // Surface a stale install (CTS-PACK-4). Informational only: outputs and
+    // exit code are unaffected, and a failed check emits nothing.
+    const versionInfo = await versionCheck.catch(() => undefined);
+    if (versionInfo?.stale) {
+        progress.emit({
+            stage: "pack",
+            step: "stale-version",
+            message: `A newer dotrequirements CLI is available: ${versionInfo.latest} (running ${versionInfo.current}). Re-run skill-install to refresh.`,
+            data: { current: versionInfo.current, latest: versionInfo.latest },
+        });
+    }
     // Budget check (CTS-CLI-3)
     const measured = countTokensInFileExact(paths.overview);
     const budget = checkBudget(measured, budgetTokens);

package/dist/commands/codebase-to-spec/skill-install.js

@@ -43,16 +43,9 @@ export async function skillInstallCommand(options = {}) {
         }
         if (result.companions) {
             process.stdout.write(`Installed cts-worker agent at ${result.companions.agentPath}\n`);
-            process.stdout.write(`Installed persona-injection hook at ${result.companions.hookScriptPath}\n`);
-            if (result.companions.hookRegistered) {
-                process.stdout.write(`Registered PreToolUse hook in ${result.companions.settingsPath}\n`);
-            }
-            else {
-                process.stdout.write(`PreToolUse hook already registered in ${result.companions.settingsPath}\n`);
-            }
-            process.stdout.write("\n⚠️  The hook script uses `dotrequirements` from PATH. If you're working in a local dev clone, set DOTREQUIREMENTS_CLI to override (see the hook script for details).\n");
+            process.stdout.write(`Installed specify-codebase workflow at ${result.companions.workflowPath}\n`);
         }
-        process.stdout.write("\nSkill ready. In Claude Code, invoke it with `/codebase-to-spec` (or via natural language).\n");
+        process.stdout.write("\nSkill ready. In Claude Code, invoke it with `/codebase-to-spec` (or via natural language). Requires a Claude Code version with dynamic-workflow support.\n");
     }
     catch (err) {
         process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);

package/dist/commands/init.js

@@ -353,8 +353,13 @@ async function inviteFlow(cwd, token) {
         console.log(`✓ Joined team "${inviteInfo.teamName}"`);
     }
     catch (err) {
+        // Production redacts ConvexError messages to "Server Error" but keeps
+        // error.data — check both, or this graceful path only works in dev
+        const data = err.data;
+        const dataMessage = typeof data?.message === "string" ? data.message : "";
         const errorMessage = err instanceof Error ? err.message : String(err);
-        if (errorMessage.includes("already a member")) {
+        if (dataMessage.includes("already a member") ||
+            errorMessage.includes("already a member")) {
             console.log(`Already a member of "${inviteInfo.teamName}"`);
         }
         else {

package/dist/commands/link-resolution.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Pure decision logic for `dotrequirements link`'s non-interactive mode
+ * (LINK-10/11/12). No I/O: the link command gathers state (teams, projects)
+ * and these functions decide what to do — use a project, create one, rename,
+ * or stop with a decision-needed result that carries everything an AI
+ * assistant needs to ask the user and retry with a deviation flag.
+ */
+export interface TeamOption {
+    teamId: string;
+    name: string;
+    tier: string;
+    tierName: string;
+    projectCount: number;
+    projectLimit: number;
+}
+export interface ProjectOption {
+    projectId: string;
+    projectName: string;
+    projectSlug: string | null;
+    isDefault: boolean;
+    hasUserContent: boolean;
+}
+export interface LinkFlags {
+    yes?: boolean;
+    team?: string;
+    connect?: string;
+    create?: boolean;
+    name?: string;
+    json?: boolean;
+}
+/**
+ * LINK-12.3: any deviation flag implies non-interactive mode.
+ */
+export declare function isNonInteractive(flags: LinkFlags): boolean;
+export declare function hasCapacity(team: TeamOption): boolean;
+/** A choice the user must make, with everything needed to ask and retry. */
+export interface DecisionNeeded {
+    kind: "decision";
+    decision: "team" | "project" | "capacity";
+    message: string;
+    options: Array<{
+        label: string;
+        /** Exact flag to pass on retry (LINK-11.4), when retryable via link */
+        retryFlag?: string;
+    }>;
+}
+export interface NoMatch {
+    kind: "no-match";
+    flag: "team" | "connect";
+    provided: string;
+    alternatives: string[];
+}
+export type TeamResolution = {
+    kind: "use";
+    team: TeamOption;
+} | DecisionNeeded | NoMatch;
+/**
+ * LINK-10.1, LINK-11.0, LINK-12.0, LINK-12.4
+ */
+export declare function resolveTeam(teams: TeamOption[], flags: LinkFlags): TeamResolution;
+export type ProjectResolution = {
+    kind: "connect";
+    project: ProjectOption;
+    rename: boolean;
+} | {
+    kind: "create";
+} | DecisionNeeded | NoMatch;
+/**
+ * LINK-10.2/10.3 (default-project rule), LINK-11.1/11.2 (decision menus),
+ * LINK-12.1/12.2/12.4 (deviation flags).
+ */
+export declare function resolveProject(projects: ProjectOption[], team: TeamOption, flags: LinkFlags): ProjectResolution;
+/**
+ * Prompt-free project naming for non-interactive mode (LINK-9.0): explicit
+ * flag, then package metadata, then directory name, then a fixed fallback —
+ * never a prompt.
+ */
+export declare function resolveProjectName(flags: LinkFlags, packageName: string | undefined, directoryName: string | undefined): string;
+//# sourceMappingURL=link-resolution.d.ts.map