@dzhechkov/harness-core 0.2.0

package/src/workflows.ts

@@ -0,0 +1,123 @@
+/**
+ * Dynamic workflow templates for Opus 4.8+ orchestration.
+ *
+ * Per ADR-005: workflows live in the orchestration layer only.
+ * They generate JS scripts that Claude Code's dynamic workflow engine executes.
+ * Core schema, adapters, and skill content remain model-agnostic.
+ *
+ * @packageDocumentation
+ */
+
+/** A workflow template — generates a JS orchestration script from parameters. */
+export interface WorkflowTemplate {
+  readonly name: string;
+  readonly description: string;
+  readonly generate: (options: WorkflowOptions) => string;
+}
+
+/** Options passed to workflow generation. */
+export interface WorkflowOptions {
+  readonly projectRoot: string;
+  readonly dryRun?: boolean;
+  readonly packages?: readonly string[];
+}
+
+const coverageLift: WorkflowTemplate = {
+  name: 'coverage-lift',
+  description: 'Lift Tier-A package coverage to ≥95% using parallel agents per package.',
+  generate: (opts) => `
+// Dynamic Workflow: Coverage Lift
+// Generated for: ${opts.projectRoot}
+// Per ADR-005: orchestration only — no adapter/core changes
+
+const tierA = ${JSON.stringify(opts.packages ?? [
+    'core', 'memory', 'harness-core', 'harness-cli',
+    'harness-presets', 'mcp-server-tools',
+    'adapter-claude', 'adapter-codex', 'adapter-opencode', 'adapter-hermes',
+    'skills-qe',
+  ])};
+
+const tasks = tierA.map(pkg => ({
+  name: \`coverage-\${pkg}\`,
+  description: \`Lift @dzhechkov/\${pkg} to ≥95% line coverage. Run: pnpm --filter @dzhechkov/\${pkg} test -- --coverage. Add tests for uncovered lines.\`,
+}));
+
+// Claude Code dynamic workflow engine will:
+// 1. Spawn one agent per task (up to 16 concurrent)
+// 2. Each agent reads coverage, writes tests, re-runs coverage
+// 3. Results aggregated when all agents complete
+export default { tasks, maxConcurrency: 4${opts.dryRun ? ', dryRun: true' : ''} };
+`.trim(),
+};
+
+const mutationKill: WorkflowTemplate = {
+  name: 'mutation-kill',
+  description: 'Kill surviving mutants across core packages using parallel Stryker runs.',
+  generate: (opts) => `
+// Dynamic Workflow: Mutation Kill
+// Generated for: ${opts.projectRoot}
+
+const packages = ${JSON.stringify(opts.packages ?? ['core', 'memory', 'harness-core'])};
+
+const tasks = packages.map(pkg => ({
+  name: \`mutate-\${pkg}\`,
+  description: \`Run Stryker on @dzhechkov/\${pkg}, analyze survivors, write tests to kill them. Target: ≥80% mutation score.\`,
+}));
+
+export default { tasks, maxConcurrency: 3${opts.dryRun ? ', dryRun: true' : ''} };
+`.trim(),
+};
+
+const canonicalize: WorkflowTemplate = {
+  name: 'canonicalize',
+  description: 'Canonicalize packages from vendored directories into @dzhechkov/* namespace.',
+  generate: (opts) => `
+// Dynamic Workflow: Canonicalize
+// Generated for: ${opts.projectRoot}
+
+const tasks = [
+  { name: 'discover', description: 'Scan vendored directories for un-canonicalized packages.' },
+  { name: 'copy', description: 'Copy discovered packages to packages/@dzhechkov/. Exclude node_modules, .git, runtime state.' },
+  { name: 'metadata', description: 'Add publishConfig, repository, homepage to each package.json.' },
+  { name: 'verify', description: 'Run byte-level diff between source and canonical. 0 missing, 0 changed.' },
+  { name: 'test', description: 'Run canonical-packages structural tests. All must pass.' },
+];
+
+export default { tasks, maxConcurrency: 2${opts.dryRun ? ', dryRun: true' : ''} };
+`.trim(),
+};
+
+const securityAudit: WorkflowTemplate = {
+  name: 'security-audit',
+  description: 'Run adversarial security audit with parallel boundary scanning.',
+  generate: (opts) => `
+// Dynamic Workflow: Security Audit
+// Generated for: ${opts.projectRoot}
+
+const tasks = [
+  { name: 'npm-audit', description: 'Run pnpm audit, capture baseline.' },
+  { name: 'gitleaks', description: 'Run gitleaks detect, document findings.' },
+  { name: 'boundaries', description: 'Verify all 8 input boundaries have runtime guards.' },
+  { name: 'payloads', description: 'Test aidefence payloads against boundaries.' },
+  { name: 'report', description: 'Generate security-audit.md with 6 H2 sections.' },
+];
+
+export default { tasks, maxConcurrency: 3${opts.dryRun ? ', dryRun: true' : ''} };
+`.trim(),
+};
+
+/** All registered workflow templates. */
+export const WORKFLOWS: Record<string, WorkflowTemplate> = {
+  'coverage-lift': coverageLift,
+  'mutation-kill': mutationKill,
+  'canonicalize': canonicalize,
+  'security-audit': securityAudit,
+};
+
+/** Valid workflow names. */
+export const WORKFLOW_NAMES = Object.keys(WORKFLOWS);
+
+/** Look up a workflow by name. */
+export function getWorkflow(name: string): WorkflowTemplate | undefined {
+  return WORKFLOWS[name];
+}