@kleber.mottajr/juninho 1.1.0 → 1.3.0

package/README.md

@@ -1,6 +1,6 @@
 # juninho
 
-Bootstrap the **Agentic Coding Framework** (framework.md) into any [OpenCode](https://opencode.ai) project in a single command.
+Bootstrap the **Agentic Coding Framework** into any [OpenCode](https://opencode.ai) project in a single command. Multi-stack support for Node.js, Python, Go, Java/Kotlin, and generic projects.
 
 ## Install
 
@@ -14,29 +14,115 @@ npm install -g @kleber.mottajr/juninho
 # Navigate to your project
 cd my-opencode-project
 
-# Run setup — one command, everything configured
+# Run setup — auto-detects project type
 juninho setup
 
+# Or specify type explicitly
+juninho setup --type python
+
 # Output:
 # [juninho] Installing Agentic Coding Framework...
+# [juninho] ✓ Project type: Python
 # [juninho] ✓ Framework installed successfully!
 # [juninho] Open OpenCode — /j.plan, /j.spec and /j.implement are ready.
 ```
 
-## What it does
+### Supported project types
 
-`juninho setup` automatically creates:
+| Type | Detection | Skills |
+|------|-----------|--------|
+| `node-nextjs` | `package.json` with `next` dep | 9 (all skills) |
+| `node-generic` | `package.json` without `next` | 5 |
+| `python` | `pyproject.toml`, `requirements.txt`, `setup.py` | 5 |
+| `go` | `go.mod` | 5 |
+| `java` | `pom.xml`, `build.gradle`, `build.gradle.kts` | 5 |
+| `generic` | Fallback | 4 |
 
-- **9 agents** in `.opencode/agents/` (j.planner, j.spec-writer, j.implementer, j.validator, j.reviewer, j.plan-reviewer, j.unify, j.explore, j.librarian)
-- **9 skills** in `.opencode/skills/` (j.test-writing, j.page-creation, j.api-route-creation, j.server-action-creation, j.schema-migration, j.agents-md-writing, j.domain-doc-writing, j.principle-doc-writing, j.shell-script-writing)
-- **11 plugins** in `.opencode/plugins/` (auto-discovered by OpenCode)
-- **4 tools** in `.opencode/tools/` (find-pattern, next-version, lsp, ast-grep)
-- **14 slash commands** in `.opencode/commands/` (/j.plan, /j.spec, /j.implement, /j.sync-docs, /j.init-deep, /j.start-work, /j.handoff, /j.ulw-loop, /j.check, /j.lint, /j.test, /j.pr-review, /j.status, /j.unify)
-- **State files** for persistent context and execution tracking
-- **Docs scaffold** with AGENTS.md, domain index, principles docs, and manifest
-- **Support scripts** in `.opencode/scripts/` for pre-commit, related tests, structure lint, and full checks
+Java projects with Kotlin (`build.gradle.kts` with kotlin plugin or `.kt` files) automatically get Kotlin-specific lint (ktlint/detekt), test patterns, and skills.
+
+---
+
+## How It Works
+
+The framework orchestrates a multi-agent AI workflow for spec-driven development. The developer never codes directly — instead, specialized agents handle planning, implementation, validation, and closeout through slash commands.
+
+### Specification & Planning
+
+`/j.spec` conducts a 5-phase interview (Discovery → Requirements → Contract → Data → Review) with background codebase and external research. `/j.plan` runs 3 phases: Metis (intent analysis), Prometheus (interview + decomposition), and Momus (executability review). Both require explicit developer approval.
+
+![Spec & Plan Sequence](juninho-seq-spec-plan.png)
+
+### Implementation, Verification & Closeout
+
+`/j.implement` executes wave-by-wave with git worktrees for parallelism. Each task follows the READ → ACT → COMMIT → VALIDATE loop. `@j.validator` gates every task against the spec. Pre-commit hooks run lint + related tests. `/j.check` runs repo-wide verification. `/j.unify` reconciles delivery, merges worktrees, updates docs, and creates a PR.
+
+![Implement Sequence](juninho-seq-implement.png)
+
+### Context Injection & Plugin Architecture
+
+12 plugins intercept every tool call across 5 tiers to inject context and enforce quality. External knowledge flows through Context7 (library docs) and Context-Mode (semantic search) MCP servers.
 
-Then patches `opencode.json` with agent definitions and Context7 MCP.
+![Context Injection Sequence](juninho-seq-context.png)
+
+| Tier | Mechanism | What it provides |
+|------|-----------|-----------------|
+| **1** | `j.directory-agents-injector` | Hierarchical AGENTS.md (root → parent → current dir) |
+| **2** | `j.carl-inject` (CARL) | Content-aware principles + domain docs via keyword matching (≤8KB) |
+| **3** | `j.skill-inject` | File pattern → SKILL.md injection (e.g., `*.test.ts` → test-writing skill) |
+| **4** | Plan `<skills>` declarations | Per-task required skills from plan.md |
+| **5** | State files + `j.memory` | Cross-session persistent context |
+
+### Agent Roles
+
+| Agent | Model | Role |
+|-------|-------|------|
+| `@j.spec-writer` | Strong | 5-phase interview → spec.md |
+| `@j.planner` | Strong | 3-phase planning → plan.md |
+| `@j.implementer` | Medium | Wave execution, READ→ACT→COMMIT→VALIDATE |
+| `@j.validator` | Medium | Spec-first validation, BLOCK/FIX/NOTE/APPROVED |
+| `@j.plan-reviewer` | Medium | Executability gate for plans |
+| `@j.reviewer` | Medium | Post-PR advisory review (read-only) |
+| `@j.unify` | Medium | Closeout: merge, docs, PR |
+| `@j.explore` | Weak | Read-only codebase research |
+| `@j.librarian` | Weak | External docs via Context7 + Context-Mode MCP |
+
+---
+
+## What it creates
+
+`juninho setup` automatically generates:
+
+- **9 agents** in `.opencode/agents/`
+- **4–9 skills** in `.opencode/skills/` (filtered by project type)
+- **12 plugins** in `.opencode/plugins/` (auto-discovered by OpenCode)
+- **4 tools** in `.opencode/tools/` (find-pattern, next-version, lsp, ast-grep)
+- **15 slash commands** in `.opencode/commands/`
+- **State files** for persistent context and execution tracking
+- **Docs scaffold** with AGENTS.md, domain index, principles docs, and manifest
+- **Support scripts** in `.opencode/scripts/` for pre-commit, related tests, structure lint, and full checks
+- **skill-map.json** for dynamic skill-to-pattern mapping
+
+Then patches `opencode.json` with agent definitions, Context7 MCP, and Context-Mode MCP.
+
+### Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/j.spec` | Feature specification via 5-phase interview |
+| `/j.plan` | Strategic planning with 3-phase process |
+| `/j.implement` | Execute plan wave-by-wave with validation |
+| `/j.check` | Repo-wide verification (typecheck + lint + tests) |
+| `/j.unify` | Closeout: merge worktrees, update docs, create PR |
+| `/j.pr-review` | Advisory post-PR code review |
+| `/j.start-work` | Begin work session with context loading |
+| `/j.handoff` | End-of-session handoff document |
+| `/j.status` | Show execution state and task progress |
+| `/j.ulw-loop` | Ultra work loop (parallel implementation) |
+| `/j.init-deep` | Deep codebase initialization (AGENTS.md hierarchy) |
+| `/j.sync-docs` | Refresh domain/principles documentation |
+| `/j.finish-setup` | Scan codebase, generate dynamic skills + docs |
+| `/j.lint` | Run structure lint on staged files |
+| `/j.test` | Run tests related to staged files |
 
 ## Idempotency
 
@@ -48,6 +134,19 @@ Running `juninho setup` twice is safe — it detects `.opencode/.juninho-install
 juninho setup --force
 ```
 
+## CLI Options
+
+```bash
+juninho setup [dir] [options]
+
+Options:
+  --force          Force reinstall even if already configured
+  --type <value>   Project type: node-nextjs, node-generic, python, go, java, generic
+  --no-tty         Non-interactive mode (skip prompts)
+  --version        Show version number
+  --help           Show help
+```
+
 ## License
 
 MIT

package/dist/cli.js

@@ -6,39 +6,47 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const installer_js_1 = require("./installer.js");
 const path_1 = __importDefault(require("path"));
+const project_types_js_1 = require("./project-types.js");
 const { version: VERSION } = require("../package.json");
 const args = process.argv.slice(2);
 const command = args[0] ?? "";
 const forceFlag = args.includes("--force");
-const targetDir = args.find(a => !a.startsWith("--") && a !== command) ?? process.cwd();
+// Parse --type flag
+const typeIdx = args.indexOf("--type");
+const typeValue = typeIdx !== -1 ? args[typeIdx + 1] : undefined;
+const targetDir = args.find((a, i) => !a.startsWith("--") && a !== command && i !== typeIdx + 1) ?? process.cwd();
 function showHelp() {
     console.log(`
 juninho v${VERSION} — Agentic Coding Framework bootstrapper for OpenCode
-
-Usage:
-  juninho <command> [project-dir] [options]
-
-Commands:
-  setup [dir] [--force]   Install the framework into a project
-
+
+Usage:
+  juninho <command> [project-dir] [options]
+
+Commands:
+  setup [dir] [--force]   Install the framework into a project
+
 Options:
   --force                 Reinstall even if already configured
+  --type <type>           Set project type (skips auto-detection)
+                          Values: ${project_types_js_1.VALID_PROJECT_TYPES.join(", ")}
   --version, -v           Show juninho version
   --help, -h              Show this help message
-
-Model Tiers:
-  Strong  → Planning & spec writing    (default: claude-opus-4.6)
-  Medium  → Implementation & review    (default: claude-sonnet-4.6)
-  Weak    → Research & exploration     (default: claude-haiku-4.5)
-
-  During setup, juninho detects available models via 'opencode models'
-  and lets you choose the best model for each tier.
-  To reconfigure models, run 'juninho setup --force'.
-
-Examples:
-  juninho setup                    Install with auto-detected models
-  juninho setup ./my-project       Install into a specific directory
-  juninho setup --force            Reinstall & reconfigure models
+
+Model Tiers:
+  Strong  → Planning & spec writing    (default: claude-opus-4.6)
+  Medium  → Implementation & review    (default: claude-sonnet-4.6)
+  Weak    → Research & exploration     (default: claude-haiku-4.5)
+
+  During setup, juninho detects available models via 'opencode models'
+  and lets you choose the best model for each tier.
+  To reconfigure models, run 'juninho setup --force'.
+
+Examples:
+  juninho setup                              Auto-detect stack and models
+  juninho setup ./my-project                 Install into a specific directory
+  juninho setup --type python                Force Python project type
+  juninho setup --type java ./spring-app     Java/Kotlin project (Kotlin auto-detected)
+  juninho setup --force                      Reinstall & reconfigure models
 `);
 }
 function showVersion() {
@@ -51,7 +59,16 @@ else if (command === "--version" || command === "-v") {
     showVersion();
 }
 else if (command === "setup") {
-    (0, installer_js_1.runSetup)(path_1.default.resolve(targetDir), { force: forceFlag })
+    // Validate --type if provided
+    if (typeValue !== undefined && !project_types_js_1.VALID_PROJECT_TYPES.includes(typeValue)) {
+        console.error(`[juninho] Invalid project type: ${typeValue}`);
+        console.error(`[juninho] Valid types: ${project_types_js_1.VALID_PROJECT_TYPES.join(", ")}`);
+        process.exit(1);
+    }
+    (0, installer_js_1.runSetup)(path_1.default.resolve(targetDir), {
+        force: forceFlag,
+        type: typeValue,
+    })
         .then(() => process.exit(0))
         .catch((e) => {
         console.error("[juninho] Error:", e.message);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AACA,iDAAyC;AACzC,gDAAuB;AAEvB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAA;AAE9E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAClC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;AAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;AAEvF,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;WACH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjB,CAAC,CAAA;AACF,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACtB,CAAC;AAED,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IAC/D,QAAQ,EAAE,CAAA;AACZ,CAAC;KAAM,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACvD,WAAW,EAAE,CAAA;AACf,CAAC;KAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IAC/B,IAAA,uBAAQ,EAAC,cAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SACpD,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;QAClB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACN,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAA;IACtD,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AACA,iDAAyC;AACzC,gDAAuB;AACvB,yDAA0E;AAE1E,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAA;AAE9E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAClC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;AAE1C,oBAAoB;AACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AACtC,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAEhE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,OAAO,GAAG,CAAC,CACpE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;AAElB,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;WACH,OAAO;;;;;;;;;;;oCAWkB,sCAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;CAmBjE,CAAC,CAAA;AACF,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACtB,CAAC;AAED,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IAC/D,QAAQ,EAAE,CAAA;AACZ,CAAC;KAAM,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACvD,WAAW,EAAE,CAAA;AACf,CAAC;KAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IAC/B,8BAA8B;IAC9B,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,sCAAmB,CAAC,QAAQ,CAAC,SAAwB,CAAC,EAAE,CAAC;QACvF,OAAO,CAAC,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAA;QAC7D,OAAO,CAAC,KAAK,CAAC,0BAA0B,sCAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,IAAA,uBAAQ,EAAC,cAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;QAChC,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAoC;KAC3C,CAAC;SACC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;QAClB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACN,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAA;IACtD,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC"}

package/dist/config.d.ts

@@ -5,6 +5,7 @@
  * Contains the user's chosen models for each tier (strong/medium/weak).
  */
 import { type ModelTier } from "./models.js";
+import type { ProjectType, BuildTool } from "./project-types.js";
 export interface JuninhoConfig {
     /** Model ID for strong-tier agents (planner, spec-writer) */
     strong: string;
@@ -12,6 +13,12 @@ export interface JuninhoConfig {
     medium: string;
     /** Model ID for weak-tier agents (explore, librarian) */
     weak: string;
+    /** Detected or user-selected project type */
+    projectType?: ProjectType;
+    /** Whether the java project uses Kotlin */
+    isKotlin?: boolean;
+    /** Build tool for java projects */
+    buildTool?: BuildTool;
 }
 /**
  * Load saved configuration from .opencode/juninho-config.json.

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,aAAa,CAAA;AAG9D,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;CACb;AAQD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAanE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAM1E;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CA6B/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAM/E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,aAAa,CAAA;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEhE,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mCAAmC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAQD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAoBnE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAM1E;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CA6B/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAM/E"}

package/dist/config.js

@@ -32,7 +32,14 @@ function loadConfig(projectDir) {
     try {
         const data = JSON.parse((0, fs_1.readFileSync)(p, "utf-8"));
         if (data.strong && data.medium && data.weak) {
-            return { strong: data.strong, medium: data.medium, weak: data.weak };
+            return {
+                strong: data.strong,
+                medium: data.medium,
+                weak: data.weak,
+                projectType: data.projectType,
+                isKotlin: data.isKotlin,
+                buildTool: data.buildTool,
+            };
         }
         return null;
     }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AA0BH,gCAaC;AAMD,gCAMC;AAUD,sCA6BC;AAKD,wCAMC;AAnGD,2BAAuE;AACvE,gDAAuB;AACvB,2CAA8D;AAC9D,iDAAwD;AAWxD,MAAM,eAAe,GAAG,qBAAqB,CAAA;AAE7C,SAAS,UAAU,CAAC,UAAkB;IACpC,OAAO,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,eAAe,CAAC,CAAA;AAC5D,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,UAAkB;IAC3C,MAAM,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IAChC,IAAI,CAAC,IAAA,eAAU,EAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAE/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;QACjD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5C,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAA;QACtE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,UAAkB,EAAE,MAAqB;IAClE,MAAM,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IAC9C,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC,EAAE,CAAC;QACrB,IAAA,cAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,IAAA,kBAAa,EAAC,UAAU,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AAC/E,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,UAAkB;IAC9C,wBAAwB;IACxB,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IACpC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IAEvB,mBAAmB;IACnB,MAAM,SAAS,GAAG,IAAA,sCAAuB,GAAE,CAAA;IAC3C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAA,4BAAgB,EAAC,SAAS,CAAC,CAAA;QACxC,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC;YACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC;SAChC,CAAA;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,IAAI,KAAK,CACb,kDAAkD;QAClD,iEAAiE;QACjE,IAAI;QACJ,uBAAuB;QACvB,6DAA6D;QAC7D,sDAAsD;QACtD,IAAI;QACJ,eAAe;QACf,+DAA+D;QAC/D,oFAAoF,CACrF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAqB;IAClD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAA;AACH,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/installer.d.ts

@@ -1,5 +1,7 @@
+import { type ProjectType } from "./project-types.js";
 export interface SetupOptions {
     force?: boolean;
+    type?: ProjectType;
 }
 export declare function runSetup(projectDir: string, options?: SetupOptions): Promise<void>;
 //# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAqLD,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+E5F"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,KAAK,WAAW,EAQjB,MAAM,oBAAoB,CAAA;AAO3B,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAoTD,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsH5F"}

package/dist/installer.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runSetup = runSetup;
 const fs_1 = require("fs");
 const readline_1 = require("readline");
+const child_process_1 = require("child_process");
 const path_1 = __importDefault(require("path"));
 const agents_js_1 = require("./templates/agents.js");
 const skills_js_1 = require("./templates/skills.js");
@@ -18,6 +19,8 @@ const docs_js_1 = require("./templates/docs.js");
 const config_js_1 = require("./config.js");
 const discovery_js_1 = require("./discovery.js");
 const models_js_1 = require("./models.js");
+const project_types_js_1 = require("./project-types.js");
+const lint_detection_js_1 = require("./lint-detection.js");
 /* ─── Readline helper ─── */
 function ask(rl, question) {
     return new Promise((resolve) => {
@@ -141,33 +144,126 @@ async function manualEntry(rl, existing) {
     };
 }
 /* ─── Resolve models (auto or interactive) ─── */
-/**
- * Resolve models for setup:
- *   1. Saved config exists → use it
- *   2. Auto-discovery succeeds and finds exactly one per tier → use auto
- *   3. Otherwise → interactive selection
- */
 async function resolveModelsForSetup(projectDir, rl) {
-    // 1. Check saved config
     const saved = (0, config_js_1.loadConfig)(projectDir);
     if (saved)
         return saved;
-    // 2. Try auto-discovery (non-interactive happy path)
     const available = (0, discovery_js_1.discoverAvailableModels)();
     if (available.length > 0) {
         const best = (0, models_js_1.selectBestModels)(available);
         if (best.strong && best.medium && best.weak) {
-            // All tiers have a clear best — use them automatically
             return { strong: best.strong, medium: best.medium, weak: best.weak };
         }
     }
-    // 3. Non-interactive fallback (CI, piped stdin, no TTY)
     if (!process.stdin.isTTY) {
         return { strong: models_js_1.DEFAULT_MODELS.strong, medium: models_js_1.DEFAULT_MODELS.medium, weak: models_js_1.DEFAULT_MODELS.weak };
     }
-    // 4. Interactive selection (discovery failed or ambiguous)
     return interactiveModelSelection(rl, null);
 }
+/* ─── Resolve project type ─── */
+const TYPE_LABELS = {
+    "node-nextjs": "Node.js + Next.js",
+    "node-generic": "Node.js (generic)",
+    "python": "Python",
+    "go": "Go",
+    "java": "Java / Kotlin (JVM)",
+    "generic": "Generic",
+};
+async function resolveProjectType(projectDir, rl, options, savedConfig) {
+    // 1. CLI flag takes precedence
+    if (options.type) {
+        const isKotlin = options.type === "java" && (0, project_types_js_1.detectKotlin)(projectDir);
+        if (isKotlin) {
+            console.log("[juninho] Kotlin detected in Java project");
+        }
+        return { projectType: options.type, isKotlin };
+    }
+    // 2. Saved config (unless --force)
+    if (savedConfig?.projectType && !options.force) {
+        return {
+            projectType: savedConfig.projectType,
+            isKotlin: savedConfig.isKotlin ?? false,
+        };
+    }
+    // 3. Auto-detect
+    const detected = (0, project_types_js_1.detectProjectType)(projectDir);
+    if (detected) {
+        const isKotlin = detected === "java" && (0, project_types_js_1.detectKotlin)(projectDir);
+        const label = isKotlin ? "Java/Kotlin (JVM)" : TYPE_LABELS[detected];
+        if (process.stdin.isTTY) {
+            const response = await ask(rl, `[juninho] Tipo de projeto detectado: ${label}. Confirma? (S/n): `);
+            if (response.toLowerCase() === "n") {
+                return interactiveTypeSelection(rl, projectDir);
+            }
+        }
+        return { projectType: detected, isKotlin };
+    }
+    // 4. No detection — interactive or fallback
+    if (process.stdin.isTTY) {
+        console.log("[juninho] Tipo de projeto não detectado automaticamente.");
+        return interactiveTypeSelection(rl, projectDir);
+    }
+    return { projectType: "generic", isKotlin: false };
+}
+async function interactiveTypeSelection(rl, projectDir) {
+    console.log("");
+    console.log("[juninho] Selecione o tipo de projeto:");
+    project_types_js_1.VALID_PROJECT_TYPES.forEach((t, i) => {
+        console.log(`  ${i + 1}) ${TYPE_LABELS[t]}`);
+    });
+    const response = await ask(rl, `  Escolha (1-${project_types_js_1.VALID_PROJECT_TYPES.length}): `);
+    const idx = parseInt(response, 10);
+    const projectType = (idx >= 1 && idx <= project_types_js_1.VALID_PROJECT_TYPES.length)
+        ? project_types_js_1.VALID_PROJECT_TYPES[idx - 1]
+        : "generic";
+    const isKotlin = projectType === "java" && (0, project_types_js_1.detectKotlin)(projectDir);
+    if (isKotlin) {
+        console.log("[juninho] Kotlin detected in Java project");
+    }
+    return { projectType, isKotlin };
+}
+/* ─── Lint detection and suggestion ─── */
+async function handleLintDetection(projectDir, projectType, isKotlin, buildTool, rl) {
+    const result = (0, lint_detection_js_1.detectLintTool)(projectDir, projectType, isKotlin);
+    if (result.detected) {
+        console.log(`[juninho] ✓ Linter detectado: ${result.detected}${result.configFile ? ` (${result.configFile})` : ""}`);
+        return result.detected;
+    }
+    // No linter detected — suggest if interactive
+    if (!process.stdin.isTTY)
+        return undefined;
+    const suggestions = (0, lint_detection_js_1.suggestLintTools)(projectType, isKotlin, buildTool);
+    if (suggestions.length === 0)
+        return undefined;
+    const typeLabel = isKotlin ? "Kotlin" : TYPE_LABELS[projectType];
+    console.log("");
+    console.log(`[juninho] Nenhum linter detectado. Sugestões para projetos ${typeLabel}:`);
+    suggestions.forEach((s, i) => {
+        console.log(`  ${i + 1}) ${s.name} — ${s.command}`);
+    });
+    console.log(`  ${suggestions.length + 1}) Skip`);
+    const response = await ask(rl, `  Escolha (1-${suggestions.length + 1}) ou Enter para skip: `);
+    const idx = parseInt(response, 10);
+    if (idx >= 1 && idx <= suggestions.length) {
+        const chosen = suggestions[idx - 1];
+        if (chosen.install) {
+            console.log(`[juninho] Instalando ${chosen.name}...`);
+            try {
+                (0, child_process_1.execSync)(chosen.install, {
+                    cwd: projectDir,
+                    stdio: "inherit",
+                    timeout: 120_000,
+                });
+                console.log(`[juninho] ✓ ${chosen.name} instalado`);
+            }
+            catch {
+                console.log(`[juninho] ⚠ Falha ao instalar ${chosen.name}. Continue manualmente.`);
+            }
+        }
+        return chosen.name;
+    }
+    return undefined;
+}
 /* ─── Main setup ─── */
 async function runSetup(projectDir, options = {}) {
     const marker = path_1.default.join(projectDir, ".opencode", ".juninho-installed");
@@ -186,40 +282,55 @@ async function runSetup(projectDir, options = {}) {
         console.log(`[juninho]   Strong: ${models.strong}`);
         console.log(`[juninho]   Medium: ${models.medium}`);
         console.log(`[juninho]   Weak:   ${models.weak}`);
+        // Step 0.5: Resolve project type
+        const savedConfig = (0, config_js_1.loadConfig)(projectDir);
+        const { projectType, isKotlin } = await resolveProjectType(projectDir, rl, options, savedConfig);
+        const buildTool = projectType === "java" ? (0, project_types_js_1.detectBuildTool)(projectDir) : undefined;
+        const typeLabel = isKotlin ? "Java/Kotlin" : TYPE_LABELS[projectType];
+        console.log(`[juninho] ✓ Project type: ${typeLabel}${buildTool ? ` (${buildTool})` : ""}`);
+        // Step 0.7: Detect/suggest lint tool
+        const lintTool = await handleLintDetection(projectDir, projectType, isKotlin, buildTool, rl);
         // Step 1: Create directory structure
-        createDirectories(projectDir);
+        const config = (0, project_types_js_1.getEffectiveConfig)(projectType, isKotlin, buildTool);
+        createDirectories(projectDir, config.skills);
         console.log("[juninho] ✓ Directories created");
-        // Step 2: Save model config
-        (0, config_js_1.saveConfig)(projectDir, models);
-        console.log("[juninho] ✓ Model config saved");
-        // Step 3: Write agents (with resolved models)
-        (0, agents_js_1.writeAgents)(projectDir, models);
+        // Step 2: Save config (models + project type)
+        const fullConfig = {
+            ...models,
+            projectType,
+            isKotlin: isKotlin || undefined,
+            buildTool,
+        };
+        (0, config_js_1.saveConfig)(projectDir, fullConfig);
+        console.log("[juninho] ✓ Config saved");
+        // Step 3: Write agents
+        (0, agents_js_1.writeAgents)(projectDir, models, projectType, isKotlin, buildTool);
         console.log("[juninho] ✓ Agents created (9)");
-        // Step 4: Write skills
-        (0, skills_js_1.writeSkills)(projectDir);
-        console.log("[juninho] ✓ Skills created (9)");
+        // Step 4: Write skills (filtered by project type)
+        (0, skills_js_1.writeSkills)(projectDir, projectType, isKotlin);
+        console.log(`[juninho] ✓ Skills created (${config.skills.length})`);
         // Step 5: Write plugins
-        (0, plugins_js_1.writePlugins)(projectDir);
+        (0, plugins_js_1.writePlugins)(projectDir, projectType, isKotlin);
         console.log("[juninho] ✓ Plugins created (12)");
         // Step 6: Write tools
-        (0, tools_js_1.writeTools)(projectDir);
+        (0, tools_js_1.writeTools)(projectDir, projectType, isKotlin, buildTool);
         console.log("[juninho] ✓ Tools created (4)");
         // Step 7: Write support scripts
-        (0, support_scripts_js_1.writeSupportScripts)(projectDir);
+        (0, support_scripts_js_1.writeSupportScripts)(projectDir, projectType, isKotlin, lintTool);
         console.log("[juninho] ✓ Support scripts created (4)");
         // Step 8: Write commands
         (0, commands_js_1.writeCommands)(projectDir);
-        console.log("[juninho] ✓ Commands created (14)");
+        console.log("[juninho] ✓ Commands created (15)");
         // Step 9: Write state files
         (0, state_js_1.writeState)(projectDir);
         console.log("[juninho] ✓ State files created");
-        // Step 10: Write docs
-        (0, docs_js_1.writeDocs)(projectDir);
+        // Step 10: Write docs (parameterized by project type)
+        (0, docs_js_1.writeDocs)(projectDir, projectType, isKotlin);
         console.log("[juninho] ✓ Docs scaffold created");
-        // Step 11: Patch opencode.json (with resolved models)
+        // Step 11: Patch opencode.json
         (0, docs_js_1.patchOpencodeJson)(projectDir, models);
         console.log("[juninho] ✓ opencode.json patched");
-        // Step 12: Install pre-commit hook (outer validation loop)
+        // Step 12: Install pre-commit hook
         writePreCommitHook(projectDir);
         // Step 13: Write marker
         (0, fs_1.writeFileSync)(marker, new Date().toISOString());
@@ -227,6 +338,30 @@ async function runSetup(projectDir, options = {}) {
         console.log("[juninho] ✓ Framework installed successfully!");
         console.log("[juninho] Open OpenCode — /j.plan, /j.spec and /j.implement are ready.");
         console.log("[juninho] Agents: @j.planner, @j.spec-writer, @j.implementer, @j.validator, @j.reviewer, @j.unify, @j.explore, @j.librarian");
+        // Step 14: Offer /j.finish-setup
+        if (process.stdin.isTTY) {
+            console.log("");
+            const finishResponse = await ask(rl, "[juninho] Deseja executar /j.finish-setup agora para gerar skills e docs do projeto? (S/n): ");
+            if (finishResponse.toLowerCase() !== "n") {
+                console.log("[juninho] Executando /j.finish-setup via opencode...");
+                try {
+                    (0, child_process_1.execSync)('opencode run "/j.finish-setup"', {
+                        cwd: projectDir,
+                        stdio: "inherit",
+                        timeout: 600_000, // 10 minutes
+                    });
+                }
+                catch {
+                    console.log("[juninho] ⚠ Falha ao executar /j.finish-setup. Execute manualmente no OpenCode.");
+                }
+            }
+            else {
+                console.log("[juninho] Rode /j.finish-setup no OpenCode quando quiser gerar skills e documentação.");
+            }
+        }
+        else {
+            console.log("[juninho] Rode /j.finish-setup no OpenCode quando quiser gerar skills e documentação do projeto.");
+        }
     }
     finally {
         rl.close();
@@ -235,32 +370,30 @@ async function runSetup(projectDir, options = {}) {
 function writePreCommitHook(projectDir) {
     const gitHooksDir = path_1.default.join(projectDir, ".git", "hooks");
     if (!(0, fs_1.existsSync)(gitHooksDir)) {
-        // Not a git repo or hooks dir doesn't exist — skip silently
         return;
     }
     const hookPath = path_1.default.join(gitHooksDir, "pre-commit");
     if ((0, fs_1.existsSync)(hookPath)) {
         const existing = (0, fs_1.readFileSync)(hookPath, "utf-8");
         if (!existing.includes("installed by juninho")) {
-            // Preserve existing hook — do not overwrite
             console.log("[juninho] ⚠ pre-commit hook already exists — skipping (not installed by juninho)");
             return;
         }
     }
-    const hookContent = `#!/bin/sh
-# Deterministic outer validation loop — installed by juninho
-# Runs structure lint + related tests before every commit.
-# Do not bypass with --no-verify.
-set -e
-
-ROOT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
-
-if [ ! -x "$ROOT_DIR/.opencode/scripts/pre-commit.sh" ]; then
-  echo "[pre-commit] FAIL: .opencode/scripts/pre-commit.sh not found or not executable"
-  exit 1
-fi
-
-exec "$ROOT_DIR/.opencode/scripts/pre-commit.sh"
+    const hookContent = `#!/bin/sh
+# Deterministic outer validation loop — installed by juninho
+# Runs structure lint + related tests before every commit.
+# Do not bypass with --no-verify.
+set -e
+
+ROOT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+
+if [ ! -x "$ROOT_DIR/.opencode/scripts/pre-commit.sh" ]; then
+  echo "[pre-commit] FAIL: .opencode/scripts/pre-commit.sh not found or not executable"
+  exit 1
+fi
+
+exec "$ROOT_DIR/.opencode/scripts/pre-commit.sh"
 `;
     (0, fs_1.writeFileSync)(hookPath, hookContent);
     try {
@@ -271,20 +404,13 @@ exec "$ROOT_DIR/.opencode/scripts/pre-commit.sh"
         console.log("[juninho] ✓ pre-commit hook written (chmod not supported on this platform — make it executable manually)");
     }
 }
-function createDirectories(projectDir) {
+function createDirectories(projectDir, skills) {
     const dirs = [
         ".opencode",
         ".opencode/agents",
         ".opencode/skills",
-        ".opencode/skills/j.test-writing",
-        ".opencode/skills/j.page-creation",
-        ".opencode/skills/j.api-route-creation",
-        ".opencode/skills/j.server-action-creation",
-        ".opencode/skills/j.schema-migration",
-        ".opencode/skills/j.agents-md-writing",
-        ".opencode/skills/j.domain-doc-writing",
-        ".opencode/skills/j.principle-doc-writing",
-        ".opencode/skills/j.shell-script-writing",
+        // Only create skill directories for the relevant project type
+        ...skills.map((s) => `.opencode/skills/${s}`),
         ".opencode/plugins",
         ".opencode/tools",
         ".opencode/scripts",