@kleber.mottajr/juninho 1.0.0-alpha.1

package/README.md

@@ -0,0 +1,52 @@
+# juninho
+
+Bootstrap the **Agentic Coding Framework** (framework.md) into any [OpenCode](https://opencode.ai) project in a single command.
+
+## Install
+
+```bash
+npm install -g @kleber.mottajr/juninho
+```
+
+## Usage
+
+```bash
+# Navigate to your project
+cd my-opencode-project
+
+# Run setup — one command, everything configured
+juninho setup
+
+# Output:
+# [juninho] Installing Agentic Coding Framework...
+# [juninho] ✓ Framework installed successfully!
+# [juninho] Open OpenCode — /plan, /spec and /implement are ready.
+```
+
+## What it does
+
+`juninho setup` automatically creates:
+
+- **7 agents** in `.opencode/agents/` (planner, spec-writer, implementer, validator, reviewer, plan-reviewer, unify)
+- **5 skills** in `.opencode/skills/` (test-writing, page-creation, api-route-creation, server-action-creation, schema-migration)
+- **10 plugins** in `.opencode/plugins/` (auto-discovered by OpenCode)
+- **4 tools** in `.opencode/tools/` (find-pattern, next-version, lsp, ast-grep)
+- **7 slash commands** in `.opencode/commands/` (/plan, /spec, /implement, /init-deep, /start-work, /handoff, /ulw-loop)
+- **State files** for persistent context and execution tracking
+- **Docs scaffold** with AGENTS.md, domain index, and manifest
+
+Then patches `opencode.json` with agent definitions and Context7 MCP.
+
+## Idempotency
+
+Running `juninho setup` twice is safe — it detects `.opencode/.juninho-installed` and skips if already configured. Use `--force` to reinstall.
+
+## Re-install
+
+```bash
+juninho setup --force
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const installer_js_1 = require("./installer.js");
+const path_1 = __importDefault(require("path"));
+const args = process.argv.slice(2);
+const command = args[0] ?? "setup";
+const forceFlag = args.includes("--force");
+const targetDir = args.find(a => !a.startsWith("--") && a !== command) ?? process.cwd();
+if (command === "setup") {
+    (0, installer_js_1.runSetup)(path_1.default.resolve(targetDir), { force: forceFlag })
+        .then(() => process.exit(0))
+        .catch((e) => {
+        console.error("[juninho] Error:", e.message);
+        process.exit(1);
+    });
+}
+else if (command === "--help" || command === "-h") {
+    console.log(`
+juninho — Agentic Coding Framework bootstrapper for OpenCode
+
+Usage:
+  juninho [setup] [project-dir] [--force]
+
+Commands:
+  setup     Install the framework into a project (default)
+
+Options:
+  --force   Reinstall even if already configured
+  --help    Show this help message
+
+Examples:
+  juninho setup
+  juninho setup ./my-project
+  juninho setup --force
+`);
+}
+else {
+    console.error(`[juninho] Unknown command: ${command}`);
+    console.error("Run 'juninho --help' for usage.");
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AACA,iDAAyC;AACzC,gDAAuB;AAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAClC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAA;AAClC,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,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,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,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;CAiBb,CAAC,CAAA;AACF,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/installer.d.ts

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

package/dist/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD5F"}

package/dist/installer.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSetup = runSetup;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const agents_js_1 = require("./templates/agents.js");
+const skills_js_1 = require("./templates/skills.js");
+const plugins_js_1 = require("./templates/plugins.js");
+const tools_js_1 = require("./templates/tools.js");
+const commands_js_1 = require("./templates/commands.js");
+const state_js_1 = require("./templates/state.js");
+const docs_js_1 = require("./templates/docs.js");
+async function runSetup(projectDir, options = {}) {
+    const marker = path_1.default.join(projectDir, ".opencode", ".juninho-installed");
+    if ((0, fs_1.existsSync)(marker) && !options.force) {
+        console.log("[juninho] Framework already installed. Use --force to reinstall.");
+        return;
+    }
+    console.log("[juninho] Installing Agentic Coding Framework...");
+    console.log(`[juninho] Target: ${projectDir}`);
+    // Step 1: Create directory structure
+    createDirectories(projectDir);
+    console.log("[juninho] ✓ Directories created");
+    // Step 2: Write agents
+    (0, agents_js_1.writeAgents)(projectDir);
+    console.log("[juninho] ✓ Agents created (7)");
+    // Step 3: Write skills
+    (0, skills_js_1.writeSkills)(projectDir);
+    console.log("[juninho] ✓ Skills created (5)");
+    // Step 4: Write plugins
+    (0, plugins_js_1.writePlugins)(projectDir);
+    console.log("[juninho] ✓ Plugins created (10)");
+    // Step 5: Write tools
+    (0, tools_js_1.writeTools)(projectDir);
+    console.log("[juninho] ✓ Tools created (4)");
+    // Step 6: Write commands
+    (0, commands_js_1.writeCommands)(projectDir);
+    console.log("[juninho] ✓ Commands created (7)");
+    // Step 7: Write state files
+    (0, state_js_1.writeState)(projectDir);
+    console.log("[juninho] ✓ State files created");
+    // Step 8: Write docs
+    (0, docs_js_1.writeDocs)(projectDir);
+    console.log("[juninho] ✓ Docs scaffold created");
+    // Step 9: Patch opencode.json
+    (0, docs_js_1.patchOpencodeJson)(projectDir);
+    console.log("[juninho] ✓ opencode.json patched");
+    // Step 10: Write marker
+    (0, fs_1.writeFileSync)(marker, new Date().toISOString());
+    console.log("");
+    console.log("[juninho] ✓ Framework installed successfully!");
+    console.log("[juninho] Open OpenCode — /plan, /spec and /implement are ready.");
+    console.log("[juninho] Agents available: @planner, @spec-writer, @implementer, @validator, @reviewer, @unify");
+}
+function createDirectories(projectDir) {
+    const dirs = [
+        ".opencode",
+        ".opencode/agents",
+        ".opencode/skills",
+        ".opencode/skills/test-writing",
+        ".opencode/skills/page-creation",
+        ".opencode/skills/api-route-creation",
+        ".opencode/skills/server-action-creation",
+        ".opencode/skills/schema-migration",
+        ".opencode/plugins",
+        ".opencode/tools",
+        ".opencode/commands",
+        ".opencode/state",
+        "docs",
+        "docs/principles",
+        "docs/domain",
+        "docs/specs",
+        "worktrees",
+    ];
+    for (const dir of dirs) {
+        const fullPath = path_1.default.join(projectDir, dir);
+        if (!(0, fs_1.existsSync)(fullPath)) {
+            (0, fs_1.mkdirSync)(fullPath, { recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/installer.js.map

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

package/dist/templates/agents.d.ts

@@ -0,0 +1,2 @@
+export declare function writeAgents(projectDir: string): void;
+//# sourceMappingURL=agents.d.ts.map

package/dist/templates/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/templates/agents.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAUpD"}