workspace-maxxing 0.1.0

package/dist/scripts/scaffold.js

@@ -0,0 +1,279 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffoldWorkspace = scaffoldWorkspace;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function scaffoldWorkspace(options) {
+    const { name, stages, output, force = false } = options;
+    if (!stages || stages.length === 0) {
+        throw new Error('stages list cannot be empty');
+    }
+    const outputDir = path.resolve(output);
+    if (fs.existsSync(outputDir)) {
+        if (!force) {
+            throw new Error(`Output directory already exists: ${outputDir} (use --force to overwrite)`);
+        }
+        fs.rmSync(outputDir, { recursive: true, force: true });
+    }
+    fs.mkdirSync(outputDir, { recursive: true });
+    const systemMd = generateSystemMd(name, stages);
+    fs.writeFileSync(path.join(outputDir, 'SYSTEM.md'), systemMd);
+    const contextMd = generateContextMd(name, stages);
+    fs.writeFileSync(path.join(outputDir, 'CONTEXT.md'), contextMd);
+    const metaDir = path.join(outputDir, '00-meta');
+    fs.mkdirSync(metaDir, { recursive: true });
+    fs.writeFileSync(path.join(metaDir, 'tools.md'), generateToolsMd());
+    fs.writeFileSync(path.join(metaDir, 'execution-log.md'), generateExecutionLogMd(stages));
+    fs.writeFileSync(path.join(metaDir, 'CONTEXT.md'), `# 00-meta Context\n\nMetadata and tool inventory for the ${name} workspace.\n`);
+    for (const stage of stages) {
+        const stageDir = path.join(outputDir, stage);
+        fs.mkdirSync(stageDir, { recursive: true });
+        fs.writeFileSync(path.join(stageDir, 'CONTEXT.md'), generateStageContextMd(name, stage, stages));
+    }
+    fs.writeFileSync(path.join(outputDir, 'README.md'), generateReadmeMd(name, stages));
+    console.log(`Workspace "${name}" scaffolded at: ${outputDir}`);
+}
+function generateSystemMd(name, stages) {
+    const folderRows = stages
+        .map((stage, index) => `| ${index + 1} | \`${stage}/\` | ${stageDescription(stage)} |`)
+        .join('\n');
+    return `# ${name} — System Prompt
+
+## Role
+You are an AI assistant operating inside the ${name} workspace. Follow stage boundaries and route tasks through stage-specific CONTEXT files.
+
+## Folder Map
+
+| Stage | Folder | Purpose |
+|------:|--------|---------|
+${folderRows}
+| meta | \`00-meta/\` | Workspace configuration, tool inventory, and session notes |
+
+## Workflow Rules
+1. Read \`SYSTEM.md\` first, then root \`CONTEXT.md\`.
+2. Load only one stage \`CONTEXT.md\` at a time unless handoff explicitly requires another stage.
+3. Keep information canonical; do not duplicate facts across files.
+4. Maintain one-way stage dependencies from earlier stage numbers to later stage numbers.
+
+## Scope Guardrails
+- Build and maintain workflow documentation, not product implementation code.
+- Keep stage outputs as markdown artifacts (plans, checklists, prompts, routing notes).
+- If asked to build the product itself, capture that request as workflow requirements and stay in ICM workspace scope.
+
+## Sequential Execution Protocol
+1. Complete stages strictly in ascending numeric order.
+2. Record stage completion in \`00-meta/execution-log.md\` before moving to the next stage.
+3. Do not produce final deliverables until all prior stage checkboxes are complete.
+
+## Stage Boundaries
+- Each numbered folder is an execution stage.
+- A stage may consume upstream outputs but must not redefine upstream facts.
+- Cross-stage jumps require explicit routing through root \`CONTEXT.md\`.
+
+## Tooling Policy
+- Check \`00-meta/tools.md\` before proposing tool installation.
+- Document approved tooling changes in \`00-meta/tools.md\`.
+`;
+}
+function generateContextMd(name, stages) {
+    const routingRows = stages
+        .map((stage) => `| Work in ${stage} tasks | \`${stage}/CONTEXT.md\` | Stage contract and required outputs |`)
+        .join('\n');
+    const handoffs = stages
+        .map((stage, index) => {
+        const nextStage = stages[index + 1];
+        return nextStage
+            ? `- \`${stage}\` -> \`${nextStage}\` when completion criteria are met`
+            : `- \`${stage}\` -> deliver final output and close loop`;
+    })
+        .join('\n');
+    return `# ${name} — Context Router
+
+## How to Use This File
+Use this file to route each task to the smallest required context scope.
+
+## Task Routing
+This routing table maps task intent to the correct stage context.
+
+| When you need to... | Load | Why |
+|---------------------|------|-----|
+| Understand workspace constraints | \`SYSTEM.md\` | Global rules and stage boundaries |
+${routingRows}
+| Check available tools | \`00-meta/tools.md\` | Tool inventory and approval status |
+
+## Loading Order
+1. \`SYSTEM.md\` (always)
+2. This root \`CONTEXT.md\`
+3. One relevant stage \`CONTEXT.md\`
+4. Only the task files needed for that stage
+
+## Scope Guardrails
+- Route domain requests into workflow design steps and markdown deliverables.
+- Do not scaffold backend, frontend, or runtime product source files from this router.
+- Keep outputs file-structured and markdown-first across numbered workflow folders.
+
+## Sequential Routing Contract
+- Route only to the earliest incomplete stage in \`00-meta/execution-log.md\`.
+- Refuse jumps to later stages when earlier stages are not marked complete.
+- Append handoff notes for each completed stage before routing onward.
+
+## Stage Handoff Routing
+${handoffs}
+
+## Escalation
+Escalate when required sections are missing, dependencies are contradictory, or no valid stage route can satisfy the task.
+`;
+}
+function generateStageContextMd(name, stage, stages) {
+    const stageIndex = stages.indexOf(stage);
+    const previousStage = stageIndex > 0 ? stages[stageIndex - 1] : undefined;
+    const nextStage = stageIndex >= 0 && stageIndex < stages.length - 1
+        ? stages[stageIndex + 1]
+        : undefined;
+    const dependencyLine = previousStage
+        ? `- ${previousStage}`
+        : '- None (entry stage)';
+    const handoffLine = nextStage
+        ? `- After completion, hand off outputs to ${nextStage}`
+        : '- This is the terminal stage. Package and deliver final output.';
+    return `# ${stage} — Context
+
+## Purpose
+This folder executes the ${stage} stage of the ${name} workflow.
+
+## Inputs
+- Required data artifacts for ${stage}
+- Upstream context from previous stage when applicable
+
+## Outputs
+- Stage-specific deliverables for downstream consumption
+- Updated markdown artifacts needed by the next stage
+
+## Dependencies
+${dependencyLine}
+
+## Required Evidence
+- Update \`00-meta/execution-log.md\` to mark ${stage} complete before handoff.
+- Link or reference the markdown artifacts produced in this stage.
+
+## Completion Criteria
+- Required outputs are produced and non-empty
+- Outputs conform to stage purpose and markdown-first workflow format
+- Handoff notes are updated for downstream stage
+
+## Handoff
+${handoffLine}
+`;
+}
+function generateToolsMd() {
+    return `## Tool Inventory
+
+## Installed Tools
+
+| Tool | Version | Manager | Installed |
+|------|---------|---------|-----------|
+| — | — | — | — |
+
+## Pending Tools
+
+List tools that are proposed but not yet approved.
+`;
+}
+function generateExecutionLogMd(stages) {
+    return `# Execution Log
+
+## Stage Checklist
+
+${stages.map((stage) => `- [ ] ${stage}`).join('\n')}
+
+## Rules
+
+1. Mark a stage complete only after its completion criteria are satisfied.
+2. Stages must be checked in ascending numerical order.
+3. Every checked stage must have corresponding evidence notes.
+
+## Evidence Notes
+
+${stages.map((stage) => `### ${stage}\n- Artifacts:\n- Handoff Summary:\n`).join('\n')}`;
+}
+function generateReadmeMd(name, stages) {
+    return `# ${name} Workspace
+
+## Structure
+
+${stages.map((s) => `- \`${s}/\``).join('\n')}
+- \`00-meta/\`
+
+## Usage
+
+1. Follow the workflow stages in order
+2. Load CONTEXT.md files selectively — only what you need
+3. Update 00-meta/execution-log.md after each completed stage
+4. Keep outputs in stage folders as markdown workflow artifacts
+5. Run validate.ts to check ICM compliance
+`;
+}
+function stageDescription(stage) {
+    const descriptions = {
+        '01-input': 'Input collection and validation',
+        '02-process': 'Processing and transformation',
+        '03-output': 'Output generation and delivery',
+    };
+    return descriptions[stage] || `Stage: ${stage}`;
+}
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    const parseArg = (flag) => {
+        const idx = args.indexOf(flag);
+        return idx !== -1 ? args[idx + 1] : undefined;
+    };
+    const hasFlag = (flag) => args.includes(flag);
+    const name = parseArg('--name');
+    const stagesStr = parseArg('--stages');
+    const output = parseArg('--output');
+    if (!name || !stagesStr || !output) {
+        console.error('Usage: node scaffold.ts --name <name> --stages <s1,s2,...> --output <path> [--force]');
+        process.exit(1);
+    }
+    const stages = stagesStr.split(',').map((s) => s.trim()).filter(Boolean);
+    scaffoldWorkspace({
+        name,
+        stages,
+        output,
+        force: hasFlag('--force'),
+    });
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scripts/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/scripts/scaffold.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,8CA0CC;AApDD,uCAAyB;AACzB,2CAA6B;AAS7B,SAAgB,iBAAiB,CAAC,OAAwB;IACxD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAExD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,6BAA6B,CAAC,CAAC;QAC9F,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE9D,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC;IAEhE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC;IACpE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IACzF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,4DAA4D,IAAI,eAAe,CAAC,CAAC;IAEpI,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC7C,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EACjC,sBAAsB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAC5C,CAAC;IACJ,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAEpF,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,oBAAoB,SAAS,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,MAAgB;IACtD,MAAM,UAAU,GAAG,MAAM;SACtB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,GAAG,CAAC,QAAQ,KAAK,SAAS,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC;SACtF,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,KAAK,IAAI;;;+CAG6B,IAAI;;;;;;EAMjD,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BX,CAAC;AACF,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,MAAgB;IACvD,MAAM,WAAW,GAAG,MAAM;SACvB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,KAAK,cAAc,KAAK,uDAAuD,CAAC;SAC5G,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,QAAQ,GAAG,MAAM;SACpB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,OAAO,SAAS;YACd,CAAC,CAAC,OAAO,KAAK,WAAW,SAAS,qCAAqC;YACvE,CAAC,CAAC,OAAO,KAAK,2CAA2C,CAAC;IAC9D,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,KAAK,IAAI;;;;;;;;;;;EAWhB,WAAW;;;;;;;;;;;;;;;;;;;;EAoBX,QAAQ;;;;CAIT,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY,EAAE,KAAa,EAAE,MAAgB;IAC3E,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,SAAS,GAAG,UAAU,IAAI,CAAC,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;QACjE,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;QACxB,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,cAAc,GAAG,aAAa;QAClC,CAAC,CAAC,KAAK,aAAa,EAAE;QACtB,CAAC,CAAC,sBAAsB,CAAC;IAE3B,MAAM,WAAW,GAAG,SAAS;QAC3B,CAAC,CAAC,2CAA2C,SAAS,EAAE;QACxD,CAAC,CAAC,iEAAiE,CAAC;IAEtE,OAAO,KAAK,KAAK;;;2BAGQ,KAAK,iBAAiB,IAAI;;;gCAGrB,KAAK;;;;;;;;EAQnC,cAAc;;;gDAGgC,KAAK;;;;;;;;;EASnD,WAAW;CACZ,CAAC;AACF,CAAC;AAED,SAAS,eAAe;IACtB,OAAO;;;;;;;;;;;CAWR,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAgB;IAC9C,OAAO;;;;EAIP,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;EAUlD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,sCAAsC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,MAAgB;IACtD,OAAO,KAAK,IAAI;;;;EAIhB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;CAU5C,CAAC;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,YAAY,GAA2B;QAC3C,UAAU,EAAE,iCAAiC;QAC7C,YAAY,EAAE,+BAA+B;QAC7C,WAAW,EAAE,gCAAgC;KAC9C,CAAC;IACF,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,UAAU,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAsB,EAAE;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE/D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEpC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC;QACtG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEzE,iBAAiB,CAAC;QAChB,IAAI;QACJ,MAAM;QACN,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/scripts/validate.d.ts

@@ -0,0 +1,11 @@
+export interface CheckResult {
+    name: string;
+    passed: boolean;
+    message: string;
+}
+export interface ValidationResult {
+    passed: boolean;
+    checks: CheckResult[];
+}
+export declare function validateWorkspace(workspacePath: string): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/scripts/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/scripts/validate.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAmDD,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,CA2RzE"}