complexity-cli 1.0.0

package/Complexity.template.md

@@ -0,0 +1,38 @@
+# Project Complexity & Knowledge Map
+
+<!-- Replace {Project Name} with your project name -->
+A guide to what you need to know to work on {Project Name}, broken into three tiers.
+
+> **{X} technologies/concepts** across {Y} areas 
+> **{A} critical** 
+> **{B} important**
+> **{C} situational**
+
+---
+
+## **What you NEED to know to do any meaningful work**
+
+<!-- Criticality 3 items from the table below -->
+
+## **What you SHOULD know to be very helpful**
+
+<!-- Everything above, plus Criticality 2 items -->
+
+## **What you should EVENTUALLY learn for specific areas**
+
+<!-- Criticality 1 items -->
+
+---
+
+## Full Reference
+
+<!--
+  Criticality scale:
+    3 = Can't do meaningful work without it
+    2 = Will encounter regularly; gaps will slow you down
+    1 = Comes up occasionally or is abstracted away enough to learn on the job
+-->
+
+| Topic | Area | Criticality (1-3) |
+|---|---|---|
+| | | |

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sam Wagner [SSW]
+
+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,173 @@
+# complexity-cli
+
+A CLI tool for managing project complexity and knowledge maps. Perfect for
+tracking what developers need to know to work on your project, with AI-friendly
+workflows.
+
+## Installation
+
+### Local Development
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+### From npm (Coming Soon)
+
+```bash
+npm install -g complexity-cli
+```
+
+## Usage
+
+### Initialize a Complexity Map
+
+Create a new `COMPLEXITY.md` file in your project:
+
+```bash
+complexity init --name "My Project"
+```
+
+Or run without flags to be prompted for the project name:
+
+```bash
+complexity init
+```
+
+### Add Concepts
+
+Add technologies, frameworks, or concepts to your complexity map:
+
+```bash
+# Basic usage
+complexity add "TypeScript" 3 backend
+
+# Without area (will use "___" as placeholder)
+complexity add "TypeScript" 3
+
+# Using --level flag
+complexity add "TypeScript" --level 3 backend
+```
+
+**Criticality Levels:**
+
+- `3` = Critical: Can't do meaningful work without it
+- `2` = Important: Will encounter regularly; gaps will slow you down
+- `1` = Situational: Comes up occasionally or is abstracted away
+
+### List Concepts
+
+View all concepts in your complexity map:
+
+```bash
+complexity list
+```
+
+The `list` command automatically searches upward through directories (stopping
+at git repo root) to find `COMPLEXITY.md`, so you can run it from any
+subdirectory.
+
+### Update Concepts
+
+Modify existing concepts:
+
+```bash
+# Update level
+complexity update "TypeScript" --level 2
+
+# Update area
+complexity update "TypeScript" --area "frontend"
+
+# Update name
+complexity update "TypeScript" --name "TypeScript/JavaScript"
+
+# Update multiple properties
+complexity update "TypeScript" --level 3 --area "fullstack"
+```
+
+### Remove Concepts
+
+Remove a concept from the map:
+
+```bash
+complexity remove "TypeScript"
+
+# Skip confirmation prompt
+complexity remove "TypeScript" --force
+```
+
+### Get AI Prompt
+
+Generate a prompt for AI tools to help analyze your project:
+
+```bash
+complexity prompt
+```
+
+This outputs a comprehensive prompt that instructs an AI to:
+
+- Analyze your project's complexity
+- Use the `complexity` CLI to maintain consistency
+- Consider all relevant technologies and concepts
+
+## Features
+
+- **Simple CLI**: Easy-to-use commands for managing complexity documentation
+- **Validation**: Duplicate detection and confirmation for new areas
+- **Auto-formatting**: Automatically updates all sections and statistics
+- **Sorting**: Concepts sorted by criticality (3→1), then alphabetically
+- **Git-aware**: `complexity list` searches upward to git repo root
+- **AI-friendly**: Designed to be used by AI agents for analysis
+
+## File Format
+
+The tool generates and maintains a `COMPLEXITY.md` file with:
+
+- **Summary Statistics**: Total concepts, areas, and breakdown by criticality
+- **Tiered Sections**: What you NEED, SHOULD, and EVENTUALLY learn
+- **Full Reference Table**: Complete sortable table of all concepts
+
+Example output:
+
+```markdown
+# Project Complexity & Knowledge Map
+
+A guide to what you need to know to work on My Project, broken into three tiers.
+
+> **5 technologies/concepts** across 3 areas **2 critical** **2 important** **1
+> situational**
+
+---
+
+## **What you NEED to know to do any meaningful work**
+
+- Node.js
+- TypeScript
+
+## **What you SHOULD know to be very helpful**
+
+- React
+- PostgreSQL
+
+## **What you should EVENTUALLY learn for specific areas**
+
+- Docker
+
+---
+
+## Full Reference
+
+| Topic      | Area     | Criticality (1-3) |
+| ---------- | -------- | ----------------- |
+| Node.js    | backend  | 3                 |
+| TypeScript | backend  | 3                 |
+| PostgreSQL | backend  | 2                 |
+| React      | frontend | 2                 |
+| Docker     | devops   | 1                 |
+```
+
+## License
+
+MIT

