@lovelybunch/core 1.0.76-alpha.1 → 1.0.76-alpha.11

package/dist/pipeline-builders.js

@@ -0,0 +1,208 @@
+import { getChangeTaskInstructions, getPrepareChangeTaskInstructions, getSkillInstructions, } from './skill-instructions.js';
+/**
+ * Sanitize instruction text for safe embedding in shell commands.
+ * - Backticks -> single quotes (prevents shell command substitution)
+ * - Curly/smart quotes -> straight equivalents
+ */
+export function sanitizeInstruction(text) {
+    return text
+        .replace(/`/g, "'")
+        .replace(/[\u2018\u2019]/g, "'")
+        .replace(/[\u201C\u201D]/g, '"');
+}
+function getInstructionParts(cfg) {
+    const skillPaths = cfg.selectedSkillIds.map((id) => `.nut/skills/${id}/SKILL.md`);
+    const safeCustom = cfg.customInstruction ? sanitizeInstruction(cfg.customInstruction) : cfg.customInstruction;
+    const parts = cfg.contextType === 'change-task'
+        ? getChangeTaskInstructions(cfg.taskId, skillPaths, safeCustom, cfg.includeDefaultInstructions ?? true)
+        : cfg.contextType === 'prepare-task'
+            ? getPrepareChangeTaskInstructions(cfg.taskId, skillPaths, safeCustom)
+            : getSkillInstructions(skillPaths, safeCustom);
+    return parts.join(' ');
+}
+/**
+ * Encode a string as base64 in a way that works in both Node.js and browsers.
+ */
+function toBase64(str) {
+    const bytes = new TextEncoder().encode(str);
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++)
+        binary += String.fromCharCode(bytes[i]);
+    return btoa(binary);
+}
+/**
+ * Wrap a JS script as a shell command that writes a temp file from a base64
+ * payload, executes it, then cleans up. This avoids PTY echo noise (the
+ * echoed text is an opaque base64 string instead of readable source) and
+ * sidesteps shell-escaping and input-buffer issues.
+ */
+function wrapAsBase64TempFile(nodeJs, exitAfter = false) {
+    const b64 = toBase64(nodeJs);
+    const suffix = exitAfter ? '; exit' : '';
+    return `_f=$(mktemp /tmp/.nut-XXXXXX) && echo '${b64}' | base64 -d > "$_f" && node "$_f"; rm -f "$_f"${suffix}`;
+}
+function buildMcpSelSet(selectedMcpServers) {
+    return selectedMcpServers.map((n) => `'${n.replace(/'/g, "'\\''")}'`).join(',');
+}
+export const buildClaudeCommand = (cfg) => {
+    const interactive = cfg.interactive ?? true;
+    const instruction = getInstructionParts(cfg);
+    const selList = buildMcpSelSet(cfg.selectedMcpServers);
+    const args = [];
+    if (!interactive)
+        args.push(JSON.stringify('-p'));
+    args.push(JSON.stringify(instruction));
+    if (cfg.automationEnabled)
+        args.push(JSON.stringify('--dangerously-skip-permissions'));
+    const nodeJs = `const fs=require('fs'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const filtered=Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)).map(([k,v])=>[k,{...v,type:v.type||(v.url?'http':'stdio')}]);const o={mcpServers:Object.fromEntries(filtered)};fs.writeFileSync('.mcp.json',JSON.stringify(o,null,2));const p=spawn('claude',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+    return wrapAsBase64TempFile(nodeJs, !interactive);
+};
+export const buildGeminiCommand = (cfg) => {
+    const interactive = cfg.interactive ?? true;
+    const instruction = getInstructionParts(cfg);
+    const selList = buildMcpSelSet(cfg.selectedMcpServers);
+    const args = [];
+    if (!interactive)
+        args.push(`'--non-interactive'`);
+    if (cfg.automationEnabled)
+        args.push(`'--yolo'`);
+    args.push(JSON.stringify(instruction));
+    const nodeJs = `const fs=require('fs'),path=require('path'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const geminiPath=path.join(require('os').homedir(),'.gemini','settings.json');let settings={};try{settings=JSON.parse(fs.readFileSync(geminiPath,'utf8'))}catch(e){}settings.mcpServers=Object.fromEntries(Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)));fs.writeFileSync(geminiPath,JSON.stringify(settings,null,2));const p=spawn('gemini',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+    return wrapAsBase64TempFile(nodeJs, !interactive);
+};
+export const buildCodexCommand = (cfg) => {
+    const interactive = cfg.interactive ?? true;
+    const instruction = getInstructionParts(cfg);
+    const selList = buildMcpSelSet(cfg.selectedMcpServers);
+    const args = [];
+    if (!interactive)
+        args.push(JSON.stringify('exec'));
+    args.push(JSON.stringify(instruction));
+    if (cfg.automationEnabled)
+        args.push(JSON.stringify('--dangerously-bypass-approvals-and-sandbox'));
+    const nodeJs = `const fs=require('fs'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const filtered=Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)).map(([k,v])=>[k,{...v,type:v.type||(v.url?'http':'stdio')}]);const o={mcpServers:Object.fromEntries(filtered)};fs.writeFileSync('.mcp.json',JSON.stringify(o,null,2));const p=spawn('codex',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+    return wrapAsBase64TempFile(nodeJs, !interactive);
+};
+export const buildDroidCommand = (cfg) => {
+    const interactive = cfg.interactive ?? true;
+    const instruction = getInstructionParts(cfg);
+    const selList = buildMcpSelSet(cfg.selectedMcpServers);
+    const args = [];
+    if (!interactive)
+        args.push(JSON.stringify('exec'));
+    args.push(JSON.stringify(instruction));
+    const nodeJs = `const fs=require('fs'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const filtered=Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)).map(([k,v])=>[k,{...v,type:v.type||(v.url?'http':'stdio')}]);const o={mcpServers:Object.fromEntries(filtered)};fs.writeFileSync('.mcp.json',JSON.stringify(o,null,2));const p=spawn('droid',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+    return wrapAsBase64TempFile(nodeJs, !interactive);
+};
+export const buildKiroCommand = (cfg) => {
+    const interactive = cfg.interactive ?? true;
+    const instruction = getInstructionParts(cfg);
+    const selList = buildMcpSelSet(cfg.selectedMcpServers);
+    const args = [`'chat'`];
+    if (!interactive || cfg.automationEnabled)
+        args.push(`'--no-interactive'`);
+    if (cfg.automationEnabled)
+        args.push(`'--trust-all-tools'`);
+    args.push(JSON.stringify(instruction));
+    const nodeJs = `const fs=require('fs'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const filtered=Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)).map(([k,v])=>[k,{...v,type:v.type||(v.url?'http':'stdio')}]);const o={mcpServers:Object.fromEntries(filtered)};fs.writeFileSync('.mcp.json',JSON.stringify(o,null,2));const p=spawn('kiro-cli',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+    return wrapAsBase64TempFile(nodeJs, !interactive);
+};
+/**
+ * Build a short banner printed in the terminal before the agent launches.
+ */
+export function buildPipelineBanner(cfg) {
+    const mode = (cfg.interactive ?? true)
+        ? 'interactive'
+        : 'non-interactive (agent will exit on completion)';
+    return [
+        ``,
+        `Running ${cfg.cliAgent} 🥥`,
+        ``,
+        `Task:    ${cfg.taskId}`,
+        `Context: ${cfg.contextType}`,
+        `Mode:    ${mode}`,
+        ``,
+        ``,
+    ].join('\\n');
+}
+const BUILDERS = {
+    claude: buildClaudeCommand,
+    gemini: buildGeminiCommand,
+    codex: buildCodexCommand,
+    droid: buildDroidCommand,
+    kiro: buildKiroCommand,
+};
+/**
+ * Build the shell command for a given pipeline configuration.
+ * Returns a heredoc-wrapped command suitable for direct PTY input.
+ * Prefer `buildPipelineScript` + temp file for server/CLI callers
+ * to avoid PTY echo noise.
+ */
+export function buildPipelineCommand(cfg) {
+    const builder = BUILDERS[cfg.cliAgent];
+    if (!builder) {
+        throw new Error(`Unknown CLI agent: ${cfg.cliAgent}`);
+    }
+    return builder(cfg);
+}
+/**
+ * Build just the raw Node.js script for a pipeline configuration.
+ * Callers should write this to a temp file and execute `node <path>`,
+ * which avoids PTY echo noise and input-buffer limits.
+ */
+export function buildPipelineScript(cfg) {
+    const instruction = getInstructionParts(cfg);
+    const interactive = cfg.interactive ?? true;
+    const selList = buildMcpSelSet(cfg.selectedMcpServers);
+    const agentScripts = {
+        claude: () => {
+            const args = [];
+            if (!interactive)
+                args.push(JSON.stringify('-p'));
+            args.push(JSON.stringify(instruction));
+            if (cfg.automationEnabled)
+                args.push(JSON.stringify('--dangerously-skip-permissions'));
+            return `const fs=require('fs'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const filtered=Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)).map(([k,v])=>[k,{...v,type:v.type||(v.url?'http':'stdio')}]);const o={mcpServers:Object.fromEntries(filtered)};fs.writeFileSync('.mcp.json',JSON.stringify(o,null,2));const p=spawn('claude',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+        },
+        gemini: () => {
+            const args = [];
+            if (!interactive)
+                args.push(`'--non-interactive'`);
+            if (cfg.automationEnabled)
+                args.push(`'--yolo'`);
+            args.push(JSON.stringify(instruction));
+            return `const fs=require('fs'),path=require('path'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const geminiPath=path.join(require('os').homedir(),'.gemini','settings.json');let settings={};try{settings=JSON.parse(fs.readFileSync(geminiPath,'utf8'))}catch(e){}settings.mcpServers=Object.fromEntries(Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)));fs.writeFileSync(geminiPath,JSON.stringify(settings,null,2));const p=spawn('gemini',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+        },
+        codex: () => {
+            const args = [];
+            if (!interactive)
+                args.push(JSON.stringify('exec'));
+            args.push(JSON.stringify(instruction));
+            if (cfg.automationEnabled)
+                args.push(JSON.stringify('--dangerously-bypass-approvals-and-sandbox'));
+            return `const fs=require('fs'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const filtered=Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)).map(([k,v])=>[k,{...v,type:v.type||(v.url?'http':'stdio')}]);const o={mcpServers:Object.fromEntries(filtered)};fs.writeFileSync('.mcp.json',JSON.stringify(o,null,2));const p=spawn('codex',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+        },
+        droid: () => {
+            const args = [];
+            if (!interactive)
+                args.push(JSON.stringify('exec'));
+            args.push(JSON.stringify(instruction));
+            return `const fs=require('fs'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const filtered=Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)).map(([k,v])=>[k,{...v,type:v.type||(v.url?'http':'stdio')}]);const o={mcpServers:Object.fromEntries(filtered)};fs.writeFileSync('.mcp.json',JSON.stringify(o,null,2));const p=spawn('droid',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+        },
+        kiro: () => {
+            const args = [`'chat'`];
+            if (!interactive || cfg.automationEnabled)
+                args.push(`'--no-interactive'`);
+            if (cfg.automationEnabled)
+                args.push(`'--trust-all-tools'`);
+            args.push(JSON.stringify(instruction));
+            return `const fs=require('fs'),{spawn}=require('child_process');const s=new Set([${selList}]);const c=JSON.parse(fs.readFileSync('.nut/mcp/config.json','utf8'));const filtered=Object.entries(c.mcpServers||{}).filter(([k])=>s.has(k)).map(([k,v])=>[k,{...v,type:v.type||(v.url?'http':'stdio')}]);const o={mcpServers:Object.fromEntries(filtered)};fs.writeFileSync('.mcp.json',JSON.stringify(o,null,2));const p=spawn('kiro-cli',[${args.join(',')}],{stdio:'inherit'});p.on('exit',code=>process.exit(code));`;
+        },
+    };
+    const scriptBuilder = agentScripts[cfg.cliAgent];
+    if (!scriptBuilder) {
+        throw new Error(`Unknown CLI agent: ${cfg.cliAgent}`);
+    }
+    return scriptBuilder();
+}
+//# sourceMappingURL=pipeline-builders.js.map

package/dist/pipeline-builders.js.map

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

package/dist/pipelines.d.ts

@@ -0,0 +1,4 @@
+export { SCHEMA_REFERENCE_INSTRUCTION, PROJECT_REFERENCE_INSTRUCTION, getChangeTaskInstructions, getPrepareChangeTaskInstructions, getSkillInstructions, getAgentInstructions, } from './skill-instructions.js';
+export { sanitizeInstruction, buildClaudeCommand, buildGeminiCommand, buildCodexCommand, buildDroidCommand, buildKiroCommand, buildPipelineCommand, buildPipelineScript, buildPipelineBanner, } from './pipeline-builders.js';
+export type { CliAgent, PipelineContextType, PipelineConfig, BuildCommand, } from './pipeline-builders.js';
+//# sourceMappingURL=pipelines.d.ts.map

package/dist/pipelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelines.d.ts","sourceRoot":"","sources":["../src/pipelines.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,EACzB,gCAAgC,EAChC,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EACV,QAAQ,EACR,mBAAmB,EACnB,cAAc,EACd,YAAY,GACb,MAAM,wBAAwB,CAAA"}

package/dist/pipelines.js

@@ -0,0 +1,3 @@
+export { SCHEMA_REFERENCE_INSTRUCTION, PROJECT_REFERENCE_INSTRUCTION, getChangeTaskInstructions, getPrepareChangeTaskInstructions, getSkillInstructions, getAgentInstructions, } from './skill-instructions.js';
+export { sanitizeInstruction, buildClaudeCommand, buildGeminiCommand, buildCodexCommand, buildDroidCommand, buildKiroCommand, buildPipelineCommand, buildPipelineScript, buildPipelineBanner, } from './pipeline-builders.js';
+//# sourceMappingURL=pipelines.js.map

package/dist/pipelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelines.js","sourceRoot":"","sources":["../src/pipelines.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,EACzB,gCAAgC,EAChC,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA"}

package/dist/skill-instructions.d.ts

@@ -1,11 +1,11 @@
 export declare const SCHEMA_REFERENCE_INSTRUCTION = "Consult the schema references in .nut/.schema (task.schema.md, project.schema.md, architecture.schema.md, skill.schema.md, knowledge.schema.md) so any updates you make follow the documented structure and include complete arrays for plan steps, dependencies, tags, labels, and comments.";
 export declare const PROJECT_REFERENCE_INSTRUCTION = "Use .nut/context/project.md and .nut/context/architecture.md for reference.";
 /**
- * Get instructions for change task (cp-*) workflows
+ * Get instructions for change task (task-*) workflows
  */
-export declare function getChangeTaskInstructions(proposalId: string, skillPaths: string[], customInstruction?: string, includeDefaultInstructions?: boolean): string[];
+export declare function getChangeTaskInstructions(taskId: string, skillPaths: string[], customInstruction?: string, includeDefaultInstructions?: boolean): string[];
 /**
- * Get instructions for reviewing / preparing a change task (cp-*) before implementation.
+ * Get instructions for reviewing / preparing a change task (task-*) before implementation.
  * Assesses readiness without starting any actual work.
  */
 export declare function getPrepareChangeTaskInstructions(taskId: string, skillPaths: string[], customInstruction?: string): string[];

package/dist/skill-instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-instructions.d.ts","sourceRoot":"","sources":["../src/skill-instructions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,kSACwP,CAAC;AAClS,eAAO,MAAM,6BAA6B,gFACqC,CAAA;AAE/E;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,0BAA0B,GAAE,OAAc,GACzC,MAAM,EAAE,CAyEV;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,EAAE,CAoEV;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,EAAE,CAgBV;AAGD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,6BAAuB,CAAC"}
+{"version":3,"file":"skill-instructions.d.ts","sourceRoot":"","sources":["../src/skill-instructions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,kSACwP,CAAC;AAClS,eAAO,MAAM,6BAA6B,gFACqC,CAAA;AAE/E;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,0BAA0B,GAAE,OAAc,GACzC,MAAM,EAAE,CAyFV;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,EAAE,CAqFV;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,EAAE,CAgBV;AAGD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,6BAAuB,CAAC"}

package/dist/skill-instructions.js

@@ -1,9 +1,9 @@
 export const SCHEMA_REFERENCE_INSTRUCTION = 'Consult the schema references in .nut/.schema (task.schema.md, project.schema.md, architecture.schema.md, skill.schema.md, knowledge.schema.md) so any updates you make follow the documented structure and include complete arrays for plan steps, dependencies, tags, labels, and comments.';
 export const PROJECT_REFERENCE_INSTRUCTION = 'Use .nut/context/project.md and .nut/context/architecture.md for reference.';
 /**
- * Get instructions for change task (cp-*) workflows
+ * Get instructions for change task (task-*) workflows
  */
-export function getChangeTaskInstructions(proposalId, skillPaths, customInstruction, includeDefaultInstructions = true) {
+export function getChangeTaskInstructions(taskId, skillPaths, customInstruction, includeDefaultInstructions = true) {
     const sections = [];
     // Add default instructions only if requested
     if (includeDefaultInstructions) {
@@ -12,43 +12,58 @@ export function getChangeTaskInstructions(proposalId, skillPaths, customInstruct
             `## Task`,
             ``,
             `- Review and begin working on the following task:`,
-            `  .nut/tasks/${proposalId}.md`,
-            `- Retrieve your firstName, lastName, and email address from: .nut/config.json and use this identity to address yourself in any task updates, comments, git commits, etc.`,
+            `  .nut/tasks/${taskId}.md`,
+            `- Retrieve your firstName, lastName, and email address from: .nut/config.json and use this identity for task updates, comments, git commits, etc.`,
         ].join('\n'));
         // Task Lifecycle section
         sections.push([
             `## Task Lifecycle`,
             ``,
-            `- Before beginning any work: nut task update ${proposalId} --status active`,
-            `- Add appropriate steps with: nut task step ${proposalId} "Step description" --author "firstName lastName"`,
+            `1. Before beginning any work, set the task to active:`,
+            `   nut task update ${taskId} --status active`,
             ``,
-            `- If you need human clarification or input: nut task update ${proposalId} --status blocked. The clarification can be communicated as follows: nut task comment ${proposalId} "Comments here" --author "firstName lastName". At this point please stop work.`,
+            `2. Work through the existing plan steps, updating each as you go:`,
+            `   nut task step-update ${taskId} <stepId> --status active    (when starting a step)`,
+            `   nut task step-update ${taskId} <stepId> --status done      (when complete)`,
+            `   nut task step-update ${taskId} <stepId> --status failed --error "reason"`,
+            `   nut task step-update ${taskId} <stepId> --status skipped   (if not applicable)`,
+            `   If no steps exist yet, add them: nut task step ${taskId} "Step description"`,
             ``,
-            `- When implementation is complete and ready for approval: nut task update ${proposalId} --status review`,
-            `- Only mark the task complete once approval criteria are satisfied: nut task update ${proposalId} --status done`,
+            `3. If you need human clarification or input, block the task and stop work:`,
+            `   nut task update ${taskId} --status blocked`,
+            `   nut task comment ${taskId} "Describe what you need" --author "firstName lastName"`,
+            ``,
+            `4. When implementation is complete and ready for review:`,
+            `   nut task update ${taskId} --status review`,
+            `   nut task comment ${taskId} "Summary of what was done" --author "firstName lastName"`,
+            ``,
+            `### Handling Revision Requests`,
+            ``,
+            `If the task status is 'revision', the user has reviewed your work and left feedback.`,
+            `Read the most recent comment(s) carefully, address the feedback, then set back to review:`,
+            `   nut task update ${taskId} --status review`,
         ].join('\n'));
         // Abilities section
         sections.push([
             `## Abilities`,
             ``,
-            `- The following abilities are at your disposal and should be factored into the plan where appropriate (each command has its own --help):`,
-            `  - Work with knowledge documents (used for the output of any research-centric tasks):`,
-            `    - nut knowledge create "Quick Note" --content "# Quick Note\\n\\nSome content here"`,
-            `    - nut knowledge list`,
-            `    - nut knowledge get example-filename.md`,
-            `  - Creating media such as images, audio, or video:`,
-            `    - nut resource`,
-            `  - Using available skills (specialized, reusable, and portable modules). There is also an official registry you can pull from:`,
-            `    - nut skill list`,
-            `    - nut skill registry list`,
-            `- Similarly, the following are available: git, gh, node, python`,
+            `Beyond task management, the following are at your disposal and should be factored into the plan where appropriate (each command has its own --help):`,
+            `- Knowledge documents (for research outputs, notes, and reference material):`,
+            `  - nut knowledge create "Title" --content "# Title\\n\\nContent here"`,
+            `  - nut knowledge list / get / update`,
+            `- Resource library (images, audio, video, or existing files):`,
+            `  - nut resource ls / add ./file.png`,
+            `  - nut resource image "description" --save`,
+            `  - nut resource audio "description" --save`,
+            `- Skills (specialized, reusable modules with an official registry):`,
+            `  - nut skill list / nut skill registry list`,
+            `- Also available: git, gh, node, python`,
         ].join('\n'));
         // Operational Rules section
         sections.push([
             `## Operational Rules`,
             ``,
-            `- DO use the nut CLI to update task status as progress changes`,
-            `  (nut --help or nut task --help for details)`,
+            `- DO use the nut CLI to update task and step status as progress changes`,
             `- DO NOT edit files outside the scope of the approved task (unless instructed by the Additional Instructions below)`,
         ].join('\n'));
     }
