agileflow 2.99.1 → 2.99.2

package/src/core/commands/team/start.md

@@ -1,6 +1,6 @@
 ---
 description: Start a team from a template
-argument-hint: <template-name>
+argument-hint: "<template-name>"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/team/status.md

@@ -1,6 +1,6 @@
 ---
 description: Show team member statuses and tasks
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/team/stop.md

@@ -1,6 +1,6 @@
 ---
 description: Gracefully shut down a team
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/template.md

@@ -1,6 +1,6 @@
 ---
 description: Create and manage custom document templates
-argument-hint: ACTION=create|edit|list|use [TYPE=story|epic|adr|custom] [NAME=<name>]
+argument-hint: "ACTION=create|edit|list|use [TYPE=story|epic|adr|custom] [NAME=<name>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/tests.md

@@ -1,6 +1,6 @@
 ---
 description: Set up automated testing infrastructure
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/update.md

@@ -1,6 +1,6 @@
 ---
 description: Generate stakeholder progress report
-argument-hint: [PERIOD=week|sprint|month|quarter] [AUDIENCE=exec|client|team|board] [FORMAT=email|markdown]
+argument-hint: "[PERIOD=week|sprint|month|quarter] [AUDIENCE=exec|client|team|board] [FORMAT=email|markdown]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/validate-expertise.md

@@ -1,6 +1,6 @@
 ---
 description: Validate expertise files for drift and staleness
-argument-hint: [<domain>]
+argument-hint: "[<domain>]"
 model: haiku
 compact_context:
   priority: medium

package/src/core/commands/velocity.md

@@ -1,6 +1,6 @@
 ---
 description: Track velocity and forecast sprint capacity
-argument-hint: [PERIOD=week|sprint|month|all] [FORECAST=<EP-ID>] [FORMAT=report|chart|json]
+argument-hint: "[PERIOD=week|sprint|month|all] [FORECAST=<EP-ID>] [FORMAT=report|chart|json]"
 model: haiku
 compact_context:
   priority: medium

package/src/core/commands/verify.md

@@ -1,6 +1,6 @@
 ---
 description: Run project tests and update story test status
-argument-hint: [<US-ID>]
+argument-hint: "[<US-ID>]"
 compact_context:
   priority: critical
   preserve_rules:

package/src/core/commands/whats-new.md

@@ -1,6 +1,6 @@
 ---
 description: Show what's new in AgileFlow
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: low
   preserve_rules:

package/src/core/commands/workflow.md

@@ -1,6 +1,6 @@
 ---
 description: Define and run parameterized workflow templates
-argument-hint: <template> [<arguments>]
+argument-hint: "<template> [<arguments>]"
 compact_context:
   priority: normal
   preserve_rules:

package/tools/cli/installers/ide/codex.js

@@ -92,6 +92,12 @@ class CodexSetup extends BaseIdeSetup {
     // Replace Claude-specific references using content-transformer
     bodyContent = replaceReferences(bodyContent, IDE_REPLACEMENTS.codex);
 
+    // Replace /agileflow: prefix and all subsequent colons for Codex compatibility
+    // e.g., /agileflow:story:list → $agileflow-story-list
+    bodyContent = bodyContent.replace(/\/agileflow:([a-zA-Z0-9:_-]+)/g, (_match, rest) => {
+      return '$agileflow-' + rest.replace(/:/g, '-');
+    });
+
     return `---
 ${skillFrontmatter}
 ---
@@ -115,10 +121,12 @@ ${codexHeader}${bodyContent}`;
     let bodyContent = stripFrontmatter(content);
 
     // Replace Claude-specific references using content-transformer
-    // Use codex replacements plus command-specific pattern
-    bodyContent = replaceReferences(bodyContent, {
-      ...IDE_REPLACEMENTS.codex,
-      '/agileflow:': '$agileflow-',
+    bodyContent = replaceReferences(bodyContent, IDE_REPLACEMENTS.codex);
+
+    // Replace /agileflow: prefix and all subsequent colons for Codex compatibility
+    // e.g., /agileflow:story:list → $agileflow-story-list
+    bodyContent = bodyContent.replace(/\/agileflow:([a-zA-Z0-9:_-]+)/g, (_match, rest) => {
+      return '$agileflow-' + rest.replace(/:/g, '-');
     });
 
     // Add Codex prompt header

package/tools/cli/lib/content-injector.js

@@ -492,6 +492,19 @@ function injectContent(content, context = {}) {
 
   let result = content;
 
+  // Multi-line list placeholders can corrupt YAML if injected into frontmatter.
+  // Keep frontmatter untouched for these placeholders and inject only in body.
+  const replaceInBodyOnly = (input, replacer) => {
+    const frontmatterMatch = input.match(/^(---\n[\s\S]*?\n---\n?)([\s\S]*)$/);
+    if (!frontmatterMatch) {
+      return replacer(input);
+    }
+
+    const frontmatter = frontmatterMatch[1];
+    const body = frontmatterMatch[2];
+    return `${frontmatter}${replacer(body)}`;
+  };
+
   // Expand preserve rules placeholders first (YAML frontmatter processing)
   if (coreDir && fs.existsSync(coreDir) && result.includes('{{RULES:')) {
     result = expandPreserveRules(result, coreDir);
@@ -529,14 +542,20 @@ function injectContent(content, context = {}) {
   if (coreDir && fs.existsSync(coreDir)) {
     if (result.includes('{{AGENT_LIST}}')) {
       const agentList = generateAgentList(path.join(coreDir, 'agents'));
-      result = result.replace(/<!-- \{\{AGENT_LIST\}\} -->/g, agentList);
-      result = result.replace(/\{\{AGENT_LIST\}\}/g, agentList);
+      result = replaceInBodyOnly(result, body => {
+        let updated = body.replace(/<!-- \{\{AGENT_LIST\}\} -->/g, agentList);
+        updated = updated.replace(/\{\{AGENT_LIST\}\}/g, agentList);
+        return updated;
+      });
     }
 
     if (result.includes('{{COMMAND_LIST}}')) {
       const commandList = generateCommandList(path.join(coreDir, 'commands'));
-      result = result.replace(/<!-- \{\{COMMAND_LIST\}\} -->/g, commandList);
-      result = result.replace(/\{\{COMMAND_LIST\}\}/g, commandList);
+      result = replaceInBodyOnly(result, body => {
+        let updated = body.replace(/<!-- \{\{COMMAND_LIST\}\} -->/g, commandList);
+        updated = updated.replace(/\{\{COMMAND_LIST\}\}/g, commandList);
+        return updated;
+      });
     }
 
     // Replace session harness template placeholder