Skip to content

DataArt/artisyn-implementation-harness / skills/implementation-harness

implementation-harness

Flagged

Install the portable AI-dev harness, rebuild its operational graph standalone, harvest project skill improvements into its canonical templates, package direct canonical edits into a portable bundle, or apply canonical updates to an existing project. Use /implementation-harness launch, /implementation-harness reindex-graph, or /implementation-harness patch harvest|prepare|apply.

FileKindSize
CHANGELOG.mdmarkdown37.5 KB
README.mdmarkdown13.7 KB
SKILL.mdskill md9.6 KB
bin/artisyn-implementation-harness.mjsexecutablescript11.8 KB
bin/lib/placer.mjsscript2.6 KB
bin/lib/providers.mjsscript1.8 KB
bin/lib/reporter.mjsscript3.0 KB
bin/lib/zip.mjsscript4.0 KB
canonical/adaptors/claude/browser.mdmarkdown2.5 KB
canonical/adaptors/claude/context.mdmarkdown517 B
canonical/adaptors/claude/credentials.mdmarkdown512 B
canonical/adaptors/claude/delegation.mdmarkdown910 B
canonical/adaptors/claude/interaction.mdmarkdown359 B
canonical/adaptors/claude/planning.mdmarkdown745 B
canonical/adaptors/claude/review.mdmarkdown1.0 KB
canonical/adaptors/claude/task-tracking.mdmarkdown897 B
canonical/adaptors/codex/browser.mdmarkdown1.0 KB
canonical/adaptors/codex/context.mdmarkdown517 B
canonical/adaptors/codex/credentials.mdmarkdown480 B
canonical/adaptors/codex/delegation.mdmarkdown910 B
canonical/adaptors/codex/interaction.mdmarkdown359 B
canonical/adaptors/codex/planning.mdmarkdown904 B
canonical/adaptors/codex/review.mdmarkdown973 B
canonical/adaptors/codex/task-tracking.mdmarkdown1.1 KB
canonical/adaptors/copilot/browser.mdmarkdown620 B
canonical/adaptors/copilot/context.mdmarkdown881 B
canonical/adaptors/copilot/credentials.mdmarkdown992 B
canonical/adaptors/copilot/delegation.mdmarkdown1.2 KB
canonical/adaptors/copilot/interaction.mdmarkdown454 B
canonical/adaptors/copilot/planning.mdmarkdown785 B
canonical/adaptors/copilot/review.mdmarkdown791 B
canonical/adaptors/copilot/task-tracking.mdmarkdown723 B
canonical/agents/architect/INTENT.mdmarkdown2.4 KB
canonical/agents/architect/TEMPLATE.mdmarkdown6.5 KB
canonical/agents/docs-writer/INTENT.mdmarkdown2.2 KB
canonical/agents/docs-writer/TEMPLATE.mdmarkdown2.8 KB
canonical/agents/infra/INTENT.mdmarkdown2.1 KB
canonical/agents/infra/TEMPLATE.mdmarkdown5.1 KB
canonical/agents/layer/INTENT.mdmarkdown6.0 KB
canonical/agents/layer/TEMPLATE.mdmarkdown1.5 KB
canonical/agents/onboarding/INTENT.mdmarkdown5.3 KB
canonical/agents/onboarding/TEMPLATE.mdmarkdown4.2 KB
canonical/agents/product-architect/INTENT.mdmarkdown7.5 KB
canonical/agents/product-architect/TEMPLATE.mdmarkdown3.9 KB
canonical/agents/scrum-master/INTENT.mdmarkdown10.9 KB
canonical/agents/scrum-master/TEMPLATE.mdmarkdown12.3 KB
canonical/docs/.og/cli.mjsscript13.6 KB
canonical/docs/.og/cli.test.mjsscript19.6 KB
canonical/docs/.og/constants.mjsscript2.9 KB
canonical/docs/.og/docs-operational-graph.sqlitebinary24.0 KB
canonical/docs/.og/docs.mjsscript5.5 KB
canonical/docs/.og/edges.mjsscript5.8 KB
canonical/docs/.og/schema.mjsscript741 B
canonical/docs/.og/utils.mjsscript5.2 KB
canonical/docs/Engineering Guide/01 Conventions.mdmarkdown3.0 KB
canonical/docs/Engineering Guide/03 Engineer Role.mdmarkdown2.6 KB
canonical/docs/Engineering Guide/04 AI Coding Tool Compatibility.mdmarkdown3.6 KB
canonical/docs/Engineering Guide/05 MCP Setup.mdmarkdown6.6 KB
canonical/docs/Engineering Guide/Documentation/01 Principles.mdmarkdown15.3 KB
canonical/docs/Engineering Guide/Documentation/02 Structure.mdmarkdown3.8 KB
canonical/docs/Engineering Guide/Documentation/03 HLD Intent.mdmarkdown8.1 KB
canonical/docs/Engineering Guide/Documentation/04 LLD Intent.mdmarkdown9.7 KB
canonical/docs/Engineering Guide/Documentation/05 NFR Intent.mdmarkdown6.0 KB
canonical/docs/Engineering Guide/Documentation/07 Terminology.mdmarkdown1.4 KB
canonical/docs/Engineering Guide/Lifecycles/00 Overview.mdmarkdown5.8 KB
canonical/docs/Engineering Guide/Lifecycles/01 Dev Lifecycle.mdmarkdown19.9 KB
canonical/docs/Engineering Guide/Lifecycles/02 Design Lifecycle.mdmarkdown29.4 KB
canonical/docs/Engineering Guide/Lifecycles/03 Evolve Lifecycle.mdmarkdown7.0 KB
canonical/docs/Engineering Guide/Lifecycles/04 Architecture Lifecycle.mdmarkdown3.6 KB
canonical/docs/Engineering Guide/Lifecycles/05 Documents Flow.mdmarkdown9.5 KB
canonical/manifest.jsonconfig1.6 KB
canonical/mcp.jsonconfig23 B
canonical/root-instructions/INTERFACE.mdmarkdown3.3 KB
canonical/settings.jsonconfig332 B
canonical/skills/design/INTENT.mdmarkdown28.6 KB
canonical/skills/design/TEMPLATE.mdmarkdown19.0 KB
canonical/skills/design/interfaces/architecture.mdmarkdown2.8 KB
canonical/skills/design/interfaces/contract.mdmarkdown7.4 KB
canonical/skills/design/interfaces/design.mdmarkdown2.3 KB
canonical/skills/design/interfaces/efforts.mdmarkdown2.5 KB
canonical/skills/design/interfaces/stack.mdmarkdown1.6 KB
canonical/skills/design/patterns/announce-progress.mdmarkdown997 B
canonical/skills/design/patterns/approval-intelligent.mdmarkdown1.5 KB
canonical/skills/design/patterns/approval-sign-off.mdmarkdown2.4 KB
canonical/skills/design/patterns/context-resolution.mdmarkdown6.6 KB
canonical/skills/design/patterns/design-architect-review.mdmarkdown2.4 KB
canonical/skills/design/patterns/design-oq-triage.mdmarkdown3.8 KB
canonical/skills/design/patterns/design-quality-gate.mdmarkdown1.4 KB
canonical/skills/design/patterns/do-report-commit.mdmarkdown1.2 KB
canonical/skills/design/patterns/docs-writer-authoring.mdmarkdown3.6 KB
canonical/skills/design/patterns/metrics.mdmarkdown11.9 KB
canonical/skills/design/patterns/multi-decision-split.mdmarkdown3.6 KB
canonical/skills/design/patterns/phase-sign-off.mdmarkdown2.4 KB
canonical/skills/design/patterns/satellite-review.mdmarkdown1.5 KB
canonical/skills/design/patterns/session-continuity.mdmarkdown827 B
canonical/skills/design/patterns/task-tracking.mdmarkdown779 B
canonical/skills/design/patterns/waf-review.mdmarkdown4.2 KB
canonical/skills/design/patterns/write-confirm.mdmarkdown963 B
canonical/skills/design/references/00-decision-router.mdmarkdown3.8 KB
canonical/skills/design/references/00-router.mdmarkdown4.6 KB
canonical/skills/design/references/01-context-gathering.mdmarkdown8.1 KB
canonical/skills/design/references/02-ceremony.mdmarkdown4.6 KB
canonical/skills/design/references/03-frame.mdmarkdown6.7 KB
canonical/skills/design/references/04-research.mdmarkdown8.1 KB
canonical/skills/design/references/05-evaluate.mdmarkdown9.0 KB
canonical/skills/design/references/06-solution.mdmarkdown13.7 KB
canonical/skills/design/references/07-review-gate.mdmarkdown4.1 KB
canonical/skills/design/references/08-address-feedback.mdmarkdown8.0 KB
canonical/skills/design/references/09-publish.mdmarkdown8.9 KB
canonical/skills/design/references/10-completion.mdmarkdown7.4 KB
canonical/skills/design/scripts/constants.mjsscript2.0 KB
canonical/skills/design/scripts/design-metrics.mjsscript35.4 KB
canonical/skills/design/scripts/design-metrics.test.mjsscript12.0 KB
canonical/skills/design/scripts/utils.mjsscript3.1 KB
canonical/skills/design/templates/evaluate.mdmarkdown1.4 KB
canonical/skills/design/templates/frame.mdmarkdown2.6 KB
canonical/skills/design/templates/report.mdmarkdown4.8 KB
canonical/skills/design/templates/research.mdmarkdown2.4 KB
canonical/skills/design/templates/stat.jsonconfig1.7 KB
canonical/skills/design/templates/stat.schema.jsonconfig17.1 KB
canonical/skills/dev/INTENT.mdmarkdown15.9 KB
canonical/skills/dev/TEMPLATE.mdmarkdown9.0 KB
canonical/skills/dev/interfaces/intent.mdmarkdown2.6 KB
canonical/skills/dev/patterns/announce-progress.mdmarkdown1.1 KB
canonical/skills/dev/patterns/approval-intelligent.mdmarkdown1.5 KB
canonical/skills/dev/patterns/approval-sign-off.mdmarkdown1.9 KB
canonical/skills/dev/patterns/do-report-commit.mdmarkdown888 B
canonical/skills/dev/patterns/metrics.mdmarkdown17.7 KB
canonical/skills/dev/patterns/phase-sign-off.mdmarkdown2.2 KB
canonical/skills/dev/patterns/review-gate.mdmarkdown3.6 KB
canonical/skills/dev/patterns/satellite-review.mdmarkdown3.1 KB
canonical/skills/dev/patterns/session-continuity.mdmarkdown797 B
canonical/skills/dev/patterns/task-tracking.mdmarkdown766 B
canonical/skills/dev/patterns/write-confirm.mdmarkdown615 B
canonical/skills/dev/references/00-router.mdmarkdown2.2 KB
canonical/skills/dev/references/01-context-gathering.mdmarkdown10.3 KB
canonical/skills/dev/references/02-ceremony.mdmarkdown4.5 KB
canonical/skills/dev/references/03-plan.mdmarkdown14.2 KB
canonical/skills/dev/references/04-implement.mdmarkdown11.7 KB
canonical/skills/dev/references/05-test.mdmarkdown7.8 KB
canonical/skills/dev/references/06-document.mdmarkdown11.7 KB
canonical/skills/dev/references/07-completion.mdmarkdown6.3 KB
canonical/skills/dev/scripts/constants.mjsscript3.2 KB
canonical/skills/dev/scripts/quality.mjsscript9.1 KB
canonical/skills/dev/scripts/quality.test.mjsscript6.6 KB
canonical/skills/dev/scripts/timing.mjsscript38.1 KB
canonical/skills/dev/scripts/timing.test.mjsscript21.0 KB
canonical/skills/dev/scripts/utils.mjsscript3.1 KB
canonical/skills/dev/templates/plan.mdmarkdown3.3 KB
canonical/skills/dev/templates/report.mdmarkdown6.4 KB
canonical/skills/dev/templates/stat.jsonconfig1.4 KB
canonical/skills/dev/templates/stat.schema.jsonconfig29.3 KB
canonical/skills/evolve/INTENT.mdmarkdown1.6 KB
canonical/skills/evolve/TEMPLATE.mdmarkdown1.3 KB
canonical/skills/evolve/interfaces/improvement.mdmarkdown1.2 KB
canonical/skills/evolve/interfaces/reflection.mdmarkdown353 B
canonical/skills/evolve/interfaces/validation.mdmarkdown653 B
canonical/skills/evolve/patterns/task-tracking.mdmarkdown787 B
canonical/skills/evolve/references/00-router.mdmarkdown1.1 KB
canonical/skills/evolve/references/01-reflect.mdmarkdown805 B
canonical/skills/evolve/references/02-triage.mdmarkdown2.6 KB
canonical/skills/evolve/references/03-draft.mdmarkdown1.2 KB
canonical/skills/evolve/references/04-validate.mdmarkdown1.5 KB
canonical/skills/evolve/references/05-adopt.mdmarkdown1.5 KB
canonical/skills/war/INTENT.mdmarkdown4.5 KB
canonical/skills/war/TEMPLATE.mdmarkdown1.8 KB
canonical/skills/war/patterns/present-and-save.mdmarkdown1.0 KB
canonical/skills/war/patterns/scope-resolution.mdmarkdown830 B
canonical/skills/war/references/01-design.mdmarkdown3.4 KB
canonical/skills/war/references/02-implementation.mdmarkdown3.8 KB
canonical/skills/war/templates/design-report.mdmarkdown869 B
canonical/skills/war/templates/implementation-report.mdmarkdown1.8 KB
canonical/skills/where-we-are/INTENT.mdmarkdown3.3 KB
canonical/skills/where-we-are/TEMPLATE.mdmarkdown6.3 KB
canonical/skills/where-we-are/report-template.mdmarkdown2.0 KB
canonical/skills/x-ray/INTENT.mdmarkdown2.4 KB
canonical/skills/x-ray/TEMPLATE.mdmarkdown10.5 KB
implementation-harness.mdmarkdown1.4 KB
package.jsonmanifest696 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/CHANGELOG.md.patchother1.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/README.md.patchother1.9 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/SKILL.md.patchother2.5 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/agents/docs-writer/INTENT.md.patchother1.4 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/docs/.og/cli.test.mjs.patchother846 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/docs/Engineering Guide/04 AI Coding Tool Compatibility.md.patchother3.4 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/docs/Engineering Guide/05 MCP Setup.md.patchother5.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/manifest.json.patchother662 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/settings.json.patchother150 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/skills/design/INTENT.md.patchother19.4 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/patterns/skill-authoring.md.patchother692 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/host-capabilities.md.patchother1.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/01-launch.md.patchother1.1 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/01a-launch-plan.md.patchother1.6 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/01b-launch-install.md.patchother7.3 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/02-launch-questions.md.patchother5.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/08-provider-launch.md.patchother3.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/patch/04-patch-harvest.md.patchother2.6 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/patch/05-patch-apply.md.patchother3.0 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/patch/06-patch-state.md.patchother7.1 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/scripts/lib/agent-format.mjs.patchother2.2 KB