@@ -72,7 +87,7 @@ export function getChangeTaskInstructions(proposalId, skillPaths, customInstruct
     return [sections.join('\n\n')];
 }
 /**
- * Get instructions for reviewing / preparing a change task (cp-*) before implementation.
+ * Get instructions for reviewing / preparing a change task (task-*) before implementation.
  * Assesses readiness without starting any actual work.
  */
 export function getPrepareChangeTaskInstructions(taskId, skillPaths, customInstruction) {
@@ -81,43 +96,60 @@ export function getPrepareChangeTaskInstructions(taskId, skillPaths, customInstr
     sections.push([
         `## Your Task`,
         ``,
-        `- Review the following task (including all the existing comments and implementation steps) to ensure you have enough information and resources (skills, tools, access, etc) to successfully complete it: .nut/tasks/${taskId}.md`,
-        `- Note: DO NOT start any work at this stage, this is only a preparatory assessment phase.`,
-        `- Retrieve your firstName, lastName, and email address from: .nut/config.json and use this identity to address yourself in any task updates, comments, etc.`,
-        `- Add a readiness score between 0 and 100 where 100 is total confidence that you could complete the task without any mistakes or further user input: nut task update ${taskId} --readiness <score>`,
-        `- Add a comment that communicates your readiness and any other relevant information: nut task comment ${taskId} "Comment here" --author "firstName lastName".`,
-        `- If your readiness score is high enough, add appropriate implementation steps with: nut task step ${taskId} "Step description"`,
-        `- Of particular importance is whether it would make sense to decompose this into separate tasks, although DO NOT do this without user confirmation first.`,
-        `- Finally, update the task status to either 'ready' or 'blocked' based on your assessment: nut task update ${taskId} --status [ready|blocked]`,
+        `Review the following task to assess whether it is ready for implementation.`,
+        `This is a preparatory assessment phase only -- DO NOT start any implementation work.`,
+        ``,
+        `- Read the task (including all existing comments and plan steps): .nut/tasks/${taskId}.md`,
+        `- Retrieve your firstName, lastName, and email address from: .nut/config.json and use this identity for task updates, comments, etc.`,
+        ``,
+        `### Assessment Steps`,
+        ``,
+        `1. Set a readiness score (0-100, where 100 = total confidence you could complete the task without mistakes or further input):`,
+        `   nut task update ${taskId} --readiness <score>`,
+        ``,
+        `2. If readiness is high enough, add implementation plan steps:`,
+        `   nut task step ${taskId} "Step description"`,
+        ``,
+        `3. Evaluate whether the task should be decomposed into smaller tasks.`,
+        `   If decomposition is recommended, note this in your comment but DO NOT decompose without user confirmation.`,
+        ``,
+        `4. Add a comment summarizing your assessment (readiness rationale, risks, decomposition recommendation if any):`,
+        `   nut task comment ${taskId} "Assessment summary" --author "firstName lastName"`,
+        ``,
+        `5. Set the task status based on your assessment:`,
+        `   nut task update ${taskId} --status ready     (if ready for implementation)`,
+        `   nut task update ${taskId} --status blocked    (if missing information or resources)`,
+        ``,
+        `### Handling Revision Requests`,
+        ``,
+        `If the task status is 'revision', the user has reviewed your assessment and left feedback.`,
+        `Read the most recent comment(s) carefully, revise your plan steps and readiness accordingly,`,
+        `then set status back to 'ready' or 'blocked' as appropriate.`,
     ].join('\n'));
     // Abilities section
     sections.push([
         `## Abilities`,
         ``,
-        `- The following abilities are at your disposal and should be factored into the plan where appropriate (each command has its own --help):`,
-        `  - Work with knowledge documents (used for the output of any research-centric tasks):`,
-        `    - nut knowledge create "Quick Note" --content "# Quick Note\\n\\nSome content here"`,
-        `    - nut knowledge list`,
-        `    - nut knowledge get example-filename.md`,
-        `    - nut knowledge update example-filename.md --content "# Quick Note\\n\\nSome content here"`,
-        `  - Creating media such as images, audio, or video or adding existing files to the resource library:`,
-        `    - nut resource ls`,
-        `    - nut resource add ./screenshot.png`,
-        `    - nut resource image "A serene morning in Tokyo" --save`,
-        `    - nut resource audio "Welcome to the future" --save`,
-        `  - Using available skills (specialized, reusable, and portable modules). There is also an official registry you can pull from:`,
-        `    - nut skill list`,
-        `    - nut skill registry list`,
-        `- Similarly, the following are available: git, gh, node, python`,
+        `Beyond task management, the following are at your disposal and should be factored into the plan where appropriate (each command has its own --help):`,
+        `- Knowledge documents (for research outputs, notes, and reference material):`,
+        `  - nut knowledge create "Title" --content "# Title\\n\\nContent here"`,
+        `  - nut knowledge list / get / update`,
+        `- Resource library (images, audio, video, or existing files):`,
+        `  - nut resource ls / add ./file.png`,
+        `  - nut resource image "description" --save`,
+        `  - nut resource audio "description" --save`,
+        `- Skills (specialized, reusable modules with an official registry):`,
+        `  - nut skill list / nut skill registry list`,
+        `- Also available: git, gh, node, python`,
     ].join('\n'));
     // Operational Rules section
     sections.push([
         `## Operational Rules`,
         ``,
+        `- DO NOT start any implementation work during this phase`,
         `- DO NOT use 'npx' when running the nut CLI`,
-        `- DO use the nut CLI to update task status as progress changes`,
-        `  (nut --help or nut task --help for details)`,
-        `- DO NOT edit files outside the scope of the approved task (unless instructed by the Additional Instructions below)`,
+        `- DO use the nut CLI to update task status and readiness`,
+        `- DO NOT edit files outside the scope of the task (unless instructed by the Additional Instructions below)`,
     ].join('\n'));
     // Skills section (conditional)
     if (skillPaths.length > 0) {

package/dist/skill-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-instructions.js","sourceRoot":"","sources":["../src/skill-instructions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-instructions.js","sourceRoot":"","sources":["../src/skill-instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GACvC,+RAA+R,CAAC;AAClS,MAAM,CAAC,MAAM,6BAA6B,GACxC,6EAA6E,CAAA;AAE/E;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAc,EACd,UAAoB,EACpB,iBAA0B,EAC1B,6BAAsC,IAAI;IAE1C,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,6CAA6C;IAC7C,IAAI,0BAA0B,EAAE,CAAC;QAC/B,eAAe;QACf,QAAQ,CAAC,IAAI,CAAC;YACZ,SAAS;YACT,EAAE;YACF,mDAAmD;YACnD,gBAAgB,MAAM,KAAK;YAC3B,mJAAmJ;SACpJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAEb,yBAAyB;QACzB,QAAQ,CAAC,IAAI,CAAC;YACZ,mBAAmB;YACnB,EAAE;YACF,uDAAuD;YACvD,sBAAsB,MAAM,kBAAkB;YAC9C,EAAE;YACF,mEAAmE;YACnE,2BAA2B,MAAM,qDAAqD;YACtF,2BAA2B,MAAM,8CAA8C;YAC/E,2BAA2B,MAAM,4CAA4C;YAC7E,2BAA2B,MAAM,kDAAkD;YACnF,qDAAqD,MAAM,qBAAqB;YAChF,EAAE;YACF,4EAA4E;YAC5E,sBAAsB,MAAM,mBAAmB;YAC/C,uBAAuB,MAAM,yDAAyD;YACtF,EAAE;YACF,0DAA0D;YAC1D,sBAAsB,MAAM,kBAAkB;YAC9C,uBAAuB,MAAM,2DAA2D;YACxF,EAAE;YACF,gCAAgC;YAChC,EAAE;YACF,sFAAsF;YACtF,2FAA2F;YAC3F,sBAAsB,MAAM,kBAAkB;SAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAEb,oBAAoB;QACpB,QAAQ,CAAC,IAAI,CAAC;YACZ,cAAc;YACd,EAAE;YACF,sJAAsJ;YACtJ,8EAA8E;YAC9E,wEAAwE;YACxE,uCAAuC;YACvC,+DAA+D;YAC/D,sCAAsC;YACtC,6CAA6C;YAC7C,6CAA6C;YAC7C,qEAAqE;YACrE,8CAA8C;YAC9C,yCAAyC;SAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAEb,4BAA4B;QAC5B,QAAQ,CAAC,IAAI,CAAC;YACZ,sBAAsB;YACtB,EAAE;YACF,yEAAyE;YACzE,qHAAqH;SACtH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACf,CAAC;IAED,+BAA+B;IAC/B,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC;YACZ,WAAW;YACX,EAAE;YACF,kCAAkC;YAClC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACf,CAAC;IAED,gDAAgD;IAChD,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC;YACZ,sBAAsB;YACtB,EAAE;YACF,iBAAiB,CAAC,IAAI,EAAE;SACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACf,CAAC;IAED,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAAc,EACd,UAAoB,EACpB,iBAA0B;IAE1B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,eAAe;IACf,QAAQ,CAAC,IAAI,CAAC;QACZ,cAAc;QACd,EAAE;QACF,6EAA6E;QAC7E,sFAAsF;QACtF,EAAE;QACF,gFAAgF,MAAM,KAAK;QAC3F,sIAAsI;QACtI,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,+HAA+H;QAC/H,sBAAsB,MAAM,sBAAsB;QAClD,EAAE;QACF,gEAAgE;QAChE,oBAAoB,MAAM,qBAAqB;QAC/C,EAAE;QACF,uEAAuE;QACvE,+GAA+G;QAC/G,EAAE;QACF,iHAAiH;QACjH,uBAAuB,MAAM,qDAAqD;QAClF,EAAE;QACF,kDAAkD;QAClD,sBAAsB,MAAM,mDAAmD;QAC/E,sBAAsB,MAAM,4DAA4D;QACxF,EAAE;QACF,gCAAgC;QAChC,EAAE;QACF,4FAA4F;QAC5F,8FAA8F;QAC9F,8DAA8D;KAC/D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAEb,oBAAoB;IACpB,QAAQ,CAAC,IAAI,CAAC;QACZ,cAAc;QACd,EAAE;QACF,sJAAsJ;QACtJ,8EAA8E;QAC9E,wEAAwE;QACxE,uCAAuC;QACvC,+DAA+D;QAC/D,sCAAsC;QACtC,6CAA6C;QAC7C,6CAA6C;QAC7C,qEAAqE;QACrE,8CAA8C;QAC9C,yCAAyC;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAEb,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,CAAC;QACZ,sBAAsB;QACtB,EAAE;QACF,0DAA0D;QAC1D,6CAA6C;QAC7C,0DAA0D;QAC1D,4GAA4G;KAC7G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAEb,+BAA+B;IAC/B,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC;YACZ,WAAW;YACX,EAAE;YACF,oHAAoH;YACpH,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACf,CAAC;IAED,gDAAgD;IAChD,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC;YACZ,sBAAsB;YACtB,EAAE;YACF,iBAAiB,CAAC,IAAI,EAAE;SACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACf,CAAC;IAED,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAoB,EACpB,iBAA0B;IAE1B,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAE1C,mCAAmC;IACnC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,4BAA4B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjE,CAAC;IAED,qCAAqC;IACrC,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,2BAA2B,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,kEAAkE;AAClE,mDAAmD;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC"}

package/dist/system-prompts/coconut-assistant.md

@@ -211,7 +211,8 @@ You can **create tasks directly** using the `tasks` tool. Tasks are executed by
 | `add_from_url` | Save a URL as a resource | `{ "operation": "add_from_url", "url": "https://..." }` |
 
 **Image generation models:**
-- `nano-banana-pro` (default) — fast, high-quality general purpose
+- `nano-banana-pro` — fast, high-quality general purpose
+- `nano-banana-2` (default) — Google's next-gen model
 - `flux-2-dev` — good for creative/artistic styles
 - `flux-2-pro` — higher quality, more control
 - `gpt-image-1.5` — best for transparent backgrounds, limited aspect ratios (1:1, 3:2, 2:3)
@@ -222,7 +223,7 @@ You can **create tasks directly** using the `tasks` tool. Tasks are executed by
 - **Video generation takes 2–5 minutes** — warn the user before starting; suggest image or audio if they need something quick
 - **One generation at a time** — consistent with the write-once rule
 - **Use `list` first** if the user asks about existing resources — don't guess IDs
-- **Default to `nano-banana-pro`** — only use other models if the user asks or the task benefits (e.g., transparent backgrounds → `gpt-image-1.5`)
+- **Default to `nano-banana-2`** — only use other models if the user asks or the task benefits (e.g., transparent backgrounds → `gpt-image-1.5`)
 
 **When the user pastes a URL** to an image, audio, or video file, offer to save it as a resource using `add_from_url`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovelybunch/core",
-  "version": "1.0.76-alpha.1",
+  "version": "1.0.76-alpha.11",
   "description": "Core Coconut functionality",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,6 +13,10 @@
     "./logging": {
       "types": "./dist/logging/index.d.ts",
       "import": "./dist/logging/index.js"
+    },
+    "./pipelines": {
+      "types": "./dist/pipelines.d.ts",
+      "import": "./dist/pipelines.js"
     }
   },
   "files": [
@@ -38,7 +42,7 @@
     "test:ui": "vitest --ui"
   },
   "dependencies": {
-    "@lovelybunch/types": "^1.0.76-alpha.1",
+    "@lovelybunch/types": "^1.0.76-alpha.11",
     "@slack/web-api": "^7.13.0",
     "fuse.js": "^7.0.0",
     "gray-matter": "^4.0.3",

package/dist/agent-instructions.d.ts

@@ -1,17 +0,0 @@
-export declare const SCHEMA_REFERENCE_INSTRUCTION = "Consult the schema references in .nut/.schema (proposal.schema.md, project.schema.md, architecture.schema.md, agent.schema.md, knowledge.schema.md) so any updates you make follow the documented structure and include complete arrays for plan steps, dependencies, tags, labels, and comments.";
-export declare const PROJECT_REFERENCE_INSTRUCTION = "Use .nut/context/project.md and .nut/context/architecture.md for reference.";
-/**
- * Get instructions for change proposal (cp-*) workflows
- */
-export declare function getChangeProposalInstructions(proposalId: string, agentPaths: string[], customInstruction?: string, includeDefaultInstructions?: boolean): string[];
-/**
- * Get instructions for reviewing / preparing a change proposal (cp-*) before implementation.
- * Assesses readiness without starting any actual work.
- */
-export declare function getPrepareChangeProposalInstructions(proposalId: string, agentPaths: string[], customInstruction?: string): string[];
-/**
- * Get instructions for agent (ag-*) workflows
- * Agent content and custom instructions drive the behavior
- */
-export declare function getAgentInstructions(agentPaths: string[], customInstruction?: string): string[];
-//# sourceMappingURL=agent-instructions.d.ts.map

package/dist/agent-instructions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../src/agent-instructions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,sSAC4P,CAAC;AACtS,eAAO,MAAM,6BAA6B,gFACqC,CAAA;AAE/E;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,0BAA0B,GAAE,OAAc,GACzC,MAAM,EAAE,CA0EV;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,EAAE,CAqEV;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,EAAE,CAgBV"}