@infinitedusky/indusk-mcp 1.2.8 → 1.3.0

package/dist/bin/commands/extensions.js

@@ -204,6 +204,10 @@ export async function extensionsAdd(projectRoot, name, from) {
     catch {
         // leave as-is if parsing fails
     }
+    // If source is npm, install the underlying package
+    if (from.startsWith("npm:")) {
+        installNpmPackage(projectRoot, name, from.slice(4));
+    }
     const targetPath = join(extensionsDir(projectRoot), `${name}.json`);
     writeFileSync(targetPath, manifestContent);
     console.info(`  ${name}: added from ${from}`);
@@ -230,6 +234,31 @@ export async function extensionsAdd(projectRoot, name, from) {
         // ignore parse errors
     }
 }
+function installNpmPackage(projectRoot, extName, pkg) {
+    const pm = existsSync(join(projectRoot, "pnpm-lock.yaml"))
+        ? "pnpm"
+        : existsSync(join(projectRoot, "yarn.lock"))
+            ? "yarn"
+            : "npm";
+    const isWorkspace = existsSync(join(projectRoot, "pnpm-workspace.yaml"));
+    const addCmd = pm === "pnpm"
+        ? `pnpm add -D ${isWorkspace ? "-w " : ""}${pkg}@latest`
+        : pm === "yarn"
+            ? `yarn add -D ${pkg}@latest`
+            : `npm install -D ${pkg}@latest`;
+    console.info(`  ${extName}: running ${addCmd}...`);
+    try {
+        execSync(addCmd, {
+            cwd: projectRoot,
+            timeout: 60000,
+            encoding: "utf-8",
+        });
+        console.info(`  ${extName}: package installed`);
+    }
+    catch {
+        console.info(`  ${extName}: auto-install failed. Run manually: ${addCmd}`);
+    }
+}
 export async function extensionsRemove(projectRoot, names) {
     for (const name of names) {
         const enPath = join(extensionsDir(projectRoot), `${name}.json`);
@@ -278,31 +307,7 @@ export async function extensionsUpdate(projectRoot, names) {
             console.info(`  ${name}: updating from ${source}...`);
             // If source is npm, update the installed package FIRST so we get the latest
             if (source.startsWith("npm:")) {
-                const pkg = source.slice(4);
-                // Detect package manager
-                const pm = existsSync(join(projectRoot, "pnpm-lock.yaml"))
-                    ? "pnpm"
-                    : existsSync(join(projectRoot, "yarn.lock"))
-                        ? "yarn"
-                        : "npm";
-                const isWorkspace = existsSync(join(projectRoot, "pnpm-workspace.yaml"));
-                const addCmd = pm === "pnpm"
-                    ? `pnpm add -D ${isWorkspace ? "-w " : ""}${pkg}@latest`
-                    : pm === "yarn"
-                        ? `yarn add -D ${pkg}@latest`
-                        : `npm install -D ${pkg}@latest`;
-                console.info(`  ${name}: running ${addCmd}...`);
-                try {
-                    execSync(addCmd, {
-                        cwd: projectRoot,
-                        timeout: 60000,
-                        encoding: "utf-8",
-                    });
-                    console.info(`  ${name}: package updated`);
-                }
-                catch {
-                    console.info(`  ${name}: auto-update failed. Run manually: ${addCmd}`);
-                }
+                installNpmPackage(projectRoot, name, source.slice(4));
             }
             // Then fetch the latest manifest (from the now-updated package)
             await extensionsAdd(projectRoot, name, source);

package/dist/bin/commands/init-docs.js

@@ -231,6 +231,12 @@ Architecture decision records for ${projectName}. Each decision documents what w
     writeFileSync(join(docsDir, "src/lessons/index.md"), `# Lessons Learned
 
 Insights from building ${projectName}. Each lesson captures what we learned, what surprised us, and what we'd do differently.
+`);
+    writeFileSync(join(docsDir, "src/changelog.md"), `# Changelog
+
+All notable changes to ${projectName} are documented here. Follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [Unreleased]
 `);
     // Dockerfile for local dev
     const dockerDir = join(projectRoot, "docker");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@infinitedusky/indusk-mcp",
-	"version": "1.2.8",
+	"version": "1.3.0",
 	"description": "InDusk development system — skills, MCP tools, and CLI for structured AI-assisted development",
 	"type": "module",
 	"files": [

package/skills/document.md

@@ -60,7 +60,8 @@ apps/indusk-docs/src/
 │   ├── skills/      # One page per skill
 │   └── tools/       # One page per tool (Biome, CGC, composable.env)
 ├── decisions/       # Distilled from ADRs during retrospective/archival
-└── lessons/         # Distilled from retrospective insights during archival
+├── lessons/         # Distilled from retrospective insights during archival
+└── changelog.md     # Version history — Added, Changed, Fixed, etc.
 ```
 
 **CRITICAL: Every new page must be added to the sidebar.** The sidebar is configured in a single file: `apps/indusk-docs/src/.vitepress/config.ts` under `themeConfig.sidebar`. If you create a page but don't add it to the sidebar, it is invisible — users cannot navigate to it. This is the most common documentation mistake.
@@ -79,11 +80,29 @@ Never consider a documentation item complete until the sidebar entry exists.
 
 | What changed | Where to document | Doc type |
 |---|---|---|
-| New feature or tool | `reference/` | Reference page |
-| New workflow or process | `guide/` | How-to guide |
-| Configuration change | `reference/` (update existing page) | Reference update |
-| Architecture change | `reference/` + diagram | Reference + diagram |
-| Nothing user-facing | Skip | — |
+| New feature or tool | `reference/` + changelog | Reference page + Added |
+| New workflow or process | `guide/` + changelog | How-to guide + Added |
+| Configuration change | `reference/` (update existing) + changelog | Reference update + Changed |
+| Bug fix | Existing page (if relevant) + changelog | Fixed |
+| Architecture change | `reference/` + diagram + changelog | Reference + diagram + Changed |
+| Nothing user-facing | Skip changelog | — |
+
+### Changelog
+
+The changelog lives at `changelog.md` in the docs site. It uses [Keep a Changelog](https://keepachangelog.com) categories:
+
+- **Added** — new features (from `feature` workflow plans)
+- **Changed** — changes to existing functionality (from `refactor` workflows)
+- **Fixed** — bug fixes (from `bugfix` workflows)
+- **Deprecated** — soon to be removed
+- **Removed** — removed features
+- **Security** — vulnerability fixes
+
+**When to write:** During the Document gate of each phase that changes user-facing behavior. Add the entry under `## [Unreleased]`. At publish time, move Unreleased entries into a versioned section.
+
+**What to write:** One line per change. Human-readable — what users gain, not what code changed. The workflow type from the impl frontmatter tells you the category (feature → Added, bugfix → Fixed, refactor → Changed).
+
+**During planning:** The ADR's Documentation Plan section should include planned changelog entries. This forces you to think about user impact during planning, not after.
 
 ### Decisions and Lessons