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/design/scripts/design-metrics.test.mjs

View on GitHub
import { test } from 'node:test';
import assert from 'node:assert/strict';
import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import { spawnSync } from 'node:child_process';
import { fileURLToPath } from 'node:url';

const cli = fileURLToPath(new URL('./design-metrics.mjs', import.meta.url));
const stages = [
  'context-gathering',
  'ceremony',
  'frame',
  'research',
  'evaluate',
  'solution',
  'review-gate',
  'address-feedback',
  'publish',
  'completion',
];
const SIGN_OFF_GATED_STAGES = [
  'context-gathering',
  'ceremony',
  'frame',
  'research',
  'evaluate',
  'solution',
  'publish',
  'completion',
];
function fixture(t, partial = false) {
  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'design-metrics-'));
  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
  const run = (...args) =>
    spawnSync(process.execPath, [cli, '--dir', dir, ...args], { encoding: 'utf8' });
  const ok = (...args) => {
    const r = run(...args);
    assert.equal(r.status, 0, r.stderr);
    return r;
  };
  const read = () => JSON.parse(fs.readFileSync(path.join(dir, 'stat.json'), 'utf8'));
  ok('init', '--ticket', 'DESIGN-1', ...(partial ? ['--coverage', 'partial'] : []));
  return { dir, run, ok, read };
}
function approval(f, id, result = 'passed') {
  f.ok(
    'check',
    'record',
    '--id',
    id,
    '--kind',
    'acceptance',
    '--name',
    'Design approval',
    '--result',
    result,
    '--source',
    'developer',
    '--evidence',
    'Observed MR decision'
  );
}
let signoffCounter = 0;
function signoff(f, stage) {
  f.ok(
    'check',
    'record',
    '--id',
    `signoff-${++signoffCounter}`,
    '--kind',
    'acceptance',
    '--name',
    `${stage} sign-off`,
    '--result',
    'passed',
    '--source',
    'developer',
    '--evidence',
    'Looks good'
  );
}
/** Start, sign off, and complete a sign-off-gated stage in one call. */
function finishStage(f, stage) {
  f.ok('stage', 'start', '--stage', stage);
  signoff(f, stage);
  f.ok('stage', 'complete', '--stage', stage);
}
function reachReview(f) {
  for (const stage of stages.slice(0, 6)) finishStage(f, stage);
  f.ok('stage', 'start', '--stage', 'review-gate');
}
/** Reach ticket-level completion after publish's own completion. */
function finishCompletion(f) {
  finishStage(f, 'completion');
  f.ok('complete');
}
test('design initializes ten stages, isolates lifecycle, and rejects implementation steps', (t) => {
  const f = fixture(t);
  assert.deepEqual(
    f.read().stages.map((s) => s.id),
    stages
  );
  assert.equal(f.read().lifecycle, 'design');
  assert.equal(f.run('stage', 'start', '--stage', 'implement').status, 1);
  assert.equal(f.run('step', 'add', '--id', 'x').status, 1);
  const file = path.join(f.dir, 'stat.json');
  const before = fs.readFileSync(file, 'utf8');
  const d = f.read();
  d.lifecycle = 'dev';
  fs.writeFileSync(file, JSON.stringify(d));
  assert.equal(f.run('validate').status, 1);
  fs.writeFileSync(file, before);
});
test('full design survives approval wait and completes with a justified feedback skip', (t) => {
  const f = fixture(t);
  reachReview(f);
  f.ok('wait', 'start', '--reason', 'approval', '--detail', 'MR review');
  f.ok('recover');
  assert.equal(f.read().intervals.at(-1).ended_at, null);
  f.ok('resume', '--activity', 'review');
  assert.equal(
    f.run(
      'stage',
      'skip',
      '--stage',
      'address-feedback',
      '--reason',
      'no_concerns',
      '--evidence',
      'MR approved'
    ).status,
    1
  );
  approval(f, 'gate-1');
  f.ok(
    'stage',
    'skip',
    '--stage',
    'address-feedback',
    '--reason',
    'no_concerns',
    '--evidence',
    'MR approved'
  );
  f.ok('stage', 'complete', '--stage', 'review-gate');
  finishStage(f, 'publish');
  finishCompletion(f);
  assert.ok(f.read().completed_at);
  const feedback = f.read().stages.find((s) => s.id === 'address-feedback');
  assert.equal(feedback.status, 'skipped');
  assert.equal(feedback.attempts.length, 0);
  assert.equal(f.read().metrics.first_pass_verification_rate, 1);
});
test('open waits are visible in to-date metrics and report output', (t) => {
  const f = fixture(t);
  f.ok('stage', 'start', '--stage', 'frame');
  f.ok('wait', 'start', '--reason', 'approval', '--detail', 'Design review');
  spawnSync(process.execPath, ['-e', 'setTimeout(() => {}, 75)']);
  f.ok('report');
  const stat = f.read();
  assert.ok(stat.metrics.wait_seconds_to_date > 0);
  assert.ok(stat.metrics.open_wait_seconds > 0);
  assert.equal(stat.metrics.observed_wait_seconds, 0);
  assert.match(fs.readFileSync(path.join(f.dir, 'Report.md'), 'utf8'), /Wait to date:/);
});
test('feedback retries invalidate old approval and count as rework', (t) => {
  const f = fixture(t);
  reachReview(f);
  approval(f, 'gate-1', 'failed');
  f.ok('stage', 'complete', '--stage', 'review-gate');
  f.ok('stage', 'start', '--stage', 'address-feedback');
  assert.equal(
    f.read().stages.find((s) => s.id === 'address-feedback').attempts[0].trigger,
    'review_feedback'
  );
  approval(f, 'feedback-1');
  f.ok('stage', 'retry', '--stage', 'address-feedback', '--reason', 'review_feedback');
  f.ok('stage', 'complete', '--stage', 'address-feedback');
  f.ok('stage', 'start', '--stage', 'publish');
  assert.equal(f.run('stage', 'complete', '--stage', 'publish').status, 1);
  approval(f, 'feedback-2');
  signoff(f, 'publish');
  f.ok('stage', 'complete', '--stage', 'publish');
  finishCompletion(f);
  assert.ok(f.read().metrics.rework_seconds > 0);
});
test('reopening a gate restores skipped feedback and clears completion', (t) => {
  const f = fixture(t, true);
  f.ok('stage', 'start', '--stage', 'review-gate');
  approval(f, 'gate-1');
  f.ok(
    'stage',
    'skip',
    '--stage',
    'address-feedback',
    '--reason',
    'no_concerns',
    '--evidence',
    'Approved'
  );
  f.ok('stage', 'complete', '--stage', 'review-gate');
  finishStage(f, 'publish');
  finishCompletion(f);
  f.ok('stage', 'retry', '--stage', 'review-gate', '--reason', 'scope_change');
  const d = f.read();
  assert.equal(d.completed_at, null);
  assert.equal(d.stages.find((s) => s.id === 'publish').status, 'pending');
  assert.equal(
    d.stages.find((s) => s.id === 'completion').status,
    'pending',
    'resetting publish also resets completion'
  );
  const feedback = d.stages.find((s) => s.id === 'address-feedback');
  assert.equal(feedback.status, 'pending');
  assert.equal(feedback.skip_history.length, 1);
  assert.equal(
    f.run(
      'stage',
      'skip',
      '--stage',
      'address-feedback',
      '--reason',
      'no_concerns',
      '--evidence',
      'Approved'
    ).status,
    1
  );
});
test('partial publish requires observed approval and does not invent earlier work', (t) => {
  const f = fixture(t, true);
  f.ok('stage', 'start', '--stage', 'publish');
  assert.equal(f.run('stage', 'complete', '--stage', 'publish').status, 1);
  approval(f, 'direct-approval');
  signoff(f, 'publish');
  f.ok('stage', 'complete', '--stage', 'publish');
  assert.equal(f.read().completed_at, null);
  finishCompletion(f);
  assert.equal(f.read().stages[0].status, 'pending');
});
test('reports contain stage rows and preserve design state and gate notes', (t) => {
  const f = fixture(t);
  f.ok('stage', 'start', '--stage', 'frame');
  const file = path.join(f.dir, 'Report.md');
  const notes = '# Design\n\n## State\ncurrent_stage: frame\n\n## Gate\nApproved: pending\n';
  fs.writeFileSync(file, notes);
  f.ok('report');
  f.ok('report');
  const report = fs.readFileSync(file, 'utf8');
  assert.ok(report.startsWith(notes));
  assert.ok(report.includes('## Stage Metrics'));
  assert.ok(report.includes('frame (active)'));
  assert.ok(report.includes('publish (pending)'));
  assert.equal(report.match(/<!-- design-metrics:start -->/g).length, 1);
  assert.equal(fs.existsSync(path.join(f.dir, '2-report.md')), false);
});

