wogiflow 2.32.0 → 2.33.0

package/lib/skill-export-claude-plugin.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+/**
+ * Skill Exporter — Claude Code plugin format (Phase 1B — wf-0342fc33)
+ *
+ * Produces a Claude Code plugin manifest + file list suitable for the
+ * `claude plugin tag` distribution path (Claude Code 2.1.118+).
+ *
+ * Layout produced (the file map this module returns; `flow skill export`
+ * is responsible for actually writing these to disk):
+ *
+ *   .claude-plugin/plugin.json     (root manifest)
+ *   skills/<name>/SKILL.md         (the skill itself)
+ *   skills/<name>/<...other files> (knowledge/, templates/, etc.)
+ *
+ * The plugin.json shape mirrors what shipping Claude Code plugins use
+ * (see e.g., the official Figma plugin's `.claude-plugin/plugin.json`):
+ *
+ *   {
+ *     name:        string,         // plugin identifier
+ *     description: string,
+ *     version:     string,
+ *     author:      { name: string } | string,
+ *     license:     string          // optional
+ *   }
+ *
+ * Like the agentskills exporter, this module assumes the caller has already
+ * run the portability checker. We don't double-verify.
+ *
+ * @module lib/skill-export-claude-plugin
+ */
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const { parseFrontmatter } = require('./skill-portability');
+const { listBundleFiles } = require('./skill-export-agentskills');
+
+const DEFAULT_LICENSE = 'MIT';
+const DEFAULT_AUTHOR = 'wogiflow';
+
+/**
+ * Read a file safely, returning empty string on failure.
+ *
+ * @param {string} filePath
+ * @returns {string}
+ */
+function safeReadFile(filePath) {
+  try {
+    return fs.readFileSync(filePath, 'utf-8');
+  } catch (_err) {
+    return '';
+  }
+}
+
+/**
+ * Export a skill to Claude Code plugin format.
+ *
+ * @param {string} skillDir - Absolute path to skill directory
+ * @param {Object} [opts]
+ * @param {string} [opts.name] - Override plugin name (default: from frontmatter or dir basename)
+ * @param {string} [opts.version] - Override version (default: from frontmatter or 0.0.0)
+ * @param {string} [opts.author] - Override author name (default: DEFAULT_AUTHOR)
+ * @returns {{manifest: Object, files: Array<{path: string, content: string}>, skillMdPath: string|null}}
+ */
+function exportToClaudePlugin(skillDir, opts = {}) {
+  if (typeof skillDir !== 'string' || !skillDir) {
+    throw new Error('exportToClaudePlugin: skillDir must be a non-empty string');
+  }
+  if (!fs.existsSync(skillDir) || !fs.statSync(skillDir).isDirectory()) {
+    throw new Error(`exportToClaudePlugin: not a directory: ${skillDir}`);
+  }
+
+  // Locate skill.md (we tolerate case variants; output is normalized to SKILL.md
+  // which is the prevailing convention in shipping Claude Code plugins).
+  let skillMdPath = null;
+  for (const candidate of ['skill.md', 'SKILL.md', 'Skill.md']) {
+    const p = path.join(skillDir, candidate);
+    if (fs.existsSync(p)) {
+      skillMdPath = p;
+      break;
+    }
+  }
+
+  let frontmatter = {};
+  if (skillMdPath) {
+    frontmatter = parseFrontmatter(safeReadFile(skillMdPath));
+  }
+
+  const name = opts.name ?? frontmatter.name ?? path.basename(skillDir);
+  const version = opts.version ?? frontmatter.version ?? '0.0.0';
+  const description = frontmatter.description ?? '';
+  const license = frontmatter.license ?? DEFAULT_LICENSE;
+  const author = opts.author ?? DEFAULT_AUTHOR;
+
+  // Plugin manifest — matches the .claude-plugin/plugin.json shape used by
+  // shipping Claude Code plugins. Keeping it tight: name/description/version/
+  // author/license. Future plugin fields (commands, hooks, mcpServers) are
+  // additive — leave room but don't speculatively fill them in.
+  const manifest = {
+    name,
+    description,
+    version,
+    author: { name: author },
+    license,
+  };
+
+  // Build file bundle. The Claude Code plugin layout puts the skill under
+  // `skills/<name>/...`, so we re-root every file under that prefix.
+  // skill.md is normalized to SKILL.md in the destination.
+  const absFiles = listBundleFiles(skillDir);
+  const files = [
+    // The plugin.json manifest itself
+    {
+      path: '.claude-plugin/plugin.json',
+      content: JSON.stringify(manifest, null, 2) + '\n',
+    },
+  ];
+
+  for (const abs of absFiles) {
+    const relRaw = path.relative(skillDir, abs) || path.basename(abs);
+    const rel = relRaw.split(path.sep).join('/');
+    let destName = rel;
+
+    // Normalize skill.md → SKILL.md at the skill root only.
+    if (rel === 'skill.md' || rel === 'Skill.md') {
+      destName = 'SKILL.md';
+    }
+
+    files.push({
+      path: `skills/${name}/${destName}`,
+      content: safeReadFile(abs),
+    });
+  }
+
+  return { manifest, files, skillMdPath };
+}
+
+module.exports = {
+  exportToClaudePlugin,
+};

