@kpnpm/homie 0.1.0 → 0.1.2

package/.opencode/plugins/homie.mjs

@@ -1,9 +1,9 @@
 // homie — OpenCode V2 plugin.
 //
-// Injects the homie personality into every model call's system context at the
-// active level, persists /homie level switches, registers the /homie command
-// and skill. Reuses the shared instruction builder so Claude Code, Codex, and
-// OpenCode all read one source of truth.
+// Registers the /homie command and skill, persists level switches, and
+// injects the homie personality into every model call's system context at
+// the active level. Command replies are one plain line — the full ruleset
+// is delivered invisibly through the context hook, never dumped into chat.
 //
 // Add to your opencode.json:
 //   { "plugins": ["@kpnpm/homie"] }
@@ -19,8 +19,8 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // The shared instruction builder is CommonJS; bridge to it from this ES module.
 const require = createRequire(import.meta.url);
-const { getChillInstructions } = require('../../hooks/homie-instructions');
-const { getDefaultLevel, normalizeLevel } = require('../../hooks/homie-config');
+const { getHomieInstructions } = require('../../hooks/homie-instructions');
+const { getDefaultLevel, normalizeLevel, writeDefaultLevel } = require('../../hooks/homie-config');
 
 // OpenCode has no flag-file convention of its own; keep the level beside its config.
 const statePath = path.join(
@@ -42,16 +42,17 @@ function writeLevel(level) {
   fs.writeFileSync(statePath, level);
 }
 
+// Returns the applied level, null for an unrecognized level, or undefined
+// when nothing changed (bare /homie while already on → report-only).
 // `off` is persisted like any level; the context hook reads it and stays
-// silent. An unrecognized level leaves the current one alone. Bare /homie
-// turns the voice on at yo (per SKILL.md); with any level active the command
-// just reports — the execute() reply shows the current level.
+// silent. Bare /homie turns the voice on at yo (per SKILL.md).
 function persistLevel(args) {
   const wanted = String(args == null ? '' : args).trim();
-  if (!wanted && readLevel() !== 'off') return; // bare /homie: report-only when active
+  if (!wanted && readLevel() !== 'off') return undefined;
   const level = wanted ? normalizeLevel(wanted) : 'yo';
-  if (!level) return;
+  if (!level) return null;
   writeLevel(level);
+  return level;
 }
 
 function readSkill() {
@@ -90,11 +91,32 @@ export default {
         name: 'homie',
         description: 'Switch personality level (off/yo/dawg/mafa)',
         execute: async ({ sessionID, prompt, delivery }) => {
-          persistLevel(prompt.text);
-          const level = readLevel();
-          const text = level === 'off'
-            ? 'Homie is off — back to the normal tone.'
-            : 'HOMIE MODE — level: ' + level + '.\n\n' + getChillInstructions(level);
+          const wanted = String(prompt.text || '').trim();
+          const words = wanted.split(/\s+/).filter(Boolean);
+          const first = words[0] || '';
+          let text;
+
+          if (first === 'default') {
+            const applied = words[1] ? writeDefaultLevel(words[1]) : null;
+            text = applied
+              ? 'Homie default set: ' + applied + '. New sessions start at ' + applied + '.'
+              : 'Usage: /homie default <level>. Levels: off, yo, dawg, mafa.';
+          } else {
+            const applied = persistLevel(first);
+            const level = readLevel();
+            if (first && applied === null) {
+              text = 'Unknown level "' + first + '". Levels: off, yo, dawg, mafa.';
+            } else if (level === 'off') {
+              text = 'Homie off.';
+            } else {
+              text = 'Homie mode: ' + level + '.';
+            }
+          }
+
+          // One plain line only. The context hook below injects the full
+          // ruleset into the system context of this same model call, so the
+          // confirmation turn is already in voice — without dumping the
+          // ruleset into the chat.
           await ctx.session.prompt({ ...prompt, sessionID, text, delivery });
         },
       });
@@ -105,7 +127,7 @@ export default {
     await ctx.session.hook('context', (event) => {
       const level = readLevel();
       if (level === 'off') return;
-      event.system.push({ type: 'text', text: getChillInstructions(level) });
+      event.system.push({ type: 'text', text: getHomieInstructions(level) });
     });
   },
 };

