devlyn-cli 1.1.0 → 1.1.2

package/README.md

@@ -6,9 +6,9 @@
   <img alt="DEVLYN" src="assets/logo.svg" width="540" />
 </picture>
 
-### The Skills & Commands Toolkit for Claude Code
+### Context Engineering & Harness Engineering Toolkit for Claude Code
 
-**Ship better code with battle-tested AI workflows — debugging, code review, UI design, product specs, and more.**
+**Structured prompts, agent orchestration, and automated pipelines — debugging, code review, UI design, product specs, and more.**
 
 [![npm version](https://img.shields.io/npm/v/devlyn-cli.svg)](https://www.npmjs.com/package/devlyn-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -24,13 +24,26 @@
 
 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) is powerful out of the box — but teams need **consistent, repeatable workflows**. Without shared conventions, every developer prompts differently, reviews differently, and debugs differently.
 
-devlyn-cli solves this by installing a curated `.claude/` configuration into any project:
+devlyn-cli solves this with two complementary engineering approaches:
+
+### Context Engineering
+
+Structured prompts and role-based instructions that shape _what the AI knows and how it thinks_ for each task.
 
 - **16 slash commands** for debugging, code review, UI design, documentation, and more
 - **5 core skills** that activate automatically based on conversation context
-- **Agent team workflows** that spawn specialized AI teammates for complex tasks
+- **Agent team workflows** that spawn specialized AI teammates with role-specific expertise
 - **Product & feature spec templates** for structured planning
-- **Commit conventions** for consistent git history
+
+### Harness Engineering
+
+Pipeline orchestration that controls _how agents execute_ — permissions, state management, multi-phase workflows, and cross-model evaluation.
+
+- **`/devlyn:auto-resolve`** — 8-phase automated pipeline (build → evaluate → fix loop → simplify → review → security → clean → docs)
+- **`bypassPermissions` mode** for autonomous subagent execution
+- **File-based state machine** — agents communicate via `.claude/done-criteria.md` and `EVAL-FINDINGS.md`
+- **Git checkpoints** at each phase for rollback safety
+- **Cross-model evaluation** via `--with-codex` flag (OpenAI Codex as independent evaluator)
 
 **Zero dependencies. One command. Works with any project.**
 

package/bin/devlyn.js

@@ -521,10 +521,29 @@ async function init(skipPrompts = false) {
     }
   }
   if (!settings.env) settings.env = {};
+  // Auto-allow pipeline files so auto-resolve doesn't prompt for permission
+  if (!settings.permissions) settings.permissions = {};
+  if (!settings.permissions.allow) settings.permissions.allow = [];
+  const pipelinePermissions = [
+    'Write:.claude/done-criteria.md',
+    'Write:.claude/EVAL-FINDINGS.md',
+    'Edit:.claude/done-criteria.md',
+    'Edit:.claude/EVAL-FINDINGS.md',
+  ];
+  let settingsChanged = false;
+  for (const perm of pipelinePermissions) {
+    if (!settings.permissions.allow.includes(perm)) {
+      settings.permissions.allow.push(perm);
+      settingsChanged = true;
+    }
+  }
   if (!settings.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS) {
     settings.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = '1';
+    settingsChanged = true;
+  }
+  if (settingsChanged) {
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-    log('  → settings.json (agent teams enabled)', 'dim');
+    log('  → settings.json (agent teams + pipeline permissions)', 'dim');
   }
 
   // Install agents for other detected CLIs

package/config/skills/devlyn:auto-resolve/SKILL.md

@@ -26,7 +26,9 @@ $ARGUMENTS
    Codex examples: `--with-codex` (both), `--with-codex evaluate`, `--with-codex review`
    If no flags are present, use defaults.
 
-3. Announce the pipeline plan:
+3. **If `--with-codex` is enabled**: Read `references/codex-integration.md` and run the "PRE-FLIGHT CHECK" section to verify Codex MCP server availability before proceeding.
+
+4. Announce the pipeline plan:
 ```
 Auto-resolve pipeline starting
 Task: [extracted task description]

package/config/skills/devlyn:auto-resolve/references/codex-integration.md

@@ -6,6 +6,27 @@ Codex is accessed via `mcp__codex-cli__*` MCP tools (provided by codex-mcp-serve
 
 ---
 
+## PRE-FLIGHT CHECK
+
+Before starting the pipeline, verify the Codex MCP server is available by calling `mcp__codex-cli__ping`.
+
+- **If ping succeeds**: continue normally.
+- **If ping fails or `mcp__codex-cli__ping` tool is not found**: warn the user and ask how to proceed:
+  ```
+  ⚠ Codex MCP server not detected. --with-codex requires codex-mcp-server.
+
+  To install:
+    npm i -g @openai/codex
+    claude mcp add codex-cli -- npx -y codex-mcp-server
+
+  Options:
+    [1] Continue without --with-codex (Claude-only evaluation/review)
+    [2] Abort pipeline
+  ```
+  If the user chooses [1], disable `--with-codex` and continue. If [2], stop.
+
+---
+
 ## PHASE 2-CODEX: CROSS-MODEL EVALUATE
 
 Run after the Claude evaluator (Phase 2) completes, only if `--with-codex` includes `evaluate` or `both`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devlyn-cli",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Claude Code configuration toolkit for teams",
   "bin": {
     "devlyn": "bin/devlyn.js"