package/lib/skill-portability.js

@@ -0,0 +1,324 @@
+#!/usr/bin/env node
+
+/**
+ * Skill Portability Checker (Phase 1B — wf-0342fc33)
+ *
+ * Determines whether a skill is portable to the broader Claude Code / agentskills.io
+ * ecosystem. A "portable" skill MUST NOT reference WogiFlow-specific paths, state files,
+ * imports, or slash-command invocations — because those won't exist outside this project.
+ *
+ * Fail-loud: every blocker is cited with `path:line`. Callers MUST refuse export when
+ * `portable === false`.
+ *
+ * Usage:
+ *   const { assessSkillPortability } = require('./skill-portability');
+ *   const result = assessSkillPortability('/path/to/.claude/skills/commit');
+ *   // result = { portable: true, blockers: [], manifest: {...}, scannedFiles: [...] }
+ *
+ * @module lib/skill-portability
+ */
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+// ---------------------------------------------------------------------------
+// Blocker patterns
+// ---------------------------------------------------------------------------
+// Each entry: { pattern: RegExp, label: string }
+//
+// The pattern is matched line-by-line against every text file under the skill
+// directory. If any line matches any pattern, the skill is non-portable.
+//
+// NOTE on scoping: we deliberately use *substring* matches on canonical WogiFlow
+// path strings rather than language-level imports, because skill content is
+// mostly Markdown. A reference like ".workflow/state/ready.json" in a how-to
+// guide is just as project-locking as a literal `require('./scripts/flow-utils')`.
+
+const BLOCKER_PATTERNS = [
+  // State-file references
+  { pattern: /\.workflow\//, label: 'wogiflow-state-path (.workflow/)' },
+  { pattern: /\bwogiflow-cloud\b/, label: 'wogiflow-cloud reference' },
+  { pattern: /\bready\.json\b/, label: 'ready.json reference' },
+  { pattern: /\bfeedback-patterns\.md\b/, label: 'feedback-patterns.md reference' },
+  { pattern: /\bdecisions\.md\b/, label: 'decisions.md reference' },
+  { pattern: /\bapp-map\.md\b/, label: 'app-map.md reference' },
+  { pattern: /\bfunction-map\.md\b/, label: 'function-map.md reference' },
+  { pattern: /\bapi-map\.md\b/, label: 'api-map.md reference' },
+  // Imports / requires of WogiFlow modules
+  { pattern: /\bflow-utils\b/, label: 'flow-utils import/reference' },
+  { pattern: /require\(['"][^'"]*\/scripts\/flow[-/]/, label: 'WogiFlow scripts/ require()' },
+  { pattern: /from\s+['"][^'"]*\/scripts\/flow[-/]/, label: 'WogiFlow scripts/ import' },
+  // Slash-command invocations (any /wogi-* with a word char after)
+  { pattern: /\/wogi-[a-z][a-z0-9-]*/i, label: '/wogi-* slash command' },
+  // Shell invocations of the local flow CLI
+  { pattern: /\.\/scripts\/flow\b/, label: 'local ./scripts/flow CLI call' },
+  { pattern: /\bflow\s+(?:wogi-|skill\s+|story\s+|start\s+|status\b|ready\b|finalize\b)/, label: 'flow CLI subcommand specific to WogiFlow' },
+];
+
+// File extensions we scan for blockers.
+const SCAN_EXTENSIONS = new Set(['.md', '.markdown', '.txt', '.yaml', '.yml', '.json', '.js', '.ts', '.sh']);
+
+// Max file size to scan (defense against accidentally enormous fixtures).
+const MAX_SCAN_BYTES = 1 * 1024 * 1024; // 1 MiB
+
+// Max files to scan (defense against deeply nested fixture trees).
+const MAX_SCAN_FILES = 200;
+
+// ---------------------------------------------------------------------------
+// Frontmatter parser (kept local — same shape as flow-skill-freshness.js)
+// ---------------------------------------------------------------------------
+
+const DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+
+/**
+ * Parse YAML frontmatter from a skill.md file. Handles colons in values
+ * by splitting on the first colon only. Blocks prototype pollution keys.
+ *
+ * @param {string} content - File content
+ * @returns {Object} Parsed frontmatter key-value pairs (empty object on miss)
+ */
+function parseFrontmatter(content) {
+  if (typeof content !== 'string') return {};
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return {};
+
+  const result = {};
+  for (const rawLine of match[1].split(/\r?\n/)) {
+    const line = rawLine.replace(/\s+$/, '');
+    if (!line || line.startsWith('#')) continue;
+    // Skip list-item lines (we don't parse arrays here — caller pulls those via dedicated logic)
+    if (line.startsWith('- ')) continue;
+    const colonIdx = line.indexOf(':');
+    if (colonIdx === -1) continue;
+    const key = line.slice(0, colonIdx).trim();
+    if (!key || DANGEROUS_KEYS.has(key)) continue;
+    const value = line.slice(colonIdx + 1).trim().replace(/^["']|["']$/g, '');
+    result[key] = value;
+  }
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Directory walker
+// ---------------------------------------------------------------------------
+
+/**
+ * Walk a directory and return absolute paths of files we should scan.
+ * Skips hidden dirs (except the skill root itself), node_modules, large files.
+ *
+ * @param {string} rootDir - Absolute path to skill directory
+ * @returns {string[]} Absolute file paths, capped at MAX_SCAN_FILES
+ */
+function listScanFiles(rootDir) {
+  const out = [];
+  const stack = [rootDir];
+
+  while (stack.length > 0 && out.length < MAX_SCAN_FILES) {
+    const dir = stack.pop();
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch (_err) {
+      continue;
+    }
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (entry.name === 'node_modules' || entry.name === '.git') continue;
+        stack.push(full);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      const ext = path.extname(entry.name).toLowerCase();
+      if (!SCAN_EXTENSIONS.has(ext)) continue;
+      let stat;
+      try {
+        stat = fs.statSync(full);
+      } catch (_err) {
+        continue;
+      }
+      if (stat.size > MAX_SCAN_BYTES) continue;
+      out.push(full);
+      if (out.length >= MAX_SCAN_FILES) break;
+    }
+  }
+  return out;
+}
+
+// ---------------------------------------------------------------------------
+// Core: assessSkillPortability
+// ---------------------------------------------------------------------------
+
+/**
+ * Assess whether a skill directory is portable to non-WogiFlow consumers.
+ *
+ * Algorithm:
+ *   1. Validate the directory exists and has a `skill.md` (or SKILL.md).
+ *   2. Parse the skill.md frontmatter (used by exporters for manifest fields).
+ *   3. Walk the directory, scanning every text-y file line by line.
+ *   4. For each line, test all BLOCKER_PATTERNS; collect citations.
+ *   5. portable = blockers.length === 0.
+ *
+ * If the frontmatter declares `portable: false` explicitly, that wins even
+ * when the content scan finds nothing — the skill author is signaling an
+ * implicit-dependency the scanner can't detect (e.g., relies on a project
+ * convention that isn't a literal path string).
+ *
+ * If the frontmatter declares `portable: true` but the scanner finds blockers,
+ * the scanner wins — fail-loud is the priority.
+ *
+ * @param {string} skillDir - Absolute path to skill directory
+ * @param {Object} [opts]
+ * @param {RegExp[]} [opts.extraPatterns] - Additional blocker patterns
+ * @returns {{portable: boolean, blockers: Array<{file: string, line: number, match: string, label: string}>, manifest: Object, scannedFiles: string[], skillMdPath: string|null}}
+ */
+function assessSkillPortability(skillDir, opts = {}) {
+  if (typeof skillDir !== 'string' || !skillDir) {
+    return {
+      portable: false,
+      blockers: [{ file: '<input>', line: 0, match: '', label: 'invalid skill directory (empty path)' }],
+      manifest: {},
+      scannedFiles: [],
+      skillMdPath: null,
+    };
+  }
+
+  let stat;
+  try {
+    stat = fs.statSync(skillDir);
+  } catch (_err) {
+    return {
+      portable: false,
+      blockers: [{ file: skillDir, line: 0, match: '', label: 'skill directory does not exist' }],
+      manifest: {},
+      scannedFiles: [],
+      skillMdPath: null,
+    };
+  }
+  if (!stat.isDirectory()) {
+    return {
+      portable: false,
+      blockers: [{ file: skillDir, line: 0, match: '', label: 'skill path is not a directory' }],
+      manifest: {},
+      scannedFiles: [],
+      skillMdPath: null,
+    };
+  }
+
+  // Locate skill.md (case variants accepted)
+  let skillMdPath = null;
+  for (const candidate of ['skill.md', 'SKILL.md', 'Skill.md']) {
+    const p = path.join(skillDir, candidate);
+    if (fs.existsSync(p)) {
+      skillMdPath = p;
+      break;
+    }
+  }
+
+  let manifest = {};
+  if (skillMdPath) {
+    try {
+      const content = fs.readFileSync(skillMdPath, 'utf-8');
+      manifest = parseFrontmatter(content);
+    } catch (_err) {
+      // Continue; missing manifest is itself a portability concern handled below.
+    }
+  }
+
+  const blockers = [];
+  if (!skillMdPath) {
+    blockers.push({
+      file: skillDir,
+      line: 0,
+      match: '',
+      label: 'skill.md not found at skill root',
+    });
+  }
+
+  // Explicit author declaration: portable: false short-circuits scanning.
+  const declaredPortable = typeof manifest.portable === 'string'
+    ? manifest.portable.toLowerCase() === 'true'
+    : null;
+  if (declaredPortable === false) {
+    blockers.push({
+      file: skillMdPath ?? skillDir,
+      line: 0,
+      match: 'portable: false',
+      label: 'manifest declares portable: false',
+    });
+  }
+
+  // Compose pattern list: builtin + extras.
+  const patterns = [...BLOCKER_PATTERNS];
+  if (Array.isArray(opts.extraPatterns)) {
+    for (const p of opts.extraPatterns) {
+      if (p instanceof RegExp) {
+        patterns.push({ pattern: p, label: `custom: ${p.source}` });
+      }
+    }
+  }
+
+  const files = listScanFiles(skillDir);
+  for (const file of files) {
+    let content;
+    try {
+      content = fs.readFileSync(file, 'utf-8');
+    } catch (_err) {
+      continue;
+    }
+    const rel = path.relative(skillDir, file) || path.basename(file);
+    const lines = content.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      for (const { pattern, label } of patterns) {
+        const match = line.match(pattern);
+        if (match) {
+          blockers.push({
+            file: rel,
+            line: i + 1,
+            match: match[0],
+            label,
+          });
+        }
+      }
+    }
+  }
+
+  return {
+    portable: blockers.length === 0,
+    blockers,
+    manifest,
+    scannedFiles: files.map((f) => path.relative(skillDir, f) || path.basename(f)),
+    skillMdPath,
+  };
+}
+
+/**
+ * Format a blockers array as a human-readable report. Useful for CLI output.
+ *
+ * @param {Array} blockers - Output of assessSkillPortability().blockers
+ * @returns {string} Multi-line summary
+ */
+function formatBlockers(blockers) {
+  if (!Array.isArray(blockers) || blockers.length === 0) {
+    return 'No portability blockers found.';
+  }
+  const lines = [`Found ${blockers.length} portability blocker(s):`];
+  for (const b of blockers) {
+    const where = `${b.file}:${b.line}`;
+    const detail = b.match ? ` — "${b.match}"` : '';
+    lines.push(`  - [${b.label}] ${where}${detail}`);
+  }
+  return lines.join('\n');
+}
+
+module.exports = {
+  assessSkillPortability,
+  formatBlockers,
+  parseFrontmatter,
+  // Exposed for tests
+  BLOCKER_PATTERNS,
+  SCAN_EXTENSIONS,
+};

package/lib/skill-registry.js

@@ -288,13 +288,39 @@ async function listSkills(projectRoot) {
       ? `(installed: ${isInstalled.version})`
       : `(v${skill.version})`;
 
-    console.log(`  ${status} ${skill.name.padEnd(15)} ${versionInfo}`);
+    // Phase 1B: surface portability field on listed skills. We treat the
+    // field as a boolean tri-state — true/false from the manifest, undefined
+    // when missing (renders as no tag). Default-on-display is `false` when
+    // missing per Phase 1B spec.
+    const portableSource = isInstalled ?? skill;
+    const portable = readPortableField(portableSource);
+    const portableTag = portable === true ? ' [portable]' : '';
+
+    console.log(`  ${status} ${skill.name.padEnd(15)} ${versionInfo}${portableTag}`);
     console.log(`    ${skill.description}`);
   }
 
   console.log('\nUse `flow skill add <name>` to install a skill');
 }
 
+/**
+ * Read the `portable` flag from a skill manifest, defaulting to false.
+ *
+ * Manifest values may arrive as boolean (JSON manifest) or string (YAML
+ * frontmatter copied through). Anything other than literal-true is false.
+ * Phase 1B (wf-0342fc33).
+ *
+ * @param {Object} manifest - Skill manifest object
+ * @returns {boolean} portable flag, default false
+ */
+function readPortableField(manifest) {
+  if (!manifest || typeof manifest !== 'object') return false;
+  const v = manifest.portable;
+  if (v === true) return true;
+  if (typeof v === 'string' && v.toLowerCase() === 'true') return true;
+  return false;
+}
+
 /**
  * Install a skill
  * @param {string} skillName - Skill name
@@ -353,8 +379,12 @@ async function addSkill(skillName, projectRoot, options) {
   }
 
   // Write manifest (safe - we control the filename)
+  // Phase 1B: explicitly persist `portable` as boolean (default false). Upstream
+  // manifests may omit the field or set it as a string; we normalize here so
+  // downstream tools and `flow skill list` see a consistent shape.
   const localManifest = {
     ...manifest,
+    portable: readPortableField(manifest),
     installedAt: new Date().toISOString(),
     installedVersion: manifest.version
   };
@@ -523,4 +553,4 @@ async function skill(args) {
   }
 }
 
-module.exports = { skill };
+module.exports = { skill, readPortableField };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wogiflow",
-  "version": "2.32.0",
+  "version": "2.33.0",
   "description": "AI-powered development workflow management system with multi-model support",
   "main": "lib/index.js",
   "bin": {
@@ -10,7 +10,7 @@
   },
   "scripts": {
     "flow": "./scripts/flow",
-    "test": "NODE_ENV=test node --test tests/auto-compact-prompt.test.js tests/flow-paths.test.js tests/flow-io.test.js tests/flow-audit-gates.test.js tests/flow-standards-hook-three-layer.test.js tests/flow-correction-detector-reconcile.test.js tests/flow-correction-backfill.test.js tests/flow-audit-gates-feature-output-health.test.js tests/flow-config-loader.test.js tests/flow-damage-control.test.js tests/flow-output.test.js tests/flow-constants.test.js tests/flow-session-state.test.js tests/flow-hooks-integration.test.js tests/flow-utils.test.js tests/flow-security.test.js tests/flow-memory-db.test.js tests/flow-durable-session.test.js tests/flow-skill-matcher.test.js tests/flow-bridge.test.js tests/flow-proactive-compact.test.js tests/flow-cascade-completion.test.js tests/flow-capture-gate.test.js tests/flow-correction-detector-hybrid.test.js tests/flow-promote.test.js tests/flow-archive-runs.test.js tests/flow-memory.test.js tests/flow-hooks-pre-tool-helpers.test.js tests/flow-hooks-bugfix-scope-gate.test.js tests/flow-hooks-routing-gate.test.js tests/flow-hooks-phase-read-gate.test.js tests/flow-hooks-commit-log-gate.test.js tests/flow-hooks-deploy-gate.test.js tests/flow-hooks-todowrite-gate.test.js tests/flow-hooks-git-safety-gate.test.js tests/flow-hooks-scope-mutation-gate.test.js tests/flow-hooks-strike-gate.test.js tests/flow-hooks-component-check.test.js tests/flow-hooks-scope-gate.test.js tests/flow-hooks-implementation-gate.test.js tests/flow-hooks-research-gate.test.js tests/flow-hooks-loop-check.test.js tests/flow-hooks-manager-boundary-gate.test.js tests/flow-hooks-phase-gate.test.js tests/flow-hooks-pre-tool-orchestrator.test.js tests/flow-hooks-observation-capture.test.js tests/flow-hooks-task-gate.test.js tests/flow-durable-session-suspension.test.js tests/flow-health-mcp-scopes.test.js tests/flow-lean-config.test.js tests/flow-workspace-autopickup.test.js tests/flow-worker-boundary-gate.test.js tests/flow-worker-question-classifier.test.js tests/flow-completion-truth-gate-contradictions.test.js tests/flow-structure-sensor.test.js tests/flow-workspace-dispatch-tracking.test.js tests/workspace-ipc-sqlite.test.js tests/workspace-ipc-multi-worker.test.js tests/flow-story-gates.test.js tests/flow-workspace-restart-handoff.test.js tests/flow-wogi-claude-wrapper.test.js tests/flow-wave1-integrations.test.js tests/flow-wave2-integrations.test.js tests/flow-wave3-integrations.test.js tests/flow-commit-claims-gate.test.js tests/auto-review.test.js tests/gate-telemetry-surface.test.js tests/agents-md-alias.test.js tests/flow-skill-manage.test.js tests/fuzzy-patch.test.js tests/mode-schema.test.js tests/flow-feature-dossier.test.js tests/flow-autonomous-mode.test.js tests/flow-epic-cascade.test.js tests/flow-workspace-summary.test.js tests/flow-hooks-research-evidence-gate.test.js tests/flow-worker-mcp-strip.test.js tests/flow-orchestrate-corrections.test.js tests/flow-source-fidelity.test.js tests/flow-hooks-long-input-enforcement.test.js tests/workspace-channel-tracking.test.js tests/flow-hooks-deletion-log.test.js tests/flow-task-boundary-reset.test.js tests/flow-deferral-gate.test.js tests/flow-research-required-gate.test.js tests/flow-standards-forbidden-patterns.test.js tests/flow-hooks-architect-required-gate.test.js tests/flow-architect-runs.test.js tests/flow-installer-forbidden-patterns.test.js tests/flow-deferral-classifier-ai.test.js tests/flow-no-defer-policy.test.js tests/flow-self-adversary-loop.test.js tests/flow-impl-question-classifier.test.js tests/flow-hooks-self-adversary-gate.test.js && NODE_ENV=test node tests/run-quality-gates.test.js",
+    "test": "NODE_ENV=test node --test tests/auto-compact-prompt.test.js tests/flow-paths.test.js tests/flow-io.test.js tests/flow-audit-gates.test.js tests/flow-standards-hook-three-layer.test.js tests/flow-correction-detector-reconcile.test.js tests/flow-correction-backfill.test.js tests/flow-audit-gates-feature-output-health.test.js tests/flow-config-loader.test.js tests/flow-damage-control.test.js tests/flow-output.test.js tests/flow-constants.test.js tests/flow-session-state.test.js tests/flow-hooks-integration.test.js tests/flow-utils.test.js tests/flow-security.test.js tests/flow-memory-db.test.js tests/flow-durable-session.test.js tests/flow-skill-matcher.test.js tests/flow-bridge.test.js tests/flow-proactive-compact.test.js tests/flow-cascade-completion.test.js tests/flow-capture-gate.test.js tests/flow-correction-detector-hybrid.test.js tests/flow-promote.test.js tests/flow-archive-runs.test.js tests/flow-memory.test.js tests/flow-hooks-pre-tool-helpers.test.js tests/flow-hooks-bugfix-scope-gate.test.js tests/flow-hooks-routing-gate.test.js tests/flow-hooks-phase-read-gate.test.js tests/flow-hooks-commit-log-gate.test.js tests/flow-hooks-deploy-gate.test.js tests/flow-hooks-todowrite-gate.test.js tests/flow-hooks-git-safety-gate.test.js tests/flow-hooks-scope-mutation-gate.test.js tests/flow-hooks-strike-gate.test.js tests/flow-hooks-component-check.test.js tests/flow-hooks-scope-gate.test.js tests/flow-hooks-implementation-gate.test.js tests/flow-hooks-research-gate.test.js tests/flow-hooks-loop-check.test.js tests/flow-hooks-manager-boundary-gate.test.js tests/flow-hooks-phase-gate.test.js tests/flow-hooks-pre-tool-orchestrator.test.js tests/flow-hooks-observation-capture.test.js tests/flow-hooks-task-gate.test.js tests/flow-durable-session-suspension.test.js tests/flow-health-mcp-scopes.test.js tests/flow-lean-config.test.js tests/flow-workspace-autopickup.test.js tests/flow-worker-boundary-gate.test.js tests/flow-worker-question-classifier.test.js tests/flow-completion-truth-gate-contradictions.test.js tests/flow-structure-sensor.test.js tests/flow-workspace-dispatch-tracking.test.js tests/workspace-ipc-sqlite.test.js tests/workspace-ipc-multi-worker.test.js tests/flow-story-gates.test.js tests/flow-workspace-restart-handoff.test.js tests/flow-wogi-claude-wrapper.test.js tests/flow-wave1-integrations.test.js tests/flow-wave2-integrations.test.js tests/flow-wave3-integrations.test.js tests/flow-commit-claims-gate.test.js tests/auto-review.test.js tests/gate-telemetry-surface.test.js tests/agents-md-alias.test.js tests/flow-skill-manage.test.js tests/fuzzy-patch.test.js tests/mode-schema.test.js tests/flow-feature-dossier.test.js tests/flow-autonomous-mode.test.js tests/flow-epic-cascade.test.js tests/flow-workspace-summary.test.js tests/flow-hooks-research-evidence-gate.test.js tests/flow-worker-mcp-strip.test.js tests/flow-orchestrate-corrections.test.js tests/flow-source-fidelity.test.js tests/flow-hooks-long-input-enforcement.test.js tests/workspace-channel-tracking.test.js tests/flow-hooks-deletion-log.test.js tests/flow-task-boundary-reset.test.js tests/flow-deferral-gate.test.js tests/flow-research-required-gate.test.js tests/flow-standards-forbidden-patterns.test.js tests/flow-hooks-architect-required-gate.test.js tests/flow-architect-runs.test.js tests/flow-installer-forbidden-patterns.test.js tests/flow-deferral-classifier-ai.test.js tests/flow-no-defer-policy.test.js tests/flow-self-adversary-loop.test.js tests/flow-impl-question-classifier.test.js tests/flow-hooks-self-adversary-gate.test.js tests/flow-scheduled-runner.test.js tests/flow-schedule-cli.test.js tests/flow-skill-portability.test.js tests/flow-skill-export.test.js && NODE_ENV=test node tests/run-quality-gates.test.js",
     "test:syntax": "find scripts/ lib/ -name '*.js' -not -path '*/node_modules/*' -exec node --check {} +",
     "lint": "eslint scripts/ lib/ tests/",
     "lint:ci": "eslint scripts/ lib/ tests/ --max-warnings 0",

package/scripts/flow

@@ -123,6 +123,7 @@ show_help() {
     echo "  skill remove <name>  Remove installed skill"
     echo "  skill update [name]  Update skill(s)"
     echo "  skill info <name>    Show skill details"
+    echo "  skill export <name>  Export portable skill (agentskills@v1 | claude-plugin)"
     echo "  correct              Capture a correction/learning"
     echo "  correct \"desc\"       Quick mode with description"
     echo "  correct list         List recent corrections"
@@ -696,6 +697,10 @@ case "${1:-}" in
                 # List skills from registry
                 node -e "require('$SCRIPT_DIR/../lib/skill-registry').skill(['list'])"
                 ;;
+            export)
+                # Phase 1B (wf-0342fc33): portable skill export to agentskills.io / claude-plugin formats
+                node "$SCRIPT_DIR/flow-skill-export.js" "${@:3}"
+                ;;
             propose|patch|promote|reject|archive|pending)
                 # Agent proposal CLI (staged, user-approved at session-end)
                 node "$SCRIPT_DIR/flow-skill-manage.js" "${@:2}"
@@ -715,6 +720,9 @@ case "${1:-}" in
                 echo "  update [name]       Update skill(s)"
                 echo "  info <name>         Show skill details"
                 echo ""
+                echo "Portable Export (Phase 1B):"
+                echo "  export <name> [--format=agentskills@v1|claude-plugin] [--out=<dir>]"
+                echo ""
                 echo "Agent Proposals (staged, user-approved at session-end):"
                 echo "  propose --name <n> --content <f>  Stage new skill"
                 echo "  patch   --name <n> --content <f>  Stage edit to existing skill"

package/scripts/flow-config-defaults.js

@@ -1242,6 +1242,26 @@ const CONFIG_DEFAULTS = {
     }
   },
 
+  // --- Scheduled / Background Mode (Phase 1A — wf-b211a076) ---
+  // Default OFF; enable per-project via `.workflow/config.json`.
+  // Headless runner at `scripts/flow-scheduled-runner.js`; GH workflow at
+  // `.github/workflows/wogi-scheduled.yml`. CLI installer: `flow schedule install`.
+  // Hard invariants (also enforced by the runner): operates only on the default
+  // branch in a temp worktree; never `git push origin master`, never
+  // `gh pr merge`, never writes to `.workflow/state/decisions.md`.
+  scheduledMode: {
+    enabled: false,
+    dailyTokenBudget: 5000000,
+    perJobModel: {
+      'nightly-regression': 'haiku',
+      'weekly-audit': 'sonnet',
+      'weekly-digest': 'sonnet',
+      'per-pr-review': 'opus'
+    },
+    dryRun: false,
+    jobs: ['nightly-regression', 'weekly-audit', 'weekly-digest', 'per-pr-review']
+  },
+
   // --- Workflow Steps ---
   workflowSteps: WORKFLOW_STEP_DEFAULTS
 };