docorbit 0.1.0 → 0.1.2

package/apps/cli/src/commands/update.ts

@@ -1,73 +0,0 @@
-import { resolve } from 'node:path';
-import { DocOrbitDb, DocOrbitRepository } from '../../../../packages/storage/src/index.ts';
-import {
-  detectWorkspaceDependencies,
-  readDocsLock,
-  updateDocsLock,
-  writeDocsLock,
-} from '../../../../packages/workspace/src/index.ts';
-import { runInitCommand } from './init.ts';
-
-export interface UpdateCommandOptions {
-  json?: boolean;
-  dbPath?: string;
-  projectDir?: string;
-}
-
-export async function runUpdateCommand(
-  targetPackage?: string,
-  options: UpdateCommandOptions = {}
-): Promise<void> {
-  const projectDir = resolve(options.projectDir || '.');
-  const existingLock = readDocsLock(projectDir);
-
-  if (!existingLock) {
-    console.log(`No docs.lock found at ${projectDir}. Initializing first...`);
-    await runInitCommand(projectDir, { json: options.json, dbPath: options.dbPath });
-    return;
-  }
-
-  const dbPath = options.dbPath || '.docorbit/docorbit.db';
-  const db = new DocOrbitDb(dbPath);
-  const repository = new DocOrbitRepository(db);
-
-  try {
-    const scanResult = detectWorkspaceDependencies(projectDir);
-    const updated = updateDocsLock(scanResult, repository, existingLock, targetPackage);
-
-    writeDocsLock(projectDir, updated);
-
-    if (options.json) {
-      console.log(JSON.stringify(updated, null, 2));
-      return;
-    }
-
-    console.log(`\n=== DocOrbit docs.lock Updated ===`);
-    if (targetPackage) {
-      console.log(`Target Package: ${targetPackage}`);
-    } else {
-      console.log(`Updated all resolved dependencies.`);
-    }
-
-    const lockedCount = Object.keys(updated.dependencies).length;
-    console.log(`Total Locked Docs: ${lockedCount}\n`);
-
-    console.log('-----------------------------------------------------------------------------');
-    console.log('| Package               | Project Ver | Doc Ver  | Match       | Confidence |');
-    console.log('-----------------------------------------------------------------------------');
-    for (const [key, dep] of Object.entries(updated.dependencies)) {
-      const pkgPad = key.padEnd(21).slice(0, 21);
-      const projPad = dep.resolvedDependencyVersion.padEnd(11).slice(0, 11);
-      const docPad = dep.docVersion.padEnd(8).slice(0, 8);
-      const matchPad = dep.matchType.padEnd(11).slice(0, 11);
-      const confPad = (dep.confidence * 100).toFixed(0) + '%';
-      console.log(`| ${pkgPad} | ${projPad} | ${docPad} | ${matchPad} | ${confPad.padEnd(10)} |`);
-    }
-    console.log('-----------------------------------------------------------------------------\n');
-  } catch (err: unknown) {
-    console.error(`DocOrbit Update Error: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
-  } finally {
-    db.close();
-  }
-}

package/apps/cli/src/commands/verify.ts

@@ -1,48 +0,0 @@
-import * as fs from 'node:fs';
-import { DocOrbitDb, DocOrbitRepository } from '../../../../packages/storage/src/index.ts';
-import { VerificationService } from '../../../../packages/verification/src/index.ts';
-import type { VerifyCommandOptions } from '../../../../packages/shared/src/index.ts';
-import { formatVerificationReport } from '../formatters/terminal.ts';
-
-export async function runVerifyCommand(codeOrFile: string = '', options: VerifyCommandOptions = {}): Promise<void> {
-  if (!codeOrFile) {
-    console.error('Error: "verify" command requires code snippet or file path as an argument.');
-    process.exit(1);
-  }
-
-  let code = codeOrFile;
-  let filePath: string | undefined;
-
-  // Check if argument is a file path
-  if (fs.existsSync(codeOrFile) && fs.statSync(codeOrFile).isFile()) {
-    filePath = codeOrFile;
-    code = fs.readFileSync(codeOrFile, 'utf8');
-  }
-
-  const dbPath = options.dbPath || '.docorbit/docorbit.db';
-  const db = new DocOrbitDb(dbPath);
-  const repo = new DocOrbitRepository(db);
-
-  try {
-    const service = new VerificationService(repo);
-    const { result } = service.verifyCode({
-      code,
-      filePath,
-      language: options.language,
-      library: options.library,
-      version: options.docVersion,
-      projectDir: options.projectDir || process.cwd(),
-    });
-
-    if (options.json) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      console.log(formatVerificationReport(result));
-    }
-  } catch (err: unknown) {
-    console.error(`DocOrbit Verify Error: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
-  } finally {
-    db.close();
-  }
-}

package/apps/cli/src/formatters/colors.ts

@@ -1,23 +0,0 @@
-// ANSI colors
-export const RESET = '\x1b[0m';
-export const BOLD = '\x1b[1m';
-export const DIM = '\x1b[2m';
-export const GREEN = '\x1b[32m';
-export const BLUE = '\x1b[34m';
-export const CYAN = '\x1b[36m';
-export const YELLOW = '\x1b[33m';
-export const RED = '\x1b[31m';
-export const MAGENTA = '\x1b[35m';
-
-export const c = {
-  bold: (s: string) => `${BOLD}${s}${RESET}`,
-  dim: (s: string) => `${DIM}${s}${RESET}`,
-  green: (s: string) => `${GREEN}${s}${RESET}`,
-  blue: (s: string) => `${BLUE}${s}${RESET}`,
-  cyan: (s: string) => `${CYAN}${s}${RESET}`,
-  yellow: (s: string) => `${YELLOW}${s}${RESET}`,
-  red: (s: string) => `${RED}${s}${RESET}`,
-  magenta: (s: string) => `${MAGENTA}${s}${RESET}`,
-  gray: (s: string) => `${DIM}${s}${RESET}`,
-  underline: (s: string) => `\x1b[4m${s}${RESET}`,
-};

package/apps/cli/src/formatters/inspection.ts

@@ -1,102 +0,0 @@
-import type { InspectionReport, IngestionResult } from '../../../../packages/core/src/index.ts';
-import { RESET, BOLD, DIM, GREEN, BLUE, CYAN, YELLOW, RED, MAGENTA } from './colors.ts';
-
-export function formatInspectionReport(report: InspectionReport): string {
-  const lines: string[] = [];
-
-  lines.push('');
-  lines.push(`${BOLD}${CYAN}DocOrbit${RESET} ${DIM}— Documentation Intelligence Report${RESET}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push(`${BOLD}Target URL:${RESET} ${BLUE}${report.targetUrl}${RESET}`);
-  lines.push('');
-
-  // Sources Table
-  lines.push(`${BOLD}Discovered Sources (${report.summary.totalFound}):${RESET}`);
-  lines.push(`${DIM}${'─'.repeat(64)}${RESET}`);
-
-  if (report.sourcesDiscovered.length === 0) {
-    lines.push(`  ${YELLOW}No machine-readable sources discovered.${RESET}`);
-  } else {
-    for (const src of report.sourcesDiscovered) {
-      const icon = src.status === 'valid' ? `${GREEN}✓${RESET}` : `${RED}✗${RESET}`;
-      const typeStr = `[${src.type}]`.padEnd(16);
-      const mr = src.machineReadable ? `${GREEN}machine-readable${RESET}` : `${DIM}human-html${RESET}`;
-      const auth = `${src.authority}`;
-      lines.push(`  ${icon} ${BOLD}${typeStr}${RESET} ${mr.padEnd(26)} ${DIM}(${auth}, conf: ${Math.round(src.confidence * 100)}%)${RESET}`);
-      lines.push(`    ${DIM}↳ ${src.url}${RESET}`);
-    }
-  }
-
-  lines.push('');
-  lines.push(`${BOLD}Purpose-Based Source Recommendations:${RESET}`);
-  lines.push(`${DIM}${'─'.repeat(64)}${RESET}`);
-
-  const purposes = [
-    { key: 'navigation', label: 'Navigation    ' },
-    { key: 'conceptual', label: 'Conceptual    ' },
-    { key: 'api',        label: 'API Reference ' },
-    { key: 'examples',   label: 'Code Examples ' },
-    { key: 'implementation', label: 'Implementation' },
-  ] as const;
-
-  for (const p of purposes) {
-    const rec = report.recommendations[p.key];
-    if (rec && rec.recommended) {
-      lines.push(`  ${CYAN}${p.label}${RESET} → ${GREEN}${rec.recommended.type}${RESET} ${DIM}(${rec.recommended.url})${RESET}`);
-    } else {
-      lines.push(`  ${CYAN}${p.label}${RESET} → ${DIM}No dedicated source${RESET}`);
-    }
-  }
-
-  lines.push('');
-  lines.push(`${BOLD}Summary:${RESET}`);
-  lines.push(`  Machine-readable sources: ${GREEN}${report.summary.machineReadableCount}${RESET}`);
-  lines.push(`  Official sources:         ${GREEN}${report.summary.officialCount}${RESET}`);
-  lines.push(`  OpenAPI detected:         ${report.summary.hasOpenApi ? `${GREEN}Yes${RESET}` : `${DIM}No${RESET}`}`);
-  lines.push(`  llms.txt detected:        ${report.summary.hasLlmsTxt ? `${GREEN}Yes${RESET}` : `${DIM}No${RESET}`}`);
-  lines.push(`  skill.md detected:        ${report.summary.hasSkill ? `${GREEN}Yes${RESET}` : `${DIM}No${RESET}`}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-export function formatIngestionResult(result: IngestionResult): string {
-  const lines: string[] = [];
-
-  lines.push('');
-  lines.push(`${BOLD}${GREEN}DocOrbit${RESET} ${DIM}— Documentation Ingested Successfully${RESET}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push(`${BOLD}Target URL:${RESET}  ${BLUE}${result.targetUrl}${RESET}`);
-  lines.push(`${BOLD}Snapshot ID:${RESET} ${MAGENTA}${result.snapshotId}${RESET}`);
-  lines.push(`${BOLD}Duration:${RESET}    ${result.durationMs}ms`);
-  lines.push('');
-
-  lines.push(`${BOLD}Ingested Pages (${result.pages.length}):${RESET}`);
-  lines.push(`${DIM}${'─'.repeat(64)}${RESET}`);
-
-  for (let i = 0; i < result.pages.length; i++) {
-    const p = result.pages[i];
-    const warnBadge = p.securityAnnotations.length > 0
-      ? ` ${YELLOW}[${p.securityAnnotations.length} alert(s)]${RESET}`
-      : '';
-    lines.push(`  ${BOLD}${i + 1}.${RESET} ${CYAN}${p.title}${RESET}${warnBadge}`);
-    lines.push(`     ${DIM}URL:    ${p.url}${RESET}`);
-    lines.push(`     ${DIM}Tokens: ~${p.estimatedTokens} | Code blocks: ${p.codeExamples.length} | Hash: ${p.contentHash.slice(0, 8)}${RESET}`);
-  }
-
-  lines.push('');
-  lines.push(`${BOLD}Ingestion Summary:${RESET}`);
-  lines.push(`  Total Pages:            ${BOLD}${result.stats.totalPages}${RESET}`);
-  lines.push(`  Total Raw Bytes:        ${(result.stats.totalBytes / 1024).toFixed(1)} KB`);
-  lines.push(`  Estimated Tokens:       ~${result.stats.totalEstimatedTokens}`);
-  lines.push(`  Total Code Examples:    ${result.stats.totalCodeExamples}`);
-  lines.push(`  Machine-readable types: ${result.stats.machineReadableSources}`);
-  if (result.stats.totalChunks !== undefined) {
-    lines.push(`  Total Chunks:           ${BOLD}${result.stats.totalChunks}${RESET}`);
-  }
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push('');
-
-  return lines.join('\n');
-}

package/apps/cli/src/formatters/knowledge.ts

@@ -1,272 +0,0 @@
-import type {
-  ApiEndpoint,
-  IndexedExample,
-  Pitfall,
-  Recipe,
-} from '../../../../packages/shared/src/index.ts';
-import { RESET, BOLD, DIM, GREEN, BLUE, CYAN, YELLOW, RED, MAGENTA } from './colors.ts';
-
-export function formatApiEndpoints(
-  endpoints: ApiEndpoint[],
-  query?: string
-): string {
-  const lines: string[] = [];
-
-  lines.push('');
-  lines.push(`${BOLD}${CYAN}DocOrbit${RESET} ${DIM}— API Intelligence for: "${query || '*'}"${RESET}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-
-  if (endpoints.length === 0) {
-    lines.push(`  ${YELLOW}No matching API endpoints found.${RESET}`);
-    lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  for (let i = 0; i < endpoints.length; i++) {
-    const ep = endpoints[i];
-    let methodColor = GREEN;
-    if (ep.method === 'post') methodColor = BLUE;
-    else if (ep.method === 'put') methodColor = YELLOW;
-    else if (ep.method === 'delete') methodColor = RED;
-    else if (ep.method === 'patch') methodColor = MAGENTA;
-
-    const methodBadge = `${methodColor}${BOLD}[${ep.method.toUpperCase()}]${RESET}`;
-    const depBadge = ep.deprecated ? ` ${RED}${BOLD}[DEPRECATED]${RESET}` : '';
-    const verBadge = ep.docVersion ? ` ${DIM}(${ep.docVersion})${RESET}` : '';
-
-    lines.push(`  ${BOLD}${i + 1}.${RESET} ${methodBadge} ${BOLD}${CYAN}${ep.path}${RESET}${depBadge}${verBadge}`);
-    if (ep.summary) {
-      lines.push(`     ${BOLD}${ep.summary}${RESET}`);
-    }
-    if (ep.description && ep.description !== ep.summary) {
-      lines.push(`     ${DIM}${ep.description.slice(0, 120)}${ep.description.length > 120 ? '...' : ''}${RESET}`);
-    }
-
-    if (ep.parameters.length > 0) {
-      const paramStr = ep.parameters.map(p => {
-        const req = p.required ? `${RED}*${RESET}` : '';
-        return `${p.name}${req} (${p.in}:${p.type || 'any'})`;
-      }).join(', ');
-      lines.push(`     ${DIM}Params: ${paramStr}${RESET}`);
-    }
-
-    if (ep.auth.length > 0) {
-      const authStr = ep.auth.map(a => `${a.type}${a.scheme ? `:${a.scheme}` : ''}`).join(', ');
-      lines.push(`     ${DIM}Auth: ${authStr}${RESET}`);
-    }
-
-    if (ep.pagination) {
-      lines.push(`     ${DIM}Pagination: ${ep.pagination.type} (${ep.pagination.parameters.join(', ')})${RESET}`);
-    }
-
-    if (ep.errors.length > 0) {
-      const errorCodes = ep.errors.map(e => e.statusCode).join(', ');
-      lines.push(`     ${DIM}Error Codes: ${errorCodes}${RESET}`);
-    }
-
-    if (ep.provenance?.sourceUrl) {
-      lines.push(`     ${DIM}Source: ${ep.provenance.sourceUrl}${RESET}`);
-    }
-    lines.push('');
-  }
-
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push('');
-  return lines.join('\n');
-}
-
-export function formatIndexedExamples(
-  examples: IndexedExample[],
-  task?: string
-): string {
-  const lines: string[] = [];
-
-  lines.push('');
-  lines.push(`${BOLD}${CYAN}DocOrbit${RESET} ${DIM}— Code Example Intelligence for: "${task || '*'}"${RESET}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-
-  if (examples.length === 0) {
-    lines.push(`  ${YELLOW}No matching code examples found.${RESET}`);
-    lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  for (let i = 0; i < examples.length; i++) {
-    const ex = examples[i];
-    const fwBadge = ex.framework ? ` ${MAGENTA}[${ex.framework}]${RESET}` : '';
-    const langBadge = `${GREEN}[${ex.language}]${RESET}`;
-    const verBadge = ex.docVersion ? ` ${DIM}(${ex.docVersion})${RESET}` : '';
-    const authBadge = ex.sourceAuthority === 'official' ? `${BLUE}[official]${RESET}` : `${DIM}[community]${RESET}`;
-
-    lines.push(`  ${BOLD}${i + 1}.${RESET} ${CYAN}${ex.task}${RESET} ${langBadge}${fwBadge} ${authBadge}${verBadge}`);
-    if (ex.relatedApi) {
-      lines.push(`     ${BOLD}Target API:${RESET} ${BLUE}${ex.relatedApi}${RESET}`);
-    }
-    if (ex.relatedSymbol) {
-      lines.push(`     ${BOLD}Symbol:${RESET} ${MAGENTA}${ex.relatedSymbol}${RESET}`);
-    }
-
-    lines.push(`     ${DIM}┌── code snippet ──────────────────────────${RESET}`);
-    const codeLines = ex.code.split('\n').slice(0, 15);
-    for (const cl of codeLines) {
-      lines.push(`     ${DIM}│${RESET} ${cl}`);
-    }
-    if (ex.code.split('\n').length > 15) {
-      lines.push(`     ${DIM}│ ... (${ex.code.split('\n').length - 15} more lines)${RESET}`);
-    }
-    lines.push(`     ${DIM}└──────────────────────────────────────────${RESET}`);
-    lines.push(`     ${DIM}Source: ${ex.sourceUrl}${RESET}`);
-    lines.push('');
-  }
-
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push('');
-  return lines.join('\n');
-}
-
-export function formatPitfalls(
-  pitfalls: Pitfall[],
-  task?: string
-): string {
-  const lines: string[] = [];
-
-  lines.push('');
-  lines.push(`${BOLD}${YELLOW}DocOrbit${RESET} ${DIM}— Pitfalls & Warnings for: "${task || '*'}"${RESET}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-
-  if (pitfalls.length === 0) {
-    lines.push(`  ${GREEN}No matching pitfalls or warnings found.${RESET}`);
-    lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  for (let i = 0; i < pitfalls.length; i++) {
-    const pf = pitfalls[i];
-    let badgeColor = YELLOW;
-    if (pf.kind === 'breaking_change' || pf.kind === 'removed' || pf.kind === 'security') {
-      badgeColor = RED;
-    } else if (pf.kind === 'deprecated') {
-      badgeColor = MAGENTA;
-    }
-
-    const kindBadge = `${badgeColor}${BOLD}[${pf.kind.toUpperCase().replace(/_/g, ' ')}]${RESET}`;
-    const verBadge = pf.docVersion ? ` ${DIM}(${pf.docVersion})${RESET}` : '';
-
-    lines.push(`  ${BOLD}${i + 1}.${RESET} ${kindBadge} ${BOLD}${pf.title}${RESET}${verBadge}`);
-    if (pf.relatedApi) {
-      lines.push(`     ${DIM}Related API: ${BLUE}${pf.relatedApi}${RESET}`);
-    }
-    lines.push(`     ${DIM}│${RESET} ${pf.content}`);
-    if (pf.provenance?.sourceUrl) {
-      lines.push(`     ${DIM}Source: ${pf.provenance.sourceUrl}${RESET}`);
-    }
-    lines.push('');
-  }
-
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push('');
-  return lines.join('\n');
-}
-
-export function formatRecipe(recipe: Recipe): string {
-  const lines: string[] = [];
-
-  const confidencePct = Math.round(recipe.confidence * 100);
-  const confColor = confidencePct >= 70 ? GREEN : (confidencePct >= 40 ? YELLOW : RED);
-
-  lines.push('');
-  lines.push(`${BOLD}${GREEN}DocOrbit${RESET} ${DIM}— Implementation Recipe${RESET}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push(`${BOLD}Goal:${RESET}       ${CYAN}${recipe.goal}${RESET}`);
-  lines.push(`${BOLD}Confidence:${RESET} ${confColor}${confidencePct}%${RESET}`);
-  if (recipe.docVersion) {
-    lines.push(`${BOLD}Version:${RESET}    ${MAGENTA}${recipe.docVersion}${RESET}`);
-  }
-  lines.push('');
-
-  // Prerequisites
-  lines.push(`${BOLD}Prerequisites (${recipe.prerequisites.length}):${RESET}`);
-  lines.push(`${DIM}${'─'.repeat(64)}${RESET}`);
-  if (recipe.prerequisites.length === 0) {
-    lines.push(`  ${DIM}No special prerequisites documented.${RESET}`);
-  } else {
-    for (const pre of recipe.prerequisites) {
-      const badge = pre.evidenceLevel === 'documented_fact'
-        ? `${GREEN}[FACT]${RESET}`
-        : `${YELLOW}[INFERRED]${RESET}`;
-      lines.push(`  • ${badge} ${pre.text}`);
-    }
-  }
-  lines.push('');
-
-  // Ordered Implementation Steps
-  lines.push(`${BOLD}Implementation Steps (${recipe.orderedSteps.length}):${RESET}`);
-  lines.push(`${DIM}${'─'.repeat(64)}${RESET}`);
-  for (const s of recipe.orderedSteps) {
-    let badge = `${GREEN}[FACT]${RESET}`;
-    if (s.evidenceLevel === 'inferred_relationship') badge = `${YELLOW}[INFERRED]${RESET}`;
-    else if (s.evidenceLevel === 'missing_information') badge = `${RED}[MISSING]${RESET}`;
-
-    lines.push(`  ${BOLD}${s.step}.${RESET} ${badge} ${BOLD}${CYAN}${s.title}${RESET}`);
-    if (s.apiEndpoint) {
-      lines.push(`     ${BOLD}API Endpoint:${RESET} ${BLUE}${s.apiEndpoint}${RESET}`);
-    }
-    lines.push(`     ${s.description}`);
-
-    if (s.exampleCode) {
-      lines.push(`     ${DIM}┌── example ────────────────────────────────${RESET}`);
-      const codeLines = s.exampleCode.split('\n').slice(0, 10);
-      for (const cl of codeLines) {
-        lines.push(`     ${DIM}│${RESET} ${cl}`);
-      }
-      if (s.exampleCode.split('\n').length > 10) {
-        lines.push(`     ${DIM}│ ... (${s.exampleCode.split('\n').length - 10} more lines)${RESET}`);
-      }
-      lines.push(`     ${DIM}└──────────────────────────────────────────${RESET}`);
-    }
-
-    if (s.pitfalls && s.pitfalls.length > 0) {
-      for (const pf of s.pitfalls) {
-        lines.push(`     ${YELLOW}⚠ ${pf}${RESET}`);
-      }
-    }
-    if (s.sourceUrl) {
-      lines.push(`     ${DIM}Source: ${s.sourceUrl}${RESET}`);
-    }
-    lines.push('');
-  }
-
-  // Evidence-Based Validation Steps
-  lines.push(`${BOLD}Validation Steps (${recipe.validationSteps.length}):${RESET}`);
-  lines.push(`${DIM}${'─'.repeat(64)}${RESET}`);
-  for (const vs of recipe.validationSteps) {
-    let badge = `${GREEN}[FACT]${RESET}`;
-    if (vs.evidenceLevel === 'inferred_relationship') badge = `${YELLOW}[INFERRED]${RESET}`;
-    else if (vs.evidenceLevel === 'missing_information') badge = `${RED}[MISSING]${RESET}`;
-
-    lines.push(`  ${BOLD}${vs.step}.${RESET} ${badge} ${vs.description}`);
-    if (vs.expectedResponse) {
-      lines.push(`     ${DIM}Expected Response:${RESET} ${vs.expectedResponse.slice(0, 100)}`);
-    }
-    if (vs.testPattern) {
-      lines.push(`     ${DIM}Test Pattern:${RESET} ${vs.testPattern.slice(0, 100)}`);
-    }
-  }
-  lines.push('');
-
-  // Sources consulted
-  if (recipe.sources.length > 0) {
-    lines.push(`${BOLD}Sources Consulted:${RESET}`);
-    for (const src of recipe.sources) {
-      lines.push(`  ${DIM}• ${src}${RESET}`);
-    }
-    lines.push('');
-  }
-
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push('');
-  return lines.join('\n');
-}

package/apps/cli/src/formatters/retrieval.ts

@@ -1,74 +0,0 @@
-import type { SearchResult, ContextPackage } from '../../../../packages/shared/src/index.ts';
-import { RESET, BOLD, DIM, GREEN, CYAN, YELLOW, MAGENTA } from './colors.ts';
-
-export function formatSearchResults(query: string, results: SearchResult[]): string {
-  const lines: string[] = [];
-
-  lines.push('');
-  lines.push(`${BOLD}${CYAN}DocOrbit${RESET} ${DIM}— Search Results for: "${query}"${RESET}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-
-  if (results.length === 0) {
-    lines.push(`  ${YELLOW}No matching documentation chunks found.${RESET}`);
-    lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  for (let i = 0; i < results.length; i++) {
-    const res = results[i];
-    const chunk = res.chunk;
-    const breadcrumb = chunk.sectionPath.length > 0 ? chunk.sectionPath.join(' > ') : (chunk.title || 'General');
-
-    lines.push(`  ${BOLD}${i + 1}.${RESET} ${CYAN}${breadcrumb}${RESET} ${GREEN}(Score: ${res.score})${RESET}`);
-    lines.push(`     ${DIM}Type: ${chunk.chunkType} | Est. Tokens: ~${chunk.tokenEstimate} | Chunk: ${chunk.id}${RESET}`);
-    if (res.matchReasons.length > 0) {
-      lines.push(`     ${DIM}Matches: ${res.matchReasons.join(' • ')}${RESET}`);
-    }
-    if (res.symbols.length > 0) {
-      lines.push(`     ${MAGENTA}Symbols: ${res.symbols.map(s => s.name).join(', ')}${RESET}`);
-    }
-
-    const preview = chunk.content.split('\n').filter(l => l.trim().length > 0).slice(0, 3).join('\n     ');
-    lines.push(`     ${DIM}│${RESET} ${preview}`);
-    lines.push('');
-  }
-
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push('');
-  return lines.join('\n');
-}
-
-export function formatContextPackage(pkg: ContextPackage): string {
-  const lines: string[] = [];
-
-  lines.push('');
-  lines.push(`${BOLD}${GREEN}DocOrbit${RESET} ${DIM}— Assembled Context Package${RESET}`);
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push(`${BOLD}Task:${RESET}             ${CYAN}${pkg.task}${RESET}`);
-  lines.push(`${BOLD}Detected Intent:${RESET}  ${MAGENTA}${pkg.detectedIntent}${RESET}`);
-  lines.push(`${BOLD}Estimated Tokens:${RESET} ~${pkg.totalEstimatedTokens} / ${pkg.tokenBudget} (heuristic)`);
-  lines.push(`${BOLD}Chunks Included:${RESET}  ${pkg.chunks.length}`);
-  lines.push(`${BOLD}Sources Cited:${RESET}    ${pkg.sources.length > 0 ? pkg.sources.join(', ') : 'Local documentation'}`);
-
-  if (pkg.warnings.length > 0) {
-    lines.push('');
-    lines.push(`${YELLOW}${BOLD}Advisories & Warnings (${pkg.warnings.length}):${RESET}`);
-    for (const w of pkg.warnings) {
-      lines.push(`  ${YELLOW}⚠ ${w}${RESET}`);
-    }
-  }
-
-  lines.push('');
-  lines.push(`${BOLD}Package Markdown Preview:${RESET}`);
-  lines.push(`${DIM}${'─'.repeat(64)}${RESET}`);
-  const previewLines = pkg.markdown.split('\n').slice(0, 20);
-  lines.push(previewLines.join('\n'));
-  if (pkg.markdown.split('\n').length > 20) {
-    lines.push(`\n${DIM}... (${pkg.markdown.split('\n').length - 20} more lines in full package)${RESET}`);
-  }
-  lines.push(`${DIM}${'═'.repeat(64)}${RESET}`);
-  lines.push('');
-
-  return lines.join('\n');
-}