package/dist/commands/add.d.ts

@@ -0,0 +1,4 @@
+export declare function addCommand(concept: string, levelArg: string | undefined, areaArg: string | undefined, options: {
+    level?: string;
+}): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AA8EA,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,iBAkB5B"}

package/dist/commands/add.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCommand = addCommand;
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const parser_1 = require("../core/parser");
+const generator_1 = require("../core/generator");
+const validator_1 = require("../core/validator");
+const prompts_1 = require("../utils/prompts");
+const error_helpers_1 = require("../utils/error-helpers");
+const BLANK_AREA = '___';
+function getLevelInput(levelArg, options) {
+    const levelInput = options.level || levelArg;
+    if (!levelInput) {
+        (0, error_helpers_1.exitWithUsageError)('Criticality level is required.', 'complexity add <concept> <level> [area]\n   or: complexity add <concept> --level <level> [area]');
+    }
+    return levelInput;
+}
+function validateLevel(levelInput) {
+    if (!(0, validator_1.isValidLevel)(levelInput)) {
+        (0, error_helpers_1.exitWithError)('Level must be 1, 2, or 3.');
+    }
+    return parseInt(levelInput);
+}
+function requireComplexityFile() {
+    const filePath = (0, parser_1.findComplexityFile)();
+    if (!filePath) {
+        (0, error_helpers_1.exitWithError)('COMPLEXITY.md not found.', 'Run "complexity init" to create one.');
+    }
+    return filePath;
+}
+function validateConceptDoesNotExist(concept, existingConcepts) {
+    if ((0, validator_1.isDuplicate)(concept, existingConcepts)) {
+        (0, error_helpers_1.exitWithError)(`Concept "${concept}" already exists.`, 'Use "complexity update" to modify it.');
+    }
+}
+async function confirmNewAreaIfNeeded(area, existingConcepts) {
+    if (area === BLANK_AREA) {
+        return;
+    }
+    if ((0, validator_1.isExistingArea)(area, existingConcepts)) {
+        return;
+    }
+    const confirmed = await (0, prompts_1.confirmAction)(`No pre-existing area "${area}" found. Would you still like to add it?`);
+    if (!confirmed) {
+        (0, error_helpers_1.exitCancelled)();
+    }
+}
+function createConcept(concept, level, area) {
+    return {
+        topic: concept,
+        area,
+        criticality: level
+    };
+}
+function saveComplexityFile(filePath, projectName, concepts) {
+    const markdown = (0, generator_1.generateMarkdown)(projectName, concepts);
+    fs.writeFileSync(filePath, markdown, 'utf-8');
+}
+async function addCommand(concept, levelArg, areaArg, options) {
+    const levelInput = getLevelInput(levelArg, options);
+    const level = validateLevel(levelInput);
+    const area = areaArg || BLANK_AREA;
+    const filePath = requireComplexityFile();
+    const doc = (0, parser_1.parseComplexityFile)(filePath);
+    validateConceptDoesNotExist(concept, doc.concepts);
+    await confirmNewAreaIfNeeded(area, doc.concepts);
+    const newConcept = createConcept(concept, level, area);
+    const updatedConcepts = [...doc.concepts, newConcept];
+    saveComplexityFile(filePath, doc.projectName, updatedConcepts);
+    console.log(chalk_1.default.green(`✓ Added "${concept}" (Level ${level}, Area: ${area})`));
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+export declare function initCommand(options: {
+    name?: string;
+    force?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA2CA,wBAAsB,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,iBAU5E"}

package/dist/commands/init.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const prompts_1 = require("../utils/prompts");
+const error_helpers_1 = require("../utils/error-helpers");
+const TEMPLATE_FILE = path.join(__dirname, '../../Complexity.template.md');
+const OUTPUT_FILE = 'COMPLEXITY.md';
+function getOutputPath() {
+    return path.join(process.cwd(), OUTPUT_FILE);
+}
+function validateFileDoesNotExist(outputPath, force) {
+    if (fs.existsSync(outputPath) && !force) {
+        (0, error_helpers_1.exitWithError)(`${OUTPUT_FILE} already exists in this directory.`, 'Use --force to overwrite it.');
+    }
+}
+async function getProjectName(providedName) {
+    if (providedName) {
+        return providedName;
+    }
+    return (0, prompts_1.promptForInput)('Enter project name:', path.basename(process.cwd()));
+}
+function readTemplateFile() {
+    if (!fs.existsSync(TEMPLATE_FILE)) {
+        (0, error_helpers_1.exitWithError)(`Template file not found at ${TEMPLATE_FILE}`);
+    }
+    return fs.readFileSync(TEMPLATE_FILE, 'utf-8');
+}
+function initializeTemplateContent(template, projectName) {
+    return template
+        .replace(/\{Project Name\}/g, projectName)
+        .replace(/\{X\}/g, '0')
+        .replace(/\{Y\}/g, '0')
+        .replace(/\{A\}/g, '0')
+        .replace(/\{B\}/g, '0')
+        .replace(/\{C\}/g, '0');
+}
+async function initCommand(options) {
+    const outputPath = getOutputPath();
+    validateFileDoesNotExist(outputPath, options.force ?? false);
+    const projectName = await getProjectName(options.name);
+    const template = readTemplateFile();
+    const content = initializeTemplateContent(template, projectName);
+    fs.writeFileSync(outputPath, content, 'utf-8');
+    console.log(chalk_1.default.green(`✓ Created ${OUTPUT_FILE} for project: ${projectName}`));
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,kCAUC;AArDD,uCAAyB;AACzB,2CAA6B;AAC7B,kDAA0B;AAC1B,8CAAkD;AAClD,0DAAuD;AAEvD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;AAC3E,MAAM,WAAW,GAAG,eAAe,CAAC;AAEpC,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,wBAAwB,CAAC,UAAkB,EAAE,KAAc;IAClE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,IAAA,6BAAa,EAAC,GAAG,WAAW,oCAAoC,EAAE,8BAA8B,CAAC,CAAC;IACpG,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,YAAgC;IAC5D,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,IAAA,wBAAc,EAAC,qBAAqB,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,IAAA,6BAAa,EAAC,8BAA8B,aAAa,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAgB,EAAE,WAAmB;IACtE,OAAO,QAAQ;SACZ,OAAO,CAAC,mBAAmB,EAAE,WAAW,CAAC;SACzC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAEM,KAAK,UAAU,WAAW,CAAC,OAA2C;IAC3E,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,wBAAwB,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IAE7D,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,yBAAyB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEjE,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,aAAa,WAAW,iBAAiB,WAAW,EAAE,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/commands/list.d.ts

@@ -0,0 +1,2 @@
+export declare function listCommand(): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAuDA,wBAAgB,WAAW,SAiB1B"}

package/dist/commands/list.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listCommand = listCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const parser_1 = require("../core/parser");
+const generator_1 = require("../core/generator");
+const error_helpers_1 = require("../utils/error-helpers");
+function requireComplexityFile() {
+    const filePath = (0, parser_1.findComplexityFile)();
+    if (!filePath) {
+        (0, error_helpers_1.exitWithError)('COMPLEXITY.md not found.', 'Run "complexity init" to create one.');
+    }
+    return filePath;
+}
+function displayEmptyState(filePath) {
+    console.log(chalk_1.default.yellow('No concepts found in COMPLEXITY.md'));
+    console.log(chalk_1.default.gray(`File location: ${filePath}`));
+}
+function displayHeader(projectName, filePath, totalConcepts) {
+    console.log(chalk_1.default.bold(`\nProject: ${projectName}`));
+    console.log(chalk_1.default.gray(`File: ${filePath}`));
+    console.log(chalk_1.default.gray(`Total concepts: ${totalConcepts}\n`));
+}
+function displayConceptGroup(title, concepts, color) {
+    if (concepts.length === 0) {
+        return;
+    }
+    console.log(color(title));
+    concepts.forEach(concept => {
+        console.log(`  ${chalk_1.default.bold(concept.topic)} ${chalk_1.default.gray(`[${concept.area}]`)}`);
+    });
+    console.log('');
+}
+function groupConceptsByCriticality(concepts) {
+    return {
+        critical: concepts.filter(c => c.criticality === 3),
+        important: concepts.filter(c => c.criticality === 2),
+        situational: concepts.filter(c => c.criticality === 1),
+    };
+}
+function listCommand() {
+    const filePath = requireComplexityFile();
+    const doc = (0, parser_1.parseComplexityFile)(filePath);
+    const sorted = (0, generator_1.sortConcepts)(doc.concepts);
+    if (sorted.length === 0) {
+        displayEmptyState(filePath);
+        return;
+    }
+    displayHeader(doc.projectName, filePath, sorted.length);
+    const groups = groupConceptsByCriticality(sorted);
+    displayConceptGroup('Critical (Level 3):', groups.critical, chalk_1.default.red.bold);
+    displayConceptGroup('Important (Level 2):', groups.important, chalk_1.default.yellow.bold);
+    displayConceptGroup('Situational (Level 1):', groups.situational, chalk_1.default.green.bold);
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare function promptCommand(): void;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/commands/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,SAkC5B"}

package/dist/commands/prompt.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptCommand = promptCommand;
+function promptCommand() {
+    const prompt = `
+I'd like you to analyze this project and create a comprehensive complexity map. This map should list everything someone needs to know to take full ownership of this software project.
+
+For each technology, concept, or skill:
+- Rate its criticality from 1-3:
+  * 3 = Can't do meaningful work without it
+  * 2 = Will encounter regularly; gaps will slow you down  
+  * 1 = Comes up occasionally or is abstracted away
+
+- Categorize it by area (e.g., backend, frontend, infrastructure, devops, etc.)
+
+Use the following CLI commands to maintain the COMPLEXITY.md file:
+- \`complexity add <concept> <level> [area]\` - Add a new technology
+- \`complexity update <concept> --level <level> --area <area>\` - Update existing entry
+- \`complexity remove <concept>\` - Remove an entry
+- \`complexity list\` - View current entries
+
+Be thorough and accurate. Consider:
+- Programming languages and frameworks
+- Databases and data stores
+- DevOps and infrastructure tools
+- Testing frameworks and methodologies
+- Build tools and package managers
+- Domain-specific knowledge
+- Architectural patterns and design principles
+- Third-party services and APIs
+
+Start by reviewing the existing entries with \`complexity list\`, then add, update, or remove entries as needed to ensure completeness and accuracy.
+
+Do not update the COMPLEXITY.md file manually.
+`.trim();
+    console.log(prompt);
+}
+//# sourceMappingURL=prompt.js.map

package/dist/commands/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":";;AAAA,sCAkCC;AAlCD,SAAgB,aAAa;IAC3B,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BhB,CAAC,IAAI,EAAE,CAAC;IAEP,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC"}

package/dist/commands/remove.d.ts

@@ -0,0 +1,4 @@
+export declare function removeCommand(concept: string, options: {
+    force?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAoDA,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,iBAWhF"}