package/commands/homie.toml

@@ -1,2 +1,2 @@
 description = "Switch homie personality level (off/yo/dawg/mafa)"
-prompt = "Switch to homie {{args}} mode. With no level, turn the voice on at yo, or report the current level if already on. This is a communication personality only: casual/warm at yo, blunt with light roasting and rare mild swearing (damn, hell, crap) at dawg, very informal and sarcastic with natural (never forced) profanity at mafa. Voice lives in chat prose only — code, diffs, commands, commit messages, and permission warnings stay plain. Technical recommendations, tools, permissions, and code correctness never change."
+prompt = "Switch homie voice level: {{args}} (yo casual / dawg blunt, rare mild swearing / mafa very informal, natural profanity / off normal). No level: report the current one, or start at yo if off. Chat voice only — technical answers, code, and commands never change."

package/hooks/homie-activate.js

@@ -9,21 +9,23 @@
 const fs = require('fs');
 const path = require('path');
 const { getDefaultLevel, isShellSafe } = require('./homie-config');
-const { getChillInstructions } = require('./homie-instructions');
+const { getHomieInstructions } = require('./homie-instructions');
 const {
   setLevel,
   writeHookOutput,
   isCodex,
   isCopilot,
   getClaudeDir,
-  statePath,
 } = require('./homie-runtime');
 
 const level = getDefaultLevel();
 
-// "off" default — skip activation entirely, don't write flag or emit rules.
+// "off" default — persist off like any level: a stale flag from a previous
+// session would otherwise keep the statusline badge showing the old level
+// while this session is normal. Stay silent: emitting a notice every session
+// is context noise for a plugin that is off.
 if (level === 'off') {
-  try { writeHookOutput('SessionStart', 'off', 'HOMIE DEFAULT OFF — start normal.'); } catch (e) {}
+  try { setLevel('off'); } catch (e) {}
   process.exit(0);
 }
 
@@ -35,7 +37,7 @@ try {
 }
 
 // 2. Emit the homie ruleset at the default level.
-let output = getChillInstructions(level);
+let output = getHomieInstructions(level);
 
 // 3. Detect missing statusline config — nudge Claude to help set it up.
 // Codex and Copilot don't read Claude settings.json; skip the nudge there.

package/hooks/homie-instructions.js

@@ -97,7 +97,7 @@ function getFallbackInstructions(level) {
     'Switch: /homie yo|dawg|mafa.';
 }
 
-function getChillInstructions(level) {
+function getHomieInstructions(level) {
   const effectiveLevel = normalizeLevel(level);
   if (!effectiveLevel || effectiveLevel === 'off') return '';
 
@@ -112,5 +112,5 @@ function getChillInstructions(level) {
 module.exports = {
   filterSkillBodyForLevel,
   getFallbackInstructions,
-  getChillInstructions,
+  getHomieInstructions,
 };

package/hooks/homie-mode-tracker.js

@@ -6,10 +6,9 @@ const { getDefaultLevel, writeDefaultLevel, isDeactivationCommand } = require('.
 const {
   readLevel,
   setLevel,
-  clearLevel,
   writeHookOutput,
 } = require('./homie-runtime');
-const { getChillInstructions } = require('./homie-instructions');
+const { getHomieInstructions } = require('./homie-instructions');
 
 let input = '';
 let done = false;
@@ -75,7 +74,7 @@ function finish() {
         // Deliver the new level's ruleset along with the confirmation so the
         // switch turn itself is already in voice.
         const header = 'HOMIE MODE CHANGED — level: ' + level;
-        writeHookOutput('UserPromptSubmit', level, header + '\n\n' + getChillInstructions(level));
+        writeHookOutput('UserPromptSubmit', level, header + '\n\n' + getHomieInstructions(level));
       } else if (level === 'off') {
         // Persist `off` like any level (plan lesson #7): clearing the flag
         // races the default logic — an absent flag reads as the default level.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kpnpm/homie",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Personality layer for coding agents. Same code, different voice: yo / dawg / mafa / off.",
   "keywords": [
     "opencode-plugin",
@@ -43,4 +43,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}