@jetrabbits/agentic 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v0.3.3
+
+- Updated MemPalace project initialization to pipe explicit confirmation (`echo "Y" | mempalace init ...`) for non-interactive setup robustness.
+- Removed `agent-model-mapper` from OpenCode plugin registration.
+- Deleted obsolete OpenCode plugin source `extensions/opencode/plugins/agent-model-mapper.ts`.
+
 ## v0.3.2
 
 - Added optional post-task specialist agents `instruction_reviewer` and `memory_curator` outside the mandatory SDLC role matrix.

package/agentic

@@ -1946,7 +1946,7 @@ print_mempalace_project_setup_instructions() {
   out "2) Install MemPalace:"
   out "   pip install mempalace"
   out "3) Initialize the project memory taxonomy without LLM calls:"
-  out "   mempalace init \"$PROJECT_DIR\" --yes --no-llm"
+  out "   echo \"N\" | mempalace init \"$PROJECT_DIR\" --yes --no-llm"
   out "4) Mine project knowledge into its isolated wing:"
   out "   mempalace mine \"$PROJECT_DIR\" --wing \"$project_wing\""
   if [[ -d "$PROJECT_DIR/docs" ]]; then
@@ -2242,7 +2242,7 @@ initialize_mempalace_project() {
     return 1
   fi
 
-  if ! run_mempalace_command "MemPalace init" mempalace init "$PROJECT_DIR" --yes --no-llm; then
+  if ! run_mempalace_command "MemPalace init" bash -lc "echo \"N\" | mempalace init \"$PROJECT_DIR\" --yes --no-llm"; then
     print_mempalace_project_setup_instructions
     return 1
   fi

package/docs/agentic-stabilization/README.md

@@ -5,10 +5,10 @@
 - Post-install doctor checks run independently for `codex`, `opencode`, `claude`, and `gemini`.
 - `AGENTIC_DOCTOR_TIMEOUT_SECONDS` defaults to `10`; a timeout is reported as a doctor failure and install continues.
 - Codex doctor runs non-interactively with `--ephemeral`, `--sandbox workspace-write`, and the same lightweight smoke prompt as other supported doctor targets.
-- OpenCode uses `agent-model-mapper` instead of the removed `model-checker` artifacts.
+- OpenCode uses an install-time `agent-model-mapper` flow instead of the removed `model-checker` artifacts.
 - `agent-model-mapper` writes `.opencode/opencode.json` during interactive install only after confirmation.
-- `agent-model-mapper` uses `fzf` for install-time model dropdowns when available and OpenCode startup skips once all roles are mapped.
-- The runtime OpenCode plugin never opens `fzf`, asks questions, or writes project files.
+- `agent-model-mapper` uses `fzf` for install-time model dropdowns when available.
+- No runtime OpenCode plugin is shipped for `agent-model-mapper`, so OpenCode startup never opens `fzf`, asks questions, or writes project files.
 - Context7 offers an interactive key mode: configure without a key or enter `CONTEXT7_API_KEY` for the selected target configs.
 - OpenCode MemPalace setup writes `mempalace-mcp` config and initializes/mines project memory into a project-specific wing without LLM calls.
 - Telegram notification credentials are read from project `.agentic.json` when the plugin is enabled.
@@ -24,8 +24,9 @@
 - Hung agent doctor commands time out and do not stop remaining selected agents from running.
 - Doctor output includes timeout duration, exit status, and per-agent elapsed time.
 - `extensions/opencode/plugins/model-checker.ts` and `model-checker.json` are absent.
-- `extensions/opencode/opencode.json` lists `agent-model-mapper`.
-- Runtime model mapper execution does not prompt or modify project files.
+- `extensions/opencode/plugins/agent-model-mapper.ts` is absent.
+- `extensions/opencode/opencode.json` does not list `agent-model-mapper`.
+- Install-time model mapper execution still writes confirmed role model mappings.
 - Telegram plugin tests prove environment-only credentials and no secret output.
 - Real blackbox tests print created files, managed guidance sources, and MCP config evidence, then save instruction evidence to a temp file without printing Telegram secrets.
 

package/docs/agentic-usage.md

@@ -169,7 +169,7 @@ When `opencode` is selected, interactive installs ask whether to enable Telegram
 ~/.config/agentic/opencode-plugins.json
 ```
 
-Non-interactive installs create a disabled config when no config exists. Interactive installs ask for Telegram `botToken` and `chatId` when `telegram-notification` is selected. Those credentials are written to the target project `.agentic.json` under `settings.opencode_plugins.telegram`, not to `~/.config/agentic/opencode-plugins.json`. Treat `.agentic.json` as plaintext secret-bearing project config when Telegram is enabled and do not commit it to public repositories. When enabled, `agent-model-mapper` runs during interactive `agentic install`/`agentic tui`, uses `fzf` as a dropdown picker when available, and writes `.opencode/opencode.json` only after a Confirm action. OpenCode startup never prompts for model mapping; the runtime plugin only reports whether install-time mapping is already complete.
+Non-interactive installs create a disabled config when no config exists. Interactive installs ask for Telegram `botToken` and `chatId` when `telegram-notification` is selected. Those credentials are written to the target project `.agentic.json` under `settings.opencode_plugins.telegram`, not to `~/.config/agentic/opencode-plugins.json`. Treat `.agentic.json` as plaintext secret-bearing project config when Telegram is enabled and do not commit it to public repositories. When enabled, `agent-model-mapper` runs during interactive `agentic install`/`agentic tui`, uses `fzf` as a dropdown picker when available, and writes `.opencode/opencode.json` only after a Confirm action. OpenCode startup does not load a mapper runtime plugin or prompt for model mapping.
 
 ## Context7
 

package/docs/opencode_setup.md

@@ -46,7 +46,7 @@ The runtime plugin reads credentials from the project `.agentic.json`; it does n
 
 Non-interactive `agentic install` defaults optional plugins to disabled when no config exists.
 
-`agent-model-mapper` reads roles from target `.opencode/agents/*.md` and discovers model names from `~/.config/opencode/opencode.json`, then adds models from active providers in `~/.local/share/opencode/auth.json` using non-deprecated entries in `~/.cache/opencode/models.json`. When enabled, interactive `agentic install`/`agentic tui` prompts for a main and fallback model per role, using `fzf` as a dropdown picker when available, and writes `.opencode/opencode.json` only after a Confirm action. OpenCode startup never opens `fzf` or waits for model input; the runtime plugin only reports whether install-time mapping is complete.
+`agent-model-mapper` reads roles from target `.opencode/agents/*.md` and discovers model names from `~/.config/opencode/opencode.json`, then adds models from active providers in `~/.local/share/opencode/auth.json` using non-deprecated entries in `~/.cache/opencode/models.json`. When enabled, interactive `agentic install`/`agentic tui` prompts for a main and fallback model per role, using `fzf` as a dropdown picker when available, and writes `.opencode/opencode.json` only after a Confirm action. OpenCode startup never opens `fzf` or waits for model input because no mapper runtime plugin is shipped or registered.
 
 For OpenCode targets, `agentic` writes generated operating guidance to `.opencode/AGENTS.md`. If OpenCode is installed
 alongside another agent target, root `AGENTS.md` is generated as well for the non-OpenCode target.

package/docs/review-pipeline/examples/instruction-review.example.md

@@ -0,0 +1,95 @@
+# Instruction Effectiveness Review
+
+## Summary
+
+The instruction set helped the task stay inside the existing extension layout and prevented the new roles from being
+added to the mandatory SDLC matrix. Tool discipline was mostly strong because repository facts were discovered before
+editing. The main gap was that review pipeline behavior had to be inferred from docs rather than a dedicated guidance
+section. No code quality findings are included because they are outside this role's scope.
+
+## Scores
+
+| Category | Score 0-10 | Notes |
+|---|---:|---|
+| Clarity | 8 | Role boundaries were clear after reading README and SDLC rules. |
+| Usefulness | 8 | Existing extension patterns made implementation straightforward. |
+| Tool discipline | 8 | File inspection was targeted and avoided repeated broad loops. |
+| Memory discipline | 7 | Memory rules existed, but post-task curation was not documented. |
+| Ambiguity resistance | 7 | The repo lacked a review pipeline section, causing one product decision. |
+| Token efficiency | 7 | Some duplicate role text is necessary for installed agents. |
+| Overall | 8 | Minor instruction additions are enough. |
+
+## Effective instructions
+
+| Instruction | Impact | Evidence |
+|---|---|---|
+| Keep SDLC roles one-to-one | Prevented specialist roles from replacing core SDLC owners. | `sdlc-role-responsibilities.md` keeps the mandatory matrix unchanged. |
+| Discover project guidance before implementation | Found the extension-based agent layout. | Existing files live under `extensions/*/agents`. |
+
+## Harmful instructions
+
+| Instruction | Problem | Evidence |
+|---|---|---|
+| None | No instruction directly caused task failure. | The task completed with scoped docs and tests. |
+
+## Missing instructions
+
+| Missing instruction | Why needed | Suggested text |
+|---|---|---|
+| Post-task review pipeline guidance | Future agents need to know when specialists run and where reports go. | Add a review pipeline section that lists optional roles and `.reviews/<task-id>/` output paths. |
+
+## Redundant instructions
+
+| Instruction | Reason |
+|---|---|
+| Repeated role boundaries across extension files | Required because each installed agent file must be self-contained. |
+
+## Tool usage findings
+
+| Tool | Calls | Useful | Waste | Notes |
+|---|---:|---:|---:|---|
+| `rg` | 4 | 4 | 0 | Located role and installer references quickly. |
+| `sed` | 5 | 5 | 0 | Confirmed local file formats before edits. |
+| `apply_patch` | 3 | 3 | 0 | Added and updated tracked files. |
+
+## Suggested edits
+
+### Remove
+
+```md
+None.
+```
+
+### Replace
+
+```md
+The same 7-agent team works across supported IDEs.
+```
+
+with:
+
+```md
+The same 7-agent SDLC team works across supported IDEs, with optional post-task review specialists.
+```
+
+### Add
+
+```md
+Use `instruction_reviewer` and `memory_curator` after non-trivial tasks when instruction quality or memory hygiene needs review.
+```
+
+## Estimated waste
+
+| Metric | Estimate |
+|---|---:|
+| Extra tokens | 500 |
+| Extra tool calls | 1 |
+| Extra retries | 0 |
+| Extra runtime | 2 minutes |
+
+## Final recommendation
+
+Minor edits
+
+The instruction set is generally effective. Add explicit review pipeline guidance so future runs do not have to infer
+how specialist agents should be used.

package/docs/review-pipeline/examples/memory-curation.example.md

@@ -0,0 +1,56 @@
+# Memory Curation Report
+
+## Summary
+
+The task introduced a durable convention: post-task review specialists are optional and remain outside the mandatory
+SDLC role matrix. That convention is likely to help future agent-system changes. Temporary test output, command logs,
+and generated report examples should not be stored as memory. No automatic memory write is recommended without user or
+orchestrator approval.
+
+## Store
+
+| Priority | Fact | Reason | Suggested memory text |
+|---|---|---|---|
+| High | `instruction_reviewer` and `memory_curator` are optional post-task specialists, not SDLC owners. | Prevents future role-boundary drift. | Agentic treats `instruction_reviewer` and `memory_curator` as optional post-task review specialists outside the mandatory SDLC role matrix. |
+| Medium | Review artifacts use `.reviews/<task-id>/` or timestamp fallback. | Helps future tasks place reports consistently. | Post-task review reports should be written under `.reviews/<task-id>/`, or `.reviews/YYYY-MM-DD-HHMMSS/` when no task id exists. |
+
+## Update
+
+| Existing memory | Replace with | Reason |
+|---|---|---|
+| None | None | No stale memory was identified. |
+
+## Merge
+
+| Memory A | Memory B | Merged memory | Reason |
+|---|---|---|---|
+| None | None | None | No duplicate memory was identified. |
+
+## Ignore
+
+| Fact | Reason |
+|---|---|
+| Exact shell output from test runs | Temporary logs are low-value memory. |
+| Generated example report wording | Generated code/docs examples should remain in files, not memory. |
+| One-time task status | Current task state is transient. |
+
+## Delete candidates
+
+| Memory | Reason |
+|---|---|
+| None | No delete candidate was found. |
+
+## Contradictions
+
+| Memory | New information | Resolution |
+|---|---|---|
+| None | None | No contradiction found. |
+
+## Final recommendation
+
+Store count: 2
+Update count: 0
+Merge count: 0
+Delete candidate count: 0
+Memory quality score: 8/10
+Store only the two durable conventions. Ignore logs, generated examples, and current task progress.

package/docs/review-pipeline/examples/summary.example.md

@@ -0,0 +1,18 @@
+# Review Summary
+
+## Instruction review
+
+Overall score: 8/10
+Recommendation: Minor edits
+
+## Memory curation
+
+Store: 2
+Update: 0
+Delete candidates: 0
+
+## Action items
+
+- [ ] Document optional post-task specialists in README.
+- [ ] Keep specialist roles outside the mandatory SDLC matrix.
+- [ ] Store only durable review-pipeline conventions, not logs or generated examples.

package/extensions/opencode/agents/developer.md

@@ -1,6 +1,6 @@
 ---
 description: Software Developer for implementation, unit/integration tests, and maintainable delivery
-mode: subagent
+mode: all
 vibe: Ships clean, tested code — and leaves the codebase better than they found it.
 ---
 

package/extensions/opencode/agents/devops-engineer.md

@@ -1,6 +1,6 @@
 ---
 description: DevOps Engineer for infrastructure, CI/CD pipelines, deployment automation, and platform reliability
-mode: subagent
+mode: all
 vibe: If it's not in code and not in the pipeline, it doesn't exist.
 ---
 

package/extensions/opencode/agents/instruction_reviewer.md

@@ -1,6 +1,6 @@
 ---
 description: Instruction Reviewer for post-task reports on instruction effectiveness, tool discipline, memory discipline, and context efficiency
-mode: subagent
+mode: all
 vibe: Reviews the instructions that shaped the work, not the code that was produced.
 ---
 

package/extensions/opencode/agents/memory_curator.md

@@ -1,6 +1,6 @@
 ---
 description: Memory Curator for post-task recommendations on what to store, update, merge, ignore, or delete from long-term memory
-mode: subagent
+mode: all
 vibe: Keeps memory useful by storing less, but storing better.
 ---
 

package/extensions/opencode/agents/team-lead.md

@@ -1,6 +1,6 @@
 ---
 description: Software Team Lead for technical strategy, risk management, quality gates, and engineering review
-mode: subagent
+mode: all
 vibe: Makes hard technical calls, keeps the team aligned, and never lets complexity become an excuse.
 ---
 

package/extensions/opencode/opencode.json

@@ -1,7 +1,6 @@
 {
   "$schema": "https://opencode.ai/config.json",
   "plugin": [
-    "agent-model-mapper",
     "sound-notification",
     "telegram-notification"
   ],
@@ -9,10 +8,8 @@
     "product-owner": {
       "description": "Main coordinator for feature development workflow",
       "mode": "primary",
-      "model": "google/antigravity-claude-sonnet-4-6",
+      "model": "",
       "fallback": [
-        "openai/gpt-5.4",
-        "opencode/minimax-m2.5-free"
       ],
       "permission": {
         "task": {
@@ -29,88 +26,71 @@
     "pm": {
       "description": "Project Manager - coordinates workflow",
       "mode": "subagent",
-      "model": "google/antigravity-claude-sonnet-4-6",
+      "model": "",
       "fallback": [
-        "openai/gpt-5.4",
-        "opencode/minimax-m2.5-free"
       ],
       "permission": {
         "task": {
           "team-lead": "allow",
           "designer": "allow",
           "developer": "allow",
-          "qa": "allow",
-          "instruction_reviewer": "allow",
-          "memory_curator": "allow"
+          "qa": "allow"
         }
       }
     },
     "team-lead": {
       "description": "Team Lead - planning and code review",
-      "mode": "subagent",
-      "model": "google/antigravity-claude-opus-4-6-thinking",
+      "mode": "all",
+      "model": "",
       "fallback": [
-        "openai/gpt-5.3-codex"
       ],
       "permission": {
         "task": {
           "developer": "allow",
-          "qa": "allow",
-          "instruction_reviewer": "allow",
-          "memory_curator": "allow"
+          "qa": "allow"
         }
       }
     },
     "developer": {
       "description": "Developer - implements code",
-      "mode": "subagent",
-      "model": "google/antigravity-claude-opus-4-6-thinking",
+      "mode": "all",
+      "model": "",
       "fallback": [
-        "openai/gpt-5.3-codex"
       ]
     },
     "devops-engineer": {
       "description": "DevOps Engineer - infrastructure, CI/CD, and platform reliability",
-      "mode": "subagent",
-      "model": "google/antigravity-claude-opus-4-6-thinking",
+      "mode": "all",
+      "model": "",
       "fallback": [
-        "openai/gpt-5.3-codex"
       ]
     },
     "instruction_reviewer": {
       "description": "Instruction Reviewer - post-task review of instruction effectiveness and tool discipline",
-      "mode": "subagent",
-      "model": "google/antigravity-claude-sonnet-4-6",
+      "mode": "all",
+      "model": "",
       "fallback": [
-        "openai/gpt-5.4",
-        "opencode/minimax-m2.5-free"
       ]
     },
     "memory_curator": {
       "description": "Memory Curator - post-task memory hygiene recommendations without automatic writes",
-      "mode": "subagent",
-      "model": "google/antigravity-claude-sonnet-4-6",
+      "mode": "all",
+      "model": "",
       "fallback": [
-        "openai/gpt-5.4",
-        "opencode/minimax-m2.5-free"
       ]
     },
     "qa": {
       "description": "QA Engineer - runs tests",
       "mode": "subagent",
-      "model": "google/antigravity-gemini-3-flash",
+      "model": "",
       "fallback": [
-        "opencode/minimax-m2.5-free",
-        "openai/gpt-5.4"
       ]
     },
     "designer": {
       "description": "Designer - UI/UX validation",
       "mode": "subagent",
-      "model": "google/antigravity-claude-sonnet-4-6",
+      "model": "",
       "fallback": [
-        "opencode/minimax-m2.5-free",
-        "openai/gpt-5.4"
       ]
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetrabbits/agentic",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Agent Intelligence Configuration CLI",
   "bin": {
     "agentic": "bin/agentic.js"

package/extensions/opencode/plugins/agent-model-mapper.ts

@@ -1,117 +0,0 @@
-import type { Plugin } from "@opencode-ai/plugin"
-import { existsSync, readFileSync } from "node:fs"
-import { readdir, readFile } from "node:fs/promises"
-import { basename, join } from "node:path"
-
-type AgenticPluginConfig = {
-  agentModelMapper?: {
-    enabled?: boolean
-  }
-  settings?: any
-}
-
-type Role = {
-  name: string
-  description: string
-  mode: string
-}
-
-function readAgenticConfig(): AgenticPluginConfig {
-  const configHome = process.env.XDG_CONFIG_HOME || join(process.env.HOME || "", ".config")
-  const configPath = join(configHome, "agentic", "opencode-plugins.json")
-
-  try {
-    return JSON.parse(readFileSync(configPath, "utf-8")) as AgenticPluginConfig
-  } catch {
-    return {}
-  }
-}
-
-function readProjectAgenticConfig(directory: string): AgenticPluginConfig {
-  try {
-    return JSON.parse(readFileSync(join(directory, ".agentic.json"), "utf-8")) as AgenticPluginConfig
-  } catch {
-    return {}
-  }
-}
-
-function parseFrontmatter(text: string): Record<string, string> {
-  if (!text.startsWith("---\n")) return {}
-  const end = text.indexOf("\n---", 4)
-  if (end === -1) return {}
-
-  const result: Record<string, string> = {}
-  for (const line of text.slice(4, end).split("\n")) {
-    const index = line.indexOf(":")
-    if (index === -1) continue
-    result[line.slice(0, index).trim()] = line.slice(index + 1).trim().replace(/^['"]|['"]$/g, "")
-  }
-  return result
-}
-
-async function readRoles(directory: string): Promise<Role[]> {
-  const agentsDir = join(directory, ".opencode", "agents")
-  let entries: string[]
-  try {
-    entries = await readdir(agentsDir)
-  } catch {
-    return []
-  }
-
-  const roles: Role[] = []
-  for (const entry of entries.sort()) {
-    if (!entry.endsWith(".md")) continue
-    const path = join(agentsDir, entry)
-    const text = await readFile(path, "utf-8")
-    const frontmatter = parseFrontmatter(text)
-    roles.push({
-      name: basename(entry, ".md"),
-      description: frontmatter.description || "OpenCode agent",
-      mode: frontmatter.mode || "subagent",
-    })
-  }
-  return roles
-}
-
-function readJsonIfExists(path: string): unknown {
-  if (!existsSync(path)) return undefined
-  try {
-    return JSON.parse(readFileSync(path, "utf-8"))
-  } catch {
-    return undefined
-  }
-}
-
-function hasCompleteAgentModelMapping(directory: string, roles: Role[]): boolean {
-  const state = readJsonIfExists(join(directory, ".opencode", "agent-model-mapper.state.json")) as Record<string, any> | undefined
-  if (!state?.configured) return false
-
-  const config = readJsonIfExists(join(directory, ".opencode", "opencode.json")) as Record<string, any> | undefined
-  const agents = config?.agent
-  if (!agents || typeof agents !== "object") return false
-  return roles.every((role) => {
-    const agent = agents[role.name]
-    return agent && typeof agent === "object" && typeof agent.model === "string" && agent.model.trim().length > 0
-  })
-}
-
-export const AgentModelMapperPlugin: Plugin = async ({ directory }) => {
-  const projectConfig = readProjectAgenticConfig(directory)
-  const globalConfig = readAgenticConfig()
-  const enabled = projectConfig.settings?.opencode_plugins?.agentModelMapper?.enabled ?? globalConfig.agentModelMapper?.enabled
-  if (!enabled) return {}
-
-  const roles = await readRoles(directory)
-  if (!roles.length) {
-    console.log("agent-model-mapper: skipped because .opencode/agents/*.md was not found")
-    return {}
-  }
-
-  if (hasCompleteAgentModelMapping(directory, roles)) {
-    console.log("agent-model-mapper: skipped because all Agentic roles already have model mappings")
-    return {}
-  }
-
-  console.log("agent-model-mapper: install-time model mapping is required; run agentic install or agentic tui")
-  return {}
-}