owflow 0.1.4 → 0.1.6

package/dist/skills/html-renderer/references/styles.css

@@ -0,0 +1,388 @@
+:root {
+  /* Mirrored from tokens.json to keep CSS runtime simple. */
+  --hr-color-primary: #cc785c;
+  --hr-color-primary-active: #a9583e;
+  --hr-color-primary-disabled: #e6dfd8;
+  --hr-color-ink: #141413;
+  --hr-color-body: #3d3d3a;
+  --hr-color-body-strong: #252523;
+  --hr-color-muted: #6c6a64;
+  --hr-color-muted-soft: #8e8b82;
+  --hr-color-hairline: #e6dfd8;
+  --hr-color-hairline-soft: #ebe6df;
+  --hr-color-canvas: #faf9f5;
+  --hr-color-surface-soft: #f5f0e8;
+  --hr-color-surface-card: #efe9de;
+  --hr-color-surface-cream-strong: #e8e0d2;
+  --hr-color-surface-dark: #181715;
+  --hr-color-surface-dark-elevated: #252320;
+  --hr-color-surface-dark-soft: #1f1e1b;
+  --hr-color-on-primary: #ffffff;
+  --hr-color-on-dark: #faf9f5;
+  --hr-color-on-dark-soft: #a09d96;
+  --hr-color-accent-teal: #5db8a6;
+  --hr-color-accent-amber: #e8a55a;
+  --hr-color-success: #5db872;
+  --hr-color-warning: #d4a017;
+  --hr-color-error: #c64545;
+
+  --hr-font-display: "Copernicus", "Tiempos Headline", "Cormorant Garamond", "EB Garamond", Georgia, serif;
+  --hr-font-body: "StyreneB", "Styrene B", Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  --hr-font-code: "JetBrains Mono", ui-monospace, monospace;
+
+  --hr-space-xxs: 4px;
+  --hr-space-xs: 8px;
+  --hr-space-sm: 12px;
+  --hr-space-md: 16px;
+  --hr-space-lg: 24px;
+  --hr-space-xl: 32px;
+  --hr-space-xxl: 48px;
+  --hr-space-section: 96px;
+
+  --hr-radius-xs: 4px;
+  --hr-radius-sm: 6px;
+  --hr-radius-md: 8px;
+  --hr-radius-lg: 12px;
+  --hr-radius-xl: 16px;
+  --hr-radius-pill: 9999px;
+}
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: var(--hr-font-body);
+  color: var(--hr-color-body);
+  background: var(--hr-color-canvas);
+}
+
+.hr-page {
+  max-width: 1100px;
+  margin: 0 auto;
+  padding: var(--hr-space-xl) var(--hr-space-lg) var(--hr-space-section);
+}
+
+.hr-section {
+  margin-top: var(--hr-space-section);
+}
+
+.hr-section:first-child {
+  margin-top: 0;
+}
+
+.hr-heading-eyebrow {
+  display: inline-block;
+  margin: 0 0 var(--hr-space-sm);
+  color: var(--hr-color-muted);
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.hr-heading-h1,
+.hr-heading-h2,
+.hr-heading-h3,
+.hr-heading-h4 {
+  margin: 0;
+  color: var(--hr-color-ink);
+}
+
+.hr-heading-h1 {
+  font-family: var(--hr-font-display);
+  font-size: clamp(2.5rem, 5vw, 4rem);
+  font-weight: 400;
+  letter-spacing: -1.5px;
+  line-height: 1.05;
+}
+
+.hr-heading-h2 {
+  font-family: var(--hr-font-display);
+  font-size: clamp(2rem, 4vw, 3rem);
+  font-weight: 400;
+  letter-spacing: -1px;
+  line-height: 1.1;
+}
+
+.hr-heading-h3 {
+  font-family: var(--hr-font-display);
+  font-size: clamp(1.7rem, 3vw, 2.25rem);
+  font-weight: 400;
+  letter-spacing: -0.5px;
+  line-height: 1.15;
+}
+
+.hr-heading-h4 {
+  font-size: 1.125rem;
+  font-weight: 500;
+  line-height: 1.4;
+}
+
+.hr-stack {
+  display: grid;
+  gap: var(--hr-space-md);
+}
+
+.hr-text-block {
+  max-width: 75ch;
+  color: var(--hr-color-body);
+}
+
+.hr-text-block p,
+.hr-text-block ul,
+.hr-text-block ol {
+  margin: 0;
+  font-size: 16px;
+  line-height: 1.55;
+}
+
+.hr-text-block ul,
+.hr-text-block ol {
+  padding-left: 1.25rem;
+}
+
+.hr-text-muted {
+  color: var(--hr-color-muted);
+  font-size: 14px;
+}
+
+.hr-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+  gap: var(--hr-space-lg);
+}
+
+.hr-grid-2 {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.hr-grid-3 {
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+}
+
+.hr-grid-4 {
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+}
+
+.hr-grid-feature {
+  grid-template-columns: 2fr 1fr 1fr;
+}
+
+.hr-grid-feature > :first-child {
+  grid-row: span 1;
+}
+
+.hr-grid-sidebar {
+  grid-template-columns: 2fr 1fr;
+}
+
+@media (max-width: 880px) {
+  .hr-grid-3,
+  .hr-grid-4,
+  .hr-grid-feature {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+  .hr-grid-feature > :first-child {
+    grid-column: 1 / -1;
+  }
+}
+
+@media (max-width: 600px) {
+  .hr-grid-2,
+  .hr-grid-3,
+  .hr-grid-4,
+  .hr-grid-feature,
+  .hr-grid-sidebar {
+    grid-template-columns: 1fr;
+  }
+  .hr-grid-feature > :first-child {
+    grid-column: auto;
+  }
+}
+
+.hr-card {
+  background: var(--hr-color-surface-card);
+  border: 1px solid var(--hr-color-hairline);
+  border-radius: var(--hr-radius-lg);
+  padding: var(--hr-space-xl);
+}
+
+.hr-card-featured {
+  background: var(--hr-color-surface-dark);
+  border-color: var(--hr-color-surface-dark-elevated);
+  color: var(--hr-color-on-dark);
+}
+
+.hr-card-title {
+  margin: 0 0 var(--hr-space-sm);
+  font-size: 1.125rem;
+  font-weight: 600;
+  color: inherit;
+}
+
+.hr-card-text {
+  margin: 0;
+  color: inherit;
+  opacity: 0.92;
+  line-height: 1.55;
+}
+
+.hr-badge {
+  display: inline-block;
+  margin-top: var(--hr-space-md);
+  border-radius: var(--hr-radius-pill);
+  background: var(--hr-color-primary);
+  color: var(--hr-color-on-primary);
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  padding: 4px 10px;
+}
+
+.hr-table-wrap {
+  overflow: auto;
+  border: 1px solid var(--hr-color-hairline);
+  border-radius: var(--hr-radius-lg);
+  background: var(--hr-color-canvas);
+}
+
+.hr-table {
+  width: 100%;
+  border-collapse: collapse;
+  min-width: 640px;
+}
+
+.hr-table th,
+.hr-table td {
+  text-align: left;
+  padding: var(--hr-space-md);
+  border-bottom: 1px solid var(--hr-color-hairline-soft);
+  font-size: 14px;
+}
+
+.hr-table th {
+  color: var(--hr-color-body-strong);
+  background: var(--hr-color-surface-soft);
+  font-weight: 600;
+}
+
+.hr-table tbody tr:last-child td {
+  border-bottom: 0;
+}
+
+.hr-diagram {
+  border-radius: var(--hr-radius-lg);
+  border: 1px solid var(--hr-color-hairline);
+  background: linear-gradient(
+    180deg,
+    var(--hr-color-surface-card) 0%,
+    var(--hr-color-canvas) 100%
+  );
+  padding: var(--hr-space-lg);
+}
+
+.hr-diagram pre {
+  margin: 0;
+  font-family: var(--hr-font-code);
+  font-size: 14px;
+  line-height: 1.6;
+  color: var(--hr-color-body-strong);
+  white-space: pre-wrap;
+}
+
+.hr-diagram .mermaid {
+  margin: 0;
+  display: flex;
+  justify-content: center;
+  font-family: var(--hr-font-code);
+  font-size: 14px;
+  line-height: 1.6;
+  color: var(--hr-color-body-strong);
+  white-space: pre;
+}
+
+.hr-diagram .mermaid svg {
+  max-width: 100%;
+  height: auto;
+  display: block;
+  margin: 0 auto;
+}
+
+.hr-quote {
+  margin: 0;
+  border-left: 4px solid var(--hr-color-primary);
+  padding: var(--hr-space-md) var(--hr-space-lg);
+  background: var(--hr-color-surface-soft);
+  border-radius: 0 var(--hr-radius-md) var(--hr-radius-md) 0;
+}
+
+.hr-quote p {
+  margin: 0;
+  font-family: var(--hr-font-display);
+  font-size: 1.5rem;
+  line-height: 1.3;
+  letter-spacing: -0.3px;
+  color: var(--hr-color-ink);
+}
+
+.hr-quote footer {
+  margin-top: var(--hr-space-sm);
+  color: var(--hr-color-muted);
+  font-size: 14px;
+}
+
+.hr-highlight {
+  border: 1px solid var(--hr-color-hairline);
+  border-left-width: 6px;
+  border-radius: var(--hr-radius-md);
+  background: var(--hr-color-surface-soft);
+  padding: var(--hr-space-md) var(--hr-space-lg);
+}
+
+.hr-highlight-title {
+  margin: 0 0 var(--hr-space-xs);
+  font-size: 13px;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.hr-highlight p {
+  margin: 0;
+  line-height: 1.55;
+}
+
+.hr-highlight-note {
+  border-left-color: var(--hr-color-accent-teal);
+}
+
+.hr-highlight-note .hr-highlight-title {
+  color: #2d8071;
+}
+
+.hr-highlight-warning {
+  border-left-color: var(--hr-color-warning);
+}
+
+.hr-highlight-warning .hr-highlight-title {
+  color: #8a6a0e;
+}
+
+.hr-highlight-important {
+  border-left-color: var(--hr-color-primary);
+}
+
+.hr-highlight-important .hr-highlight-title {
+  color: var(--hr-color-primary-active);
+}
+
+.hr-hr {
+  border: 0;
+  border-top: 1px solid var(--hr-color-hairline);
+  margin: var(--hr-space-xl) 0;
+}

package/dist/skills/html-renderer/references/tokens.json

@@ -0,0 +1,104 @@
+{
+  "meta": {
+    "name": "html-renderer-tokens",
+    "version": "1.0.0",
+    "description": "Global visual tokens for markdown to HTML rendering."
+  },
+  "colors": {
+    "primary": "#cc785c",
+    "primaryActive": "#a9583e",
+    "primaryDisabled": "#e6dfd8",
+    "ink": "#141413",
+    "body": "#3d3d3a",
+    "bodyStrong": "#252523",
+    "muted": "#6c6a64",
+    "mutedSoft": "#8e8b82",
+    "hairline": "#e6dfd8",
+    "hairlineSoft": "#ebe6df",
+    "canvas": "#faf9f5",
+    "surfaceSoft": "#f5f0e8",
+    "surfaceCard": "#efe9de",
+    "surfaceCreamStrong": "#e8e0d2",
+    "surfaceDark": "#181715",
+    "surfaceDarkElevated": "#252320",
+    "surfaceDarkSoft": "#1f1e1b",
+    "onPrimary": "#ffffff",
+    "onDark": "#faf9f5",
+    "onDarkSoft": "#a09d96",
+    "accentTeal": "#5db8a6",
+    "accentAmber": "#e8a55a",
+    "success": "#5db872",
+    "warning": "#d4a017",
+    "error": "#c64545"
+  },
+  "spacing": {
+    "xxs": "4px",
+    "xs": "8px",
+    "sm": "12px",
+    "md": "16px",
+    "lg": "24px",
+    "xl": "32px",
+    "xxl": "48px",
+    "section": "96px"
+  },
+  "radius": {
+    "xs": "4px",
+    "sm": "6px",
+    "md": "8px",
+    "lg": "12px",
+    "xl": "16px",
+    "pill": "9999px",
+    "full": "9999px"
+  },
+  "typography": {
+    "displayXl": {
+      "fontFamily": "\"Copernicus\", \"Tiempos Headline\", \"Cormorant Garamond\", \"EB Garamond\", Georgia, serif",
+      "fontSize": "64px",
+      "fontWeight": 400,
+      "lineHeight": 1.05,
+      "letterSpacing": "-1.5px"
+    },
+    "displayLg": {
+      "fontFamily": "\"Copernicus\", \"Tiempos Headline\", \"Cormorant Garamond\", \"EB Garamond\", Georgia, serif",
+      "fontSize": "48px",
+      "fontWeight": 400,
+      "lineHeight": 1.1,
+      "letterSpacing": "-1px"
+    },
+    "displayMd": {
+      "fontFamily": "\"Copernicus\", \"Tiempos Headline\", \"Cormorant Garamond\", \"EB Garamond\", Georgia, serif",
+      "fontSize": "36px",
+      "fontWeight": 400,
+      "lineHeight": 1.15,
+      "letterSpacing": "-0.5px"
+    },
+    "titleMd": {
+      "fontFamily": "\"StyreneB\", \"Styrene B\", Inter, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
+      "fontSize": "18px",
+      "fontWeight": 500,
+      "lineHeight": 1.4,
+      "letterSpacing": "0"
+    },
+    "bodyMd": {
+      "fontFamily": "\"StyreneB\", \"Styrene B\", Inter, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
+      "fontSize": "16px",
+      "fontWeight": 400,
+      "lineHeight": 1.55,
+      "letterSpacing": "0"
+    },
+    "bodySm": {
+      "fontFamily": "\"StyreneB\", \"Styrene B\", Inter, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
+      "fontSize": "14px",
+      "fontWeight": 400,
+      "lineHeight": 1.55,
+      "letterSpacing": "0"
+    },
+    "code": {
+      "fontFamily": "\"JetBrains Mono\", ui-monospace, monospace",
+      "fontSize": "14px",
+      "fontWeight": 400,
+      "lineHeight": 1.6,
+      "letterSpacing": "0"
+    }
+  }
+}

package/dist/skills/migration/SKILL.md

@@ -23,6 +23,7 @@ Systematic migration workflow from current state analysis to verified migration
 1. **Create Task Items**: Use `TaskCreate` for all phases (see Phase Configuration), then set dependencies with `TaskUpdate addBlockedBy`
 2. **Create Task Directory**: `.owflow/tasks/migrations/YYYY-MM-DD-task-name/`
 3. **Initialize State**: Create `orchestrator-state.yml` with migration context
+   - **CRITICAL**: Use the `verify_template` tool immediately after creation to check YAML validity against `orchestrator-state-migration.yml`.
 4. **Discover project documentation**: Read `.owflow/docs/INDEX.md` (if exists), extract ALL file paths from the "Project Documentation" section — includes predefined docs AND any user-added project docs. Store as `project_context.project_doc_paths` in state.
 
 **Output**:
@@ -150,6 +151,12 @@ question - Display executive summary before asking. Extract from gap analysis: c
 **Output**: `analysis/requirements.md`, `implementation/spec.md`, `analysis/rollback-plan.md`, optionally `analysis/dual-run-plan.md`
 **State**: Update `rollback_plan_created`, `dual_run_configured`
 
+**Part C — Diagram Refinement (Skill, content-preserving)**:
+
+4. Invoke Skill tool: `diagrams-mermaid` to refine `implementation/spec.md`
+5. Add migration-focused visuals (target architecture and transition/compatibility flow) as supplements, not replacements for strategy prose.
+6. If minimum context is missing, record open gaps instead of inventing systems, protocols, or migration paths.
+
 → Pause
 
 question - Display executive summary before asking. Read `implementation/spec.md` and extract: migration strategy chosen, scope boundaries, rollback approach, breaking changes identified, key constraints. Format as brief overview then "Continue to implementation planning?"
@@ -167,6 +174,12 @@ question - Display executive summary before asking. Read `implementation/spec.md
 
 **Context to pass to subagent**: task_path, task_type (migration), migration_type, task_description, phase_summaries (current_state_analysis, gap_analysis, specification)
 
+**Post-plan diagram refinement (Skill, content-preserving)**:
+
+- Invoke Skill tool: `diagrams-mermaid` for `implementation/implementation-plan.md`
+- Add one migration execution/state flow with rollback checkpoints.
+- Preserve written task steps and rollback details as source of truth.
+
 → Pause
 
 question - Display executive summary before asking. Read `implementation/implementation-plan.md` and extract: number of task groups, total steps, rollback steps included, key dependencies, execution sequence. Format as brief overview then "Continue to execute migration?"
@@ -296,39 +309,7 @@ question - Display executive summary: total issues found, issues fixed, issues r
 
 Migration-specific fields in `orchestrator-state.yml`:
 
-```yaml
-migration_context:
-  migration_type: "code" | "data" | "architecture" | "general"
-  current_system:
-    description: null
-    technologies: []
-  target_system:
-    description: null
-    technologies: []
-  migration_strategy:
-    approach: "incremental" | "big-bang" | "dual-run" | "phased"
-    phases: []
-  risk_level: null
-  breaking_changes: []
-  rollback_plan_created: false
-  dual_run_configured: false
-
-external_research:
-  performed: false
-  category: null
-  breaking_changes: []
-  migration_guide_url: null
-
-verification_context:
-  last_status: null
-  issues_found: null
-  fixes_applied: []
-  decisions_made: []
-  reverify_count: 0
-
-options:
-  docs_enabled: false
-```
+Refer to the template [src/templates/orchestrator-state-migration.yml](../../templates/orchestrator-state-migration.yml).
 
 ---
 

package/dist/skills/orchestrator-framework/references/orchestrator-creation-checklist.md

@@ -10,6 +10,7 @@ Before considering an orchestrator complete, verify ALL items:
 
 - [ ] **Step 0: Load Framework** — Initialization reads `orchestrator-patterns.md`
 - [ ] **State file creation** — Explicit step to CREATE `orchestrator-state.yml`
+- [ ] **State verification** — Explicit step to use `verify_template` to check YAML validity after creation
 - [ ] **Phase structure** — Each phase has: Purpose, Execute, Output, State, Transition (`→ Pause` / `→ AUTO-CONTINUE` / `→ Conditional`)
 - [ ] **Delegation enforcement** — Each delegated phase has: ANTI-PATTERN block, INVOKE NOW block, SELF-CHECK
 - [ ] **POST-CONTINUATION blocks** — After Skill tool phases, explicit instructions to read state, update completed_phases, and continue

package/dist/skills/orchestrator-framework/references/orchestrator-patterns.md

@@ -163,42 +163,7 @@ All orchestrators use `orchestrator-state.yml` at `.owflow/tasks/[type]/YYYY-MM-
 
 ### Common Fields
 
-```yaml
-orchestrator:
-  # Phase tracking
-  started_phase: [phase-name]
-  completed_phases: []
-  failed_phases: []
-
-  # Auto-fix tracking (per phase)
-  auto_fix_attempts:
-    phase-1: 0
-    phase-2: 0
-
-  # Optional phase flags
-  options:
-    e2e_enabled: true | false | null
-    user_docs_enabled: true | false | null
-    code_review_enabled: true | false | null
-
-  # Timestamps
-  created: [ISO 8601 timestamp]
-  updated: [ISO 8601 timestamp]
-  task_path: .owflow/tasks/[type]/YYYY-MM-DD-task-name
-
-  # Task tracking IDs (maps phase names to TaskCreate IDs)
-  task_ids:
-    phase-1: null
-    phase-2: null
-
-# Task metadata
-task:
-  title: [human-readable task title]
-  description: [full task description]
-  status: pending | in_progress | completed | failed | blocked
-  tags: []
-  priority: null # high | medium | low
-```
+Refer to the template [src/templates/orchestrator-state-base.yml](../../../templates/orchestrator-state-base.yml).
 
 ### Extension Pattern
 
@@ -217,21 +182,7 @@ See each orchestrator's SKILL.md "Domain Context" section for full schema.
 
 When development starts from completed research (`--research` flag):
 
-```yaml
-task_context:
-  research_reference:
-    path: null
-    research_question: null
-    research_type: null # technical | requirements | literature | mixed
-    confidence_level: null # high | medium | low
-
-  phase_summaries:
-    research:
-      summary: null
-      key_findings: []
-      recommended_approach: null
-      decisions_made: []
-```
+Refer to `research_reference` in the template [src/templates/orchestrator-state-development.yml](../../../templates/orchestrator-state-development.yml).
 
 Research context flows to ALL phases via context passing. Artifacts are also copied to `analysis/research-context/`.
 
@@ -239,14 +190,7 @@ Research context flows to ALL phases via context passing. Artifacts are also cop
 
 All orchestrators with verification phases use:
 
-```yaml
-verification_context:
-  last_status: passed | passed_with_issues | failed | null
-  issues_found: []
-  fixes_applied: []
-  decisions_made: []
-  reverify_count: 0 # max 3
-```
+Refer to `verification_context` in the template [src/templates/orchestrator-state-base.yml](../../../templates/orchestrator-state-base.yml) or domain templates.
 
 ---
 
@@ -258,6 +202,7 @@ verification_context:
 2. **Determine starting phase**: New task starts Phase 1; resume reads state for first incomplete phase
 3. **Create task directory**: Standard structure with analysis/, implementation/, verification/, documentation/ _(skip on resume)_
 4. **Create state file**: `orchestrator-state.yml` _(skip on resume)_
+   - **CRITICAL**: Use the `verify_template` tool immediately after creation to check YAML validity against the corresponding template.
 5. **Create task items**: `TaskCreate` for all phases, then `TaskUpdate addBlockedBy` for dependencies. On resume, also restore completed phase statuses.
 6. **Output summary**: Show task info, phases, starting message