@smartmemory/compose 0.5.0 → 0.5.1

package/README.md

@@ -74,6 +74,20 @@ compose plan "a tool that summarizes my team's standups"
 
 `compose build` then picks up a plan-authored feature and ratifies its design rather than rewriting it.
 
+Bundled [team presets](docs/team-presets.md): `feature` (parallel implementation),
+`research` (parallel exploration), `review` (parallel review), and `fable-astra`:
+
+```bash
+compose build FEAT-1 --team fable-astra
+```
+
+Fable plans independent tasks, Codex workers implement in isolated worktrees, and
+a fresh read-only Astra reviewer checks the merged result after verification.
+Fable then requests another implementation or repair wave, declares the work
+blocked, or approves ship into one base-parent commit. Concurrency is 3; the
+$150 cost ceiling is overridable with `--cost-ceiling-usd`. See the
+[loop and limits](docs/pipelines.md#fable-astra-wave-loop).
+
 ## Quick install
 
 Prerequisites: Node.js 18+. [Stratum](https://github.com/smartmemory/stratum) needs no separate install — `@smartmemory/stratum` is a dependency, and `compose init` registers the installed copy's MCP entrypoint automatically (a sibling `stratum/` checkout is a development convenience, not a requirement; the python `stratum-mcp` PyPI package is retired). Codex steps additionally need the OpenAI `codex` CLI. Full prereqs in [docs/install.md](docs/install.md).

package/bin/compose.js

@@ -567,8 +567,9 @@ async function runInit(flags, cwdOverride) {
   // and then fails with "Lifecycle spec not found" because init never copied it —
   // so the command was unavailable in every fresh workspace independently of the
   // spec's dialect. Each spec's `<name>.profiles.json` sidecar travels WITH it:
-  // loadPipelineProfiles fails open, so a spec copied without its sidecar runs on
-  // bare defaults and silently drops the tool restrictions it declares.
+  // loadPipelineProfiles treats a missing string-only sidecar as bare defaults (the
+  // tool restrictions it declares silently vanish), and runBuild REFUSES a local copy
+  // of a preset whose sidecar configures execution (team-fable-astra) without it.
   const pipelinesDir = join(cwd, 'pipelines')
   mkdirSync(pipelinesDir, { recursive: true })
   const DEFAULT_PIPELINES = [
@@ -2619,6 +2620,20 @@ if (cmd === 'build') {
   }
   let filteredArgs = args.filter((a, i) => i !== cwdIdx && (cwdIdx === -1 || i !== cwdIdx + 1))
 
+  // Extract value-taking build flags before --team counts positional features.
+  // --cwd is already removed; leave --template for the explicit team conflict.
+  const ceilingIdx = filteredArgs.findIndex(a => a === '--cost-ceiling-usd' || a.startsWith('--cost-ceiling-usd='))
+  let costCeilingUsd
+  if (ceilingIdx !== -1) {
+    const inline = filteredArgs[ceilingIdx].includes('=')
+    costCeilingUsd = Number(inline ? filteredArgs[ceilingIdx].split('=')[1] : filteredArgs[ceilingIdx + 1])
+    if (!Number.isFinite(costCeilingUsd) || costCeilingUsd <= 0) {
+      console.error('--cost-ceiling-usd requires a finite positive USD amount')
+      process.exit(1)
+    }
+    filteredArgs.splice(ceilingIdx, inline ? 1 : 2)
+  }
+
   // --team flag (COMP-TEAMS)
   let teamTemplate = null
   try {
@@ -2667,7 +2682,7 @@ if (cmd === 'build') {
   if (teamTemplate && !templateName) {
     templateName = teamTemplate
   }
-  const filteredArgs2 = filteredArgs.filter((a, i) => i !== templateIdx && (templateIdx === -1 || i !== templateIdx + 1))
+  let filteredArgs2 = filteredArgs.filter((a, i) => i !== templateIdx && (templateIdx === -1 || i !== templateIdx + 1))
 
   const featureCodes = filteredArgs2.filter(a => !a.startsWith('-'))
   const featureCode = featureCodes[0]
@@ -2725,6 +2740,10 @@ if (cmd === 'build') {
     console.error('Error: --abort and --all/prefix/multi are mutually exclusive')
     process.exit(1)
   }
+  if (costCeilingUsd !== undefined && isBatch) {
+    console.error('--cost-ceiling-usd is single-build only; batch is not supported')
+    process.exit(1)
+  }
   if (resume && fresh) {
     console.error('--resume and --fresh are mutually exclusive')
     process.exit(1)
@@ -2780,6 +2799,7 @@ if (cmd === 'build') {
     console.error('  --abort        Abort the active build')
     console.error('  --resume       Resume the active build for <feature-code>')
     console.error('  --fresh        Start a fresh build, discarding stale failed/resumable state')
+    console.error('  --cost-ceiling-usd <amount>  Override a configured ceiling (single build; holds still require a human)')
     console.error('  --all          Build all PLANNED features in dependency order')
     console.error('  --dry-run      Print build order without executing')
     console.error('  --cwd <path>   Agent working directory (for cross-repo features)')
@@ -2856,6 +2876,7 @@ if (cmd === 'build') {
       if (implementerArg) singleOpts.implementer = implementerArg   // COMP-MODEL-AB
       if (reviewerArg) singleOpts.reviewer = reviewerArg             // COMP-MODEL-AB
       if (resume) singleOpts.resume = true
+      if (costCeilingUsd !== undefined) singleOpts.costCeilingUsd = costCeilingUsd
       if (fresh) singleOpts.fresh = true
       if (nonInteractiveBuild) singleOpts.gateOpts = { nonInteractive: true }
       if (resumeFlowId) singleOpts.resumeFlowId = resumeFlowId

package/lib/agent-string.js

@@ -8,17 +8,17 @@
  *   "claude:read-only-reviewer:fast"  → provider + template + tier
  *   "claude::fast"                    → provider + tier (no template)
  *
- * Tiers: critical | standard | fast  (maps to Opus / Sonnet / Haiku via model-tiers.js)
+ * Tiers: critical | standard | fast | coordinator  (maps to Opus / Sonnet / Haiku / Fable via model-tiers.js)
  */
 
 import { resolveTemplate } from '../server/agent-templates.js';
-import { resolveTierModel, resolveTierThinking } from '../server/model-tiers.js';
+import { MODEL_TIERS, resolveTierModel, resolveTierThinking } from '../server/model-tiers.js';
 
 /** Known provider names — validated by validateAgentString. */
 const KNOWN_PROVIDERS = new Set(['claude', 'codex']);
 
 /** Known tier names — validated by validateAgentString (null = no tier = ok). */
-const KNOWN_TIERS = new Set(['critical', 'standard', 'fast']);
+const KNOWN_TIERS = new Set(Object.keys(MODEL_TIERS));
 
 /**
  * Parse a raw agent string into provider, template, and tier parts.
@@ -52,7 +52,7 @@ export function parseAgentString(raw) {
  *
  * Checks:
  *   - provider must be a known connector type (claude | codex)
- *   - tier, if present, must be a known tier (critical | standard | fast)
+ *   - tier, if present, must be a known tier (critical | standard | fast | coordinator)
  *
  * COMP-MODEL-AB: used by --implementer / --reviewer flag validation.
  *
@@ -73,6 +73,11 @@ export function validateAgentString(raw) {
       `(known: ${[...KNOWN_TIERS].sort().join(', ')})`
     );
   }
+  if (tier != null && resolveTierModel(tier, provider) === null) {
+    throw new Error(
+      `Invalid agent string "${raw}": tier "${tier}" is not available for provider "${provider}"`
+    );
+  }
 }
 
 /**

package/lib/build-stream-writer.js

@@ -198,6 +198,12 @@ export class BuildStreamWriter {
    * @param {string} [status='complete']  Build exit status
    * @param {object} [costTotals]         Optional cumulative cost/token totals
    */
+  pause(detail = {}) {
+    if (this.#closed) return;
+    this.write({ type: 'build_paused', featureCode: this.#featureCode, ...detail });
+    this.#closed = true;
+  }
+
   close(status = 'complete', costTotals = null) {
     if (this.#closed) return;
     this.#closed = true;