noskills 4.1.41 → 4.1.43

package/README.md

@@ -110,8 +110,9 @@ reminders into every task. Stack concerns to define your project's character.
 
 **One source of truth for every tool.** Write rules once in `.eser/rules/`.
 noskills generates CLAUDE.md, .cursorrules, Kiro steering files, Copilot
-instructions, and Windsurf rules. Your teammate on Cursor and your teammate on
-Claude Code both get the same conventions, automatically.
+instructions, Windsurf rules, OpenCode AGENTS.md + plugins, Codex CLI hooks +
+TOML agents, and Copilot CLI hooks + MCP config. Your teammate on Cursor and
+your teammate on Claude Code both get the same conventions, automatically.
 
 **A human who's always in charge.** noskills never makes decisions silently.
 Discovery questions -> you answer. Spec approval -> you decide. Architectural
@@ -261,6 +262,11 @@ eser noskills concern add open-source       # Activate concerns
 eser noskills spec new "photo upload"       # Start spec -> DISCOVERY
 # Agent takes over: calls noskills next, answers questions,
 # builds to spec, reports progress. You approve transitions.
+
+# Or skip structure entirely:
+eser noskills free                          # FREE mode — no enforcement
+# Work freely, then exit when you want structure back:
+eser noskills free --exit                   # Back to IDLE
 ```
 
 After `init`, your CLAUDE.md (or .cursorrules, etc.) tells the agent to call
@@ -349,13 +355,15 @@ Every spec follows a deterministic phase flow:
 
 ```
 IDLE -> DISCOVERY -> DISCOVERY_REVIEW -> SPEC_DRAFT -> SPEC_APPROVED -> EXECUTING <-> BLOCKED
