ultra-builder-pro-cli 0.13.0 → 0.15.0

package/skills/ultra-research/references/quality-delivery.md

@@ -1,34 +0,0 @@
-# Quality and delivery research
-
-Read this reference when acceptance depends on operational risk, security, migration,
-deployment, recovery, or release constraints.
-
-## Risk-driven quality
-
-Identify failures that would materially affect users, data, authorization, money,
-availability, or recoverability. For each relevant risk, record:
-
-- trigger and affected boundary;
-- expected behavior and observable signal;
-- prevention, detection, and recovery;
-- verification method and owner.
-
-Apply security, performance, accessibility, and resilience checks according to the
-actual product surface. Do not impose generic categories or coverage percentages when
-they do not define acceptance.
-
-## Delivery path
-
-Capture the environments, configuration authority, migration order, compatibility
-window, health and readiness checks, observability, rollout, rollback, and operator
-actions needed for this product.
-
-Prefer existing repository and platform workflows. Add a new service, dependency, or
-deployment mechanism only when the accepted architecture requires it.
-
-## Record the result
-
-Update the architecture and product specifications with testable quality scenarios,
-delivery constraints, failure behavior, recovery evidence, and release acceptance.
-Keep exact volatile commands in the repository's runbook when they are operational
-procedure rather than durable architecture.

package/skills/ultra-research/references/synthesis.md

@@ -1,38 +0,0 @@
-# Baseline synthesis and validation
-
-Read this reference after the selected research lanes are complete.
-
-## Traceability check
-
-Verify that each accepted outcome has:
-
-1. supporting problem, user, or constraint evidence;
-2. an explicit decision and scope boundary;
-3. testable acceptance behavior;
-4. a compatible architecture or delivery path;
-5. a named unresolved blocker when any link is missing.
-
-Check the reverse direction as well: every proposed component, dependency, and quality
-requirement must support an accepted outcome or constraint.
-
-## Consistency check
-
-- Use one term for each actor, boundary, and authoritative data source.
-- Remove duplicate narratives and stale alternatives.
-- Keep source links next to the claims they support.
-- Separate durable decisions from volatile external facts.
-- Preserve explicit non-goals and rejected alternatives only when they prevent a
-  likely future mistake.
-
-## Handoff
-
-Report:
-
-- validated scope and decisive evidence;
-- specification files changed;
-- accepted decisions and material uncertainty;
-- blockers, or an explicit statement that none remain;
-- one next action.
-
-Do not create a parallel summary document solely for model consumption. The planning
-workflow should read the smallest authoritative baseline sections it needs.

package/skills/ultra-research/references/users-scope.md

@@ -1,40 +0,0 @@
-# Users, behavior, and scope
-
-Read this reference when actors, workflows, acceptance, boundaries, or success signals
-are unclear.
-
-## Actors and scenarios
-
-Model only actors supported by evidence. Prefer roles and jobs over fictional persona
-biographies. For each material scenario, capture:
-
-- trigger and preconditions;
-- actor goal;
-- main flow and system response;
-- important failure or recovery path;
-- observable completion signal.
-
-## Acceptance and scope
-
-Turn scenarios into testable behavior. Each requirement should name the observable
-outcome, relevant constraints, and how success can be verified.
-
-Define:
-
-- included behavior required for the accepted outcome;
-- explicit non-goals;
-- dependencies and assumptions;
-- deferred work only when a real sequencing decision exists.
-
-Avoid arbitrary release buckets or a fixed number of stories. Scope follows the
-validated outcome and delivery constraint.
-
-## Success signals
-
-Choose metrics only when they will guide a decision. Define the event, population,
-window, source, owner, and interpretation. Do not invent target values; record a
-baseline, a user-approved target, or the experiment needed to establish one.
-
-Update the product specification with actors, scenarios, acceptance, scope, non-goals,
-and decision-relevant success signals. Keep business facts in their source system and
-link them rather than copying volatile datasets into the specification.

package/ultra-tools/legacy-memory.test.cjs

