@jaimevalasek/aioson 1.21.7 → 1.22.0

package/src/cli.js

@@ -82,12 +82,12 @@ const { runSquadWebhook } = require('./commands/squad-webhook');
 const { runSquadBus } = require('./commands/squad-bus');
 const { runSquadAutorun } = require('./commands/squad-autorun');
 const { runSquadDependencyGraph } = require('./commands/squad-dependency-graph');
-const { runSquadToolRegister } = require('./commands/squad-tool-register');
-const { runSquadReview } = require('./commands/squad-review');
-const { runAgentAudit } = require('./commands/agent-audit');
-const { runSkillAudit } = require('./commands/skill-audit');
-const { runQualityAudit } = require('./commands/quality-audit');
-const { runBriefGen } = require('./commands/brief-gen');
+const { runSquadToolRegister } = require('./commands/squad-tool-register');
+const { runSquadReview } = require('./commands/squad-review');
+const { runAgentAudit } = require('./commands/agent-audit');
+const { runSkillAudit } = require('./commands/skill-audit');
+const { runQualityAudit } = require('./commands/quality-audit');
+const { runBriefGen } = require('./commands/brief-gen');
 const { runHarnessInit, runHarnessValidate, runHarnessApplyValidation } = require('./commands/harness');
 const { runVerifyGate } = require('./commands/verify-gate');
 const {
@@ -194,6 +194,7 @@ const { runOpReinforce } = require('./commands/op-reinforce');
 const { runOpMigrate } = require('./commands/op-migrate');
 const { runFeatureClose } = require('./commands/feature-close');
 const { runFeatureArchive, runFeatureSweep } = require('./commands/feature-archive');
+const { runFeatureExport } = require('./commands/feature-export');
 const { runDossierInit, runDossierShow, runDossierAddFinding, runDossierAddCodemap, runDossierLinkRule, runDossierCompact } = require('./commands/dossier');
 const { runDossierAddResearch } = require('./commands/dossier-add-research');
 const { runDossierAudit } = require('./commands/dossier-audit');
@@ -204,10 +205,10 @@ const { runGateApprove } = require('./commands/gate-approve');
 const { runArtifactValidate } = require('./commands/artifact-validate');
 const { runWorkflowExecute } = require('./commands/workflow-execute');
 const { runRunnerQueueFromPlan } = require('./commands/runner-queue-from-plan');
-const { runLearningAutoPromote } = require('./commands/learning-auto-promote');
-const { runBriefValidate } = require('./commands/brief-validate');
-const { runIntakeAsk } = require('./commands/intake-ask');
-const { runPreflightContext } = require('./commands/preflight-context');
+const { runLearningAutoPromote } = require('./commands/learning-auto-promote');
+const { runBriefValidate } = require('./commands/brief-validate');
+const { runIntakeAsk } = require('./commands/intake-ask');
+const { runPreflightContext } = require('./commands/preflight-context');
 const { runContextCompact } = require('./commands/context-compact');
 const { runSquadScaffold } = require('./commands/squad-scaffold');
 const { runPatternDetect } = require('./commands/pattern-detect');
@@ -385,27 +386,33 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'squad-tool-register',
   'squad:review',
   'squad-review',
-  'agent:audit',
-  'agent-audit',
-  'skill:audit',
-  'skill-audit',
-  'quality:audit',
-  'quality-audit',
-  'brief:gen',
+  'agent:audit',
+  'agent-audit',
+  'skill:audit',
+  'skill-audit',
+  'quality:audit',
+  'quality-audit',
+  'brief:gen',
   'harness:init',
   'harness-init',
   'harness:validate',
   'harness-validate',
   'harness:apply-validation',
   'harness-apply-validation',
+  'harness:approve',
+  'harness-approve',
+  'harness:reject',
+  'harness-reject',
+  'harness:status',
+  'harness-status',
   'brief-gen',
   'verify:gate',
   'verify-gate',
-  'brief:validate',
-  'brief-validate',
-  'intake:ask',
-  'intake-ask',
-  'preflight:context',
+  'brief:validate',
+  'brief-validate',
+  'intake:ask',
+  'intake-ask',
+  'preflight:context',
   'preflight-context',
   'context:compact',
   'context-compact',
@@ -640,6 +647,8 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'feature-archive',
   'feature:sweep',
   'feature-sweep',
+  'feature:export',
+  'feature-export',
   'dossier:init',
   'dossier-init',
   'dossier:show',
@@ -827,11 +836,11 @@ function printHelp(t, logger) {
   logHelpLine(t, logger, 'cli.help_squad_daemon');
   logHelpLine(t, logger, 'cli.help_squad_mcp');
   logHelpLine(t, logger, 'cli.help_squad_roi');
-  logHelpLine(t, logger, 'cli.help_squad_score');
-  logHelpLine(t, logger, 'cli.help_squad_learning');
-  logHelpLine(t, logger, 'cli.help_agent_audit');
-  logHelpLine(t, logger, 'cli.help_quality_audit');
-  logHelpLine(t, logger, 'cli.help_learning');
+  logHelpLine(t, logger, 'cli.help_squad_score');
+  logHelpLine(t, logger, 'cli.help_squad_learning');
+  logHelpLine(t, logger, 'cli.help_agent_audit');
+  logHelpLine(t, logger, 'cli.help_quality_audit');
+  logHelpLine(t, logger, 'cli.help_learning');
   logHelpLine(t, logger, 'cli.help_runtime_init');
   logHelpLine(t, logger, 'cli.help_runtime_ingest');
   logHelpLine(t, logger, 'cli.help_runtime_task_start');
@@ -840,10 +849,10 @@ function printHelp(t, logger) {
   logHelpLine(t, logger, 'cli.help_runtime_task_finish');
   logHelpLine(t, logger, 'cli.help_runtime_finish');
   logHelpLine(t, logger, 'cli.help_runtime_task_fail');
-  logHelpLine(t, logger, 'cli.help_runtime_fail');
-  logHelpLine(t, logger, 'cli.help_runtime_status');
-  logHelpLine(t, logger, 'cli.help_agent_recover');
-  logHelpLine(t, logger, 'cli.help_runtime_session_start');
+  logHelpLine(t, logger, 'cli.help_runtime_fail');
+  logHelpLine(t, logger, 'cli.help_runtime_status');
+  logHelpLine(t, logger, 'cli.help_agent_recover');
+  logHelpLine(t, logger, 'cli.help_runtime_session_start');
   logHelpLine(t, logger, 'cli.help_runtime_session_log');
   logHelpLine(t, logger, 'cli.help_runtime_session_finish');
   logHelpLine(t, logger, 'cli.help_runtime_session_status');
@@ -855,10 +864,10 @@ function printHelp(t, logger) {
   logHelpLine(t, logger, 'cli.help_scaffold_complete');
   logHelpLine(t, logger, 'cli.help_runtime_backup');
   logHelpLine(t, logger, 'cli.help_runtime_restore');
-  logHelpLine(t, logger, 'cli.help_skill_install');
-  logHelpLine(t, logger, 'cli.help_skill_list');
-  logHelpLine(t, logger, 'cli.help_skill_remove');
-  logHelpLine(t, logger, 'cli.help_skill_audit');
+  logHelpLine(t, logger, 'cli.help_skill_install');
+  logHelpLine(t, logger, 'cli.help_skill_list');
+  logHelpLine(t, logger, 'cli.help_skill_remove');
+  logHelpLine(t, logger, 'cli.help_skill_audit');
   logHelpLine(t, logger, 'cli.help_design_hybrid_options');
   logHelpLine(t, logger, 'cli.help_cloud_import_squad');
   logHelpLine(t, logger, 'cli.help_cloud_import_genome');
@@ -1239,29 +1248,38 @@ async function main() {
       result = await runSquadToolRegister({ args, options, logger: commandLogger });
     } else if (command === 'squad:review' || command === 'squad-review') {
       result = await runSquadReview({ args, options, logger: commandLogger });
-    } else if (command === 'agent:audit' || command === 'agent-audit') {
-      result = await runAgentAudit({ args, options, logger: commandLogger });
-    } else if (command === 'skill:audit' || command === 'skill-audit') {
-      result = await runSkillAudit({ args, options, logger: commandLogger });
-    } else if (command === 'quality:audit' || command === 'quality-audit') {
-      result = await runQualityAudit({ args, options, logger: commandLogger });
-    } else if (command === 'brief:gen' || command === 'brief-gen') {
-      result = await runBriefGen({ args, options, logger: commandLogger, t });
+    } else if (command === 'agent:audit' || command === 'agent-audit') {
+      result = await runAgentAudit({ args, options, logger: commandLogger });
+    } else if (command === 'skill:audit' || command === 'skill-audit') {
+      result = await runSkillAudit({ args, options, logger: commandLogger });
+    } else if (command === 'quality:audit' || command === 'quality-audit') {
+      result = await runQualityAudit({ args, options, logger: commandLogger });
+    } else if (command === 'brief:gen' || command === 'brief-gen') {
+      result = await runBriefGen({ args, options, logger: commandLogger, t });
     } else if (command === 'harness:init' || command === 'harness-init') {
       result = await runHarnessInit({ args, options, logger: commandLogger, t });
     } else if (command === 'harness:validate' || command === 'harness-validate') {
       result = await runHarnessValidate({ args, options, logger: commandLogger, t });
     } else if (command === 'harness:apply-validation' || command === 'harness-apply-validation') {
       result = await runHarnessApplyValidation({ args, options, logger: commandLogger, t });
+    } else if (command === 'harness:approve' || command === 'harness-approve') {
+      const { runHarnessApprove } = require('./commands/harness-gate');
+      result = await runHarnessApprove({ args, options, logger: commandLogger, t });
+    } else if (command === 'harness:reject' || command === 'harness-reject') {
+      const { runHarnessReject } = require('./commands/harness-gate');
+      result = await runHarnessReject({ args, options, logger: commandLogger, t });
+    } else if (command === 'harness:status' || command === 'harness-status') {
+      const { runHarnessStatus } = require('./commands/harness-status');
+      result = await runHarnessStatus({ args, options, logger: commandLogger, t });
     } else if (command === 'verify:gate' || command === 'verify-gate') {
       result = await runVerifyGate({ args, options, logger: commandLogger, t });
 
-    } else if (command === 'brief:validate' || command === 'brief-validate') {
-      result = await runBriefValidate({ args, options, logger: commandLogger });
-    } else if (command === 'intake:ask' || command === 'intake-ask') {
-      result = await runIntakeAsk({ args, options, logger: commandLogger });
-    } else if (command === 'preflight:context' || command === 'preflight-context') {
-      result = await runPreflightContext({ args, options, logger: commandLogger });
+    } else if (command === 'brief:validate' || command === 'brief-validate') {
+      result = await runBriefValidate({ args, options, logger: commandLogger });
+    } else if (command === 'intake:ask' || command === 'intake-ask') {
+      result = await runIntakeAsk({ args, options, logger: commandLogger });
+    } else if (command === 'preflight:context' || command === 'preflight-context') {
+      result = await runPreflightContext({ args, options, logger: commandLogger });
     } else if (command === 'context:compact' || command === 'context-compact') {
       result = await runContextCompact({ args, options, logger: commandLogger });
     } else if (command === 'squad:scaffold' || command === 'squad-scaffold') {
@@ -1297,9 +1315,9 @@ async function main() {
       result = await runSpecCheckpoint({ args, options, logger: commandLogger });
     } else if (command === 'spec:tasks' || command === 'spec-tasks') {
       result = await runSpecTasks({ args, options, logger: commandLogger });
-    } else if (command.startsWith('learning:') || command === 'learning') {
-      const sub = command === 'learning' ? (options.sub || args[1] || 'list') : command.split(':')[1];
-      result = await runLearning({ args, options: { ...options, sub }, logger: commandLogger, t });
+    } else if (command.startsWith('learning:') || command === 'learning') {
+      const sub = command === 'learning' ? (options.sub || args[1] || 'list') : command.split(':')[1];
+      result = await runLearning({ args, options: { ...options, sub }, logger: commandLogger, t });
     } else if (command.startsWith('plan:') || command === 'plan') {
       const sub = command === 'plan' ? (args[1] || 'show') : command.split(':')[1];
       result = await runImplementationPlan({ args, options: { ...options, sub }, logger: commandLogger, t });
@@ -1523,6 +1541,8 @@ async function main() {
       }
     } else if (command === 'feature:sweep' || command === 'feature-sweep') {
       result = await runFeatureSweep({ args, options, logger: commandLogger });
+    } else if (command === 'feature:export' || command === 'feature-export') {
+      result = await runFeatureExport({ args, options, logger: commandLogger });
     } else if (command === 'dossier:init' || command === 'dossier-init') {
       result = await runDossierInit({ args, options, logger: commandLogger });
     } else if (command === 'dossier:show' || command === 'dossier-show') {

package/src/commands/briefing.js

@@ -14,134 +14,13 @@
  * Format: YAML frontmatter (briefings: array) + Markdown table
  */
 
-const fs = require('node:fs/promises');
 const path = require('node:path');
 const readline = require('node:readline');
-
-// ─── Config path ──────────────────────────────────────────────────────────────
-
-function configPath(projectDir) {
-  return path.join(projectDir, '.aioson', 'briefings', 'config.md');
-}
-
-// ─── YAML frontmatter parser (briefings-specific) ────────────────────────────
-
-/**
- * Parse .aioson/briefings/config.md frontmatter.
- * Returns { updated_at, briefings: [...] }
- *
- * Expected format:
- *   ---
- *   updated_at: 2026-04-10
- *   briefings:
- *     - slug: foo
- *       status: draft
- *       source_plans: [plans/x.md]
- *       created_at: "2026-04-10"
- *       approved_at: null
- *       prd_generated: null
- *   ---
- */
-function parseConfigFrontmatter(content) {
-  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match) return null;
-
-  const raw = match[1];
-  const lines = raw.split(/\r?\n/);
-
-  const result = { updated_at: null, briefings: [] };
-  let inBriefings = false;
-  let currentItem = null;
-
-  for (const line of lines) {
-    if (/^updated_at:\s*(.*)$/.test(line)) {
-      result.updated_at = line.replace(/^updated_at:\s*/, '').trim().replace(/^["']|["']$/g, '');
-      continue;
-    }
-
-    if (/^briefings:/.test(line)) {
-      inBriefings = true;
-      continue;
-    }
-
-    if (!inBriefings) continue;
-
-    // New item in array
-    if (/^\s{2}-\s+slug:\s*(.+)/.test(line)) {
-      if (currentItem) result.briefings.push(currentItem);
-      const slug = line.replace(/^\s{2}-\s+slug:\s*/, '').trim().replace(/^["']|["']$/g, '');
-      currentItem = { slug, status: 'draft', source_plans: [], created_at: null, approved_at: null, prd_generated: null };
-      continue;
-    }
-
-    if (currentItem) {
-      const fieldMatch = line.match(/^\s{4}(\w+):\s*(.*)/);
-      if (!fieldMatch) continue;
-      const [, key, rawVal] = fieldMatch;
-      const val = rawVal.trim().replace(/^["']|["']$/g, '');
-
-      if (key === 'source_plans') {
-        // Parse inline array: [plans/x.md, plans/y.md]
-        const arrMatch = val.match(/^\[(.+)\]$/);
-        currentItem.source_plans = arrMatch
-          ? arrMatch[1].split(',').map((s) => s.trim().replace(/^["']|["']$/g, ''))
-          : val === '' ? [] : [val];
-      } else if (val === 'null' || val === '') {
-        currentItem[key] = null;
-      } else {
-        currentItem[key] = val;
-      }
-    }
-  }
-
-  if (currentItem) result.briefings.push(currentItem);
-  return result;
-}
-
-// ─── Config serializer ────────────────────────────────────────────────────────
-
-function serializeSourcePlans(plans) {
-  if (!plans || plans.length === 0) return '[]';
-  const items = plans.map((p) => `"${p}"`).join(', ');
-  return `[${items}]`;
-}
-
-function serializeConfigFrontmatter(data) {
-  const lines = ['---', `updated_at: ${data.updated_at || new Date().toISOString().slice(0, 10)}`, 'briefings:'];
-
-  for (const b of data.briefings) {
-    lines.push(`  - slug: ${b.slug}`);
-    lines.push(`    status: ${b.status}`);
-    lines.push(`    source_plans: ${serializeSourcePlans(b.source_plans)}`);
-    lines.push(`    created_at: "${b.created_at || ''}"`);
-    lines.push(`    approved_at: ${b.approved_at ? `"${b.approved_at}"` : 'null'}`);
-    lines.push(`    prd_generated: ${b.prd_generated ? `"${b.prd_generated}"` : 'null'}`);
-  }
-
-  lines.push('---');
-  return lines.join('\n');
-}
-
-// ─── Markdown table builder ───────────────────────────────────────────────────
-
-function buildMarkdownTable(briefings) {
-  const header = '| slug | status | source_plans | created | approved | prd |';
-  const sep = '|------|--------|-------------|---------|----------|-----|';
-  const rows = briefings.map((b) => {
-    const sources = (b.source_plans || []).join(', ') || '—';
-    return `| ${b.slug} | ${b.status} | ${sources} | ${b.created_at || '—'} | ${b.approved_at || '—'} | ${b.prd_generated || '—'} |`;
-  });
-  return [header, sep, ...rows].join('\n');
-}
-
-// ─── Config writer ────────────────────────────────────────────────────────────
-
-async function writeConfig(configFile, data) {
-  const frontmatter = serializeConfigFrontmatter(data);
-  const table = buildMarkdownTable(data.briefings);
-  const body = `\n# Briefings Registry\n\n${table}\n`;
-  await fs.writeFile(configFile, `${frontmatter}\n${body}`, 'utf8');
-}
+const {
+  configPath: registryConfigPath,
+  readBriefingRegistry,
+  writeBriefingRegistry
+} = require('../lib/briefing-refiner/briefing-registry');
 
 // ─── Interactive prompt helpers ───────────────────────────────────────────────
 
@@ -205,23 +84,21 @@ function promptCheckboxDeselect(items, promptText) {
 async function runBriefingApprove({ args, options = {}, logger }) {
   const projectDir = path.resolve(process.cwd(), args[0] || '.');
   const slugOpt = String(options.slug || '').trim() || null;
-  const configFile = configPath(projectDir);
+  const configFile = registryConfigPath(projectDir);
 
   // ── Read config ────────────────────────────────────────────────────────────
-  let raw;
+  let data;
   try {
-    raw = await fs.readFile(configFile, 'utf8');
-  } catch {
+    data = await readBriefingRegistry(projectDir);
+  } catch (error) {
+    if (error && error.code === 'invalid_frontmatter') {
+      logger.error('config.md com frontmatter inválido. Verifique o arquivo manualmente.');
+      return { ok: false, error: 'invalid_frontmatter' };
+    }
     logger.error('Nenhum briefing encontrado. Ative @briefing para criar o primeiro briefing.');
     return { ok: false, error: 'no_config' };
   }
 
-  const data = parseConfigFrontmatter(raw);
-  if (!data) {
-    logger.error('config.md com frontmatter inválido. Verifique o arquivo manualmente.');
-    return { ok: false, error: 'invalid_frontmatter' };
-  }
-
   const drafts = data.briefings.filter((b) => b.status === 'draft');
 
   if (drafts.length === 0) {
@@ -259,7 +136,7 @@ async function runBriefingApprove({ args, options = {}, logger }) {
   briefingEntry.approved_at = today;
   data.updated_at = today;
 
-  await writeConfig(configFile, data);
+  await writeBriefingRegistry(projectDir, data);
 
   logger.log(`✓ Briefing "${target.slug}" aprovado.`);
   logger.log('  Ative @product para gerar o PRD — ele detectará o briefing aprovado automaticamente.');
@@ -272,25 +149,26 @@ async function runBriefingApprove({ args, options = {}, logger }) {
 async function runBriefingUnapprove({ args, options = {}, logger }) {
   const projectDir = path.resolve(process.cwd(), args[0] || '.');
   const slugOpt = String(options.slug || '').trim() || null;
-  const configFile = configPath(projectDir);
+  const configFile = registryConfigPath(projectDir);
 
   // ── Read config ────────────────────────────────────────────────────────────
-  let raw;
+  let data;
   try {
-    raw = await fs.readFile(configFile, 'utf8');
-  } catch {
+    data = await readBriefingRegistry(projectDir);
+  } catch (error) {
+    if (error && error.code === 'invalid_frontmatter') {
+      logger.error('config.md com frontmatter inválido. Verifique o arquivo manualmente.');
+      return { ok: false, error: 'invalid_frontmatter' };
+    }
     logger.error('Nenhum briefing encontrado. Ative @briefing para criar o primeiro briefing.');
     return { ok: false, error: 'no_config' };
   }
 
-  const data = parseConfigFrontmatter(raw);
-  if (!data) {
-    logger.error('config.md com frontmatter inválido. Verifique o arquivo manualmente.');
-    return { ok: false, error: 'invalid_frontmatter' };
-  }
-
-  // Only approved and non-implemented briefings can be unapproved
-  const approveds = data.briefings.filter((b) => b.status === 'approved');
+  // Only approved briefings that have NOT yet generated a PRD can be unapproved.
+  // Reverting a prd_generated briefing would desync it from its downstream PRD,
+  // so it is excluded here (mirrors the registry-level guard in
+  // returnApprovedBriefingToDraft).
+  const approveds = data.briefings.filter((b) => b.status === 'approved' && !b.prd_generated);
 
   if (approveds.length === 0) {
     logger.log('Nenhum briefing aprovado disponível para retornar a draft.');
@@ -333,7 +211,7 @@ async function runBriefingUnapprove({ args, options = {}, logger }) {
   }
   data.updated_at = today;
 
-  await writeConfig(configFile, data);
+  await writeBriefingRegistry(projectDir, data);
 
   const names = targets.map((b) => b.slug);
   logger.log(`✓ ${names.length === 1 ? `Briefing "${names[0]}" retornado` : `Briefings retornados`} para draft: ${names.join(', ')}`);

package/src/commands/commit-prepare.js

@@ -33,7 +33,10 @@ function resolveGitRoot(projectDir) {
 }
 
 function parseGitStatusShort(gitRoot) {
-  const output = runGit(gitRoot, ['status', '--short']);
+  // core.quotePath=false makes git emit non-ASCII paths literally (UTF-8) instead
+  // of C-style double-quoted/escaped form, so the parsed path is the real path and
+  // `git add -- <path>` later targets the correct file.
+  const output = runGit(gitRoot, ['-c', 'core.quotePath=false', 'status', '--short']);
   const lines = output.split('\n').filter(Boolean);
   const staged = [];
   const unstaged = [];
@@ -223,7 +226,7 @@ async function resolveGuardFindings(gitRoot, guardResult, logger) {
         logger.log(`  ✔ Adicionado a contentAllowPaths: ${finding.path}`);
       }
     } else if (action === 'block') {
-      const pattern = `${finding.path.includes('**') ? finding.path : finding.path}`;
+      const pattern = finding.path;
       if (!guardConfig.blockPaths.includes(pattern)) {
         guardConfig.blockPaths.push(pattern);
         guardConfigChanged = true;

package/src/commands/feature-archive.js

@@ -131,6 +131,42 @@ async function findArchivedFiles(archiveDir) {
   return entries.filter((e) => e.isFile()).map((e) => e.name);
 }
 
+/**
+ * Enumerate every artefact that belongs to a feature slug — the exact surface
+ * `feature:archive` would move — but as a pure read-only discovery, for
+ * non-destructive consumers (e.g. `feature:export`). Never mutates the tree.
+ *
+ * Reuses the slug-collision guard (readOtherSlugs/findSlugFiles) so a longer
+ * sibling slug (`checkout-v2`) never leaks into `checkout`.
+ *
+ * @returns {{ rootFiles: string[], dirs: Array<{label:string, sourceDir:string}>, doneDir: string|null }}
+ *   rootFiles are bare names under `.aioson/context/`; dirs/doneDir are absolute paths.
+ */
+async function collectFeatureArtifacts({ ctxDir, targetDir, slug, includeDone = true }) {
+  const featuresPath = path.join(ctxDir, 'features.md');
+  const otherSlugs = await readOtherSlugs(featuresPath, slug);
+  const rootFiles = await findSlugFiles(ctxDir, slug, otherSlugs);
+
+  const slugDirCandidates = [
+    { label: 'dossier', sourceDir: path.join(ctxDir, 'features', slug) },
+    { label: 'plans', sourceDir: path.join(targetDir, '.aioson', 'plans', slug) },
+    { label: 'briefings', sourceDir: path.join(targetDir, '.aioson', 'briefings', slug) }
+  ];
+  const dirs = [];
+  for (const d of slugDirCandidates) {
+    // eslint-disable-next-line no-await-in-loop
+    if (await dirExists(d.sourceDir)) dirs.push(d);
+  }
+
+  let doneDir = null;
+  if (includeDone) {
+    const candidate = path.join(ctxDir, 'done', slug);
+    if (await dirExists(candidate)) doneDir = candidate;
+  }
+
+  return { rootFiles, dirs, doneDir };
+}
+
 async function extractSummary(prdPath) {
   const content = await readFileSafe(prdPath);
   if (!content) return null;
@@ -338,18 +374,18 @@ async function runFeatureArchive({ args = [], options = {}, logger }) {
         action: d.action,
         reason: d.reason
       }));
-    const result = {
-      ok: true,
-      dryRun: true,
-      slug,
+    const result = {
+      ok: true,
+      dryRun: true,
+      slug,
       targetDir: path.relative(targetDir, archiveDir),
-      move: toMove,
-      skip: toSkip,
-      dirs,
-      dossier: dirs.find((d) => d.label === 'dossier') || null,
-      manifestEntry: {
-        slug,
-        completed,
+      move: toMove,
+      skip: toSkip,
+      dirs,
+      dossier: dirs.find((d) => d.label === 'dossier') || null,
+      manifestEntry: {
+        slug,
+        completed,
         files: String(toMove.length + alreadyArchived.length),
         summary: summary || '—'
       }
@@ -628,4 +664,4 @@ async function runFeatureSweep({ args = [], options = {}, logger }) {
   return result;
 }
 
-module.exports = { runFeatureArchive, runFeatureSweep };
+module.exports = { runFeatureArchive, runFeatureSweep, collectFeatureArtifacts };

package/src/commands/feature-close.js

@@ -333,6 +333,46 @@ async function runFeatureClose({ args, options = {}, logger }) {
     const contractContent = await readFileSafe(contractPath);
     const progressContent = await readFileSafe(progressPath);
 
+    // REQ-13 (loop-guardrails): tema `publish` é gate de COMANDO — intercepta
+    // o feature:close quando o contrato ativo o exige e não há gate publish
+    // aprovado. Nunca detectado por diff. `--force` NÃO bypassa: a aprovação
+    // humana é o propósito do gate (decisão registrada no spec da feature).
+    if (contractContent) {
+      try {
+        const contract = JSON.parse(contractContent);
+        const requiredFor = contract && contract.human_gate && Array.isArray(contract.human_gate.required_for)
+          ? contract.human_gate.required_for
+          : [];
+        if (requiredFor.includes('publish')) {
+          const { hasApprovedPublishGate, pendingGates, createGate } = require('../harness/human-gate');
+          const { emitGuardEvent } = require('../harness/guard-events');
+          if (!hasApprovedPublishGate(planDir)) {
+            let gate = pendingGates(planDir).find((g) => g.theme === 'publish');
+            if (!gate) {
+              gate = createGate(planDir, {
+                theme: 'publish',
+                attempt: 0,
+                triggeredBy: [],
+                diffSummary: `feature:close ${slug}`,
+                runId: null
+              });
+              await emitGuardEvent(targetDir, {
+                eventType: 'human_gate_requested',
+                message: `publish gate ${gate.id} requested by feature:close`,
+                payload: { slug, gate_id: gate.id, theme: 'publish' }
+              });
+            }
+            const errMsg = `[Publish Gate BLOCKED] Feature "${slug}" requires human approval before closing (human_gate.required_for includes "publish"). Approve with: aioson harness:approve . --slug=${slug} --gate=${gate.id}`;
+            if (options.json) {
+              return { ok: false, reason: 'publish_gate_pending', feature: slug, gate: gate.id, error: errMsg };
+            }
+            logger.log(errMsg);
+            return { ok: false };
+          }
+        }
+      } catch { /* contrato ilegível — o done gate abaixo lida com o estado */ }
+    }
+
     if (contractContent && progressContent) {
       const force = options.force === true;
       let progress = null;