aiwg 2026.2.8 → 2026.2.9

package/agentic/code/frameworks/research-complete/manifest.json

@@ -0,0 +1,24 @@
+{
+  "id": "research-complete",
+  "type": "framework",
+  "name": "Research Complete",
+  "version": "1.0.0",
+  "description": "Research workflow framework for discovery, acquisition, synthesis, citation, quality, and archival operations.",
+  "modeAliases": [
+    "research"
+  ],
+  "entry": {
+    "agents": "agents",
+    "commands": "commands",
+    "skills": "skills",
+    "templates": "templates"
+  },
+  "workspace": {
+    "subdirs": [
+      "repo",
+      "corpus",
+      "working",
+      "archive"
+    ]
+  }
+}

package/docs/_manifest.json

@@ -57,6 +57,18 @@
     "references/REF-002-llm-failure-modes-agentic",
     "references/REF-003-mcp-specification-2025",
     "releases",
+    "releases/v2026.2.9-announcement",
+    "releases/v2026.2.8-announcement",
+    "releases/v2026.2.7-announcement",
+    "releases/v2026.2.5-announcement",
+    "releases/v2026.2.4-announcement",
+    "releases/v2026.2.3-announcement",
+    "releases/v2026.2.0-announcement",
+    "releases/v2026.1.7-announcement",
+    "releases/v2026.1.6-announcement",
+    "releases/v2026.1.5-announcement",
+    "releases/v2026.1.4-announcement",
+    "releases/v2026.1.3-announcement",
     "releases/v2024.12.5-announcement",
     "releases/v2024.12.4-announcement",
     "releases/v2024.12.3-announcement",
@@ -441,10 +453,94 @@
       "summary": "Release notes",
       "collapsed": true
     },
+    {
+      "id": "releases/v2026.2.9-announcement",
+      "title": "v2026.2.9",
+      "summary": "Latest release",
+      "file": "releases/v2026.2.9-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.2.8-announcement",
+      "title": "v2026.2.8",
+      "summary": "Previous release",
+      "file": "releases/v2026.2.8-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.2.7-announcement",
+      "title": "v2026.2.7",
+      "summary": "Previous release",
+      "file": "releases/v2026.2.7-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.2.5-announcement",
+      "title": "v2026.2.5",
+      "summary": "Previous release",
+      "file": "releases/v2026.2.5-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.2.4-announcement",
+      "title": "v2026.2.4",
+      "summary": "Previous release",
+      "file": "releases/v2026.2.4-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.2.3-announcement",
+      "title": "v2026.2.3",
+      "summary": "Previous release",
+      "file": "releases/v2026.2.3-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.2.0-announcement",
+      "title": "v2026.2.0",
+      "summary": "Previous release",
+      "file": "releases/v2026.2.0-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.1.7-announcement",
+      "title": "v2026.1.7",
+      "summary": "Previous release",
+      "file": "releases/v2026.1.7-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.1.6-announcement",
+      "title": "v2026.1.6",
+      "summary": "Previous release",
+      "file": "releases/v2026.1.6-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.1.5-announcement",
+      "title": "v2026.1.5",
+      "summary": "Previous release",
+      "file": "releases/v2026.1.5-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.1.4-announcement",
+      "title": "v2026.1.4",
+      "summary": "Previous release",
+      "file": "releases/v2026.1.4-announcement.md",
+      "parent": "releases"
+    },
+    {
+      "id": "releases/v2026.1.3-announcement",
+      "title": "v2026.1.3",
+      "summary": "Previous release",
+      "file": "releases/v2026.1.3-announcement.md",
+      "parent": "releases"
+    },
     {
       "id": "releases/v2024.12.5-announcement",
       "title": "v2024.12.5",
-      "summary": "Latest release",
+      "summary": "Previous release",
       "file": "releases/v2024.12.5-announcement.md",
       "parent": "releases"
     },

package/docs/releases/_manifest.json