- ^                                                                          |
+ ^  \                                                                       |
+ |   <-> FREE                                                               |
  +--------------------------------- DONE <---------------------------------+
 ```
 
 | Phase                | What happens                                                           |
 | -------------------- | ---------------------------------------------------------------------- |
 | **IDLE**             | No active spec. Start one with `noskills spec new "..."`               |
+| **FREE**             | No enforcement. Work freely. Agent has no restrictions from noskills   |
 | **DISCOVERY**        | 6 blended questions probe product, engineering, and QA simultaneously  |
 | **DISCOVERY_REVIEW** | User reviews and confirms all discovery answers before spec generation |
 | **SPEC_DRAFT**       | Spec generated from discovery answers. Human reviews                   |
@@ -411,7 +419,7 @@ Every `noskills next` call returns a structured JSON payload:
       "Do not refactor, improve, or modify code outside this task's scope.",
       "Complete the task, then report progress. The user handles git."
     ],
-    "tone": "Direct. No preamble. Start coding immediately."
+    "tone": "Direct. Orchestrate immediately — spawn sub-agents."
   },
   "context": {
     "rules": ["Use Deno for all TypeScript"],
@@ -462,13 +470,15 @@ noskills status -o json    # Structured status for scripts
 Every `noskills next` output includes a `behavioral` block with phase-specific
 rules. These tell the agent HOW to behave, not just WHAT to do:
 
-| Phase      | Behavioral tone                | Key rules                                                     |
-| ---------- | ------------------------------ | ------------------------------------------------------------- |
-| DISCOVERY  | "Curious, has a stake"         | Push back on shallow answers, probe for specifics, don't code |
-| SPEC_DRAFT | "The user is reviewing"        | Don't modify the spec, don't start coding                     |
-| EXECUTING  | "Start coding immediately"     | Don't explore beyond scope, don't refactor, timebox reading   |
-| BLOCKED    | "Brief. Decision time."        | Present decision as-is, don't suggest preferences             |
-| DONE       | "Celebrate briefly, then stop" | Don't start new work                                          |
+| Phase      | Behavioral tone                  | Key rules                                                     |
+| ---------- | -------------------------------- | ------------------------------------------------------------- |
+| IDLE       | "Welcoming. Present choices"     | No file edits until free mode or spec approved                |
+| FREE       | "Quiet. No enforcement."         | No restrictions — work freely                                 |
+| DISCOVERY  | "Curious, has a stake"           | Push back on shallow answers, probe for specifics, don't code |
+| SPEC_DRAFT | "The user is reviewing"          | Don't modify the spec, don't start coding                     |
+| EXECUTING  | "Orchestrate — spawn sub-agents" | Delegate to sub-agents, don't edit files directly             |
+| BLOCKED    | "Brief. Decision time."          | Present decision as-is, don't suggest preferences             |
+| DONE       | "Celebrate briefly, then stop"   | Don't start new work                                          |
 
 **Git is read-only** for agents (configurable via `allowGit: true` in manifest).
 Agents may read (`git log`, `git diff`, `git status`) but never write
@@ -634,9 +644,10 @@ noskills next --answer='{"involvesWebUI":true,"involvesCLI":false,"involvesPubli
 
 ### Hooks — Zero-Token Bookkeeping
 
-noskills installs hooks for Claude Code (`.claude/settings.json`) and Kiro
-(`.kiro/settings/hooks.json`) that handle state bookkeeping without spending LLM
-tokens. Claude Code hooks:
+noskills installs hooks for Claude Code (`.claude/settings.json`), Kiro
+(`.kiro/settings/hooks.json`), OpenCode (`.opencode/plugins/noskills.ts`), Codex
+CLI (`.codex/hooks.json`), and Copilot CLI (`.github/hooks/noskills.json`) that
+handle state bookkeeping without spending LLM tokens. Claude Code hooks:
 
 | Hook                | Event        | What it does                                                                                                                                         |
 | ------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -648,6 +659,11 @@ tokens. Claude Code hooks:
 
 Kiro hooks map the same behavioral guarantees to Kiro-native triggers (Pre Tool
 Use, Post Tool Use, Agent Stop, Prompt Submit) using Run Command actions.
+OpenCode hooks use the plugin system (`.opencode/plugins/`) with event handlers
+for session.created, tool.execute.before/after, and session.deleted. Codex CLI
+hooks use `.codex/hooks.json` with PascalCase events (SessionStart, PreToolUse,
+PostToolUse, Stop). Copilot CLI hooks use `.github/hooks/noskills.json` with a
+versioned schema (`{"version": 1, "hooks": {...}}`) and array-format commands.
 
 Hooks are CLI subcommands (`noskills invoke-hook <name>`), not generated script
 files. This avoids ESM/CJS issues — the same Deno entry point handles
@@ -674,7 +690,18 @@ noskills generates instruction files for every AI tool your team uses:
     |-- -> .kiro/agents/*.json             (Kiro custom agents)
     |-- -> .kiro/specs/                    (Kiro spec projection)
     |-- -> .github/copilot-instructions.md (GitHub Copilot)
-    +-- -> .windsurfrules                  (Windsurf)
+    |-- -> .windsurfrules                  (Windsurf)
+    |-- -> AGENTS.md                       (OpenCode / Codex / Copilot CLI)
+    |-- -> .opencode/plugins/noskills.ts   (OpenCode hooks)
+    |-- -> .opencode/agents/*.md           (OpenCode agents)
+    |-- -> .opencode/skills/*.md           (OpenCode spec projection)
+    |-- -> opencode.json                   (OpenCode MCP registration)
+    |-- -> .codex/hooks.json               (Codex CLI hooks)
+    |-- -> .codex/agents/*.toml            (Codex CLI agents)
+    |-- -> .codex/config.toml              (Codex CLI MCP registration)
+    |-- -> .github/hooks/noskills.json     (Copilot CLI hooks)
+    |-- -> .github/agents/*.agent.md       (Copilot CLI agents)
+    +-- -> .copilot/mcp.json               (Copilot CLI MCP registration)
 ```
 
 Write your rules once in `.eser/rules/`, run `noskills sync`, and every tool
@@ -843,7 +870,8 @@ install all get correct command references.
 **Tools vs Providers:**
 
 - **Tools** = the IDE or agent environment (`claude-code`, `cursor`, `kiro`,
-  `copilot`, `windsurf`). Affects which sync output files are generated.
+  `copilot`, `windsurf`, `opencode`, `codex`, `copilot-cli`). Affects which sync
+  output files are generated.
 - **Providers** = AI model access methods (`anthropic`, `openai`, `ollama`,
   `claude-code` CLI). Used by the Agent Bridge for validation and
   `noskills run`.

package/chunks/approve-NPG6X7O6.js

