@uoyo/mvtt 2.0.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xiangjie
+
+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,209 @@
+# My-Virtual-TechTeam (MVTT)
+
+A virtual IT team made up of AI agents. Built for [Claude Code](https://claude.ai/claude-code), MVTT turns your IDE into a coordinated squad of Analyst, Architect, Developer, Reviewer, and Tester — each with a clear role, a shared workspace, and enforceable team conventions.
+
+## Why MVTT
+
+- **One-command install** — `npx @uoyo/mvtt install` drops a full skill suite into any project
+- **Claude Code native** — 18 skills auto-discovered from `.claude/skills/`
+- **Bilingual output** — choose `en-US` or `zh-CN` at install time; every skill honors the setting
+- **Shared workspace** — `.ai-agents/` centralizes session state, domain knowledge, config, and output templates
+- **Safe lifecycle** — `install` / `update` / `uninstall` / `doctor` with manifest-based file ownership, so user data is never overwritten
+- **Extensible** — `/mvt-create-skill` lets your team grow its own skills for project-specific workflows
+
+## Installation
+
+```bash
+npx @uoyo/mvtt install
+```
+
+The installer is interactive:
+
+```
+? Select language / 选择语言
+❯ English (en-US)
+  中文 (zh-CN)
+```
+
+Optional flags:
+
+```bash
+npx @uoyo/mvtt install --pattern ddd    # Preset architecture pattern (ddd | clean-architecture | frontend-react)
+```
+
+## Quick Start
+
+1. Run `npx @uoyo/mvtt install` in your project root
+2. Open the project in Claude Code
+3. Run `/mvt-init` to initialize the workspace
+4. Run `/mvt-help` to see all available skills
+5. Follow the guided workflow through your development phases
+
+## CLI Commands
+
+| Command | Purpose |
+|---|---|
+| `npx @uoyo/mvtt install` | First-time install; interactive language selection |
+| `npx @uoyo/mvtt install --pattern <name>` | Install with a preset architecture pattern |
+| `npx @uoyo/mvtt update` | Upgrade to the latest version (user data preserved) |
+| `npx @uoyo/mvtt update --check` | Show version diff without modifying anything |
+| `npx @uoyo/mvtt doctor` | Check installation health and detect manual edits |
+| `npx @uoyo/mvtt uninstall` | Interactive confirmation, then remove generated files (user data preserved) |
+| `npx @uoyo/mvtt --help` | Full CLI help |
+| `npx @uoyo/mvtt --version` | Print version |
+
+## Skills (18 total)
+
+### Workflow Skills (Sequential Phases)
+
+| Skill | Description |
+|-------|-------------|
+| `/mvt-analyze` | Analyze requirements and extract domain concepts |
+| `/mvt-analyze-code` | Reverse-analyze existing code to generate context |
+| `/mvt-design` | Create architecture design based on requirements |
+| `/mvt-implement` | Implement features based on architecture design |
+| `/mvt-review` | Code review for quality and standards compliance |
+| `/mvt-test` | Generate tests to validate implementations |
+
+### Shortcut Skills (Anytime)
+
+| Skill | Description |
+|-------|-------------|
+| `/mvt-fix` | Diagnose and fix bugs or issues |
+| `/mvt-refactor` | Refactor code while preserving behavior |
+
+### Project Management Skills
+
+| Skill | Description |
+|-------|-------------|
+| `/mvt-init` | Initialize or refresh project setup |
+| `/mvt-status` | Show current project and workflow status |
+| `/mvt-config` | Manage framework configuration |
+| `/mvt-sync-context` | Synchronize context with code changes |
+| `/mvt-cleanup` | Clean up workspace artifacts |
+
+### Utility Skills
+
+| Skill | Description |
+|-------|-------------|
+| `/mvt-help` | Show available skills and workflow guidance |
+| `/mvt-create-skill` | Create custom MVTT skills |
+| `/mvt-add-context` | Add or update project context interactively |
+| `/mvt-check-context` | Analyze context token load and optimization |
+| `/mvt-template` | View and customize output templates |
+
+## Standard Workflow
+
+```
+/mvt-analyze → /mvt-design → /mvt-implement → /mvt-review → /mvt-test
+   Analyst       Architect      Developer       Reviewer       Tester
+```
+
+The Conductor (the underlying orchestration logic) keeps session state in `.ai-agents/workspace/session.yaml` so any skill can pick up where the previous one left off.
+
+## Configuration
+
+All preferences live in `.ai-agents/config.yaml`:
+
+```yaml
+version: "2.0"
+
+preferences:
+  language: en-US          # en-US | zh-CN — chosen during install, changeable anytime
+  output:
+    no_emojis: true        # Disable emojis in skill output
+    data_format: yaml      # yaml | json
+
+pattern:
+  active: ""               # Detected via /mvt-init or set via --pattern on install
+  selection:
+    auto_detect: true
+    confirm_with_user: true
+```
+
+Every skill reads this file on activation and enforces the settings through the shared Activation Protocol.
+
+## Architecture Patterns
+
+MVTT ships with first-class knowledge for three patterns (`.ai-agents/knowledge/patterns/`):
+
+- **`ddd`** — Domain-Driven Design (bounded contexts, aggregates, domain events)
+- **`clean-architecture`** — Layered boundaries, dependency inversion
+- **`frontend-react`** — React-specific structural conventions
+
+Each pattern contributes its own review checklist and design guidance that `/mvt-design`, `/mvt-review`, and `/mvt-refactor` automatically consume.
+
+## Runtime Layout
+
+After `install`, your project has:
+
+```
+.claude/skills/mvt-*/SKILL.md       # GENERATED (18 skills, Claude Code entry points)
+
+.ai-agents/
+├── config.yaml                      # CREATE_ONCE (user-editable)
+├── registry.yaml                    # GENERATED (skill metadata)
+├── .mvtt-manifest.json              # GENERATED (install metadata, hashes)
+├── workspace/
+│   ├── session.yaml                 # CREATE_ONCE
+│   ├── project-context.yaml         # CREATE_ONCE
+│   └── artifacts/                   # USER DATA (skill outputs)
+├── skills/_templates/
+│   ├── *-output.md                  # GENERATED (14 templates)
+│   └── custom/                      # USER DATA (your overrides)
+└── knowledge/
+    ├── core/                        # GENERATED (framework-wide principles)
+    ├── patterns/                    # GENERATED (ddd, clean-architecture, frontend-react)
+    ├── principle/                   # USER DATA (team conventions)
+    └── project/                     # USER DATA (domain-specific knowledge)
+```
+
+File classification:
+
+- **GENERATED** — owned by the CLI; overwritten on every `update`
+- **CREATE_ONCE** — created only on first install; never overwritten
+- **USER DATA** — CLI never touches these paths
+
+`doctor` hashes every GENERATED file against the manifest, so manual edits are detected immediately.
+
+## Activation Protocol (Runtime)
+
+Every skill shares a 4-step activation sequence, inlined into each `SKILL.md` at build time:
+
+1. **Load Context** — `session.yaml` + `project-context.yaml` + skill-specific extended context
+2. **Load Config & Apply Preferences** — read `config.yaml`, enforce language and output style
+3. **Pre-flight Checks** — validate prerequisites (workspace initialized, required artifacts exist, etc.)
+4. **Execute** — run skill-specific logic
+
+DRY at source (one shared section per step), flat at runtime (each `SKILL.md` is self-contained — no cross-file reads when Claude Code loads a skill).
+
+## Extending MVTT
+
+Beyond the 18 built-in skills, run `/mvt-create-skill` to scaffold a project-specific skill interactively. Custom skills live under `.ai-agents/skills/` and can override or complement any default behavior (e.g. a `/mvt-test-gherkin` variant that emits Gherkin feature files in your team's house style).
+
+## Development (Contributing to MVTT Itself)
+
+Requirements: Node.js ≥ 18.
+
+```bash
+npm install
+npm run build                       # Compile TypeScript
+npm test                            # Run test suite (66 tests)
+npm test -- --coverage              # With coverage report
+
+# Rebuild skills / templates from sources into any output directory
+node dist/index.js build --out .test-output
+```
+
+Source layout:
+
+- `src/` — CLI TypeScript source (commander-based; uses `prompts` for interactive selection)
+- `sources/skills/<name>/manifest.yaml + business.md` — Skill source files
+- `sources/templates/<name>/manifest.yaml + body.md` — Template source files
+- `sources/sections/*.md` — Shared activation protocol sections (mustache-style blocks)
+- `registry.yaml` — Single source of truth for skill metadata
+- `install-manifest.yaml` — File classification (generated / create_once / user_data)
+
+## License
+
+MIT

package/dist/build/assembler.d.ts

@@ -0,0 +1,6 @@
+export interface AssembleOptions {
+    sourcesDir: string;
+    timestamp?: string;
+}
+export declare function assembleFromManifest(manifestPath: string, options: AssembleOptions): string;
+//# sourceMappingURL=assembler.d.ts.map

package/dist/build/assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../../src/build/assembler.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,eAAe,GACvB,MAAM,CAiBR"}

package/dist/build/assembler.js

@@ -0,0 +1,32 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { loadSection } from "./section-loader.js";
+function buildFrontmatter(fm) {
+    const lines = ["---"];
+    for (const [key, value] of Object.entries(fm)) {
+        if (value.includes("\n") || value.includes("'")) {
+            lines.push(`${key}: "${value.replace(/"/g, '\\"')}"`);
+        }
+        else {
+            lines.push(`${key}: '${value}'`);
+        }
+    }
+    lines.push("---");
+    return lines.join("\n");
+}
+export function assembleFromManifest(manifestPath, options) {
+    const raw = readFileSync(manifestPath, "utf-8");
+    const manifest = parseYaml(raw);
+    const skillDir = path.dirname(manifestPath);
+    const parts = [];
+    parts.push(buildFrontmatter(manifest.frontmatter));
+    parts.push("");
+    for (const section of manifest.sections) {
+        const content = loadSection(section, skillDir, options.sourcesDir);
+        parts.push(content.trimEnd());
+        parts.push("");
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=assembler.js.map

package/dist/build/assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.js","sourceRoot":"","sources":["../../src/build/assembler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,SAAS,gBAAgB,CAAC,EAA0B;IAClD,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,KAAK,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAOD,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,OAAwB;IAExB,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAa,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/build/section-loader.d.ts

@@ -0,0 +1,4 @@
+import type { Section } from "../types/manifest.js";
+export declare function applyParams(template: string, params: Record<string, unknown>): string;
+export declare function loadSection(section: Section, skillDir: string, sourcesDir: string): string;
+//# sourceMappingURL=section-loader.d.ts.map

package/dist/build/section-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-loader.d.ts","sourceRoot":"","sources":["../../src/build/section-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAuCpD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAIR;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAiBR"}

package/dist/build/section-loader.js

@@ -0,0 +1,55 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+const BLOCK_PATTERN = /\{\{#(\w+)\}\}([\s\S]*?)\{\{\/\1\}\}\n?/g;
+const VAR_PATTERN = /\{\{(\w+|\.)?\}\}/g;
+function replaceVars(template, vars) {
+    return template.replace(VAR_PATTERN, (_match, key) => {
+        if (key === ".")
+            return String(vars["."] ?? "");
+        const val = vars[key];
+        if (val === undefined || val === null)
+            return "";
+        return String(val);
+    });
+}
+function expandBlocks(template, params) {
+    return template.replace(BLOCK_PATTERN, (_match, key, rawBody) => {
+        const val = params[key];
+        if (val === undefined || val === null || val === false)
+            return "";
+        const body = rawBody.replace(/^\n/, "");
+        if (Array.isArray(val)) {
+            return val
+                .map((item) => {
+                if (typeof item === "object" && item !== null) {
+                    return replaceVars(body, item).trimEnd();
+                }
+                return replaceVars(body, { ".": item }).trimEnd();
+            })
+                .join("\n");
+        }
+        return replaceVars(body, params);
+    });
+}
+export function applyParams(template, params) {
+    let result = expandBlocks(template, params);
+    result = replaceVars(result, params);
+    return result;
+}
+export function loadSection(section, skillDir, sourcesDir) {
+    switch (section.type) {
+        case "inline":
+            return section.content;
+        case "file": {
+            const filePath = path.resolve(skillDir, section.source);
+            return readFileSync(filePath, "utf-8");
+        }
+        case "shared":
+        case "template": {
+            const filePath = path.resolve(sourcesDir, section.source);
+            const content = readFileSync(filePath, "utf-8");
+            return applyParams(content, section.params ?? {});
+        }
+    }
+}
+//# sourceMappingURL=section-loader.js.map

package/dist/build/section-loader.js.map

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

package/dist/build/validator.d.ts

@@ -0,0 +1,6 @@
+export interface ValidationError {
+    file: string;
+    message: string;
+}
+export declare function validateManifest(manifestPath: string, sourcesDir: string): ValidationError[];
+//# sourceMappingURL=validator.d.ts.map

package/dist/build/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/build/validator.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AA6CD,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,eAAe,EAAE,CAqDnB"}

package/dist/build/validator.js

@@ -0,0 +1,77 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+function validateSectionRef(section, skillDir, sourcesDir) {
+    if (section.type === "file") {
+        const p = path.resolve(skillDir, section.source);
+        if (!existsSync(p))
+            return `File not found: ${section.source} (resolved: ${p})`;
+    }
+    if (section.type === "shared" || section.type === "template") {
+        const p = path.resolve(sourcesDir, section.source);
+        if (!existsSync(p))
+            return `Shared section not found: ${section.source} (resolved: ${p})`;
+    }
+    return null;
+}
+function checkParamCompleteness(sectionSource, sourcesDir, params) {
+    const errors = [];
+    const filePath = path.resolve(sourcesDir, sectionSource);
+    if (!existsSync(filePath))
+        return errors;
+    const content = readFileSync(filePath, "utf-8");
+    const stripped = content.replace(/\{\{#(\w+)\}\}[\s\S]*?\{\{\/\1\}\}/g, "");
+    const topLevelVars = stripped.match(/\{\{(\w+)\}\}/g) ?? [];
+    const requiredParams = new Set(topLevelVars.map((v) => v.slice(2, -2)));
+    for (const varName of requiredParams) {
+        if (varName === ".")
+            continue;
+        if (!params || !(varName in params)) {
+            errors.push(`Missing param "${varName}" for section "${sectionSource}"`);
+        }
+    }
+    return errors;
+}
+export function validateManifest(manifestPath, sourcesDir) {
+    const errors = [];
+    if (!existsSync(manifestPath)) {
+        errors.push({ file: manifestPath, message: "Manifest file not found" });
+        return errors;
+    }
+    let manifest;
+    try {
+        const raw = readFileSync(manifestPath, "utf-8");
+        manifest = parseYaml(raw);
+    }
+    catch (e) {
+        errors.push({ file: manifestPath, message: `Invalid YAML: ${e}` });
+        return errors;
+    }
+    if (!manifest.name) {
+        errors.push({ file: manifestPath, message: 'Missing required field "name"' });
+    }
+    if (!manifest.output) {
+        errors.push({ file: manifestPath, message: 'Missing required field "output"' });
+    }
+    if (!manifest.sections || !Array.isArray(manifest.sections)) {
+        errors.push({ file: manifestPath, message: 'Missing or invalid "sections" array' });
+        return errors;
+    }
+    const skillDir = path.dirname(manifestPath);
+    for (let i = 0; i < manifest.sections.length; i++) {
+        const section = manifest.sections[i];
+        const refErr = validateSectionRef(section, skillDir, sourcesDir);
+        if (refErr) {
+            errors.push({ file: manifestPath, message: `sections[${i}]: ${refErr}` });
+        }
+        if ((section.type === "shared" || section.type === "template") &&
+            section.params) {
+            const paramErrors = checkParamCompleteness(section.source, sourcesDir, section.params);
+            for (const pe of paramErrors) {
+                errors.push({ file: manifestPath, message: `sections[${i}]: ${pe}` });
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validator.js.map

package/dist/build/validator.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function run(argv: string[]): Promise<void>;
+//# 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":"AAQA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvD"}

package/dist/cli.js

@@ -0,0 +1,49 @@
+import { Command } from "commander";
+import { buildCommand } from "./commands/build.js";
+import { installCommand } from "./commands/install.js";
+import { updateCommand } from "./commands/update.js";
+import { doctorCommand } from "./commands/doctor.js";
+import { uninstallCommand } from "./commands/uninstall.js";
+import { getVersion } from "./commands/shared.js";
+export async function run(argv) {
+    const program = new Command();
+    program
+        .name("mvtt")
+        .description("My Virtual Tech Team CLI")
+        .version(getVersion(), "-v, --version");
+    program
+        .command("install")
+        .description("Install MVTT into current project")
+        .option("--pattern <name>", "Set architecture pattern (ddd, clean-architecture, etc.)")
+        .action(async (opts) => {
+        await installCommand(opts);
+    });
+    program
+        .command("update")
+        .description("Update MVTT to latest version")
+        .option("--check", "Only report version diff, do not modify")
+        .action((opts) => {
+        updateCommand(opts);
+    });
+    program
+        .command("doctor")
+        .description("Check installation health")
+        .action(() => {
+        doctorCommand();
+    });
+    program
+        .command("uninstall")
+        .description("Remove MVTT generated files")
+        .action(async () => {
+        await uninstallCommand();
+    });
+    program
+        .command("build")
+        .description("Build skills and templates from sources (dev)")
+        .option("--out <dir>", "Output directory (default: cwd)")
+        .action((opts) => {
+        buildCommand(opts);
+    });
+    await program.parseAsync(argv, { from: "user" });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,0BAA0B,CAAC;SACvC,OAAO,CAAC,UAAU,EAAE,EAAE,eAAe,CAAC,CAAC;IAE1C,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC,kBAAkB,EAAE,0DAA0D,CAAC;SACtF,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,SAAS,EAAE,yCAAyC,CAAC;SAC5D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,aAAa,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,GAAG,EAAE;QACX,aAAa,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,gBAAgB,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,aAAa,EAAE,iCAAiC,CAAC;SACxD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,YAAY,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IAEL,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/commands/build.d.ts

@@ -0,0 +1,5 @@
+export interface BuildOptions {
+    out?: string;
+}
+export declare function buildCommand(options?: BuildOptions): void;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,IAAI,CA4C7D"}

package/dist/commands/build.js

@@ -0,0 +1,46 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { assembleFromManifest } from "../build/assembler.js";
+import { validateManifest } from "../build/validator.js";
+export function buildCommand(options = {}) {
+    const projectRoot = process.cwd();
+    const sourcesDir = path.resolve(projectRoot, "sources");
+    const outputRoot = options.out ? path.resolve(options.out) : projectRoot;
+    const timestamp = new Date().toISOString();
+    let totalFiles = 0;
+    let totalErrors = 0;
+    for (const kind of ["skills", "templates"]) {
+        const baseDir = path.resolve(sourcesDir, kind);
+        if (!existsSync(baseDir))
+            continue;
+        for (const entry of readdirSync(baseDir)) {
+            const manifestPath = path.join(baseDir, entry, "manifest.yaml");
+            if (!existsSync(manifestPath))
+                continue;
+            const errors = validateManifest(manifestPath, sourcesDir);
+            if (errors.length > 0) {
+                for (const err of errors) {
+                    console.error(`[ERROR] ${err.file}: ${err.message}`);
+                }
+                totalErrors += errors.length;
+                continue;
+            }
+            const raw = readFileSync(manifestPath, "utf-8");
+            const manifest = parseYaml(raw);
+            const content = assembleFromManifest(manifestPath, {
+                sourcesDir,
+                timestamp,
+            });
+            const outPath = path.resolve(outputRoot, manifest.output);
+            mkdirSync(path.dirname(outPath), { recursive: true });
+            writeFileSync(outPath, content, "utf-8");
+            console.log(`[OK] ${manifest.output}`);
+            totalFiles++;
+        }
+    }
+    console.log(`\nBuild complete: ${totalFiles} files generated, ${totalErrors} errors.`);
+    if (totalErrors > 0)
+        process.exit(1);
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,MAAM,UAAU,YAAY,CAAC,UAAwB,EAAE;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAEzE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAU,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAEnC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;YAChE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;gBAAE,SAAS;YAExC,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAC1D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;oBACzB,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvD,CAAC;gBACD,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAa,SAAS,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,YAAY,EAAE;gBACjD,UAAU;gBACV,SAAS;aACV,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1D,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAEzC,OAAO,CAAC,GAAG,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACvC,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qBAAqB,UAAU,qBAAqB,WAAW,UAAU,CAAC,CAAC;IACvF,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/commands/doctor.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAOA,wBAAgB,aAAa,IAAI,IAAI,CAgEpC"}