@prductr/carlos 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 prductr
+
+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

@@ -0,0 +1,165 @@
+# @prductr/carlos
+
+AI-powered product roadmap generation and market fit assessment.
+
+## Overview
+
+Carlos analyzes your project's docs and codebase to generate actionable scopecraft documentation: phased roadmaps, PMF assessments, prioritized backlogs, and technical debt reports.
+
+## Installation
+
+```bash
+npm install -g @prductr/carlos   # global CLI
+npm install @prductr/carlos      # programmatic API
+```
+
+## CLI
+
+```bash
+carlos roadmap              # Generate phased product roadmap
+carlos market-fit           # Assess product-market fit (0–100 score)
+carlos backlog              # Prioritize features from docs/FEATURES.md
+carlos audit                # Technical debt audit
+carlos full                 # Run all four analyses concurrently
+carlos feedback             # How to report issues or request features
+carlos --version            # Print version
+carlos help                 # Show all commands and flags
+```
+
+### Flags
+
+| Flag | Description |
+|------|-------------|
+| `--json` | Output result as JSON (all commands) |
+| `--features <json>` | Feature list for `backlog` (JSON array, overrides FEATURES.md) |
+| `--version`, `-v` | Print version and exit |
+
+```bash
+# JSON output for scripting
+carlos market-fit --json | jq '.productMarketFitScore'
+
+# Inline feature list
+carlos backlog --features '["Auth", "Dashboard", "Export"]'
+
+# Analyze a specific directory
+carlos roadmap ./path/to/project
+```
+
+### Feature file
+
+Carlos reads `docs/FEATURES.md` (or `FEATURES.md` at root) for the `backlog` command:
+
+```markdown
+# Features
+
+- User authentication
+- Dashboard with real-time metrics
+- Export to CSV
+- Dark mode support
+```
+
+### Config file
+
+Create `carlos.config.json` in your project root to override defaults:
+
+```json
+{
+  "outputDir": "scopecraft",
+  "docsDir": "docs",
+  "includeMarketFit": true,
+  "includeTechnicalAudit": true
+}
+```
+
+## Output
+
+Carlos writes Markdown reports to `scopecraft/` (configurable via `outputDir`):
+
+```
+scopecraft/
+├── ROADMAP.md           # Phased roadmap with epics and milestones
+├── METRICS_AND_PMF.md   # PMF score, differentiators, recommendations
+├── PRODUCT_BACKLOG.md   # Now / Next / Later prioritized backlog
+└── TECHNICAL_AUDIT.md   # Debt items by category with severity
+```
+
+## PMF scoring
+
+A project scores higher when its PRD or README includes:
+
+| Section | Points |
+|---------|--------|
+| `## Target Audience` | 20 |
+| `## Problem Statement` | 20 |
+| `## Solution` | 20 |
+| `## Value Proposition` | 20 |
+| Differentiators present | 15 |
+| Low / no competition | up to 5 |
+
+A blank project scores ≤ 20. A well-documented one scores ≥ 75.
+
+## Programmatic API
+
+```typescript
+import {
+  generateRoadmap,
+  assessMarketFit,
+  prioritizeFeatures,
+  auditTechnical,
+  readFeatures,
+  loadConfig,
+} from '@prductr/carlos';
+
+// Load config from carlos.config.json (falls back to defaults)
+const config = loadConfig('/path/to/project');
+
+const roadmap    = await generateRoadmap(config);
+const assessment = await assessMarketFit(config);
+const features   = await readFeatures(config);        // reads FEATURES.md
+const backlog    = await prioritizeFeatures(config, features);
+const audit      = await auditTechnical(config);
+
+// Or run all concurrently
+const [roadmap, assessment, audit] = await Promise.all([
+  generateRoadmap(config),
+  assessMarketFit(config),
+  auditTechnical(config),
+]);
+```
+
+### Exported utilities
+
+| Export | Description |
+|--------|-------------|
+| `generateRoadmap(config)` | Generate phased roadmap |
+| `assessMarketFit(config)` | PMF assessment |
+| `prioritizeFeatures(config, features)` | RICE-scored backlog |
+| `auditTechnical(config)` | Technical debt audit |
+| `readFeatures(config)` | Read features from FEATURES.md |
+| `parseFeaturesFlag(args)` | Parse `--features` JSON from argv |
+| `loadConfig(projectRoot)` | Load + merge carlos.config.json |
+| `getVersion()` | Package version string |
+| `hasJsonFlag(args)` | Detect `--json` in argv |
+
+## Product stages
+
+Carlos infers the current stage from `package.json` version:
+
+| Version | Stage |
+|---------|-------|
+| `0.0.x` | prototype |
+| `0.x.x` | mvp |
+| `1.0.x` | beta |
+| `2.x.x`+ | growth |
+| No package.json + README | mvp |
+| No package.json, no README | idea |
+
+## Troubleshooting
+
+See [docs/RUNBOOK.md](docs/RUNBOOK.md) for common issues and fixes.
+
+To report a bug or request a feature: `carlos feedback`
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Carlos CLI - Command-line interface for product roadmap generation
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+/**
+ * Carlos CLI - Command-line interface for product roadmap generation
+ */
+import { resolve } from "path";
+import { generateRoadmap } from "./roadmap/index.js";
+import { assessMarketFit } from "./market-fit/index.js";
+import { prioritizeFeatures, readFeatures, parseFeaturesFlag } from "./product/index.js";
+import { auditTechnical } from "./technical/index.js";
+import { loadConfig, getVersion, hasJsonFlag } from "./config.js";
+const commands = {
+    roadmap: "Generate comprehensive product roadmap",
+    "market-fit": "Assess product-market fit",
+    backlog: "Prioritize product backlog (reads docs/FEATURES.md)",
+    audit: "Perform technical debt audit",
+    full: "Run complete analysis (roadmap + market-fit + audit)",
+    feedback: "Show how to provide feedback or report issues",
+    help: "Show this help message",
+};
+async function main() {
+    const args = process.argv.slice(2);
+    // Version flag: carlos --version or carlos -v
+    if (args[0] === "--version" || args[0] === "-v") {
+        console.log(getVersion());
+        return;
+    }
+    const command = args[0] || "help";
+    // Project root is the second positional arg (not starting with "-")
+    const positional = args.slice(1).find((a) => !a.startsWith("-"));
+    const projectRoot = positional || process.cwd();
+    const config = loadConfig(resolve(projectRoot));
+    const jsonMode = hasJsonFlag(args);
+    if (!jsonMode)
+        console.log("📊 Carlos - Product Roadmap Agent\n");
+    try {
+        switch (command) {
+            case "roadmap": {
+                const roadmap = await generateRoadmap(config);
+                if (jsonMode) {
+                    process.stdout.write(JSON.stringify(roadmap, null, 2) + "\n");
+                }
+                else {
+                    console.log("\n✅ Roadmap generated successfully");
+                    console.log(`   Phases: ${roadmap.phases.length}`);
+                    console.log(`   Epics: ${roadmap.epics.length}`);
+                    console.log(`   Timeline: ${roadmap.timeline}`);
+                }
+                break;
+            }
+            case "market-fit": {
+                const assessment = await assessMarketFit(config);
+                if (jsonMode) {
+                    process.stdout.write(JSON.stringify(assessment, null, 2) + "\n");
+                }
+                else {
+                    console.log("\n✅ Market fit assessment complete");
+                    console.log(`   PMF Score: ${assessment.productMarketFitScore}/100`);
+                    console.log(`   Competition: ${assessment.competition.length} competitors`);
+                    console.log(`   Recommendations: ${assessment.recommendations.length}`);
+                }
+                break;
+            }
+            case "backlog": {
+                const features = parseFeaturesFlag(args) ?? await readFeatures(config);
+                const backlog = await prioritizeFeatures(config, features);
+                if (jsonMode) {
+                    process.stdout.write(JSON.stringify(backlog, null, 2) + "\n");
+                }
+                else {
+                    console.log("\n✅ Product backlog prioritized");
+                    console.log(`   Now: ${backlog.nowItems.length} items`);
+                    console.log(`   Next: ${backlog.nextItems.length} items`);
+                    console.log(`   Later: ${backlog.laterItems.length} items`);
+                }
+                break;
+            }
+            case "audit": {
+                const audit = await auditTechnical(config);
+                if (jsonMode) {
+                    process.stdout.write(JSON.stringify(audit, null, 2) + "\n");
+                }
+                else {
+                    console.log("\n✅ Technical audit complete");
+                    console.log(`   Overall Health: ${audit.overallHealth}/100`);
+                    console.log(`   Debt Items: ${audit.debtItems.length}`);
+                    console.log(`   Critical Items: ${audit.debtItems.filter((d) => d.severity === "critical").length}`);
+                }
+                break;
+            }
+            case "full": {
+                if (!jsonMode)
+                    console.log("Running complete analysis...\n");
+                const [roadmap, assessment, audit] = await Promise.all([
+                    generateRoadmap(config),
+                    assessMarketFit(config),
+                    auditTechnical(config),
+                ]);
+                if (jsonMode) {
+                    process.stdout.write(JSON.stringify({ roadmap, assessment, audit }, null, 2) + "\n");
+                }
+                else {
+                    console.log(`✅ Roadmap: ${roadmap.phases.length} phases`);
+                    console.log(`✅ Market Fit: ${assessment.productMarketFitScore}/100`);
+                    console.log(`✅ Technical Health: ${audit.overallHealth}/100`);
+                    console.log(`\n📁 All reports written to ${config.outputDir}/`);
+                }
+                break;
+            }
+            case "feedback": {
+                console.log("📬 How to provide feedback:\n");
+                console.log("  GitHub Issues: https://github.com/prductr-com/carlos/issues");
+                console.log("  Feature requests, bug reports, and general feedback welcome.\n");
+                console.log("  When reporting bugs, please include:");
+                console.log("    - carlos version: carlos --version");
+                console.log("    - Node.js version: node --version");
+                console.log("    - Command that failed and error message");
+                break;
+            }
+            case "help":
+            default:
+                showHelp();
+                break;
+        }
+    }
+    catch (error) {
+        console.error("\n❌ Error:", error);
+        process.exit(1);
+    }
+}
+function showHelp() {
+    console.log(`Carlos v${getVersion()} — AI-powered product roadmap agent\n`);
+    console.log("Usage: carlos <command> [project-path] [flags]\n");
+    console.log("Commands:\n");
+    Object.entries(commands).forEach(([cmd, desc]) => {
+        console.log(`  ${cmd.padEnd(12)} ${desc}`);
+    });
+    console.log("\nFlags:");
+    console.log("  --version, -v        Print version and exit");
+    console.log("  --features <json>    Feature list for backlog command (JSON array)");
+    console.log("  --json               Output result as JSON (machine-readable)");
+    console.log("\nExamples:");
+    console.log("  carlos roadmap                          # Generate roadmap for current directory");
+    console.log("  carlos market-fit                       # Assess product-market fit");
+    console.log("  carlos audit                            # Run technical debt audit");
+    console.log("  carlos full                             # Complete analysis (runs concurrently)");
+    console.log("  carlos roadmap ./my-product             # Analyze specific project");
+    console.log('  carlos backlog --features \'["Auth","Dashboard"]\'  # Prioritize feature list');
+    console.log("\nConfig (carlos.config.json):");
+    console.log('  { "outputDir": "scopecraft", "docsDir": "docs",');
+    console.log('    "includeMarketFit": true, "includeTechnicalAudit": true }');
+    console.log("\nFeature file (docs/FEATURES.md or FEATURES.md):");
+    console.log("  # Features");
+    console.log("  - User authentication");
+    console.log("  - Dashboard with metrics");
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Config loader - reads carlos.config.json from projectRoot
+ */
+import { CarlosConfig } from "./types.js";
+/**
+ * Return the package version from package.json.
+ */
+export declare function getVersion(): string;
+/**
+ * Return true when --json flag is present in args.
+ */
+export declare function hasJsonFlag(args: string[]): boolean;
+/**
+ * Load Carlos config by merging carlos.config.json with defaults.
+ * Falls back to defaults silently if the file contains malformed JSON.
+ *
+ * @param projectRoot - Directory to look for carlos.config.json
+ * @returns Fully resolved CarlosConfig
+ */
+export declare function loadConfig(projectRoot: string): CarlosConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI1C;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAa5D"}

package/dist/config.js

@@ -0,0 +1,43 @@
+/**
+ * Config loader - reads carlos.config.json from projectRoot
+ */
+import { readFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { CarlosConfig } from "./types.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Return the package version from package.json.
+ */
+export function getVersion() {
+    const pkgPath = join(__dirname, "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return pkg.version;
+}
+/**
+ * Return true when --json flag is present in args.
+ */
+export function hasJsonFlag(args) {
+    return args.includes("--json");
+}
+/**
+ * Load Carlos config by merging carlos.config.json with defaults.
+ * Falls back to defaults silently if the file contains malformed JSON.
+ *
+ * @param projectRoot - Directory to look for carlos.config.json
+ * @returns Fully resolved CarlosConfig
+ */
+export function loadConfig(projectRoot) {
+    const configPath = join(projectRoot, "carlos.config.json");
+    let fileData = {};
+    if (existsSync(configPath)) {
+        try {
+            fileData = JSON.parse(readFileSync(configPath, "utf8"));
+        }
+        catch {
+            console.warn("⚠️  carlos.config.json contains invalid JSON — using defaults");
+        }
+    }
+    return CarlosConfig.parse({ projectRoot, ...fileData });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAwB,CAAC;IAC7E,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IAC3D,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAE3C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAA4B,CAAC;QACrF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Carlos - Product roadmap and market fit assessment agent
+ *
+ * A tool for generating comprehensive product roadmaps, assessing market fit,
+ * and auditing technical debt.
+ */
+export { generateRoadmap } from "./roadmap/index.js";
+export { assessMarketFit } from "./market-fit/index.js";
+export { prioritizeFeatures, readFeatures, parseFeaturesFlag } from "./product/index.js";
+export { auditTechnical } from "./technical/index.js";
+export { loadConfig, getVersion, hasJsonFlag } from "./config.js";
+export type { CarlosConfig, ProductStage, Roadmap, Phase, Epic, UserStory, MarketFitAssessment, TechnicalAudit, TechnicalDebtItem, ProductBacklog, FeaturePriority, Risk, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,SAAS,EACT,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,IAAI,GACL,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Carlos - Product roadmap and market fit assessment agent
+ *
+ * A tool for generating comprehensive product roadmaps, assessing market fit,
+ * and auditing technical debt.
+ */
+export { generateRoadmap } from "./roadmap/index.js";
+export { assessMarketFit } from "./market-fit/index.js";
+export { prioritizeFeatures, readFeatures, parseFeaturesFlag } from "./product/index.js";
+export { auditTechnical } from "./technical/index.js";
+export { loadConfig, getVersion, hasJsonFlag } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/market-fit/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Market Fit - Assess product-market fit and competitive position
+ * Analyzes target audience, competition, and market opportunity
+ */
+import type { CarlosConfig, MarketFitAssessment } from "../types.js";
+/**
+ * Assess product-market fit
+ *
+ * @param config - Carlos configuration
+ * @returns Market fit assessment with score and recommendations
+ */
+export declare function assessMarketFit(config: CarlosConfig): Promise<MarketFitAssessment>;
+//# sourceMappingURL=index.d.ts.map

package/dist/market-fit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/market-fit/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAErE;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAqD9B"}