@@ -0,0 +1 @@
+import{a as k}from"./chunk-SNHYXBHM.js";import{a as x,d as F}from"./chunk-3SLKOP72.js";import"./chunk-VPXOI7CR.js";import{c as p}from"./chunk-YK6UG66R.js";import{g as P,i as A}from"./chunk-TMC5H2A5.js";import{d as y,f as C,h as R,i as w,j as u,l as D,p as E}from"./chunk-LWCWPXCS.js";import{c as i,d as l,f as a,g as d,k as m,o as S,q as v,r as g}from"./chunk-Y6AFIAJP.js";import{a as h,b as n}from"./chunk-2N4GTHXQ.js";import{b as c}from"./chunk-MNEZ5QGX.js";import"./chunk-DHMCIRLT.js";import"./chunk-4BH6CF3J.js";import"./chunk-OTRBRRIO.js";var M=async _=>{let s=S({renderer:g.ansi(),sink:v.stdout()}),r=c.process.cwd(),o=R(_);if(!o.ok)return s.writeln(a(o.error)),await s.close(),n({exitCode:1});let t;try{t=await C(r,o.spec)}catch(e){let f=e instanceof Error?e.message:String(e);return s.writeln(a(f)),await s.close(),n({exitCode:1})}let $=await D(r);if(t.spec!==null){let e=`${r}/${y.specDir(t.spec)}`;try{await c.fs.stat(e)}catch{return s.writeln(a(`Active spec '${t.spec}' directory not found.`)),s.writeln(l("Run `noskills reset` to return to IDLE.")),await s.close(),n({exitCode:1})}}if(t.phase==="SPEC_DRAFT"){if(t.classification===null&&t.spec!==null){let b=(await E(r)).filter(I=>$?.concerns.includes(I.id)??!1);try{await k(r,t,b)}catch{}}let e=A(t);await w(r,e),e.spec!==null&&await u(r,e.spec,e),e.spec!==null&&(await x(r,e.spec,"approved"),await F(r,e.spec,"approved")),s.writeln(d("\u2714")," Spec approved. Phase: ",m("SPEC_APPROVED")),s.writeln("When ready, run ",i(`${p('next --answer="start"')}`)," to begin execution.")}else if(t.phase==="DISCOVERY_REVIEW"){let e=P(t);await w(r,e),e.spec!==null&&await u(r,e.spec,e),s.writeln(d("\u2714")," Discovery answers approved. Phase: ",m("SPEC_DRAFT")),s.writeln("Review the spec and run ",i(p("approve"))," again to approve.")}else t.phase==="DISCOVERY"&&t.discovery.completed?(s.writeln(l("Discovery complete. Spec draft already generated.")),s.writeln("Review the spec and run ",i(p("approve"))," again when in SPEC_DRAFT phase.")):s.writeln(a(`Cannot approve in phase: ${t.phase}`));return await s.close(),h(void 0)};export{M as main};

package/chunks/block-LSEXCK45.js

@@ -0,0 +1 @@
+import{c as v}from"./chunk-YK6UG66R.js";import{k as A}from"./chunk-TMC5H2A5.js";import{d as k,f as S,h as y,i as x,j as C}from"./chunk-LWCWPXCS.js";import{c as d,d as l,f as i,h as f,o as w,q as h,r as g}from"./chunk-Y6AFIAJP.js";import{a as u,b as r}from"./chunk-2N4GTHXQ.js";import{b as c}from"./chunk-MNEZ5QGX.js";import"./chunk-DHMCIRLT.js";import"./chunk-4BH6CF3J.js";import"./chunk-OTRBRRIO.js";var q=async p=>{let e=w({renderer:g.ansi(),sink:h.stdout()}),n=c.process.cwd(),o=y(p);if(!o.ok)return e.writeln(i(o.error)),await e.close(),r({exitCode:1});let m=(p??[]).filter(t=>!t.startsWith("--spec=")).join(" ")||"No reason given",s;try{s=await S(n,o.spec)}catch(t){let E=t instanceof Error?t.message:String(t);return e.writeln(i(E)),await e.close(),r({exitCode:1})}if(s.spec!==null){let t=`${n}/${k.specDir(s.spec)}`;try{await c.fs.stat(t)}catch{return e.writeln(i(`Active spec '${s.spec}' directory not found.`)),e.writeln(l("Run `noskills reset` to return to IDLE.")),await e.close(),r({exitCode:1})}}if(s.phase!=="EXECUTING")return e.writeln(i(`Cannot block in phase: ${s.phase}`)),await e.close(),r({exitCode:1});let a=A(s,m);return await x(n,a),a.spec!==null&&await C(n,a.spec,a),e.writeln(f("\u26A0")," Spec blocked: ",l(m)),e.writeln("Resolve with: ",d(`${v('next --answer="resolution"')}`)),await e.close(),u(void 0)};export{q as main};

package/chunks/cancel-7NGO246Z.js

