nubos-pilot 0.1.0

package/lib/fixtures/plans/linear/tasks/T-02.md

@@ -0,0 +1,20 @@
+---
+id: 99-01-T02
+status: pending
+tier: sonnet
+owner: np-executor
+phase: 99
+plan: 01
+type: execute
+wave: 2
+depends_on: [T-01]
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "stub"
+  artifacts: []
+  key_links: []
+---
+
+Task T-02 body.

package/lib/fixtures/plans/linear/tasks/T-03.md

@@ -0,0 +1,20 @@
+---
+id: 99-01-T03
+status: pending
+tier: sonnet
+owner: np-executor
+phase: 99
+plan: 01
+type: execute
+wave: 3
+depends_on: [T-02]
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "stub"
+  artifacts: []
+  key_links: []
+---
+
+Task T-03 body.

package/lib/fixtures/plans/parallel/PLAN.md

@@ -0,0 +1,16 @@
+---
+phase: 99
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "fixture stub"
+  artifacts: []
+  key_links: []
+---
+
+Parallel fixture: T-01 base; T-02 and T-03 depend on T-01.

package/lib/fixtures/plans/parallel/tasks/T-01.md

@@ -0,0 +1,20 @@
+---
+id: 99-01-T01
+status: pending
+tier: sonnet
+owner: np-executor
+phase: 99
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "stub"
+  artifacts: []
+  key_links: []
+---
+
+Task T-01 body.

package/lib/fixtures/plans/parallel/tasks/T-02.md

@@ -0,0 +1,20 @@
+---
+id: 99-01-T02
+status: pending
+tier: sonnet
+owner: np-executor
+phase: 99
+plan: 01
+type: execute
+wave: 2
+depends_on: [T-01]
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "stub"
+  artifacts: []
+  key_links: []
+---
+
+Task T-02 body.

package/lib/fixtures/plans/parallel/tasks/T-03.md

@@ -0,0 +1,20 @@
+---
+id: 99-01-T03
+status: pending
+tier: sonnet
+owner: np-executor
+phase: 99
+plan: 01
+type: execute
+wave: 2
+depends_on: [T-01]
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "stub"
+  artifacts: []
+  key_links: []
+---
+
+Task T-03 body.

package/lib/fixtures/plans/wave-conflict/PLAN.md

@@ -0,0 +1,16 @@
+---
+phase: 99
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "fixture stub"
+  artifacts: []
+  key_links: []
+---
+
+Wave-conflict fixture: T-02 carries wave:5 but depends on T-01 -> computed wave:2.

package/lib/fixtures/plans/wave-conflict/tasks/T-01.md

@@ -0,0 +1,20 @@
+---
+id: 99-01-T01
+status: pending
+tier: sonnet
+owner: np-executor
+phase: 99
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "stub"
+  artifacts: []
+  key_links: []
+---
+
+Task T-01 body.

package/lib/fixtures/plans/wave-conflict/tasks/T-02.md

@@ -0,0 +1,20 @@
+---
+id: 99-01-T02
+status: pending
+tier: sonnet
+owner: np-executor
+phase: 99
+plan: 01
+type: execute
+wave: 5
+depends_on: [T-01]
+files_modified: []
+autonomous: true
+must_haves:
+  truths:
+    - "stub"
+  artifacts: []
+  key_links: []
+---
+
+Task T-02 body.

package/lib/fixtures/roadmap/ROADMAP-malformed.md

@@ -0,0 +1,3 @@
+# Roadmap
+
+Intentionally malformed — no Phase Details section.

package/lib/fixtures/roadmap/ROADMAP-minimal.md

@@ -0,0 +1,51 @@
+# Roadmap: Minimal Fixture
+
+## Overview
+
+Minimal hand-authored ROADMAP for roadmap-parser regression tests.
+
+## Phases
+
+- [x] **Phase 1: Foundation** - Lay the base
+- [ ] **Phase 2.1: Hotfix** - Urgent insertion (INSERTED)
+- [ ] **Phase 3: Core** - Main build
+
+## Phase Details
+
+### Phase 1: Foundation
+**Goal**: Establish the scaffolding so later phases have something to build on.
+**Depends on**: Nothing (first phase)
+**Requirements**: F-01, F-02
+**Success Criteria** (what must be TRUE):
+  1. Scaffolding directory exists with README
+  2. Initial ADR set is committed
+
+**Plans**: 01-01 (complete)
+
+### Phase 2.1: Hotfix
+**Goal**: Patch the critical issue that blocked Phase 2.
+**Depends on**: Phase 2
+**Requirements**: F-03
+**Plans**: TBD
+
+### Phase 3: Core
+**Goal**: Build the core library modules that every workflow depends on.
+**Depends on**: Phase 2
+**Requirements**: L-01, L-02, L-03
+**Success Criteria** (what must be TRUE):
+  1. Core parser exports the public surface
+  2. All unit tests pass with ≥70% coverage
+  3. Zero runtime dependencies added
+
+**Plans**: TBD
+
+## Progress
+
+| Phase | Plans Complete | Status | Completed |
+|-------|----------------|--------|-----------|
+| 1. Foundation | 1/1 | Complete | 2026-04-14 |
+| 2.1. Hotfix | 0/TBD | Not started | - |
+| 3. Core | 0/TBD | Not started | - |
+
+---
+*Minimal roadmap fixture for lib/roadmap.test.cjs*

