@dsh-stack/tweak-plan-toggle 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# tweak-plan-toggle
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Plan/Build toggle: registers the /build command leaving plan mode through the harness plan-mode controller.
+
+An extension of the `tweaks` settings surface, split out of the bundled `tweaks` package.

package/lib/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `tweak-plan-toggle`: the Plan/Build toggle command plus the settings form
+ * projected from its own `tweak-plan-toggle` entry. Split out of the bundled
+ * `tweaks` package.
+ * @module tweak-plan-toggle
+ */
+import type { Context } from "@deepseek-ai/cordis";
+import type z from "@deepseek-ai/schemastery";
+import { type PlanToggleConfig as PlanToggleConfigType } from "./settings.js";
+export { NS_PLAN_TOGGLE, PlanToggleConfig } from "./settings.js";
+export type { PlanToggleConfig as PlanToggleConfigType } from "./settings.js";
+export { installPlanToggle } from "./plan-toggle.js";
+export declare const name = "tweak-plan-toggle";
+export declare const inject: string[];
+/** The plan-toggle extension config: the plan-toggle section itself. */
+export type Config = PlanToggleConfigType;
+export declare const Config: z<Config>;
+/**
+ * apply implementation.
+ *
+ * The plan-toggle form is the `PlanToggleConfig` this plugin already declares,
+ * and its namespace is this plugin's entry id, so there is nothing to install.
+ * What remains is to declare that this plugin ships its own page for that form
+ * and, when enabled, to register the `/build` command that leaves plan mode.
+ *
+ * @param ctx - the plugin's context.
+ * @param config - the plan-toggle configuration; `enabled` defaults to true.
+ */
+export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -0,0 +1,31 @@
+/**
+ * `tweak-plan-toggle`: the Plan/Build toggle command plus the settings form
+ * projected from its own `tweak-plan-toggle` entry. Split out of the bundled
+ * `tweaks` package.
+ * @module tweak-plan-toggle
+ */
+import { declareCustomSettingsPage } from "@dsh-stack/plugin-kit";
+import { installPlanToggle } from "./plan-toggle.js";
+import { PlanToggleConfig, } from "./settings.js";
+export { NS_PLAN_TOGGLE, PlanToggleConfig } from "./settings.js";
+export { installPlanToggle } from "./plan-toggle.js";
+export const name = "tweak-plan-toggle";
+export const inject = [];
+export const Config = PlanToggleConfig;
+/**
+ * apply implementation.
+ *
+ * The plan-toggle form is the `PlanToggleConfig` this plugin already declares,
+ * and its namespace is this plugin's entry id, so there is nothing to install.
+ * What remains is to declare that this plugin ships its own page for that form
+ * and, when enabled, to register the `/build` command that leaves plan mode.
+ *
+ * @param ctx - the plugin's context.
+ * @param config - the plan-toggle configuration; `enabled` defaults to true.
+ */
+export function apply(ctx, config) {
+    const session = { enabled: config?.enabled ?? true };
+    declareCustomSettingsPage(ctx);
+    if (session.enabled)
+        void installPlanToggle(ctx);
+}

package/lib/plan-toggle.d.ts

@@ -0,0 +1,9 @@
+/**
+ * tweak-plan-toggle: registers `/build`, delegating to the harness plan-mode
+ * controller (`ctx.planMode.set(agent, false)`), so it complements the
+ * existing `/plan` command instead of colliding with it.
+ * @module tweak-plan-toggle/plan-toggle
+ */
+import type { Context } from "@deepseek-ai/cordis";
+/** Register the Build (leave-plan-mode) toggle command. Returns the inject fiber. */
+export declare function installPlanToggle(ctx: Context): unknown;

package/lib/plan-toggle.js

@@ -0,0 +1,27 @@
+/**
+ * tweak-plan-toggle: registers `/build`, delegating to the harness plan-mode
+ * controller (`ctx.planMode.set(agent, false)`), so it complements the
+ * existing `/plan` command instead of colliding with it.
+ * @module tweak-plan-toggle/plan-toggle
+ */
+/** Register the Build (leave-plan-mode) toggle command. Returns the inject fiber. */
+export function installPlanToggle(ctx) {
+    return ctx.inject(["commands", "planMode"], (commandCtx) => {
+        return commandCtx.commands.register({
+            name: "build",
+            description: "Leave plan mode and continue in the default mode",
+            handler: ({ agent }) => {
+                switch (commandCtx.planMode.set(agent, false)) {
+                    case "committed":
+                        return { kind: "success", text: "Plan mode off. Continue building." };
+                    case "queued":
+                        return { kind: "success", text: "Leaving plan mode (applies from the next step)." };
+                    case "cancelled":
+                        return { kind: "success", text: "Plan mode is already inactive." };
+                    case "noop":
+                        return { kind: "success", text: "Plan mode is already inactive." };
+                }
+            },
+        });
+    });
+}

package/lib/settings.d.ts

@@ -0,0 +1,13 @@
+/**
+ * tweak-plan-toggle settings: the Plan/Build toggle section schema.
+ * @module tweak-plan-toggle/settings
+ */
+import z from "@deepseek-ai/schemastery";
+/** Namespace of the plan-toggle section — this plugin's own Loader entry id. */
+export declare const NS_PLAN_TOGGLE: import("@dsh-stack/plugin-kit").SettingsNamespace;
+/** Plan-toggle knobs. */
+export interface PlanToggleConfig {
+    /** Whether the Plan/Build toggle command is registered. */
+    enabled: boolean;
+}
+export declare const PlanToggleConfig: z<PlanToggleConfig>;

package/lib/settings.js

@@ -0,0 +1,11 @@
+/**
+ * tweak-plan-toggle settings: the Plan/Build toggle section schema.
+ * @module tweak-plan-toggle/settings
+ */
+import z from "@deepseek-ai/schemastery";
+import { settingsNamespace } from "@dsh-stack/plugin-kit";
+/** Namespace of the plan-toggle section — this plugin's own Loader entry id. */
+export const NS_PLAN_TOGGLE = settingsNamespace("tweak-plan-toggle");
+export const PlanToggleConfig = z.object({
+    enabled: z.boolean().default(true),
+});

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@dsh-stack/tweak-plan-toggle",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Plan/Build toggle: registers the /build command leaving plan mode through the harness plan-mode controller.",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "README.md",
+    "package.json",
+    "stack.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "stack": {
+    "kind": "plugin",
+    "id": "stack.tweaks.plan-toggle"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node check-plugin.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "*",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-commands": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-plan-mode": "0.2.0-rc.2"
+  },
+  "dependencies": {
+    "@dsh-stack/plugin-kit": "0.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "*",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-commands": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-plan-mode": "0.2.0-rc.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marius-patrik/dsh-stack.git",
+    "directory": "plugins/tweak-plan-toggle"
+  }
+}

package/stack.json

@@ -0,0 +1,10 @@
+{
+  "id": "stack.tweaks.plan-toggle",
+  "name": "@dsh-stack/tweak-plan-toggle",
+  "version": "0.1.1",
+  "kind": "plugin",
+  "description": "Plan/Build toggle: registers the /build command leaving plan mode through the harness plan-mode controller.",
+  "files": ["lib", "README.md", "package.json", "stack.json"],
+  "dependencies": ["stack.library.plugin-kit"],
+  "optionalDependencies": []
+}