test('report refresh migrates legacy dev metrics markers in place', (t) => {
  const f = fixture(t);
  f.ok('stage', 'start', '--stage', 'frame');
  const file = path.join(f.dir, 'Report.md');
  fs.writeFileSync(
    file,
    '# Design\n\n## Stage Metrics\n\n<!-- dev-metrics:start -->\nOld totals\n<!-- dev-metrics:end -->\n\n## Gate\nApproved: pending\n'
  );
  f.ok('report');
  f.ok('report');
  const report = fs.readFileSync(file, 'utf8');
  assert.equal(report.match(/## Stage Metrics/g).length, 1);
  assert.equal(report.match(/<!-- design-metrics:start -->/g).length, 1);
  assert.equal(report.match(/<!-- dev-metrics:start -->/g), null);
  assert.ok(!report.includes('Old totals'));
  assert.ok(report.includes('## Gate\nApproved: pending'));
});
test('failed executable checks block publication despite approval and restore work', (t) => {
  const f = fixture(t, true);
  f.ok('stage', 'start', '--stage', 'publish');
  approval(f, 'approval');
  assert.equal(
    f.run(
      'check',
      '--kind',
      'test',
      '--name',
      'Docs',
      '--',
      process.execPath,
      '-e',
      'process.exit(2)'
    ).status,
    2
  );
  assert.equal(f.read().intervals.at(-1).activity, 'documentation');
  assert.equal(f.run('stage', 'complete', '--stage', 'publish').status, 1);
  f.ok(
    'check',
    '--kind',
    'test',
    '--name',
    'Docs',
    '--',
    process.execPath,
    '-e',
    'process.exit(0)'
  );
  signoff(f, 'publish');
  f.ok('stage', 'complete', '--stage', 'publish');
  finishCompletion(f);
});

test('a sign-off-gated stage cannot complete without a developer-sourced sign-off in its current attempt', (t) => {
  const f = fixture(t);
  for (const stage of SIGN_OFF_GATED_STAGES) {
    f.ok('stage', 'start', '--stage', stage);
    assert.equal(
      f.run('stage', 'complete', '--stage', stage).status,
      1,
      `${stage} should refuse to complete without a sign-off`
    );
    if (stage === 'publish') approval(f, `${stage}-approval`);
    signoff(f, stage);
    f.ok('stage', 'complete', '--stage', stage);
  }
});
test('a retried stage needs a fresh sign-off; the old attempt does not carry over', (t) => {
  const f = fixture(t);
  finishStage(f, 'frame');
  f.ok('stage', 'retry', '--stage', 'frame', '--reason', 'scope_change');
  assert.equal(
    f.run('stage', 'complete', '--stage', 'frame').status,
    1,
    'old attempt sign-off does not carry over'
  );
  signoff(f, 'frame');
  f.ok('stage', 'complete', '--stage', 'frame');
});
test('review-gate and address-feedback complete on the MR-approval fact, not a named sign-off', (t) => {
  const f = fixture(t);
  reachReview(f);
  approval(f, 'gate-1');
  f.ok(
    'stage',
    'skip',
    '--stage',
    'address-feedback',
    '--reason',
    'no_concerns',
    '--evidence',
    'MR approved'
  );
  f.ok('stage', 'complete', '--stage', 'review-gate');
});
test('CLI installs alone with its own constants and helpers', (t) => {
  const isolated = fs.mkdtempSync(path.join(os.tmpdir(), 'design-metrics-alone-'));
  t.after(() => fs.rmSync(isolated, { recursive: true, force: true }));
  const installed = path.join(isolated, 'design-metrics.mjs');
  fs.copyFileSync(cli, installed);
  fs.copyFileSync(new URL('./utils.mjs', import.meta.url), path.join(isolated, 'utils.mjs'));
  const constants = fs
    .readFileSync(new URL('./constants.mjs', import.meta.url), 'utf8')
    .replaceAll('stat.json', 'custom-stat.json')
    .replaceAll('Report.md', 'custom-report.md')
    .replaceAll('.design-metrics.lock', '.custom-metrics.lock');
  fs.writeFileSync(path.join(isolated, 'constants.mjs'), constants);
  const dir = path.join(isolated, 'ticket');
  const run = (...args) =>
    spawnSync(process.execPath, [installed, '--dir', dir, ...args], { encoding: 'utf8' });
  for (const args of [
    ['init', '--ticket', 'SOLO-1'],
    ['stage', 'start', '--stage', 'frame'],
    ['report'],
  ]) {
    const result = run(...args);
    assert.equal(result.status, 0, result.stderr);
  }
  assert.ok(fs.existsSync(path.join(dir, 'custom-stat.json')));
  assert.ok(
    fs
      .readFileSync(path.join(dir, 'custom-report.md'), 'utf8')
      .includes('[custom-stat.json](custom-stat.json)')
  );
  fs.writeFileSync(path.join(dir, '.custom-metrics.lock'), 'occupied');
  assert.equal(run('checkpoint').status, 1);
});
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: 471kUpdated 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