@esthernandez/vibe-doc 0.2.1 → 0.2.3

package/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "vibe-doc",
+  "version": "0.2.3",
+  "description": "AI-powered documentation gap analyzer. Scans your codebase, classifies your project, identifies missing technical documentation, and generates professional docs from your existing artifacts.",
+  "author": {
+    "name": "626Labs LLC"
+  }
+}

package/commands/check.md

@@ -0,0 +1,7 @@
+---
+description: Check documentation completeness for deployment
+---
+
+Read `${CLAUDE_PLUGIN_ROOT}/skills/check/SKILL.md` and follow its instructions to run a CI-safe documentation check.
+
+Run `npx vibe-doc check` in the user's project directory. Present pass/fail results clearly. If docs are missing or stale, suggest running `/generate` to fix gaps.

package/commands/generate.md

@@ -0,0 +1,11 @@
+---
+description: Generate missing documentation
+---
+
+Read `${CLAUDE_PLUGIN_ROOT}/skills/generate/SKILL.md` and follow its full conversational flow to generate documentation for identified gaps.
+
+The generate skill will guide you through:
+1. Reviewing the current gap report
+2. Selecting which gaps to address
+3. Asking synthesis questions per doc type
+4. Generating markdown and/or docx output

package/commands/scan.md

@@ -0,0 +1,11 @@
+---
+description: Scan your project for documentation gaps
+---
+
+Read `${CLAUDE_PLUGIN_ROOT}/skills/scan/SKILL.md` and follow its full conversational flow to scan the user's project, classify it, and generate a documentation gap report.
+
+The scan skill will guide you through:
+1. Entry gate (context vs cold start)
+2. Artifact inventory scan via CLI
+3. Classification with user confirmation
+4. Gap report presentation

package/commands/status.md

@@ -0,0 +1,7 @@
+---
+description: Show current Vibe Doc status
+---
+
+Run `npx vibe-doc status` in the user's project directory via bash. Present the output in a clean format showing last scan time, classification, and documentation coverage.
+
+If no state exists, tell the user to run `/scan` first.

package/dist/classifier/index.js