package/lib/fixtures/roadmap/roadmap-malformed.yaml

@@ -0,0 +1,7 @@
+schema_version: 1
+milestones:
+  - id: v1.0
+    name: "unclosed
+    phases:
+      - number: 1
+       name: broken-indent

package/lib/fixtures/roadmap/roadmap-minimal.yaml

@@ -0,0 +1,40 @@
+schema_version: 1
+milestones:
+  - id: v1.0
+    name: minimal
+    phases:
+      - number: 1
+        name: "Foundation"
+        slug: foundation
+        goal: "Establish the scaffolding so later phases have something to build on."
+        depends_on: "Nothing (first phase)"
+        requirements: [F-01, F-02]
+        success_criteria:
+          - "Scaffolding directory exists with README"
+          - "Initial ADR set is committed"
+        status: done
+        plans:
+          - id: "01-01"
+            title: ""
+            complete: true
+      - number: "2.1"
+        name: "Hotfix"
+        slug: hotfix
+        goal: "Patch the critical issue that blocked Phase 2."
+        depends_on: "Phase 2"
+        requirements: [F-03]
+        success_criteria: []
+        status: pending
+        plans: []
+      - number: 3
+        name: "Core"
+        slug: core
+        goal: "Build the core library modules that every workflow depends on."
+        depends_on: "Phase 2"
+        requirements: [L-01, L-02, L-03]
+        success_criteria:
+          - "Core parser exports the public surface"
+          - "All unit tests pass with ≥70% coverage"
+          - "Zero runtime dependencies added"
+        status: pending
+        plans: []

package/lib/fixtures/roadmap/roadmap-ten-phases.yaml

@@ -0,0 +1,101 @@
+schema_version: 1
+milestones:
+  - id: "1.0"
+    name: "Example"
+    phases:
+      - number: 1
+        name: "Foundation"
+        slug: foundation
+        goal: "Scaffold the project."
+        depends_on: null
+        requirements: [LIB-01]
+        success_criteria: []
+        status: done
+        plans:
+          - id: "01-01"
+            title: ""
+            complete: true
+      - number: 2
+        name: "State"
+        slug: state
+        goal: "Introduce STATE.md and frontmatter."
+        depends_on: "Phase 1"
+        requirements: [LIB-02]
+        success_criteria: []
+        status: pending
+        plans:
+          - id: "02-01"
+            title: ""
+            complete: false
+      - number: 3
+        name: "Library Core"
+        slug: library-core
+        goal: "Land the core library modules."
+        depends_on: "Phase 2"
+        requirements: [LIB-03, LIB-04, LIB-05, LIB-06, LIB-07, LIB-08]
+        success_criteria: []
+        status: pending
+        plans: []
+      - number: 4
+        name: "Base Workflows"
+        slug: base-workflows
+        goal: "Add the base workflows and state schemas."
+        depends_on: "Phase 3"
+        requirements: [LIB-09]
+        success_criteria: []
+        status: pending
+        plans: []
+      - number: 5
+        name: "Planning Workflows"
+        slug: planning-workflows
+        goal: "Planner + plan-checker loop."
+        depends_on: "Phase 4"
+        requirements: [LIB-10]
+        success_criteria: []
+        status: pending
+        plans: []
+      - number: 6
+        name: "Execution"
+        slug: execution
+        goal: "Executor + atomic-commit-per-unit."
+        depends_on: "Phase 5"
+        requirements: [LIB-11]
+        success_criteria: []
+        status: pending
+        plans: []
+      - number: 7
+        name: "Install"
+        slug: install
+        goal: "Manifest-based installer."
+        depends_on: "Phase 6"
+        requirements: [LIB-12]
+        success_criteria: []
+        status: pending
+        plans: []
+      - number: 8
+        name: "Runtime Adapters"
+        slug: runtime-adapters
+        goal: "Claude / Codex / Gemini / OpenCode adapters."
+        depends_on: "Phase 7"
+        requirements: [LIB-13]
+        success_criteria: []
+        status: pending
+        plans: []
+      - number: 9
+        name: "Orchestration"
+        slug: orchestration
+        goal: "Metrics, plan-diff, AI + UI workflows."
+        depends_on: "Phase 8"
+        requirements: [LIB-14]
+        success_criteria: []
+        status: pending
+        plans: []
+      - number: 10
+        name: "Review and Utilities"
+        slug: review-and-utilities
+        goal: "Code-review, eval-review, session-report, cleanup."
+        depends_on: "Phase 9"
+        requirements: [LIB-15]
+        success_criteria: []
+        status: pending
+        plans: []