@@ -3,6 +3,18 @@
   "summary": "Release notes",
   "collapsed": true,
   "order": [
+    "v2026.2.9-announcement",
+    "v2026.2.8-announcement",
+    "v2026.2.7-announcement",
+    "v2026.2.5-announcement",
+    "v2026.2.4-announcement",
+    "v2026.2.3-announcement",
+    "v2026.2.0-announcement",
+    "v2026.1.7-announcement",
+    "v2026.1.6-announcement",
+    "v2026.1.5-announcement",
+    "v2026.1.4-announcement",
+    "v2026.1.3-announcement",
     "v2024.12.5-announcement",
     "v2024.12.4-announcement",
     "v2024.12.3-announcement",

package/docs/releases/v2026.2.9-announcement.md

@@ -0,0 +1,60 @@
+# AIWG v2026.2.9 — "Manifest Native" Release
+
+**Released**: 2026-02-15
+
+This release completes provider normalization around manifest-driven discovery so framework/addon deployment no longer depends on scattered provider-specific curation. Codex now receives the same research and media-curator deployment coverage as the other providers.
+
+## Highlights
+
+| What changed | Why you care |
+|--------------|--------------|
+| Manifest-native provider deployment | Framework artifacts are discovered from manifests/shared utilities instead of hardcoded per-provider lists |
+| Codex framework parity | Research and Media Curator components are now included through the same mode-aware discovery path |
+| Lower maintenance overhead | Adding new frameworks/components is significantly more automatic once manifests are present |
+| Test coverage updates | Integration and smoke tests now assert normalized provider behavior for framework deployment |
+
+## Provider Normalization
+
+All 8 providers now align on shared discovery behavior:
+
+- Claude
+- Codex (OpenAI)
+- Copilot
+- Cursor
+- Factory
+- OpenCode
+- Warp
+- Windsurf
+
+Instead of each provider manually curating framework directories, deployment now uses centralized manifest-aware helpers to resolve frameworks and artifacts by mode.
+
+## Codex: Research + Media Curator Coverage
+
+Codex deployment scripts now use framework discovery for command and skill selection, which closes gaps where newly added frameworks could be missed in Codex-specific install paths.
+
+### What this enables
+
+```bash
+# These now deploy consistently for Codex via the normalized discovery path
+aiwg use research --provider codex
+aiwg use media-curator --provider codex
+```
+
+## Manifest-Driven Extensibility
+
+A framework with a valid `manifest.json` and standard component layout is now discoverable by provider deployment without requiring one-off changes in each provider module.
+
+This release also adds explicit manifest metadata for `research-complete` to support that flow.
+
+## Install / Update
+
+```bash
+npm install -g aiwg@2026.2.9
+
+# Or update existing installation
+aiwg update
+```
+
+## Full Changelog
+
+See [CHANGELOG.md](../../CHANGELOG.md) for complete details.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiwg",
-  "version": "2026.2.8",
+  "version": "2026.2.9",
   "description": "Cognitive architecture for AI-augmented software development with structured memory, ensemble validation, and closed-loop correction. FAIR-aligned artifacts, 84% cost reduction via human-in-the-loop, standards adopted by 100+ organizations.",
   "type": "module",
   "bin": {
@@ -17,10 +17,11 @@
     "package-plugins": "node tools/plugin/package-plugins.mjs --all",
     "package-plugins:clean": "node tools/plugin/package-plugins.mjs --all --clean",
     "build": "tsc",
-    "test": "vitest",
+    "test": "vitest run",
+    "test:ci": "vitest run --exclude \"test/integration/**\" --exclude \"test/characterization/**\" --exclude \"test/smoke/**\" --exclude \"test/unit/intake/git-history-analyzer.test.ts\" --exclude \"test/unit/ralph-external/snapshot-manager.test.ts\" --exclude \"test/unit/smiths/toolsmith/runtime-discovery.test.ts\"",
     "test:coverage": "vitest --coverage",
     "test:ui": "vitest --ui",
-    "test:watch": "vitest --watch",
+    "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist coverage"
   },

package/tools/agents/deploy-agents.mjs

@@ -11,7 +11,7 @@
  * Options:
  *   --source <path>          Source directory (defaults to repo root)
  *   --target <path>          Target directory (defaults to cwd)
- *   --mode <type>            Deployment mode: general, sdlc, marketing, media-curator, research, both, or all (default)
+ *   --mode <type>            Deployment mode: general, sdlc, marketing (alias: mmk), media-curator, research, both, or all (default)
  *   --deploy-commands        Deploy commands in addition to agents
  *   --deploy-skills          Deploy skills in addition to agents
  *   --deploy-rules           Deploy rules in addition to agents
@@ -31,7 +31,7 @@
  *   general       - Deploy only writing-quality addon agents and commands (alias: writing)
  *   writing       - Deploy only writing-quality addon agents (alias for general)
  *   sdlc          - Deploy only SDLC Complete framework agents and commands
- *   marketing     - Deploy only Media/Marketing Kit framework agents and commands
+ *   marketing     - Deploy only Media/Marketing Kit framework agents and commands (alias: mmk)
  *   media-curator - Deploy only Media Curator framework agents and commands
  *   research      - Deploy only Research Complete framework agents and commands
  *   both          - Deploy writing + SDLC (legacy compatibility)
@@ -140,7 +140,7 @@ Usage:
 Options:
   --source <path>          Source directory (defaults to repo root)
   --target <path>          Target directory (defaults to cwd)
-  --mode <type>            Deployment mode: general, sdlc, marketing, media-curator, research, both, or all (default)
+  --mode <type>            Deployment mode: general, sdlc, marketing (alias: mmk), media-curator, research, both, or all (default)
   --deploy-commands        Deploy commands in addition to agents
   --deploy-skills          Deploy skills in addition to agents
   --deploy-rules           Deploy rules in addition to agents
@@ -181,7 +181,7 @@ Providers (all deploy agents, commands, skills, and rules):
 Modes:
   general       - Writing-quality addon agents and commands (alias: writing)
   sdlc          - SDLC Complete framework agents and commands
-  marketing     - Media/Marketing Kit framework agents and commands
+  marketing     - Media/Marketing Kit framework agents and commands (alias: mmk)
   media-curator - Media Curator framework agents and commands
   research      - Research Complete framework agents and commands
   both          - writing + SDLC (legacy compatibility)
@@ -342,6 +342,7 @@ function deepMerge(target, source) {
 
   // Normalize mode aliases
   if (cfg.mode === 'writing') cfg.mode = 'general';
+  if (cfg.mode === 'mmk') cfg.mode = 'marketing';
 
   console.log(`\n=== AIWG Agent Deployment ===`);
   console.log(`Provider: ${cfg.provider}`);

package/tools/agents/providers/base.mjs

@@ -371,39 +371,47 @@ export function deploySkillDir(skillDir, destDir, opts) {
  * Initialize framework-scoped workspace structure
  * Creates .aiwg/frameworks/{framework-id}/ directories
  */
-export function initializeFrameworkWorkspace(target, mode, dryRun) {
+export function initializeFrameworkWorkspace(target, mode, dryRun, srcRoot = null) {
   const aiwgBase = path.join(target, '.aiwg');
   const frameworksDir = path.join(aiwgBase, 'frameworks');
   const sharedDir = path.join(aiwgBase, 'shared');
 
-  const frameworkDirs = [];
-
-  if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
-    frameworkDirs.push({
-      id: 'sdlc-complete',
-      subdirs: ['repo', 'projects', 'working', 'archive']
-    });
-  }
+  const frameworkDirs = srcRoot
+    ? getFrameworksForMode(srcRoot, mode).map(fw => ({
+      id: fw.id,
+      subdirs: fw.workspaceSubdirs
+    }))
+    : [];
+
+  // Backward-compatible fallback when source root isn't provided.
+  if (frameworkDirs.length === 0) {
+    if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
+      frameworkDirs.push({
+        id: 'sdlc-complete',
+        subdirs: ['repo', 'projects', 'working', 'archive']
+      });
+    }
 
-  if (mode === 'marketing' || mode === 'all') {
-    frameworkDirs.push({
-      id: 'media-marketing-kit',
-      subdirs: ['repo', 'campaigns', 'working', 'archive']
-    });
-  }
+    if (mode === 'marketing' || mode === 'all') {
+      frameworkDirs.push({
+        id: 'media-marketing-kit',
+        subdirs: ['repo', 'campaigns', 'working', 'archive']
+      });
+    }
 
-  if (mode === 'media-curator' || mode === 'all') {
-    frameworkDirs.push({
-      id: 'media-curator',
-      subdirs: ['repo', 'library', 'working', 'archive']
-    });
-  }
+    if (mode === 'media-curator' || mode === 'all') {
+      frameworkDirs.push({
+        id: 'media-curator',
+        subdirs: ['repo', 'library', 'working', 'archive']
+      });
+    }
 
-  if (mode === 'research' || mode === 'all') {
-    frameworkDirs.push({
-      id: 'research-complete',
-      subdirs: ['repo', 'corpus', 'working', 'archive']
-    });
+    if (mode === 'research' || mode === 'all') {
+      frameworkDirs.push({
+        id: 'research-complete',
+        subdirs: ['repo', 'corpus', 'working', 'archive']
+      });
+    }
   }
 
   if (frameworkDirs.length === 0) return;
@@ -582,6 +590,209 @@ export function filterAgentFiles(files, opts) {
   });
 }
 
+// ============================================================================
+// Framework Discovery
+// ============================================================================
+
+const MODE_ALIASES = {
+  writing: 'general',
+  mmk: 'marketing'
+};
+
+const LEGACY_FRAMEWORK_MODE_ALIASES = {
+  'sdlc-complete': ['sdlc'],
+  'media-marketing-kit': ['marketing', 'mmk'],
+  'media-curator': ['media-curator'],
+  'research-complete': ['research']
+};
+
+const DEFAULT_FRAMEWORK_SUBDIRS = {
+  'sdlc-complete': ['repo', 'projects', 'working', 'archive'],
+  'media-marketing-kit': ['repo', 'campaigns', 'working', 'archive'],
+  'media-curator': ['repo', 'library', 'working', 'archive'],
+  'research-complete': ['repo', 'corpus', 'working', 'archive']
+};
+
+function normalizePathSegment(segment) {
+  return String(segment || '')
+    .replace(/^\/+/, '')
+    .replace(/\/+$/, '');
+}
+
+function ensureStringArray(value) {
+  if (!value) return [];
+  return Array.isArray(value) ? value.map(v => String(v)) : [String(value)];
+}
+
+function uniqueLower(values) {
+  const seen = new Set();
+  const out = [];
+  for (const raw of values) {
+    const v = String(raw || '').trim().toLowerCase();
+    if (!v || seen.has(v)) continue;
+    seen.add(v);
+    out.push(v);
+  }
+  return out;
+}
+
+export function normalizeDeploymentMode(mode = 'all') {
+  const normalized = String(mode || 'all').toLowerCase();
+  return MODE_ALIASES[normalized] || normalized;
+}
+
+function resolveFrameworkComponentDir(frameworkPath, manifest, component) {
+  const entry = manifest?.entry?.[component];
+  const relPath = normalizePathSegment(entry || component);
+  return path.join(frameworkPath, relPath);
+}
+
+/**
+ * Discover framework roots under agentic/code/frameworks.
+ * Framework metadata is loaded from root manifest.json when present.
+ */
+export function discoverFrameworks(srcRoot) {
+  const frameworksRoot = path.join(srcRoot, 'agentic', 'code', 'frameworks');
+  if (!fs.existsSync(frameworksRoot)) return [];
+
+  const frameworks = [];
+  const entries = fs.readdirSync(frameworksRoot, { withFileTypes: true })
+    .filter(e => e.isDirectory())
+    .sort((a, b) => a.name.localeCompare(b.name));
+
+  for (const entry of entries) {
+    const frameworkPath = path.join(frameworksRoot, entry.name);
+    const manifestPath = path.join(frameworkPath, 'manifest.json');
+    let manifest = {};
+
+    if (fs.existsSync(manifestPath)) {
+      try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+      } catch (e) {
+        console.warn(`Warning: Could not parse framework manifest for ${entry.name}: ${e.message}`);
+      }
+    }
+
+    const id = String(manifest.id || manifest.framework || entry.name);
+    const aliases = uniqueLower([
+      id,
+      entry.name,
+      ...ensureStringArray(manifest.modeAliases),
+      ...ensureStringArray(manifest.aliases),
+      ...(LEGACY_FRAMEWORK_MODE_ALIASES[id] || [])
+    ]);
+
+    const workspaceSubdirs = ensureStringArray(
+      manifest.workspace?.subdirs || manifest.workspace?.directories
+    );
+
+    const agentsDir = resolveFrameworkComponentDir(frameworkPath, manifest, 'agents');
+    const commandsDir = resolveFrameworkComponentDir(frameworkPath, manifest, 'commands');
+    const skillsDir = resolveFrameworkComponentDir(frameworkPath, manifest, 'skills');
+    const rulesDir = resolveFrameworkComponentDir(frameworkPath, manifest, 'rules');
+
+    frameworks.push({
+      id,
+      name: manifest.name || entry.name,
+      path: frameworkPath,
+      manifest,
+      aliases,
+      workspaceSubdirs: workspaceSubdirs.length > 0
+        ? workspaceSubdirs
+        : (DEFAULT_FRAMEWORK_SUBDIRS[id] || ['repo', 'working', 'archive']),
+      components: {
+        agents: { path: agentsDir, exists: fs.existsSync(agentsDir) },
+        commands: { path: commandsDir, exists: fs.existsSync(commandsDir) },
+        skills: { path: skillsDir, exists: fs.existsSync(skillsDir) },
+        rules: { path: rulesDir, exists: fs.existsSync(rulesDir) }
+      }
+    });
+  }
+
+  return frameworks;
+}
+
+/**
+ * Select frameworks for a deployment mode.
+ */
+export function getFrameworksForMode(srcRoot, mode) {
+  const normalizedMode = normalizeDeploymentMode(mode);
+  const frameworks = discoverFrameworks(srcRoot);
+
+  if (normalizedMode === 'all') return frameworks;
+  if (normalizedMode === 'general') return [];
+  if (normalizedMode === 'both') {
+    return frameworks.filter(fw => fw.aliases.includes('sdlc'));
+  }
+
+  return frameworks.filter(fw =>
+    fw.id.toLowerCase() === normalizedMode || fw.aliases.includes(normalizedMode)
+  );
+}
+
+/**
+ * Collect framework artifacts for a deployment mode.
+ * @param {string} srcRoot - Source root directory
+ * @param {string} mode - Deployment mode
+ * @param {object} options - Collection options
+ * @param {boolean} options.includeAgents - Include agents
+ * @param {boolean} options.includeCommands - Include commands
+ * @param {boolean} options.includeSkills - Include skills
+ * @param {boolean} options.includeRules - Include rules
+ * @param {boolean} options.recursiveCommands - Use recursive command listing
+ * @param {boolean} options.consolidatedSdlcRules - Use RULES-INDEX for SDLC when available
+ * @returns {{frameworks: Array, agents: string[], commands: string[], skills: string[], rules: string[]}}
+ */
+export function collectFrameworkArtifacts(srcRoot, mode, options = {}) {
+  const {
+    includeAgents = true,
+    includeCommands = true,
+    includeSkills = true,
+    includeRules = true,
+    recursiveCommands = true,
+    consolidatedSdlcRules = true
+  } = options;
+
+  const frameworks = getFrameworksForMode(srcRoot, mode);
+  const artifacts = {
+    frameworks,
+    agents: [],
+    commands: [],
+    skills: [],
+    rules: []
+  };
+
+  for (const framework of frameworks) {
+    if (includeAgents && framework.components.agents.exists) {
+      artifacts.agents.push(...listMdFiles(framework.components.agents.path));
+    }
+
+    if (includeCommands && framework.components.commands.exists) {
+      const commandFiles = recursiveCommands
+        ? listMdFilesRecursive(framework.components.commands.path)
+        : listMdFiles(framework.components.commands.path);
+      artifacts.commands.push(...commandFiles);
+    }
+
+    if (includeSkills && framework.components.skills.exists) {
+      artifacts.skills.push(...listSkillDirs(framework.components.skills.path));
+    }
+
+    if (includeRules && framework.components.rules.exists) {
+      if (consolidatedSdlcRules && framework.id === 'sdlc-complete') {
+        const indexPath = getRulesIndexPath(srcRoot);
+        if (indexPath) {
+          artifacts.rules.push(indexPath);
+          continue;
+        }
+      }
+      artifacts.rules.push(...listMdFiles(framework.components.rules.path));
+    }
+  }
+
+  return artifacts;
+}
+
 // ============================================================================
 // Addon Discovery
 // ============================================================================