canonical/skills/dev/scripts/quality.mjs

View on GitHub
// Report-derived quality inventory. Markdown is the source; summaries are snapshots.
import { createHash } from 'node:crypto';
import {
  FINDING_KINDS,
  FINDING_SEVERITIES,
  FINDING_RESOLUTIONS,
  FINDING_ORIGINS,
  FINDING_CLASSIFICATIONS,
  FINDING_DEVIATION_TYPES,
} from './constants.mjs';

/** @throws {Error} When `ok` is falsy, prefixed so failures are traceable to this module. */
const required = (ok, message) => {
  if (!ok) throw new Error(`Quality: ${message}`);
};
/** Whether a cell holds a real value rather than a placeholder ('—', '-', 'unavailable', 'unknown'). */
const known = (value) => value && !['—', '-', 'unavailable', 'unknown'].includes(value);

// Split GFM cells, preserving escaped pipes and backslashes.
function cells(line) {
  const parts = [''];
  for (let i = 0; i < line.length; i++) {
    if (line[i] === '\\' && ['|', '\\'].includes(line[i + 1])) parts[parts.length - 1] += line[++i];
    else if (line[i] === '|') parts.push('');
    else parts[parts.length - 1] += line[i];
  }
  if (!parts[0].trim()) parts.shift();
  if (!parts.at(-1).trim()) parts.pop();
  return parts.map((s) => s.trim());
}

