@waishnav/devspace 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Waishnav
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -65,12 +65,12 @@ After the MCP client connects, ChatGPT can open a project with
 DevSpace provides tools for:
 
 - reading, writing, and editing files inside the opened workspace
-- searching files and listing directories
+- running shell-backed search and directory inspection in the default minimal tool mode
 - running shell commands for tests, builds, git, and package scripts
 - opening isolated Git worktrees when you want parallel work
 - loading `AGENTS.md` and `CLAUDE.md` instructions
 - exposing local agent skills from your skill folders
-- showing ChatGPT Apps review cards for aggregate diffs
+- showing ChatGPT Apps tool cards, with an opt-in aggregate `show_changes` card
 
 The default local endpoint is:
 
@@ -132,15 +132,9 @@ For working on DevSpace itself:
 
 ```bash
 npm install --include=dev
+npm run dev
 npm run typecheck
 npm test
 npm run build
 npm run start
 ```
-
-For long-running local server processes, build an immutable release copy:
-
-```bash
-npm run release:build
-npm run release:start
-```

package/dist/config.js

@@ -45,7 +45,16 @@ function parseBoolean(value) {
     return ["1", "true", "yes", "on"].includes(value?.toLowerCase() ?? "");
 }
 function parseMinimalTools(env) {
-    return env.DEVSPACE_TOOL_MODE === "minimal" || parseBoolean(env.DEVSPACE_MINIMAL_TOOLS);
+    if (env.DEVSPACE_TOOL_MODE === "minimal")
+        return true;
+    if (env.DEVSPACE_TOOL_MODE === "full")
+        return false;
+    if (env.DEVSPACE_TOOL_MODE) {
+        throw new Error(`Invalid DEVSPACE_TOOL_MODE: ${env.DEVSPACE_TOOL_MODE}`);
+    }
+    if (env.DEVSPACE_MINIMAL_TOOLS !== undefined)
+        return parseBoolean(env.DEVSPACE_MINIMAL_TOOLS);
+    return true;
 }
 function parseLogLevel(value) {
     if (!value || value === "info")
@@ -85,10 +94,10 @@ function parsePositiveInteger(value, fallback, name) {
     return parsed;
 }
 function parseToolNaming(value) {
-    if (!value || value === "legacy")
-        return "legacy";
-    if (value === "short")
+    if (!value || value === "short")
         return "short";
+    if (value === "legacy")
+        return "legacy";
     throw new Error(`Invalid DEVSPACE_TOOL_NAMING: ${value}`);
 }
 function parseLoggingConfig(env) {
@@ -103,9 +112,9 @@ function parseLoggingConfig(env) {
     };
 }
 function parseWidgetMode(value) {
-    if (!value || value === "changes")
-        return "changes";
-    if (value === "off" || value === "full")
+    if (!value || value === "full")
+        return "full";
+    if (value === "off" || value === "changes")
         return value;
     throw new Error(`Invalid DEVSPACE_WIDGETS: ${value}`);
 }

package/dist/review-checkpoints.js

@@ -13,7 +13,7 @@ export function createReviewCheckpointManager() {
             try {
                 const eligibility = await getGitEligibility(root);
                 if (!eligibility.ok || !eligibility.gitRoot) {
-                    state.diagnostic = eligibility.message ?? "review_changes requires a Git workspace in this version.";
+                    state.diagnostic = eligibility.message ?? "show_changes requires a Git workspace in this version.";
                     return;
                 }
                 state.gitRoot = eligibility.gitRoot;
@@ -25,14 +25,14 @@ export function createReviewCheckpointManager() {
                 state.diagnostic = error instanceof Error ? error.message : String(error);
             }
         },
-        async reviewChanges({ workspaceId, root, since = "last_review", markReviewed = true }) {
+        async reviewChanges({ workspaceId, root, since = "last_shown", markReviewed = true }) {
             let state = states.get(workspaceId);
             if (!state) {
                 await this.initializeWorkspace({ workspaceId, root });
                 state = states.get(workspaceId);
             }
             if (!state?.gitRoot) {
-                throw new Error(state?.diagnostic ?? "review_changes requires a Git workspace in this version.");
+                throw new Error(state?.diagnostic ?? "show_changes requires a Git workspace in this version.");
             }
             const baselineRef = since === "workspace_open" ? state.openRef : state.baselineRef;
             const baseline = (await git(state.gitRoot, ["rev-parse", "--verify", `${baselineRef}^{commit}`])).stdout.trim();
@@ -50,7 +50,7 @@ export function createReviewCheckpointManager() {
             }
             return {
                 result: summary.files === 0
-                    ? `No changes since ${since === "workspace_open" ? "workspace open" : "last review"}.`
+                    ? `No changes since ${since === "workspace_open" ? "workspace open" : "last shown changes"}.`
                     : `Changed ${summary.files} ${summary.files === 1 ? "file" : "files"} (+${summary.additions} -${summary.removals}).`,
                 summary,
                 files,

package/dist/server.js

@@ -45,7 +45,7 @@ function shouldAttachWidget(mode, kind) {
         case "off":
             return false;
         case "changes":
-            return kind === "workspace" || kind === "review_changes";
+            return kind === "workspace" || kind === "show_changes";
         case "full":
             return true;
     }
@@ -93,10 +93,10 @@ function serverInstructions(config, toolNames) {
         ? `When ${toolNames.openWorkspace} returns available skills and a task matches a skill, use ${toolNames.read} to read that skill's path before proceeding. Skill paths may be outside the workspace, but ${toolNames.read} only permits advertised SKILL.md files and files under already-loaded skill directories. `
         : "";
     const agentsMd = `Follow instructions returned by ${toolNames.openWorkspace}. Before working under a path listed in availableAgentsFiles, use ${toolNames.read} to inspect that instruction file and follow it. `;
-    const review = config.widgets === "changes"
-        ? " After completing a coherent set of file modifications, call review_changes once to show the user an aggregate diff review."
+    const showChanges = config.widgets === "changes"
+        ? " After creating, editing, or overwriting files, call show_changes once after the related file changes are complete so the user can see the aggregate diff."
         : "";
-    return `Use DevSpace as a local coding workspace. Call ${toolNames.openWorkspace} once per project folder or worktree to obtain a workspaceId. Reuse that same workspaceId for all later file, search, edit, write, review, and shell tools in that folder; do not call ${toolNames.openWorkspace} again unless switching folders/worktrees, changing checkout/worktree mode, the workspaceId is rejected as unknown, or the user explicitly asks to reopen. ${agentsMd}${skills}${inspection}Prefer ${toolNames.edit} for targeted modifications, ${toolNames.write} only for new files or complete rewrites, and ${toolNames.shell} for tests, builds, git inspection, package scripts, and commands that are better executed by the shell. Do not create or modify files with ${toolNames.shell}; avoid shell redirection, heredocs, tee, sed -i, perl -i, node/python/ruby scripts, or any command whose purpose is to write project files.${review}`;
+    return `Use DevSpace as a local coding workspace. Call ${toolNames.openWorkspace} once per project folder or worktree to obtain a workspaceId. Reuse that same workspaceId for all later file, search, edit, write, show-changes, and shell tools in that folder; do not call ${toolNames.openWorkspace} again unless switching folders/worktrees, changing checkout/worktree mode, the workspaceId is rejected as unknown, or the user explicitly asks to reopen. ${agentsMd}${skills}${inspection}Prefer ${toolNames.edit} for targeted modifications, ${toolNames.write} only for new files or complete rewrites, and ${toolNames.shell} for tests, builds, git inspection, package scripts, and commands that are better executed by the shell. Do not create or modify files with ${toolNames.shell}; avoid shell redirection, heredocs, tee, sed -i, perl -i, node/python/ruby scripts, or any command whose purpose is to write project files.${showChanges}`;
 }
 function resultOutputSchema(extra = {}) {
     return {
@@ -328,7 +328,7 @@ function createMcpServer(config, workspaces, reviewCheckpoints) {
     });
     registerAppTool(server, "open_workspace", {
         title: "Open workspace",
-        description: "Open a local project directory as a coding workspace. Call this once per project folder or worktree before reading, editing, searching, writing, reviewing, or running commands. Reuse the returned workspaceId for later calls in the same folder; do not call open_workspace again unless switching folders/worktrees, changing checkout/worktree mode, the workspaceId is rejected as unknown, or the user explicitly asks to reopen. By default this opens the actual checkout; set mode=\"worktree\" when the user asks for an isolated or parallel coding session. Returns a workspaceId, loaded root project instructions, and nested instruction file paths the model should read before working in those directories.",
+        description: "Open a local project directory as a coding workspace. Call this once per project folder or worktree before reading, editing, searching, writing, showing changes, or running commands. Reuse the returned workspaceId for later calls in the same folder; do not call open_workspace again unless switching folders/worktrees, changing checkout/worktree mode, the workspaceId is rejected as unknown, or the user explicitly asks to reopen. By default this opens the actual checkout; set mode=\"worktree\" when the user asks for an isolated or parallel coding session. Returns a workspaceId, loaded root project instructions, and nested instruction file paths the model should read before working in those directories.",
         inputSchema: {
             path: z
                 .string()
@@ -669,24 +669,24 @@ function createMcpServer(config, workspaces, reviewCheckpoints) {
         };
     });
     if (config.widgets === "changes") {
-        registerAppTool(server, "review_changes", {
-            title: "Review changes",
-            description: "Review aggregate file changes in an open workspace since the last review checkpoint or since the workspace was opened. Use this after a coherent set of file modifications to show a single diff review card.",
+        registerAppTool(server, "show_changes", {
+            title: "Show changes",
+            description: "Show aggregate file changes in an open workspace since the last shown checkpoint or since the workspace was opened. After you create, edit, or overwrite files, call this once when the related file changes are complete so the user can inspect the combined diff.",
             inputSchema: {
                 workspaceId: z
                     .string()
                     .describe("Workspace identifier returned by open_workspace."),
                 since: z
-                    .enum(["last_review", "workspace_open"])
+                    .enum(["last_shown", "workspace_open"])
                     .optional()
-                    .describe("Defaults to last_review. Use workspace_open to compare against the initial open_workspace checkpoint."),
+                    .describe("Defaults to last_shown. Use workspace_open to compare against the initial open_workspace checkpoint."),
                 markReviewed: z
                     .boolean()
                     .optional()
-                    .describe("Defaults to true. When true, advances the last_review checkpoint to the current workspace state."),
+                    .describe("Defaults to true. When true, advances the last shown checkpoint to the current workspace state."),
             },
             outputSchema: resultOutputSchema(),
-            ...toolWidgetDescriptorMeta(config, "review_changes"),
+            ...toolWidgetDescriptorMeta(config, "show_changes"),
             annotations: { readOnlyHint: true },
         }, async ({ workspaceId, since, markReviewed }) => {
             const startedAt = performance.now();
@@ -694,12 +694,12 @@ function createMcpServer(config, workspaces, reviewCheckpoints) {
             const review = await reviewCheckpoints.reviewChanges({
                 workspaceId,
                 root: workspace.root,
-                since: since ?? "last_review",
+                since: since ?? "last_shown",
                 markReviewed: markReviewed ?? true,
             });
             const content = [textBlock(review.result)];
             logToolCall(config, {
-                tool: "review_changes",
+                tool: "show_changes",
                 workspaceId,
                 success: true,
                 durationMs: Math.round(performance.now() - startedAt),
@@ -707,7 +707,7 @@ function createMcpServer(config, workspaces, reviewCheckpoints) {
             return {
                 content,
                 _meta: {
-                    tool: "review_changes",
+                    tool: "show_changes",
                     card: {
                         workspaceId,
                         summary: review.summary,