@@ -106,6 +106,8 @@ function buildLowConfidenceClassification(ruleResults, inventory) {
 function mapCategoryToDeploymentContext(category, contexts) {
     const result = [];
     // Determine platform based on category
+    // TODO: these platform/environment/scale strings are untyped magic strings —
+    // worth promoting to enums when the classifier gets its next overhaul.
     let platform = 'cloud';
     if (category === scoring_engine_1.Category.MobileApplication) {
         platform = 'mobile';
@@ -113,6 +115,9 @@ function mapCategoryToDeploymentContext(category, contexts) {
     else if (category === scoring_engine_1.Category.InfrastructurePlatform) {
         platform = 'kubernetes';
     }
+    else if (category === scoring_engine_1.Category.ClaudeCodePlugin) {
+        platform = 'plugin';
+    }
     // Check for EdgeEmbedded context
     if (contexts.includes(scoring_engine_1.Context.EdgeEmbedded)) {
         platform = 'edge';
@@ -122,6 +127,10 @@ function mapCategoryToDeploymentContext(category, contexts) {
     if (contexts.includes(scoring_engine_1.Context.InternalTooling)) {
         environment = 'staging';
     }
+    if (category === scoring_engine_1.Category.ClaudeCodePlugin) {
+        // Plugins are distributed, not deployed in the SaaS sense
+        environment = 'distribution';
+    }
     // Determine scale based on contexts
     let scale = 'small';
     if (contexts.includes(scoring_engine_1.Context.CustomerFacing)) {

package/dist/classifier/llm-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-prompt.d.ts","sourceRoot":"","sources":["../../src/classifier/llm-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAA+B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,aAAa,GACzB,MAAM,CA0DR"}
+{"version":3,"file":"llm-prompt.d.ts","sourceRoot":"","sources":["../../src/classifier/llm-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAA+B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,aAAa,GACzB,MAAM,CA2DR"}

package/dist/classifier/llm-prompt.js

@@ -39,6 +39,7 @@ Choose ONE primary category that best describes this project:
 - **MobileApplication**: Native or cross-platform mobile apps
 - **AIMLSystem**: ML/AI-focused projects with models, training, inference
 - **IntegrationConnector**: Adapters, SDKs, connectors for third-party services
+- **ClaudeCodePlugin**: A Claude Code plugin or plugin marketplace — characterized by a .claude-plugin/plugin.json manifest, skills/*/SKILL.md files, commands/*.md files, or a .claude-plugin/marketplace.json. No runtime deployment in the traditional sense; distributed to users via npm or a marketplace.
 
 ## Operational Contexts
 

package/dist/classifier/scoring-engine.d.ts

@@ -10,7 +10,8 @@ export declare enum Category {
     InfrastructurePlatform = "InfrastructurePlatform",
     MobileApplication = "MobileApplication",
     AIMLSystem = "AIMLSystem",
-    IntegrationConnector = "IntegrationConnector"
+    IntegrationConnector = "IntegrationConnector",
+    ClaudeCodePlugin = "ClaudeCodePlugin"
 }
 export declare enum Context {
     Regulated = "Regulated",

package/dist/classifier/scoring-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoring-engine.d.ts","sourceRoot":"","sources":["../../src/classifier/scoring-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,oBAAY,QAAQ;IAClB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,UAAU,eAAe;IACzB,oBAAoB,yBAAyB;CAC9C;AAED,oBAAY,OAAO;IACjB,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,GAAE,MAAa,GACjC,aAAa,CAuMf"}
+{"version":3,"file":"scoring-engine.d.ts","sourceRoot":"","sources":["../../src/classifier/scoring-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,oBAAY,QAAQ;IAClB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,UAAU,eAAe;IACzB,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;CACtC;AAED,oBAAY,OAAO;IACjB,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,GAAE,MAAa,GACjC,aAAa,CA0Nf"}

package/dist/classifier/scoring-engine.js

@@ -16,6 +16,7 @@ var Category;
     Category["MobileApplication"] = "MobileApplication";
     Category["AIMLSystem"] = "AIMLSystem";
     Category["IntegrationConnector"] = "IntegrationConnector";
+    Category["ClaudeCodePlugin"] = "ClaudeCodePlugin";
 })(Category || (exports.Category = Category = {}));
 var Context;
 (function (Context) {
@@ -160,6 +161,21 @@ function scoreClassification(signals, confidenceThreshold = 0.85) {
             case 'has-github-actions':
                 contextScores[Context.InternalTooling] += 1 * w;
                 break;
+            // Claude Code Plugin signals
+            // Weighted to dominate: plugin.json is an unambiguous marker that
+            // overrides any incidental web/framework signals in the repo.
+            case 'has-claude-plugin-manifest':
+                categoryScores[Category.ClaudeCodePlugin] += 20 * w;
+                break;
+            case 'has-claude-skill-files':
+                categoryScores[Category.ClaudeCodePlugin] += 8 * w;
+                break;
+            case 'has-claude-command-files':
+                categoryScores[Category.ClaudeCodePlugin] += 6 * w;
+                break;
+            case 'has-claude-marketplace':
+                categoryScores[Category.ClaudeCodePlugin] += 10 * w;
+                break;
             default:
                 logger_1.logger.warn(`Unknown signal: ${signal.name}`);
         }

package/dist/classifier/signals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/classifier/signals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAgWrE"}
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/classifier/signals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAkZrE"}

package/dist/classifier/signals.js

@@ -12,16 +12,20 @@ const logger_1 = require("../utils/logger");
  */
 function extractSignals(inventory) {
     const signals = [];
+    // Normalize paths to forward slashes before any substring matching —
+    // otherwise Windows backslash paths break signal detection for anything
+    // that looks across path components (.github/workflows, .claude-plugin/...)
+    const norm = (s) => s.replace(/\\/g, '/').toLowerCase();
     // Source code patterns
-    const sourceFiles = inventory.categories.sourceCode.files.join('|').toLowerCase();
-    const configFiles = inventory.categories.configuration.files.join('|').toLowerCase();
-    const infraFiles = inventory.categories.infrastructure.files.join('|').toLowerCase();
-    const docFiles = inventory.categories.documentation.files.join('|').toLowerCase();
-    const allFiles = inventory.categories.sourceCode.files
+    const sourceFiles = norm(inventory.categories.sourceCode.files.join('|'));
+    const configFiles = norm(inventory.categories.configuration.files.join('|'));
+    const infraFiles = norm(inventory.categories.infrastructure.files.join('|'));
+    const docFiles = norm(inventory.categories.documentation.files.join('|'));
+    const allFiles = norm(inventory.categories.sourceCode.files
         .concat(inventory.categories.configuration.files)
         .concat(inventory.categories.infrastructure.files)
-        .join('|')
-        .toLowerCase();
+        .concat(inventory.categories.documentation.files)
+        .join('|'));
     // Express/Fastify/Koa routes
     if (sourceFiles.includes('routes') || sourceFiles.includes('controller')) {
         if (allFiles.includes('express') ||
@@ -300,6 +304,41 @@ function extractSignals(inventory) {
             weight: 1,
         });
     }
+    // Claude Code Plugin manifest — the dominant signal for plugin repos.
+    // Path-anchored to avoid false positives on stray files named plugin.json.
+    if (configFiles.includes('.claude-plugin/plugin.json') ||
+        allFiles.includes('.claude-plugin/plugin.json')) {
+        signals.push({
+            name: 'has-claude-plugin-manifest',
+            source: 'file-scanner',
+            weight: 10,
+        });
+    }
+    // Claude Code marketplace manifest (multi-plugin repo)
+    if (configFiles.includes('.claude-plugin/marketplace.json') ||
+        allFiles.includes('.claude-plugin/marketplace.json')) {
+        signals.push({
+            name: 'has-claude-marketplace',
+            source: 'file-scanner',
+            weight: 8,
+        });
+    }
+    // SKILL.md files under a skills/ directory (plugin skill surface)
+    if (docFiles.match(/\/skills\/[^/|]+\/skill\.md/)) {
+        signals.push({
+            name: 'has-claude-skill-files',
+            source: 'file-scanner',
+            weight: 6,
+        });
+    }
+    // Command markdown files under a commands/ directory
+    if (docFiles.match(/\/commands\/[^/|]+\.md/)) {
+        signals.push({
+            name: 'has-claude-command-files',
+            source: 'file-scanner',
+            weight: 5,
+        });
+    }
     logger_1.logger.debug(`Extracted ${signals.length} signals from inventory`);
     return signals;
 }

package/dist/gap-analyzer/breadcrumbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/breadcrumbs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAsT1D"}
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/breadcrumbs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAuY1D"}

package/dist/gap-analyzer/breadcrumbs.js

@@ -296,6 +296,83 @@ function getBreadcrumbs(docType) {
                 'What indexing strategy do you use?',
             ],
         },
+        readme: {
+            docType: 'readme',
+            keywords: ['readme'],
+            filePatterns: ['**/README.md', '**/README', '**/README.*'],
+            gitPatterns: ['readme:', 'docs: readme', 'docs:readme'],
+            codePatterns: [],
+            // Single-file docs: presence of the file is the satisfaction signal.
+            // The generate-time template enforces the sections; the gap analyzer
+            // only needs to know "does a README exist anywhere?"
+            requiredSections: ['present'],
+            gapQuestions: [
+                'What does your project actually do, in one sentence?',
+                'How does a new user install and run it for the first time?',
+                'What does a minimal working example look like?',
+                'Where should someone go next after reading the README?',
+            ],
+        },
+        'install-guide': {
+            docType: 'install-guide',
+            keywords: ['install', 'setup', 'getting-started'],
+            filePatterns: [
+                '**/INSTALL.md',
+                '**/INSTALLATION.md',
+                '**/docs/install*',
+                '**/docs/setup*',
+                '**/docs/getting-started*',
+            ],
+            gitPatterns: ['install:', 'setup:', 'docs: install'],
+            codePatterns: [],
+            requiredSections: ['present'],
+            gapQuestions: [
+                'What does a user need before installing (OS, runtimes, accounts)?',
+                'What is the exact command or set of steps to install?',
+                'How does a user verify the install worked?',
+                'What are the most common installation problems and fixes?',
+            ],
+        },
+        'skill-command-reference': {
+            docType: 'skill-command-reference',
+            keywords: ['skill', 'command'],
+            filePatterns: [
+                '**/SKILL.md',
+                '**/skills/**',
+                '**/commands/**',
+                '**/docs/commands*',
+                '**/docs/skills*',
+            ],
+            gitPatterns: ['skill:', 'command:', 'docs: skill'],
+            codePatterns: ['SKILL.md', 'description:', 'commands/'],
+            requiredSections: ['present'],
+            gapQuestions: [
+                'What skills or slash commands does this plugin expose?',
+                'For each, what does it do and when should someone reach for it?',
+                'What arguments or inputs does each command accept?',
+                'What does typical output look like?',
+            ],
+        },
+        'changelog-contributing': {
+            docType: 'changelog-contributing',
+            keywords: ['changelog', 'contributing', 'history'],
+            filePatterns: [
+                '**/CHANGELOG.md',
+                '**/CONTRIBUTING.md',
+                '**/HISTORY.md',
+                '**/docs/releases*',
+                '**/docs/contributing*',
+            ],
+            gitPatterns: ['release:', 'changelog:', 'docs: changelog'],
+            codePatterns: [],
+            requiredSections: ['present'],
+            gapQuestions: [
+                'Where do you track notable changes between releases?',
+                'How should a contributor get set up and propose changes?',
+                'What is the review and merge process?',
+                'Is there a code of conduct for contributors?',
+            ],
+        },
     };
     const breadcrumb = breadcrumbs[docType];
     if (!breadcrumb) {

package/dist/gap-analyzer/matrix.d.ts

@@ -9,7 +9,11 @@ export declare enum DocType {
     APISpec = "api-spec",
     DeploymentProcedure = "deployment-procedure",
     TestPlan = "test-plan",
-    DataModel = "data-model"
+    DataModel = "data-model",
+    README = "readme",
+    InstallGuide = "install-guide",
+    SkillCommandReference = "skill-command-reference",
+    ChangelogContributing = "changelog-contributing"
 }
 export declare enum Tier {
     Required = "required",

package/dist/gap-analyzer/matrix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/matrix.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,oBAAY,OAAO;IACjB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,WAAW,iBAAiB;IAC5B,OAAO,aAAa;IACpB,mBAAmB,yBAAyB;IAC5C,QAAQ,cAAc;IACtB,SAAS,eAAe;CACzB;AAED,oBAAY,IAAI;IACd,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAuED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,cAAc,EAAE,CAmDlB"}
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/matrix.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,oBAAY,OAAO;IACjB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,WAAW,iBAAiB;IAC5B,OAAO,aAAa;IACpB,mBAAmB,yBAAyB;IAC5C,QAAQ,cAAc;IACtB,SAAS,eAAe;IACxB,MAAM,WAAW;IACjB,YAAY,kBAAkB;IAC9B,qBAAqB,4BAA4B;IACjD,qBAAqB,2BAA2B;CACjD;AAED,oBAAY,IAAI;IACd,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAsHD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,cAAc,EAAE,CAmDlB"}

package/dist/gap-analyzer/matrix.js

@@ -16,6 +16,10 @@ var DocType;
     DocType["DeploymentProcedure"] = "deployment-procedure";
     DocType["TestPlan"] = "test-plan";
     DocType["DataModel"] = "data-model";
+    DocType["README"] = "readme";
+    DocType["InstallGuide"] = "install-guide";
+    DocType["SkillCommandReference"] = "skill-command-reference";
+    DocType["ChangelogContributing"] = "changelog-contributing";
 })(DocType || (exports.DocType = DocType = {}));
 var Tier;
 (function (Tier) {
@@ -35,6 +39,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Recommended,
         AIMLSystem: Tier.Recommended,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Recommended,
     },
     [DocType.Runbook]: {
         WebApplication: Tier.Required,
@@ -44,6 +49,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Required,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Optional,
     },
     [DocType.ThreatModel]: {
         WebApplication: Tier.Recommended,
@@ -53,6 +59,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Required,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Optional,
     },
     [DocType.APISpec]: {
         WebApplication: Tier.Required,
@@ -62,6 +69,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Recommended,
         AIMLSystem: Tier.Recommended,
         IntegrationConnector: Tier.Required,
+        ClaudeCodePlugin: Tier.Optional,
     },
     [DocType.DeploymentProcedure]: {
         WebApplication: Tier.Required,
@@ -71,6 +79,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Required,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Optional,
     },
     [DocType.TestPlan]: {
         WebApplication: Tier.Recommended,
@@ -80,6 +89,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Required,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Recommended,
     },
     [DocType.DataModel]: {
         WebApplication: Tier.Required,
@@ -89,6 +99,47 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Recommended,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Optional,
+        ClaudeCodePlugin: Tier.Optional,
+    },
+    [DocType.README]: {
+        WebApplication: Tier.Required,
+        APIMicroservice: Tier.Required,
+        DataPipeline: Tier.Required,
+        InfrastructurePlatform: Tier.Required,
+        MobileApplication: Tier.Required,
+        AIMLSystem: Tier.Required,
+        IntegrationConnector: Tier.Required,
+        ClaudeCodePlugin: Tier.Required,
+    },
+    [DocType.InstallGuide]: {
+        WebApplication: Tier.Recommended,
+        APIMicroservice: Tier.Recommended,
+        DataPipeline: Tier.Recommended,
+        InfrastructurePlatform: Tier.Required,
+        MobileApplication: Tier.Required,
+        AIMLSystem: Tier.Recommended,
+        IntegrationConnector: Tier.Required,
+        ClaudeCodePlugin: Tier.Required,
+    },
+    [DocType.SkillCommandReference]: {
+        WebApplication: Tier.Optional,
+        APIMicroservice: Tier.Optional,
+        DataPipeline: Tier.Optional,
+        InfrastructurePlatform: Tier.Optional,
+        MobileApplication: Tier.Optional,
+        AIMLSystem: Tier.Optional,
+        IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Required,
+    },
+    [DocType.ChangelogContributing]: {
+        WebApplication: Tier.Recommended,
+        APIMicroservice: Tier.Recommended,
+        DataPipeline: Tier.Recommended,
+        InfrastructurePlatform: Tier.Recommended,
+        MobileApplication: Tier.Recommended,
+        AIMLSystem: Tier.Recommended,
+        IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Recommended,
     },
 };
 /**

package/dist/gap-analyzer/tier-assigner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tier-assigner.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/tier-assigner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,cAAc,EAAE,EAC9B,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,GAAG,EAAE,CA+BP;AAmGD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"tier-assigner.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/tier-assigner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,cAAc,EAAE,EAC9B,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,GAAG,EAAE,CA+BP;AAiHD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/gap-analyzer/tier-assigner.js

@@ -67,19 +67,31 @@ function searchForDocumentationEvidence(breadcrumb, inventory) {
 }
 /**
  * Simple glob pattern matcher
+ * Normalizes Windows backslashes to forward slashes so glob patterns
+ * that reference path segments (e.g., "** /docs/adr/**") work cross-platform.
  */
 function matchPattern(filePath, pattern) {
     const regex = patternToRegex(pattern);
-    return regex.test(filePath.toLowerCase());
+    const normalized = filePath.replace(/\\/g, '/').toLowerCase();
+    return regex.test(normalized);
 }
 /**
  * Convert glob pattern to regex
+ *
+ * Uses a placeholder for `**` to prevent the subsequent `*` → `[^/]*`
+ * replacement from clobbering the `*` inside `.*`. A naive two-pass
+ * replacement silently produced `.[^/]*` for every `**` pattern,
+ * which broke glob matching for every doc type.
  */
 function patternToRegex(pattern) {
+    // Escape regex-special characters first
     const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    // Use a placeholder token that can't appear in a normal path
+    const DOUBLE_STAR = '\u0000DOUBLESTAR\u0000';
     const globRegex = escaped
-        .replace(/\*\*/g, '.*')
+        .replace(/\*\*/g, DOUBLE_STAR)
         .replace(/\*/g, '[^/]*')
+        .replace(new RegExp(DOUBLE_STAR, 'g'), '.*')
         .replace(/\?/g, '.');
     return new RegExp(`^${globRegex}$`, 'i');
 }

package/dist/generator/docx-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docx-writer.d.ts","sourceRoot":"","sources":["../../src/generator/docx-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOhD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,CA0CjB"}
+{"version":3,"file":"docx-writer.d.ts","sourceRoot":"","sources":["../../src/generator/docx-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmBhD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,CA0CjB"}

package/dist/generator/docx-writer.js

@@ -42,6 +42,18 @@ const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const docx_1 = require("docx");
 const logger_1 = require("../utils/logger");
+// Resolve vibe-doc's own version at module load time so generated docs
+// stamp the correct tool version. __dirname in dist/generator/ is one
+// level below the package root.
+const pkgVersion = (() => {
+    try {
+        const pkgPath = path.resolve(__dirname, '..', '..', 'package.json');
+        return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version;
+    }
+    catch {
+        return 'unknown';
+    }
+})();
 // Color scheme
 const NAVY = '1B2A4A';
 const STEEL = '3D5A80';
@@ -101,7 +113,7 @@ function parseMarkdownContent(content, docType, metadata) {
     let isFirstH1 = true;
     // Add metadata header as paragraphs
     sections.push(new docx_1.Paragraph({
-        text: `Generated by Vibe Doc v0.1.0`,
+        text: `Generated by Vibe Doc v${pkgVersion}`,
         spacing: { line: 240, lineRule: 'auto' },
     }));
     sections.push(new docx_1.Paragraph({

package/dist/generator/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/generator/extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAib/C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,EACnB,WAAW,GAAE,MAAsB,GAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2CxB"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/generator/extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+gB/C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,EACnB,WAAW,GAAE,MAAsB,GAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuDxB"}

package/dist/generator/extractor.js

@@ -413,6 +413,85 @@ function extractThreatModel(projectPath, state) {
     }
     return result;
 }
+/**
+ * Extract data for README template.
+ * Pulls project name and description from package.json when available.
+ */
+function extractReadme(projectPath, _state) {
+    const pkg = readPackageJson(projectPath);
+    const extracted = {};
+    if (pkg?.name) {
+        extracted.projectName = pkg.name;
+    }
+    if (pkg?.description) {
+        extracted.tagline = pkg.description;
+        extracted.overview = pkg.description;
+    }
+    // Try to surface a reasonable install command for npm packages
+    if (pkg?.name) {
+        extracted.installation = `\`\`\`bash\nnpm install ${pkg.name}\n\`\`\``;
+    }
+    return extracted;
+}
+/**
+ * Extract data for Install Guide template.
+ * Uses package.json engines field for Node version prerequisites.
+ */
+function extractInstallGuide(projectPath, _state) {
+    const pkg = readPackageJson(projectPath);
+    const extracted = {};
+    const prereqParts = [];
+    if (pkg?.engines?.node) {
+        prereqParts.push(`- Node.js ${pkg.engines.node}`);
+    }
+    if (pkg?.engines && Object.keys(pkg.engines).length > 0) {
+        for (const [engine, version] of Object.entries(pkg.engines)) {
+            if (engine !== 'node') {
+                prereqParts.push(`- ${engine} ${version}`);
+            }
+        }
+    }
+    if (prereqParts.length > 0) {
+        extracted.prerequisites = prereqParts.join('\n');
+    }
+    if (pkg?.name) {
+        extracted.installSteps = `\`\`\`bash\nnpm install -g ${pkg.name}\n\`\`\``;
+    }
+    return extracted;
+}
+/**
+ * Extract data for Skill/Command Reference template.
+ * Lists SKILL.md files and commands/*.md files from the documentation inventory.
+ */
+function extractSkillCommandReference(_projectPath, state) {
+    const extracted = {};
+    const docFiles = state.artifactInventory?.categories?.documentation?.files ?? [];
+    const normalizedDocs = docFiles.map((f) => f.replace(/\\/g, '/'));
+    const skillFiles = normalizedDocs.filter((f) => /\/skills\/[^/]+\/SKILL\.md$/i.test(f));
+    const commandFiles = normalizedDocs.filter((f) => /\/commands\/[^/]+\.md$/i.test(f));
+    if (skillFiles.length > 0) {
+        const skillNames = skillFiles.map((f) => {
+            const match = f.match(/\/skills\/([^/]+)\//);
+            return match ? `- \`${match[1]}\`` : null;
+        }).filter(Boolean);
+        extracted.skillList = skillNames.join('\n');
+    }
+    if (commandFiles.length > 0) {
+        const commandNames = commandFiles.map((f) => {
+            const name = path.basename(f, '.md');
+            return `- \`/${name}\``;
+        });
+        extracted.commandList = commandNames.join('\n');
+    }
+    return extracted;
+}
+/**
+ * Extract data for Changelog/Contributing template.
+ * Minimal — the template is mostly user-filled.
+ */
+function extractChangelogContributing(_projectPath, _state) {
+    return {};
+}
 /**
  * Main extraction function - maps doc type to specific extractor
  */
@@ -442,6 +521,18 @@ function extractDataForDocType(docType, state, projectPath = process.cwd()) {
             case 'threat-model':
                 extracted = extractThreatModel(projectPath, state);
                 break;
+            case 'readme':
+                extracted = extractReadme(projectPath, state);
+                break;
+            case 'install-guide':
+                extracted = extractInstallGuide(projectPath, state);
+                break;
+            case 'skill-command-reference':
+                extracted = extractSkillCommandReference(projectPath, state);
+                break;
+            case 'changelog-contributing':
+                extracted = extractChangelogContributing(projectPath, state);
+                break;
             default:
                 logger_1.logger.warn('Unknown doc type for extraction', { docType });
                 extracted = {};

package/dist/generator/markdown-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-writer.d.ts","sourceRoot":"","sources":["../../src/generator/markdown-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,WAAW,GACpB,MAAM,CAyBR"}
+{"version":3,"file":"markdown-writer.d.ts","sourceRoot":"","sources":["../../src/generator/markdown-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,WAAW,GACpB,MAAM,CAyBR"}