function table(markdown, heading) {
  // Fenced examples and comments are not records.
  const clean = markdown
    .replace(/<!--[\s\S]*?-->/g, '')
    .replace(/^(`{3,}|~{3,})[^\n]*\n[\s\S]*?^\1\s*$/gm, '');
  const sections = [...clean.matchAll(/^## ([^\n]+)\s*\n([\s\S]*?)(?=^## |$(?![\s\S]))/gm)].filter(
    (m) => m[1].trim() === heading
  );
  required(sections.length <= 1, `duplicate ${heading} section`);
  if (!sections.length) return null;
  const lines = sections[0][2].split('\n');
  const start = lines.findIndex(
    (line, i) => line.trim().startsWith('|') && /^\s*\|[\s:|-]+\|\s*$/.test(lines[i + 1] ?? '')
  );
  if (start < 0) return null;
  required(
    !lines
      .slice(start + 2)
      .some(
        (line, i, rest) =>
          line.trim().startsWith('|') && /^\s*\|[\s:|-]+\|\s*$/.test(rest[i + 1] ?? '')
      ),
    `multiple tables in ${heading}`
  );
  const headers = cells(lines[start]);
  required(new Set(headers).size === headers.length, `duplicate ${heading} columns`);
  const rows = [];
  for (let i = start + 2; i < lines.length && lines[i].trim().startsWith('|'); i++) {
    const values = cells(lines[i]);
    required(
      values.length === headers.length,
      `${heading} row ${i + 1} has wrong cell count (escape literal pipes)`
    );
    rows.push(Object.fromEntries(headers.map((h, j) => [h, values[j]])));
  }
  return { headers, rows };
}
function columns(t, expected, heading) {
  required(
    expected.every((h) => t.headers.includes(h)),
    `${heading} requires columns: ${expected.join(', ')}`
  );
}
function unique(rows, key, pattern) {
  const seen = new Set();
  for (const row of rows) {
    required(
      pattern.test(row[key]) && !seen.has(row[key]),
      `invalid or duplicate ${key}: ${row[key]}`
    );
    seen.add(row[key]);
  }
}
const countBy = (rows, key, values) =>
  Object.fromEntries(values.map((v) => [v, rows.filter((r) => r[key] === v).length]));

export function deriveQuality(markdown, checks = [], asOf = new Date().toISOString()) {
  const ft = table(markdown, 'Review Findings');
  const dt = table(markdown, 'Tech Debt');
  const tt = table(markdown, 'Test Results');
  const issues = [];
  let findings = null,
    debt = null,
    tests = null;
  if (ft) {
    columns(
      ft,
      [
        'ID',
        'Stage',
        'Origin',
        'Kind',
        'Deviation type',
        'Severity',
        'Classification',
        'Finding',
        'Evidence',
        'Resolution',
        'TD',
        'Decision',
      ],
      'Review Findings'
    );
    unique(ft.rows, 'ID', /^RF-\d+$/);
    for (const row of ft.rows) {
      for (const [key, values] of Object.entries({
        Stage: ['plan', 'implement', 'test', 'document'],
        Kind: FINDING_KINDS,
        Severity: FINDING_SEVERITIES,
        Classification: FINDING_CLASSIFICATIONS,
        Resolution: FINDING_RESOLUTIONS,
      }))
        required(values.includes(row[key]), `${row.ID}: invalid ${key}: ${row[key]}`);
      const origins = row.Origin.split(';').map((s) => s.trim());
      required(
        origins.length &&
          new Set(origins).size === origins.length &&
          origins.every((v) => FINDING_ORIGINS.includes(v)),
        `${row.ID}: invalid Origin`
      );
      required(
        row.Kind === 'deviation'
          ? FINDING_DEVIATION_TYPES.includes(row['Deviation type'])
          : row['Deviation type'] === '—',
        `${row.ID}: invalid Deviation type`
      );
      required(
        known(row.Finding) && known(row.Evidence),
        `${row.ID}: finding and evidence required`
      );
      if (row.Resolution === 'open') issues.push(`${row.ID}: open`);
      else if (!known(row.Decision)) issues.push(`${row.ID}: missing resolution evidence/decision`);
      if (row.Resolution === 'tech-debt') {
        const linked = dt?.rows.find((d) => d['#'] === row.TD);
        if (!linked || !known(linked.Owner) || !known(linked['Next action']))
          issues.push(`${row.ID}: debt needs linked TD row, owner and next action`);
      } else if (known(row.TD)) {
        required(
          dt?.rows.some((d) => d['#'] === row.TD),
          `${row.ID}: unknown TD link`
        );
      }
    }
    const pr = ft.rows.filter((r) =>
      r.Origin.split(';')
        .map((s) => s.trim())
        .includes('pr-review')
    );
    findings = {
      total: ft.rows.length,
      by_kind: countBy(ft.rows, 'Kind', FINDING_KINDS),
      by_severity: countBy(ft.rows, 'Severity', FINDING_SEVERITIES),
      by_classification: countBy(ft.rows, 'Classification', FINDING_CLASSIFICATIONS),
      by_resolution: countBy(ft.rows, 'Resolution', FINDING_RESOLUTIONS),
      deviations_by_type: countBy(
        ft.rows.filter((r) => r.Kind === 'deviation'),
        'Deviation type',
        FINDING_DEVIATION_TYPES
      ),
      pr_review: {
        total: pr.length,
        by_kind: countBy(pr, 'Kind', FINDING_KINDS),
        by_severity: countBy(pr, 'Severity', FINDING_SEVERITIES),
      },
    };
  } else issues.push('Review Findings ledger unavailable; consolidate legacy sections explicitly');
  if (dt) {
    columns(dt, ['#', 'Description', 'Type', 'Tracker'], 'Tech Debt');
    unique(dt.rows, '#', /^TD-\d+$/);
    for (const row of dt.rows) {
      required(
        known(row.Description) && known(row.Type),
        `${row['#']}: missing debt description/type`
      );
      if (known(row.Finding))
        required(
          ft?.rows.some((f) => f.ID === row.Finding),
          `${row['#']}: unknown finding link`
        );
    }
    debt = {
      total: dt.rows.length,
      ticketed: dt.rows.filter((r) => known(r.Tracker)).length,
      unticketed: dt.rows.filter((r) => !known(r.Tracker)).length,
    };
  }
  if (tt && ['Written', 'Passed', 'Failed', 'Skipped'].some((h) => tt.headers.includes(h))) {
    columns(tt, ['Project', 'Written', 'Passed', 'Failed', 'Skipped', 'Evidence'], 'Test Results');
    unique(tt.rows, 'Project', /\S/);
    const total = (key) => {
      const values = tt.rows.map((row) => {
        const value = row[key];
        if (!known(value)) return null;
        required(
          /^\d+$/.test(value) && Number.isSafeInteger(Number(value)),
          `${row.Project}: ${key} must be an integer or unavailable`
        );
        required(known(row.Evidence), `${row.Project}: measured test counts need evidence`);
        return Number(value);
      });
      return values.length && values.every((v) => v !== null)
        ? values.reduce((a, b) => a + b, 0)
        : null;
    };
    tests = {
      written: total('Written'),
      passed: total('Passed'),
      failed: total('Failed'),
      skipped: total('Skipped'),
      scopes: tt.rows.length,
    };
    for (const row of tt.rows)
      if (/^\d+$/.test(row.Failed) && Number(row.Failed) > 0)
        issues.push(`${row.Project}: latest test case failures remain`);
  }
  const runs = checks.filter((c) => c.kind === 'test');
  return {
    version: 1,
    as_of: asOf,
    source: '2-report.md',
    // Hash only source tables, excluding generated metrics that change on refresh.
    source_sha256: createHash('sha256')
      .update(JSON.stringify([ft, dt, tt]))
      .digest('hex'),
    findings,
    tech_debt: debt,
    tests,
    test_runs: {
      recorded: runs.length,
      failed: runs.filter((c) => c.result === 'failed').length,
      errors: runs.filter((c) => c.result === 'error').length,
      interrupted: runs.filter((c) => ['running', 'interrupted', 'cancelled'].includes(c.result))
        .length,
    },
    closure_issues: issues,
  };
}

export function qualitySummary(q) {
  const show = (n) => n ?? 'unavailable';
  return `Quality (recorded inventory): findings ${show(q.findings?.total)} · open ${show(q.findings?.by_resolution.open)} · PR findings ${show(q.findings?.pr_review.total)} · critical ${show(q.findings?.by_severity.critical)} · debt ${show(q.tech_debt?.total)} · tests written ${show(q.tests?.written)} · latest failed cases ${show(q.tests?.failed)} · failed test runs ${q.test_runs.failed}. Counts describe recorded coverage, not a quality score; kind/severity/resolution breakdowns are in [stat.json](stat.json).`;
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall