cortex-tms 2.1.0

package/dist/utils/validator.js

@@ -0,0 +1,241 @@
+import { readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { loadConfig, mergeConfig, getEffectiveLineLimits, } from './config.js';
+export const DEFAULT_LINE_LIMITS = {
+    'NEXT-TASKS.md': 200,
+    'FUTURE-ENHANCEMENTS.md': 500,
+    'ARCHITECTURE.md': 500,
+    'PATTERNS.md': 500,
+    'DOMAIN-LOGIC.md': 300,
+    'DECISIONS.md': 400,
+    'GLOSSARY.md': 200,
+    'SCHEMA.md': 600,
+    'TROUBLESHOOTING.md': 400,
+};
+export const MANDATORY_FILES = [
+    'NEXT-TASKS.md',
+    '.github/copilot-instructions.md',
+    'CLAUDE.md',
+];
+const PLACEHOLDER_PATTERNS = [
+    /\[Project Name\]/g,
+    /\[project-name\]/g,
+    /\[Description\]/g,
+    /\[Your Name\]/g,
+    /\[Repository URL\]/g,
+];
+async function countLines(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return content.split('\n').length;
+    }
+    catch {
+        return 0;
+    }
+}
+async function scanForPlaceholders(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const found = [];
+        for (const pattern of PLACEHOLDER_PATTERNS) {
+            const matches = content.match(pattern);
+            if (matches) {
+                found.push(...matches);
+            }
+        }
+        return {
+            found: found.length > 0,
+            placeholders: [...new Set(found)],
+        };
+    }
+    catch {
+        return { found: false, placeholders: [] };
+    }
+}
+async function countCompletedTasks(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const doneMatches = content.match(/\|\s*✅\s*(Done|Complete)\s*\|/gi);
+        return doneMatches ? doneMatches.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function hasArchiveDirectory(cwd) {
+    return existsSync(join(cwd, 'docs/archive'));
+}
+export async function validateFileSizes(cwd, limits = DEFAULT_LINE_LIMITS) {
+    const checks = [];
+    for (const [filename, limit] of Object.entries(limits)) {
+        const filePath = join(cwd, filename);
+        if (!existsSync(filePath)) {
+            continue;
+        }
+        const lineCount = await countLines(filePath);
+        if (lineCount > limit) {
+            checks.push({
+                name: `File Size: ${filename}`,
+                passed: false,
+                level: 'warning',
+                message: `${filename} exceeds recommended line limit`,
+                details: `Current: ${lineCount} lines | Limit: ${limit} lines | Overage: ${lineCount - limit} lines`,
+                file: filename,
+            });
+        }
+        else {
+            checks.push({
+                name: `File Size: ${filename}`,
+                passed: true,
+                level: 'info',
+                message: `${filename} is within size limits`,
+                details: `${lineCount}/${limit} lines`,
+                file: filename,
+            });
+        }
+    }
+    return checks;
+}
+export function validateMandatoryFiles(cwd) {
+    const checks = [];
+    for (const file of MANDATORY_FILES) {
+        const filePath = join(cwd, file);
+        const exists = existsSync(filePath);
+        checks.push({
+            name: `Mandatory File: ${file}`,
+            passed: exists,
+            level: exists ? 'info' : 'error',
+            message: exists
+                ? `${file} exists`
+                : `${file} is missing (required for TMS)`,
+            file,
+        });
+    }
+    return checks;
+}
+export async function validatePlaceholders(cwd, ignoreFiles = []) {
+    const checks = [];
+    const filesToScan = [
+        'README.md',
+        'NEXT-TASKS.md',
+        'CLAUDE.md',
+        'FUTURE-ENHANCEMENTS.md',
+        'docs/core/ARCHITECTURE.md',
+        'docs/core/PATTERNS.md',
+        'docs/core/DOMAIN-LOGIC.md',
+    ];
+    for (const file of filesToScan) {
+        if (ignoreFiles.includes(file)) {
+            continue;
+        }
+        const filePath = join(cwd, file);
+        if (!existsSync(filePath)) {
+            continue;
+        }
+        const { found, placeholders } = await scanForPlaceholders(filePath);
+        if (found) {
+            checks.push({
+                name: `Placeholders: ${file}`,
+                passed: false,
+                level: 'warning',
+                message: `${file} contains unreplaced placeholders`,
+                details: `Found: ${placeholders.join(', ')}`,
+                file,
+            });
+        }
+        else {
+            checks.push({
+                name: `Placeholders: ${file}`,
+                passed: true,
+                level: 'info',
+                message: `${file} has no unreplaced placeholders`,
+                file,
+            });
+        }
+    }
+    return checks;
+}
+export async function validateArchiveStatus(cwd) {
+    const checks = [];
+    const nextTasksPath = join(cwd, 'NEXT-TASKS.md');
+    if (!existsSync(nextTasksPath)) {
+        return checks;
+    }
+    const completedCount = await countCompletedTasks(nextTasksPath);
+    const hasArchive = hasArchiveDirectory(cwd);
+    if (completedCount > 10) {
+        checks.push({
+            name: 'Archive Status',
+            passed: false,
+            level: 'warning',
+            message: 'Too many completed tasks in NEXT-TASKS.md',
+            details: `${completedCount} completed tasks should be archived to docs/archive/`,
+            file: 'NEXT-TASKS.md',
+        });
+    }
+    else if (completedCount > 5) {
+        checks.push({
+            name: 'Archive Status',
+            passed: true,
+            level: 'info',
+            message: 'Consider archiving completed tasks soon',
+            details: `${completedCount} completed tasks in NEXT-TASKS.md`,
+            file: 'NEXT-TASKS.md',
+        });
+    }
+    else {
+        checks.push({
+            name: 'Archive Status',
+            passed: true,
+            level: 'info',
+            message: 'Active task list is healthy',
+            details: `${completedCount} completed tasks`,
+            file: 'NEXT-TASKS.md',
+        });
+    }
+    if (!hasArchive && completedCount > 0) {
+        checks.push({
+            name: 'Archive Directory',
+            passed: false,
+            level: 'warning',
+            message: 'No archive directory found',
+            details: 'Create docs/archive/ to store completed sprint history',
+        });
+    }
+    return checks;
+}
+export async function validateProject(cwd, options = {}) {
+    const { strict = false } = options;
+    const userConfig = await loadConfig(cwd);
+    const config = mergeConfig(userConfig);
+    const limits = options.limits || getEffectiveLineLimits(config);
+    const ignoreFiles = config.validation?.ignoreFiles || [];
+    const [fileSizeChecks, mandatoryChecks, placeholderChecks, archiveChecks] = await Promise.all([
+        validateFileSizes(cwd, limits),
+        Promise.resolve(validateMandatoryFiles(cwd)),
+        validatePlaceholders(cwd, ignoreFiles),
+        validateArchiveStatus(cwd),
+    ]);
+    const checks = [
+        ...mandatoryChecks,
+        ...fileSizeChecks,
+        ...placeholderChecks,
+        ...archiveChecks,
+    ];
+    const summary = {
+        total: checks.length,
+        passed: checks.filter((c) => c.passed).length,
+        warnings: checks.filter((c) => c.level === 'warning').length,
+        errors: checks.filter((c) => c.level === 'error').length,
+    };
+    const hasErrors = summary.errors > 0;
+    const hasWarnings = summary.warnings > 0;
+    const passed = strict ? !hasErrors && !hasWarnings : !hasErrors;
+    return {
+        passed,
+        checks,
+        summary,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "cortex-tms",
+  "version": "2.1.0",
+  "description": "The Universal AI-Optimized Project Boilerplate - CLI tool for bootstrapping TMS-structured projects",
+  "type": "module",
+  "bin": {
+    "cortex-tms": "./bin/cortex-tms.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "pnpm run cli:build",
+    "prepublishOnly": "pnpm run build",
+    "cli:dev": "tsx src/cli.ts",
+    "cli:build": "tsc -p tsconfig.cli.json",
+    "cli:test": "node bin/cortex-tms.js --help",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  },
+  "keywords": [
+    "documentation",
+    "boilerplate",
+    "ai",
+    "copilot",
+    "claude",
+    "tms",
+    "cli",
+    "generator",
+    "template"
+  ],
+  "author": "Cortex TMS Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cortex-tms/cortex-tms.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cortex-tms/cortex-tms/issues"
+  },
+  "homepage": "https://github.com/cortex-tms/cortex-tms#readme",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^10.2.2",
+    "ora": "^8.1.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.17.10",
+    "eslint": "^9.17.0",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.17"
+  }
+}

package/templates/.github/copilot-instructions.md

@@ -0,0 +1,28 @@
+# AI Pair Programmer: Collaboration Protocol (TMS v2.0)
+
+## ⚡ Critical Rules (Always Apply)
+
+- **Tech Stack**: [e.g., Next.js 15, TypeScript Strict, Tailwind CSS].
+- **Conventions**: Favor functional programming and composition over inheritance.
+- **Types**: ALWAYS use strict TypeScript. No `any`. No `@ts-ignore`.
+- **Logic**: Before implementing business logic, check `docs/core/DOMAIN-LOGIC.md`.
+
+## 🏗️ Technical Map (Read Order)
+
+AI agents MUST follow this order before proposing code:
+
+1. `NEXT-TASKS.md` (Current context)
+2. `docs/core/DOMAIN-LOGIC.md` (Project rules)
+3. `docs/core/PATTERNS.md` (Coding standards)
+
+## 🚫 Prohibitions
+
+- Never store secrets or API keys in code.
+- Never bypass linting or type-checking.
+- Never implement features not listed in `NEXT-TASKS.md` without asking.
+
+## ✔️ Pre-Submission Checklist
+
+- [ ] Logic verified against DOMAIN-LOGIC.md.
+- [ ] Tests added/updated and passing.
+- [ ] No `console.log` statements remaining.

package/templates/CLAUDE.md

@@ -0,0 +1,18 @@
+# 🤖 Agent Workflow & Persona
+
+## 🎯 Role
+
+Expert Senior Developer. Follow the **"Propose, Justify, Recommend"** framework.
+
+## 💻 CLI Commands
+
+- **Test**: `npm test` or `pnpm test`
+- **Lint**: `npm run lint`
+- **Build**: `npm run build`
+
+## 🛠 Operational Loop
+
+1. Read `NEXT-TASKS.md` to understand the current objective.
+2. Cross-reference `docs/core/PATTERNS.md` for existing code conventions.
+3. If unsure of a term, check `docs/core/GLOSSARY.md`.
+4. Execute TDD (Test-Driven Development).

package/templates/FUTURE-ENHANCEMENTS.md

@@ -0,0 +1,79 @@
+# FUTURE: Planned Enhancements
+
+This is the **living backlog** for [Project Name]. Tasks move from here to `NEXT-TASKS.md` when they become active in the current sprint.
+
+**Purpose**: Keep `NEXT-TASKS.md` focused (< 200 lines) by storing future work here.
+
+---
+
+## 🔴 High Priority (Next 1-2 Months)
+
+### [Feature Category 1]
+
+- **[Feature Name]**: [Brief description of what needs to be built]
+  - **Why**: [User value or technical necessity]
+  - **Effort**: [Estimated time - e.g., 4h, 2 days]
+  - **Dependencies**: [What must be done first - e.g., "Requires auth system"]
+  - **Ref**: [Optional external ticket - e.g., [#42], [PROJ-123]]
+
+- **[Feature Name]**: [Brief description]
+  - **Why**: [User value or technical necessity]
+  - **Effort**: [Estimated time]
+  - **Dependencies**: [What must be done first]
+  - **Ref**: [Optional external ticket]
+
+---
+
+## 🟡 Medium Priority (Next 3-6 Months)
+
+### [Feature Category 2]
+
+- **[Feature Name]**: [Brief description]
+  - **Why**: [User value or technical necessity]
+  - **Effort**: [Estimated time]
+  - **Impact**: [High | Medium | Low]
+  - **Ref**: [Optional external ticket]
+
+---
+
+## 🟢 Low Priority (Backlog / "Someday")
+
+### [Feature Category 3]
+
+- **[Feature Name]**: [Brief description]
+  - **Why**: [User value or technical necessity]
+  - **Effort**: [Estimated time]
+  - **Blocker**: [Why it's not high priority - e.g., "Waiting for Next.js 16 stable"]
+  - **Ref**: [Optional external ticket]
+
+---
+
+## 🧪 Experimental Ideas (R&D)
+
+### [Research Topic 1]
+
+- **[Idea Name]**: [Brief description of what we'd explore]
+  - **Hypothesis**: [What we think might work]
+  - **Success Criteria**: [How we'd know if it's valuable]
+  - **Effort**: [Research time estimate]
+  - **Risk**: [What could go wrong]
+
+---
+
+## ✅ Promotion Criteria
+
+A task moves from FUTURE → NEXT when:
+1. **User Approval**: Explicitly prioritized by project lead
+2. **Dependencies Met**: All blocking tasks are complete
+3. **Capacity Available**: `NEXT-TASKS.md` has < 5 active tasks
+4. **Sprint Alignment**: Fits within current sprint theme
+
+**See**: `docs/core/DOMAIN-LOGIC.md#rule-6-archive-promote` for full protocol
+
+---
+
+## 🗑️ Archive (Rejected / No Longer Relevant)
+
+### [YYYY-MM-DD] - [Rejected Idea Name]
+**Why Rejected**: [Reason - e.g., "User research showed low demand", "Technical complexity too high"]
+**Alternative**: [What we did instead - e.g., "Built simplified version in Sprint 3"]

package/templates/NEXT-TASKS.md

@@ -0,0 +1,20 @@
+# NEXT: Upcoming Tasks
+
+## Active Sprint: [Feature Name]
+
+**Why this matters**: [Briefly describe user value or technical necessity]
+
+| Task | Ref | Effort | Priority | Status |
+| :--- | :--- | :----- | :------- | :----- |
+| **Feature Setup** - Initial scaffold | - | 2h | 🟡 MED | ⬜ Todo |
+
+**Ref Column**:
+- `[#123]` = GitHub Issue
+- `[PROJ-123]` = Jira/other PM tool
+- `-` = No external reference
+
+## 🎯 Definition of Done
+
+- [ ] Tests passing
+- [ ] Documentation updated in `docs/core/`
+- [ ] Code follows `docs/core/PATTERNS.md`

package/templates/README.md

@@ -0,0 +1,172 @@
+# [Project Name]
+
+**[One-line description of what this project does]**
+
+[2-3 sentence overview explaining the problem this project solves and who it's for]
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+- [e.g., Node.js 20+]
+- [e.g., PostgreSQL 15+]
+- [e.g., Package manager: pnpm, npm, yarn]
+
+### Installation
+
+```bash
+# Clone the repository
+git clone [repository-url]
+cd [project-name]
+
+# Install dependencies
+[package-manager] install
+
+# Set up environment variables
+cp .env.example .env
+# Edit .env with your configuration
+
+# Run database migrations (if applicable)
+[migration-command]
+
+# Start development server
+[dev-command]
+```
+
+---
+
+## 📂 Project Structure
+
+```
+.
+├── [folder-name]/          # [Description]
+├── [folder-name]/          # [Description]
+├── docs/
+│   ├── core/              # WARM tier - Technical documentation
+│   └── archive/           # COLD tier - Historical context
+├── NEXT-TASKS.md          # HOT tier - Current sprint
+└── CLAUDE.md              # HOT tier - AI agent workflow
+```
+
+**See**: `docs/core/ARCHITECTURE.md` for detailed system design
+
+---
+
+## 🎯 Features
+
+- **[Feature 1]**: [Brief description and user value]
+- **[Feature 2]**: [Brief description and user value]
+- **[Feature 3]**: [Brief description and user value]
+
+---
+
+## 🛠️ Development
+
+### Available Commands
+
+| Command | Description |
+|:--------|:------------|
+| `[dev-command]` | Start development server |
+| `[build-command]` | Build for production |
+| `[test-command]` | Run test suite |
+| `[lint-command]` | Lint and format code |
+
+### Tech Stack
+
+- **Frontend**: [e.g., Next.js 15, React 18, Tailwind CSS]
+- **Backend**: [e.g., Express, tRPC, Prisma]
+- **Database**: [e.g., PostgreSQL, Redis]
+- **Testing**: [e.g., Vitest, Playwright]
+- **Deployment**: [e.g., Vercel, Railway, Docker]
+
+**See**: `docs/core/DECISIONS.md` for technology choices and rationale
+
+---
+
+## 📖 Documentation
+
+This project uses the [Cortex TMS](https://github.com/[your-org]/cortex-tms) documentation structure:
+
+- **`NEXT-TASKS.md`**: Current sprint and active tasks
+- **`docs/core/ARCHITECTURE.md`**: System design and component map
+- **`docs/core/PATTERNS.md`**: Code conventions and best practices
+- **`docs/core/DOMAIN-LOGIC.md`**: Business rules and constraints
+- **`docs/core/GLOSSARY.md`**: Project terminology
+- **`docs/core/DECISIONS.md`**: Architecture Decision Records (ADRs)
+
+---
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+[test-command]
+
+# Run tests in watch mode
+[test-watch-command]
+
+# Run tests with coverage
+[test-coverage-command]
+```
+
+**Coverage Target**: [e.g., 80% for core modules]
+
+---
+
+## 🚢 Deployment
+
+### Environment Variables
+
+| Variable | Description | Required | Example |
+|:---------|:------------|:---------|:--------|
+| `[VAR_NAME]` | [Description] | Yes/No | `[example-value]` |
+| `[VAR_NAME]` | [Description] | Yes/No | `[example-value]` |
+
+### Production Build
+
+```bash
+# Build for production
+[build-command]
+
+# Start production server
+[start-command]
+```
+
+**See**: `docs/core/ARCHITECTURE.md#deployment-infrastructure` for deployment guide
+
+---
+
+## 🤝 Contributing
+
+This project follows conventional commit standards and uses AI-assisted development workflows.
+
+### Workflow
+
+1. Check `NEXT-TASKS.md` for current priorities
+2. Create a branch: `[type]/[description]` (see `docs/core/GIT-STANDARDS.md`)
+3. Make your changes following `docs/core/PATTERNS.md`
+4. Run tests and linting
+5. Commit with conventional format: `type(scope): subject`
+6. Open a PR using `.github/PULL_REQUEST_TEMPLATE.md`
+
+**See**: `CLAUDE.md` for AI agent collaboration protocol
+
+---
+
+## 📝 License
+
+[License Type - e.g., MIT License]
+
+---
+
+## 🔗 Links
+
+- **Documentation**: [Link to full docs]
+- **Issue Tracker**: [Link to issues]
+- **Changelog**: `docs/archive/` (organized by sprint)
+- **Roadmap**: `FUTURE-ENHANCEMENTS.md`
+
+---
+
+**Built with [Cortex TMS](https://github.com/[your-org]/cortex-tms) - AI-Optimized Project Documentation**