package/lib/fixtures/templates/phase-context.md

@@ -0,0 +1,6 @@
+# Phase {{phase_number}}: {{phase_name}} — Context
+
+Phase number: {{phase_number}}
+Goal: {{goal}}
+
+Requirements: {{requirements}}

package/lib/fixtures/templates/plan-skeleton.md

@@ -0,0 +1,6 @@
+---
+phase: {{phase_number}}
+plan: {{plan_number}}
+---
+
+# Plan {{phase_number}}-{{plan_number}}

package/lib/frontmatter.cjs

@@ -0,0 +1,251 @@
+const { NubosPilotError } = require('./core.cjs');
+
+function _parseError(line, snippet, msg) {
+  return new NubosPilotError(
+    'frontmatter-parse-error',
+    msg,
+    { line, snippet },
+  );
+}
+
+function splitInlineArray(body, lineNo, rawLine) {
+  const items = [];
+  let current = '';
+  let inQuote = null;
+  for (let i = 0; i < body.length; i++) {
+    const ch = body[i];
+    if (inQuote) {
+      if (ch === inQuote) {
+        inQuote = null;
+      } else {
+        current += ch;
+      }
+    } else if (ch === '"' || ch === "'") {
+      inQuote = ch;
+    } else if (ch === ',') {
+      const trimmed = current.trim();
+      if (trimmed) items.push(_coerceScalar(trimmed));
+      current = '';
+    } else {
+      current += ch;
+    }
+  }
+  if (inQuote) {
+    throw _parseError(lineNo, rawLine, `Unclosed ${inQuote === '"' ? 'double' : 'single'} quote in inline array`);
+  }
+  const trimmed = current.trim();
+  if (trimmed) items.push(_coerceScalar(trimmed));
+  return items;
+}
+
+function _stripQuotes(v) {
+  if (v.length >= 2) {
+    if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+      return { stripped: v.slice(1, -1), quoted: true };
+    }
+  }
+  return { stripped: v, quoted: false };
+}
+
+function _coerceScalar(raw) {
+  const { stripped, quoted } = _stripQuotes(raw);
+  if (quoted) return stripped;
+  if (stripped === '' || stripped === '~' || stripped === 'null') return null;
+  if (stripped === 'true') return true;
+  if (stripped === 'false') return false;
+  if (/^-?\d+$/.test(stripped)) {
+
+    if (/^-?0\d/.test(stripped)) return stripped;
+    return Number(stripped);
+  }
+  if (/^-?\d+\.\d+$/.test(stripped)) return Number(stripped);
+  return stripped;
+}
+
+function _validateScalarQuoting(value, lineNo, rawLine) {
+  const trimmed = value.trim();
+  if (trimmed === '') return;
+  if (trimmed.startsWith('"')) {
+
+    if (trimmed.length < 2 || !trimmed.endsWith('"')) {
+      throw _parseError(lineNo, rawLine, 'Unclosed double-quoted string');
+    }
+  } else if (trimmed.startsWith("'")) {
+    if (trimmed.length < 2 || !trimmed.endsWith("'")) {
+      throw _parseError(lineNo, rawLine, 'Unclosed single-quoted string');
+    }
+  }
+}
+
+function extractFrontmatter(content) {
+  if (typeof content !== 'string') {
+    throw _parseError(0, '', 'extractFrontmatter: input must be a string');
+  }
+
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)([\s\S]*)$/);
+  if (!match) {
+    return { frontmatter: {}, body: content };
+  }
+
+  const yaml = match[1];
+  const body = match[2];
+  const lines = yaml.split(/\r?\n/);
+
+  const frontmatter = {};
+
+  
+  const stack = [{ container: frontmatter, indent: -1, pendingKey: null }];
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineNo = i + 1;
+    if (line.trim() === '') continue;
+
+    const leading = line.match(/^[ \t]*/)[0];
+    if (leading.includes('\t')) {
+      throw _parseError(lineNo, line, 'Tab indentation is not allowed; use spaces');
+    }
+    const indent = leading.length;
+
+    
+    while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+      const popped = stack.pop();
+      _demoteEmptyPlaceholder(popped, stack);
+    }
+    const current = stack[stack.length - 1];
+
+    const trimmed = line.trim();
+
+    if (trimmed.startsWith('- ') || trimmed === '-') {
+      const itemBody = trimmed === '-' ? '' : trimmed.slice(2);
+
+      
+      if (current.pendingKey !== null) {
+
+        
+        const parent = stack[stack.length - 2];
+        if (parent) {
+          parent.container[current.pendingKey] = [];
+          current.container = parent.container[current.pendingKey];
+          current.pendingKey = null;
+        }
+      }
+
+      if (!Array.isArray(current.container)) {
+        throw _parseError(lineNo, line, 'Unexpected "- " outside of a list context');
+      }
+
+      if (itemBody.includes(':') && /^[a-zA-Z0-9_-]+\s*:/.test(itemBody)) {
+        const kv = itemBody.match(/^([a-zA-Z0-9_-]+)\s*:\s*(.*)$/);
+        if (!kv) {
+          throw _parseError(lineNo, line, 'Malformed inline mapping in list item');
+        }
+        const itemObj = {};
+        _assignKeyValue(itemObj, kv[1], kv[2], lineNo, line);
+        current.container.push(itemObj);
+
+        
+
+        stack.push({ container: itemObj, indent: indent + 1, pendingKey: null });
+      } else {
+
+        _validateScalarQuoting(itemBody, lineNo, line);
+        current.container.push(_coerceScalar(itemBody));
+      }
+      continue;
+    }
+
+    const kvMatch = line.match(/^\s*([a-zA-Z0-9_-]+)\s*:\s*(.*)$/);
+    if (!kvMatch) {
+      throw _parseError(lineNo, line, 'Line does not match "key: value" or "- item" pattern');
+    }
+    const key = kvMatch[1];
+    const value = kvMatch[2];
+
+    if (Array.isArray(current.container)) {
+
+      
+
+      throw _parseError(lineNo, line, 'Unexpected key inside array context');
+    }
+
+    _assignKeyValue(current.container, key, value, lineNo, line, stack, indent);
+  }
+
+  
+
+  for (const entry of stack) {
+    if (entry.pendingKey !== null) {
+      const parent = _findParentOfContainer(frontmatter, entry.container);
+      if (parent && parent.obj && parent.key === entry.pendingKey) {
+        if (typeof entry.container === 'object' && !Array.isArray(entry.container) && Object.keys(entry.container).length === 0) {
+          parent.obj[entry.pendingKey] = null;
+        }
+      }
+    }
+  }
+
+  return { frontmatter, body };
+}
+
+function _demoteEmptyPlaceholder(poppedEntry, remainingStack) {
+  if (poppedEntry.pendingKey === null) return;
+  const c = poppedEntry.container;
+  if (typeof c !== 'object' || c === null) return;
+  if (Array.isArray(c)) return;
+  if (Object.keys(c).length !== 0) return;
+
+  const parent = remainingStack[remainingStack.length - 1];
+  if (parent && parent.container && !Array.isArray(parent.container)) {
+    if (parent.container[poppedEntry.pendingKey] === c) {
+      parent.container[poppedEntry.pendingKey] = null;
+    }
+  }
+}
+
+function _findParentOfContainer(root, target, path = []) {
+  if (root === target) return null; 
+  if (typeof root !== 'object' || root === null) return null;
+  if (Array.isArray(root)) {
+    for (let i = 0; i < root.length; i++) {
+      if (root[i] === target) return { obj: root, key: i };
+      const nested = _findParentOfContainer(root[i], target, path.concat(i));
+      if (nested) return nested;
+    }
+    return null;
+  }
+  for (const k of Object.keys(root)) {
+    if (root[k] === target) return { obj: root, key: k };
+    const nested = _findParentOfContainer(root[k], target, path.concat(k));
+    if (nested) return nested;
+  }
+  return null;
+}
+
+function _assignKeyValue(obj, key, rawValue, lineNo, line, stack, indent) {
+  const value = rawValue;
+  const trimmedValue = value.trim();
+
+  if (trimmedValue === '') {
+
+    
+
+    
+    obj[key] = {};
+    if (stack) {
+      stack.push({ container: obj[key], indent, pendingKey: key });
+    }
+    return;
+  }
+
+  if (trimmedValue.startsWith('[') && trimmedValue.endsWith(']')) {
+    const inner = trimmedValue.slice(1, -1);
+    obj[key] = splitInlineArray(inner, lineNo, line);
+    return;
+  }
+
+  _validateScalarQuoting(trimmedValue, lineNo, line);
+  obj[key] = _coerceScalar(trimmedValue);
+}
+
+module.exports = { extractFrontmatter };