@@ -1,80 +0,0 @@
-'use strict';
-
-const { test } = require('node:test');
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const Database = require('better-sqlite3');
-
-const legacy = require('./commands/legacy-memory.cjs');
-
-function fixture() {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'ubp-legacy-memory-'));
-  const ultra = path.join(root, '.ultra');
-  fs.mkdirSync(path.join(ultra, 'memory'), { recursive: true });
-  fs.writeFileSync(path.join(ultra, 'memory', 'memory.db'), 'legacy-hook-store');
-  const db = new Database(path.join(ultra, 'state.db'));
-  db.exec(`
-    CREATE TABLE memory_entries (
-      id INTEGER PRIMARY KEY, kind TEXT, content TEXT, task_id TEXT,
-      session_id TEXT, tag TEXT, source TEXT, ts TEXT
-    );
-    INSERT INTO memory_entries
-      (kind, content, task_id, session_id, tag, source, ts)
-    VALUES ('decision', 'legacy decision', 't1', 's1', 'arch', 'test', '2026-01-01T00:00:00Z');
-  `);
-  db.close();
-  return root;
-}
-
-test('inspect reports both legacy stores without mutating them', () => {
-  const root = fixture();
-  try {
-    const result = legacy.inspectLegacy(root);
-    assert.equal(result.hook_memory_dir, true);
-    assert.equal(result.state_memory_table, true);
-    assert.equal(result.state_memory_entries, 1);
-    assert.ok(fs.existsSync(path.join(root, '.ultra', 'memory', 'memory.db')));
-  } finally {
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});
-test('archive exports legacy state rows and copies hook memory without deletion', () => {
-  const root = fixture();
-  try {
-    const result = legacy.archiveLegacy(root, { timestamp: '2026-07-15T00-00-00-000Z' });
-    assert.equal(result.archived, true);
-    assert.ok(fs.existsSync(path.join(result.archive_dir, 'hook-memory', 'memory.db')));
-    const exported = JSON.parse(fs.readFileSync(path.join(result.archive_dir, 'state-memory-entries.json'), 'utf8'));
-    assert.equal(exported.entries.length, 1);
-    assert.equal(exported.entries[0].content, 'legacy decision');
-    assert.ok(fs.existsSync(path.join(root, '.ultra', 'memory', 'memory.db')));
-    const db = new Database(path.join(root, '.ultra', 'state.db'), { readonly: true });
-    assert.ok(db.prepare("SELECT 1 FROM sqlite_master WHERE name = 'memory_entries'").get());
-    db.close();
-  } finally {
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});
-
-test('prune requires an exact confirmation and archives before deleting', () => {
-  const root = fixture();
-  try {
-    assert.throws(() => legacy.pruneLegacy(root, { confirm: 'yes' }), /DELETE_ULTRA_LEGACY_MEMORY/);
-    assert.ok(fs.existsSync(path.join(root, '.ultra', 'memory', 'memory.db')));
-
-    const result = legacy.pruneLegacy(root, {
-      confirm: 'DELETE_ULTRA_LEGACY_MEMORY',
-      timestamp: '2026-07-15T00-00-01-000Z',
-    });
-    assert.equal(result.pruned, true);
-    assert.ok(fs.existsSync(result.archive_dir));
-    assert.ok(!fs.existsSync(path.join(root, '.ultra', 'memory')));
-    const db = new Database(path.join(root, '.ultra', 'state.db'), { readonly: true });
-    assert.equal(db.prepare("SELECT 1 FROM sqlite_master WHERE name = 'memory_entries'").get(), undefined);
-    db.close();
-  } finally {
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});

package/ultra-tools/status-command.test.cjs

@@ -1,181 +0,0 @@
-'use strict';
-
-// Phase 6.3 — ultra-tools status cost panel:
-//   • `ultra-tools status --cost --json` prints {period, by_runtime,
-//     top_tasks, total_cost_usd}.
-//   • Default human-readable mode renders a summary table.
-//   • --since 7d filters telemetry to the last 7 days.
-
-const { test } = require('node:test');
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-
-const { initStateDb, closeStateDb } = require('../mcp-server/lib/state-db.cjs');
-const ops = require('../mcp-server/lib/state-ops.cjs');
-const telemetry = require('../mcp-server/lib/telemetry.cjs');
-const statusCmd = require('./commands/status.cjs');
-
-function freshFixture() {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ubp-status-'));
-  const file = path.join(dir, '.ultra', 'state.db');
-  const init = initStateDb(file);
-  return { dir, db: init.db };
-}
-
-function teardown(dir, db) {
-  try { closeStateDb(db); } catch (_) { /* ignore */ }
-  try { fs.rmSync(dir, { recursive: true, force: true }); } catch (_) { /* ignore */ }
-}
-
-function seedCalls(db, dir) {
-  ops.createTask(db, { id: 't-cheap', title: 'cheap', type: 'feature', priority: 'P2' });
-  ops.createTask(db, { id: 't-pricey', title: 'pricey', type: 'feature', priority: 'P1' });
-  ops.createSession(db, { sid: 's-x', task_id: 't-cheap', runtime: 'claude', worktree_path: `${dir}/w1`, artifact_dir: `${dir}/a1` });
-  ops.createSession(db, { sid: 's-y', task_id: 't-pricey', runtime: 'codex', worktree_path: `${dir}/w2`, artifact_dir: `${dir}/a2` });
-  telemetry.appendTelemetry(db, { event_type: 'token_usage', tool_name: 't', session_id: 's-x', runtime: 'claude', tokens_input: 500, tokens_output: 100, rootDir: dir, payload: { model: 'claude-haiku-4-5' } });
-  telemetry.appendTelemetry(db, { event_type: 'token_usage', tool_name: 't', session_id: 's-y', runtime: 'codex', tokens_input: 10000, tokens_output: 2000, rootDir: dir, payload: { model: 'gpt-5.4' } });
-  telemetry.appendTelemetry(db, { event_type: 'tool_call', tool_name: 'task.list', session_id: null, rootDir: dir });
-}
-
-test('status --json --cost returns by_runtime + top_tasks + total_cost', () => {
-  const { dir, db } = freshFixture();
-  try {
-    seedCalls(db, dir);
-    const out = statusCmd.buildCostPanel(db, { since: null, limit: 10 });
-    assert.ok(Array.isArray(out.by_runtime));
-    assert.ok(Array.isArray(out.top_tasks));
-    assert.ok(typeof out.total_cost_usd === 'number');
-    const byR = Object.fromEntries(out.by_runtime.map((r) => [r.runtime, r]));
-    assert.equal(byR.claude.calls, 1);
-    assert.equal(byR.codex.calls, 1);
-    assert.equal(byR.unknown.calls, 1); // CLI call with null session
-    assert.equal(out.top_tasks[0].task_id, 't-pricey');
-    assert.ok(out.total_cost_usd > 0);
-  } finally { teardown(dir, db); }
-});
-
-test('buildCostPanel: empty db → zero totals, empty arrays', () => {
-  const { dir, db } = freshFixture();
-  try {
-    const out = statusCmd.buildCostPanel(db, {});
-    assert.equal(out.total_cost_usd, 0);
-    assert.equal(out.by_runtime.length, 0);
-    assert.equal(out.top_tasks.length, 0);
-    assert.deepEqual(out.baseline, {
-      id: null, mode: null, status: 'missing', health: 'fail',
-      repository_revision: null, blockers: ['BASELINE_MISSING'], warnings: [],
-    });
-  } finally { teardown(dir, db); }
-});
-
-test('status exposes an in-progress brownfield baseline from authoritative state', () => {
-  const { dir, db } = freshFixture();
-  try {
-    db.prepare(
-      `INSERT INTO baselines (id, project_name, mode, status)
-       VALUES ('adoption', 'legacy', 'brownfield', 'adopting')`,
-    ).run();
-    const out = statusCmd.buildCostPanel(db, { rootDir: dir });
-    assert.equal(out.baseline.id, 'adoption');
-    assert.equal(out.baseline.mode, 'brownfield');
-    assert.equal(out.baseline.status, 'adopting');
-    assert.deepEqual(out.baseline.blockers, ['BASELINE_NOT_READY:adopting']);
-    assert.match(statusCmd.renderHuman(out), /Baseline: brownfield\/adopting.*blocked/i);
-  } finally { teardown(dir, db); }
-});
-
-test('status reports a legacy schema as migration-required instead of throwing SQLite errors', () => {
-  const { dir, db } = freshFixture();
-  try {
-    db.exec('DROP TABLE baselines');
-    const out = statusCmd.buildCostPanel(db, { rootDir: dir });
-    assert.equal(out.baseline.status, 'migration_required');
-    assert.deepEqual(out.baseline.blockers, ['BASELINE_SCHEMA_MIGRATION_REQUIRED']);
-    assert.match(statusCmd.renderHuman(out), /migration_required/i);
-  } finally { teardown(dir, db); }
-});
-
-test('status summarizes the authoritative baseline gap ledger', () => {
-  const { dir, db } = freshFixture();
-  try {
-    db.prepare(
-      `INSERT INTO baselines (id, project_name, mode, status, gaps_json)
-       VALUES ('adoption', 'legacy', 'brownfield', 'adopting', ?)`,
-    ).run(JSON.stringify([
-      { id: 'blocker', category: 'baseline_blocker', status: 'open', blocking: true, summary: 'Missing proof', evidence_refs: [] },
-      { id: 'debt', category: 'technical_debt', status: 'accepted', blocking: false, summary: 'Slow test', evidence_refs: [] },
-    ]));
-    const out = statusCmd.buildCostPanel(db, { rootDir: dir });
-    assert.deepEqual(out.baseline.gaps, {
-      total: 2, open: 1, blocking: 1,
-      by_category: { baseline_blocker: 1, technical_debt: 1 },
-    });
-  } finally { teardown(dir, db); }
-});
-
-test('buildCostPanel: since cutoff in future → all filtered out', () => {
-  const { dir, db } = freshFixture();
-  try {
-    seedCalls(db, dir);
-    const future = new Date(Date.now() + 60 * 1000).toISOString();
-    const out = statusCmd.buildCostPanel(db, { since: future });
-    assert.equal(out.by_runtime.length, 0);
-    assert.equal(out.top_tasks.length, 0);
-  } finally { teardown(dir, db); }
-});
-
-test('parseSince: 7d / 24h / iso passthrough', () => {
-  const now = Date.parse('2026-04-17T12:00:00Z');
-  const sevenDaysAgo = statusCmd.parseSince('7d', now);
-  const expectedDayCutoff = new Date(now - 7 * 24 * 3600 * 1000).toISOString();
-  assert.equal(sevenDaysAgo, expectedDayCutoff);
-  assert.equal(statusCmd.parseSince('24h', now), new Date(now - 24 * 3600 * 1000).toISOString());
-  assert.equal(statusCmd.parseSince('2026-04-10T00:00:00Z'), '2026-04-10T00:00:00Z');
-  assert.equal(statusCmd.parseSince(null), null);
-});
-
-test('parseSince: invalid → throws', () => {
-  assert.throws(() => statusCmd.parseSince('bogus'), /since/i);
-});
-
-test('renderHuman: includes key section headers', () => {
-  const { dir, db } = freshFixture();
-  try {
-    seedCalls(db, dir);
-    const panel = statusCmd.buildCostPanel(db, {});
-    const text = statusCmd.renderHuman(panel);
-    assert.match(text, /Cost by runtime/i);
-    assert.match(text, /Top tasks/i);
-    assert.match(text, /claude/);
-    assert.match(text, /codex/);
-  } finally { teardown(dir, db); }
-});
-
-test('dispatch: --json echoes buildCostPanel output shape', () => {
-  const { dir, db } = freshFixture();
-  try {
-    seedCalls(db, dir);
-    closeStateDb(db);
-    const captured = [];
-    const origWrite = process.stdout.write.bind(process.stdout);
-    process.stdout.write = (chunk) => { captured.push(String(chunk)); return true; };
-    const envBackup = process.env.UBP_DB_PATH;
-    process.env.UBP_DB_PATH = path.join(dir, '.ultra', 'state.db');
-    try {
-      const code = statusCmd.dispatch(['--cost', '--json']);
-      assert.equal(code, 0);
-    } finally {
-      process.stdout.write = origWrite;
-      if (envBackup === undefined) delete process.env.UBP_DB_PATH; else process.env.UBP_DB_PATH = envBackup;
-    }
-    const joined = captured.join('');
-    const parsed = JSON.parse(joined);
-    assert.ok(parsed.ok);
-    assert.ok(parsed.data.by_runtime);
-    assert.ok(parsed.data.top_tasks);
-  } finally {
-    try { fs.rmSync(dir, { recursive: true, force: true }); } catch (_) { /* ignore */ }
-  }
-});