@@ -0,0 +1 @@
+import{a as k,d as D}from"./chunk-3SLKOP72.js";import{m as C}from"./chunk-TMC5H2A5.js";import{d as w,f as h,h as S,i as g,j as y}from"./chunk-LWCWPXCS.js";import{d as l,f as n,g as m,o as u,q as d,r as f}from"./chunk-Y6AFIAJP.js";import{a as p,b as i}from"./chunk-2N4GTHXQ.js";import{b as o}from"./chunk-MNEZ5QGX.js";import"./chunk-DHMCIRLT.js";import"./chunk-4BH6CF3J.js";import"./chunk-OTRBRRIO.js";var R=async E=>{let e=u({renderer:f.ansi(),sink:d.stdout()}),r=o.process.cwd(),c=S(E);if(!c.ok)return e.writeln(n(c.error)),await e.close(),i({exitCode:1});let s;try{s=await h(r,c.spec)}catch(a){let I=a instanceof Error?a.message:String(a);return e.writeln(n(I)),await e.close(),i({exitCode:1})}if(s.phase==="IDLE"||s.phase==="UNINITIALIZED"||s.phase==="COMPLETED")return e.writeln(n(`Cannot cancel in phase: ${s.phase}`)),await e.close(),i({exitCode:1});if(s.spec!==null){let a=`${r}/${w.specDir(s.spec)}`;try{await o.fs.stat(a)}catch{return e.writeln(n(`Active spec '${s.spec}' directory not found.`)),e.writeln(l("Run `noskills reset` to return to IDLE.")),await e.close(),i({exitCode:1})}}let t=C(s,"cancelled");return await g(r,t),t.spec!==null&&await y(r,t.spec,t),t.spec!==null&&(await k(r,t.spec,"cancelled"),await D(r,t.spec,"cancelled")),e.writeln(m("\u2714")," Spec cancelled."),await e.close(),p(void 0)};export{R as main};

package/chunks/{chunk-CIYGCZTM.js → chunk-3SLKOP72.js}

@@ -1,3 +1,3 @@
-import{d as o}from"./chunk-RIME26D6.js";import{b as e}from"./chunk-MNEZ5QGX.js";var d=async(r,i,n)=>{let s=`${r}/${o.specFile(i)}`;try{let t=await e.fs.readTextFile(s);t=t.replace(/^## Status: .+$/m,`## Status: ${n}`),await e.fs.writeTextFile(s,t)}catch{}},u=async(r,i,n)=>{let s=`${r}/${o.specFile(i)}`;try{let t=await e.fs.readTextFile(s),a=new RegExp(`^(- )\\[ \\]( ${n}:.*)$`,"m");t=t.replace(a,"$1[x]$2"),await e.fs.writeTextFile(s,t)}catch{}},w=async(r,i,n,s)=>{let t=`${r}/${o.specDir(i)}/progress.json`;try{let a=await e.fs.readTextFile(t),c=JSON.parse(a);for(let p of c.tasks)p.id===n&&(p.status=s);c.updatedAt=new Date().toISOString(),await e.fs.writeTextFile(t,JSON.stringify(c,null,2)+`
+import{d as o}from"./chunk-LWCWPXCS.js";import{b as e}from"./chunk-MNEZ5QGX.js";var d=async(r,i,n)=>{let s=`${r}/${o.specFile(i)}`;try{let t=await e.fs.readTextFile(s);t=t.replace(/^## Status: .+$/m,`## Status: ${n}`),await e.fs.writeTextFile(s,t)}catch{}},u=async(r,i,n)=>{let s=`${r}/${o.specFile(i)}`;try{let t=await e.fs.readTextFile(s),a=new RegExp(`^(- )\\[ \\]( ${n}:.*)$`,"m");t=t.replace(a,"$1[x]$2"),await e.fs.writeTextFile(s,t)}catch{}},w=async(r,i,n,s)=>{let t=`${r}/${o.specDir(i)}/progress.json`;try{let a=await e.fs.readTextFile(t),c=JSON.parse(a);for(let p of c.tasks)p.id===n&&(p.status=s);c.updatedAt=new Date().toISOString(),await e.fs.writeTextFile(t,JSON.stringify(c,null,2)+`
 `)}catch{}},f=async(r,i,n)=>{let s=`${r}/${o.specDir(i)}/progress.json`;try{let t=await e.fs.readTextFile(s),a=JSON.parse(t);a.status=n,a.updatedAt=new Date().toISOString(),await e.fs.writeTextFile(s,JSON.stringify(a,null,2)+`
 `)}catch{}};export{d as a,u as b,w as c,f as d};