npm - specdacular - Versions diffs - 0.7.1 → 0.8.0 - Mend

specdacular 0.7.1 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (63) hide show

package/README.md +72 -74
package/commands/specd/continue.md +59 -0
package/commands/specd/new.md +65 -0
package/commands/specd/status.md +1 -1
package/commands/specd/toolbox.md +59 -0
package/package.json +1 -1
package/specdacular/HELP.md +19 -16
package/specdacular/agents/feature-researcher.md +4 -4
package/specdacular/references/load-context.md +83 -0
package/specdacular/references/record-decision.md +61 -0
package/specdacular/references/select-feature.md +20 -20
package/specdacular/references/select-phase.md +3 -3
package/specdacular/references/spawn-research-agents.md +180 -0
package/specdacular/references/synthesize-research.md +127 -0
package/specdacular/references/validate-task.md +64 -0
package/specdacular/templates/{features → tasks}/CHANGELOG.md +2 -8
package/specdacular/templates/{features → tasks}/CONTEXT.md +6 -17
package/specdacular/templates/tasks/DECISIONS.md +46 -0
package/specdacular/templates/{features → tasks}/FEATURE.md +3 -3
package/specdacular/templates/tasks/PLAN.md +91 -0
package/specdacular/templates/tasks/RESEARCH.md +121 -0
package/specdacular/templates/{features → tasks}/ROADMAP.md +6 -43
package/specdacular/templates/tasks/STATE.md +93 -0
package/specdacular/templates/tasks/config.json +15 -0
package/specdacular/workflows/continue.md +275 -0
package/specdacular/workflows/discuss.md +184 -0
package/specdacular/workflows/execute.md +174 -0
package/specdacular/workflows/new.md +299 -0
package/specdacular/workflows/orchestrator/new.md +265 -0
package/specdacular/workflows/orchestrator/plan.md +169 -0
package/specdacular/workflows/plan.md +201 -0
package/specdacular/workflows/research.md +166 -0
package/specdacular/workflows/review.md +289 -0
package/specdacular/workflows/status.md +17 -17
package/commands/specd/blueprint.md +0 -64
package/commands/specd/feature/continue.md +0 -84
package/commands/specd/feature/new.md +0 -67
package/commands/specd/feature/toolbox.md +0 -49
package/specdacular/templates/blueprint/index.html +0 -110
package/specdacular/templates/blueprint/scripts.js +0 -71
package/specdacular/templates/blueprint/styles.css +0 -429
package/specdacular/templates/features/DECISIONS.md +0 -109
package/specdacular/templates/features/DEPENDENCIES.md +0 -47
package/specdacular/templates/features/PLAN.md +0 -180
package/specdacular/templates/features/RESEARCH.md +0 -183
package/specdacular/templates/features/STATE.md +0 -110
package/specdacular/templates/features/config.json +0 -20
package/specdacular/workflows/blueprint-diagrams.md +0 -273
package/specdacular/workflows/blueprint-wireframes.md +0 -312
package/specdacular/workflows/blueprint.md +0 -372
package/specdacular/workflows/continue-feature.md +0 -621
package/specdacular/workflows/discuss-feature.md +0 -382
package/specdacular/workflows/execute-plan.md +0 -636
package/specdacular/workflows/insert-phase.md +0 -246
package/specdacular/workflows/new-feature.md +0 -760
package/specdacular/workflows/plan-feature.md +0 -691
package/specdacular/workflows/plan-phase.md +0 -355
package/specdacular/workflows/prepare-phase.md +0 -745
package/specdacular/workflows/renumber-phases.md +0 -273
package/specdacular/workflows/research-feature.md +0 -252
package/specdacular/workflows/research-phase.md +0 -576
package/specdacular/workflows/review-feature.md +0 -316
package/specdacular/workflows/review-phase.md +0 -545

package/specdacular/templates/blueprint/index.html DELETED Viewed

@@ -1,110 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">
-  <title>{feature-name} Blueprint</title>
-  <style>
-{styles}
-  </style>
-</head>
-<body>
-  <div class="blueprint-container">
-    <nav class="blueprint-sidebar">
-      <div class="sidebar-header">
-        <h2>{feature-name}</h2>
-        <span class="subtitle">Blueprint</span>
-      </div>
-      <ul class="nav-tabs">
-        <li><a href="#overview" class="tab-link active" data-tab="overview">Overview</a></li>
-        <li><a href="#decisions" class="tab-link" data-tab="decisions">Decisions</a></li>
-        <li><a href="#context" class="tab-link" data-tab="context">Context</a></li>
-        <li><a href="#plans" class="tab-link" data-tab="plans">Plans</a></li>
-        <li><a href="#wireframes" class="tab-link {wireframes-disabled}" data-tab="wireframes">Wireframes</a></li>
-        <li><a href="#diagrams" class="tab-link {diagrams-disabled}" data-tab="diagrams">Diagrams</a></li>
-      </ul>
-      <div class="sidebar-footer">
-        <span class="generated">Generated: {date}</span>
-      </div>
-    </nav>
-    <main class="blueprint-content">
-      <section id="overview" class="tab-content active">
-        <h1>Overview</h1>
-        <div class="overview-description">
-          {feature-description}
-        </div>
-        <div class="overview-stats">
-          <div class="stat">
-            <span class="stat-value">{decisions-count}</span>
-            <span class="stat-label">Decisions</span>
-          </div>
-          <div class="stat">
-            <span class="stat-value">{sessions-count}</span>
-            <span class="stat-label">Discussion Sessions</span>
-          </div>
-          <div class="stat">
-            <span class="stat-value">{plans-count}</span>
-            <span class="stat-label">Plans</span>
-          </div>
-        </div>
-        <div class="overview-timeline">
-          <h2>Activity Timeline</h2>
-          {timeline-content}
-        </div>
-      </section>
-      <section id="decisions" class="tab-content">
-        <h1>Decisions</h1>
-        <p class="section-intro">Click any decision to expand details.</p>
-        <div class="phase-tabs">
-          {decisions-phase-tabs}
-        </div>
-        <div class="decisions-list">
-{decisions-content}
-        </div>
-      </section>
-      <section id="context" class="tab-content">
-        <h1>Discussion Context</h1>
-        <div class="phase-tabs">
-          {context-phase-tabs}
-        </div>
-        <div class="context-content">
-{context-content}
-        </div>
-      </section>
-      <section id="plans" class="tab-content">
-        <h1>Plans</h1>
-        <div class="phase-tabs">
-          {plans-phase-tabs}
-        </div>
-        <div class="plans-content">
-{plans-content}
-        </div>
-      </section>
-      <section id="wireframes" class="tab-content">
-        <h1>Wireframes</h1>
-        <div class="wireframes-content">
-{wireframes-content}
-        </div>
-      </section>
-      <section id="diagrams" class="tab-content">
-        <h1>Diagrams</h1>
-        <div class="diagrams-content">
-{diagrams-content}
-        </div>
-      </section>
-    </main>
-  </div>
-  <script src="https://cdn.jsdelivr.net/npm/mermaid@10.6.1/dist/mermaid.min.js"></script>
-  <script>
-{scripts}
-  </script>
-</body>
-</html>

package/specdacular/templates/blueprint/scripts.js DELETED Viewed

@@ -1,71 +0,0 @@
-// Initialize Mermaid for diagrams
-mermaid.initialize({
-  startOnLoad: true,
-  theme: 'default',
-  securityLevel: 'loose'
-});
-// Tab switching
-document.addEventListener('DOMContentLoaded', function() {
-  const tabLinks = document.querySelectorAll('.tab-link:not(.disabled)');
-  tabLinks.forEach(link => {
-    link.addEventListener('click', function(e) {
-      e.preventDefault();
-      // Remove active class from all tabs and content
-      document.querySelectorAll('.tab-link').forEach(l => l.classList.remove('active'));
-      document.querySelectorAll('.tab-content').forEach(c => c.classList.remove('active'));
-      // Add active class to clicked tab and corresponding content
-      this.classList.add('active');
-      const tabId = this.getAttribute('data-tab');
-      document.getElementById(tabId).classList.add('active');
-      // Re-render Mermaid diagrams in newly visible tab
-      const section = document.getElementById(tabId);
-      const diagrams = section.querySelectorAll('.mermaid');
-      if (diagrams.length > 0) {
-        mermaid.init(undefined, diagrams);
-      }
-    });
-  });
-  // Phase tab switching (within sections)
-  document.querySelectorAll('.phase-tabs').forEach(tabContainer => {
-    const tabs = tabContainer.querySelectorAll('.phase-tab');
-    const section = tabContainer.closest('.tab-content');
-    tabs.forEach(tab => {
-      tab.addEventListener('click', function() {
-        // Remove active from all phase tabs in this section
-        tabs.forEach(t => t.classList.remove('active'));
-        // Add active to clicked tab
-        this.classList.add('active');
-        // Get phase to show
-        const phase = this.getAttribute('data-phase');
-        // Hide all phase content in this section
-        section.querySelectorAll('.phase-content').forEach(content => {
-          content.classList.remove('active');
-        });
-        // Show selected phase content
-        if (phase === 'all') {
-          // Show all phase content
-          section.querySelectorAll('.phase-content').forEach(content => {
-            content.classList.add('active');
-          });
-        } else {
-          // Show only matching phase
-          const targetContent = section.querySelector('.phase-content[data-phase="' + phase + '"]');
-          if (targetContent) {
-            targetContent.classList.add('active');
-          }
-        }
-      });
-    });
-  });
-});

package/specdacular/templates/blueprint/styles.css DELETED Viewed

@@ -1,429 +0,0 @@
-* {
-  margin: 0;
-  padding: 0;
-  box-sizing: border-box;
-}
-body {
-  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-  height: 100vh;
-  overflow: hidden;
-  background: #f5f5f5;
-}
-.blueprint-container {
-  display: flex;
-  height: 100vh;
-}
-/* Sidebar */
-.blueprint-sidebar {
-  width: 250px;
-  min-width: 250px;
-  background: #2c3e50;
-  color: white;
-  display: flex;
-  flex-direction: column;
-  overflow-y: auto;
-}
-.sidebar-header {
-  padding: 1.5rem;
-  background: #1a252f;
-  border-bottom: 1px solid #34495e;
-}
-.sidebar-header h2 {
-  font-size: 1.25rem;
-  margin-bottom: 0.25rem;
-}
-.sidebar-header .subtitle {
-  font-size: 0.875rem;
-  opacity: 0.7;
-}
-.nav-tabs {
-  list-style: none;
-  flex: 1;
-  padding: 1rem 0;
-}
-.tab-link {
-  display: block;
-  padding: 0.875rem 1.5rem;
-  color: white;
-  text-decoration: none;
-  transition: background 0.2s, border-left 0.2s;
-  border-left: 4px solid transparent;
-}
-.tab-link:hover {
-  background: #34495e;
-}
-.tab-link.active {
-  background: #34495e;
-  border-left-color: #3498db;
-}
-.tab-link.disabled {
-  opacity: 0.4;
-  pointer-events: none;
-}
-.sidebar-footer {
-  padding: 1rem 1.5rem;
-  font-size: 0.75rem;
-  opacity: 0.6;
-  border-top: 1px solid #34495e;
-}
-/* Main Content */
-.blueprint-content {
-  flex: 1;
-  overflow-y: auto;
-  padding: 2rem;
-}
-.tab-content {
-  display: none;
-}
-.tab-content.active {
-  display: block;
-}
-.tab-content h1 {
-  margin-bottom: 1rem;
-  color: #2c3e50;
-}
-.section-intro {
-  color: #666;
-  margin-bottom: 1.5rem;
-}
-/* Overview Stats */
-.overview-description {
-  background: white;
-  padding: 1.5rem;
-  border-radius: 8px;
-  margin-bottom: 1.5rem;
-  line-height: 1.6;
-}
-.overview-stats {
-  display: grid;
-  grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
-  gap: 1rem;
-  margin-bottom: 2rem;
-}
-.stat {
-  background: white;
-  padding: 1.5rem;
-  border-radius: 8px;
-  text-align: center;
-}
-.stat-value {
-  display: block;
-  font-size: 2rem;
-  font-weight: bold;
-  color: #3498db;
-}
-.stat-label {
-  font-size: 0.875rem;
-  color: #666;
-}
-/* Timeline */
-.overview-timeline {
-  background: white;
-  padding: 1.5rem;
-  border-radius: 8px;
-}
-.overview-timeline h2 {
-  margin-bottom: 1rem;
-  font-size: 1.125rem;
-}
-.timeline-item {
-  padding: 0.75rem 0;
-  border-bottom: 1px solid #eee;
-  display: flex;
-  gap: 1rem;
-}
-.timeline-item:last-child {
-  border-bottom: none;
-}
-.timeline-date {
-  color: #666;
-  font-size: 0.875rem;
-  min-width: 100px;
-}
-.timeline-event {
-  flex: 1;
-}
-/* Decisions (Accordion) */
-.decisions-list {
-  display: flex;
-  flex-direction: column;
-  gap: 0.5rem;
-}
-.decision-item {
-  background: white;
-  border-radius: 8px;
-  overflow: hidden;
-}
-.decision-item summary {
-  padding: 1rem 1.5rem;
-  cursor: pointer;
-  display: flex;
-  align-items: center;
-  gap: 1rem;
-  list-style: none;
-  user-select: none;
-}
-.decision-item summary::-webkit-details-marker {
-  display: none;
-}
-.decision-item summary:hover {
-  background: #f9f9f9;
-}
-.decision-id {
-  font-family: monospace;
-  background: #e8e8e8;
-  padding: 0.25rem 0.5rem;
-  border-radius: 4px;
-  font-size: 0.875rem;
-}
-.decision-title {
-  flex: 1;
-  font-weight: 500;
-}
-.decision-status {
-  font-size: 0.75rem;
-  padding: 0.25rem 0.5rem;
-  border-radius: 4px;
-  text-transform: uppercase;
-}
-.status-active {
-  background: #d4edda;
-  color: #155724;
-}
-.status-superseded {
-  background: #fff3cd;
-  color: #856404;
-}
-.status-revoked {
-  background: #f8d7da;
-  color: #721c24;
-}
-.decision-date {
-  font-size: 0.875rem;
-  color: #666;
-}
-.decision-content {
-  padding: 1rem 1.5rem;
-  border-top: 1px solid #eee;
-  background: #fafafa;
-}
-.decision-content p {
-  margin-bottom: 0.75rem;
-  line-height: 1.6;
-}
-.decision-content ul {
-  margin-left: 1.5rem;
-  margin-bottom: 0.75rem;
-}
-.decision-content li {
-  margin-bottom: 0.25rem;
-}
-/* Expand indicator */
-.decision-item summary::after {
-  content: '\25b6';
-  font-size: 0.75rem;
-  transition: transform 0.2s;
-}
-.decision-item[open] summary::after {
-  transform: rotate(90deg);
-}
-/* Context */
-.context-content {
-  background: white;
-  padding: 1.5rem;
-  border-radius: 8px;
-}
-.context-section {
-  margin-bottom: 2rem;
-}
-.context-section h3 {
-  margin-bottom: 1rem;
-  padding-bottom: 0.5rem;
-  border-bottom: 2px solid #3498db;
-}
-.resolved-question {
-  margin-bottom: 1.5rem;
-  padding: 1rem;
-  background: #f9f9f9;
-  border-radius: 4px;
-}
-.resolved-question h4 {
-  margin-bottom: 0.5rem;
-  color: #2c3e50;
-}
-/* Plans */
-.plans-content {
-  display: flex;
-  flex-direction: column;
-  gap: 1rem;
-}
-.phase-group {
-  background: white;
-  border-radius: 8px;
-  overflow: hidden;
-}
-.phase-header {
-  padding: 1rem 1.5rem;
-  background: #3498db;
-  color: white;
-  font-weight: 600;
-}
-.plan-item {
-  padding: 1rem 1.5rem;
-  border-bottom: 1px solid #eee;
-}
-.plan-item:last-child {
-  border-bottom: none;
-}
-.plan-title {
-  font-weight: 500;
-  margin-bottom: 0.5rem;
-}
-.plan-summary {
-  font-size: 0.875rem;
-  color: #666;
-}
-/* Wireframes */
-.wireframes-content {
-  background: white;
-  padding: 1.5rem;
-  border-radius: 8px;
-}
-.wireframe-placeholder {
-  padding: 3rem;
-  text-align: center;
-  color: #999;
-  border: 2px dashed #ddd;
-  border-radius: 8px;
-}
-/* Diagrams */
-.diagrams-content {
-  background: white;
-  padding: 1.5rem;
-  border-radius: 8px;
-}
-.diagram-container {
-  margin-bottom: 2rem;
-}
-.diagram-container h3 {
-  margin-bottom: 1rem;
-}
-.mermaid {
-  background: #fafafa;
-  padding: 1rem;
-  border-radius: 4px;
-}
-/* Phase Tabs (sub-navigation within sections) */
-.phase-tabs {
-  display: flex;
-  gap: 0.5rem;
-  margin-bottom: 1.5rem;
-  border-bottom: 2px solid #eee;
-  padding-bottom: 0.5rem;
-}
-.phase-tab {
-  padding: 0.5rem 1rem;
-  background: #f5f5f5;
-  border: 1px solid #ddd;
-  border-radius: 4px 4px 0 0;
-  cursor: pointer;
-  font-size: 0.875rem;
-  color: #666;
-  transition: all 0.2s;
-}
-.phase-tab:hover {
-  background: #e8e8e8;
-}
-.phase-tab.active {
-  background: #3498db;
-  color: white;
-  border-color: #3498db;
-}
-.phase-tab.all-tab {
-  font-weight: 500;
-}
-/* Phase content visibility */
-.phase-content {
-  display: none;
-}
-.phase-content.active {
-  display: block;
-}
-/* No content placeholders */
-.no-content {
-  padding: 3rem;
-  text-align: center;
-  color: #999;
-}

package/specdacular/templates/features/DECISIONS.md DELETED Viewed

@@ -1,109 +0,0 @@
-# Decisions: {feature-name}
-**Feature:** {feature-name}
-**Created:** {YYYY-MM-DD}
-**Last Updated:** {YYYY-MM-DD}
----
-## Active Decisions
-{Decisions currently in effect. These guide implementation.}
-### DEC-001: {Decision Title}
-**Date:** {YYYY-MM-DD}
-**Status:** Active
-**Context:** {What situation required this decision}
-**Decision:** {What was decided}
-**Rationale:**
-- {Reason 1}
-- {Reason 2}
-- {Reason 3}
-**Implications:**
-- {What this means for implementation}
-- {Files or patterns affected}
-**References:**
-- `@{path/to/relevant/code}` (if applicable)
-- {Link to docs or external resource} (if applicable)
----
-### DEC-002: {Decision Title}
-**Date:** {YYYY-MM-DD}
-**Status:** Active
-**Context:** {What situation required this decision}
-**Decision:** {What was decided}
-**Rationale:**
-- {Reason}
-**Implications:**
-- {What this means}
-**References:**
-- {References}
----
-## Superseded Decisions
-{Decisions that were replaced by newer decisions. Kept for history.}
-### DEC-000: {Old Decision Title}
-**Date:** {YYYY-MM-DD}
-**Status:** Superseded by DEC-XXX
-**Original Decision:** {What was originally decided}
-**Why Changed:** {What new information or context led to change}
----
-## Revoked Decisions
-{Decisions that were explicitly cancelled without replacement.}
----
-## Decision Log
-| ID | Date | Title | Status |
-|----|------|-------|--------|
-| DEC-001 | {date} | {title} | Active |
-| DEC-002 | {date} | {title} | Active |
----
-## Decision Template
-Use this format when adding new decisions:
-```markdown
-### DEC-XXX: {Title}
-**Date:** YYYY-MM-DD
-**Status:** Active | Superseded | Revoked
-**Context:** {What situation required a decision}
-**Decision:** {What was decided}
-**Rationale:**
-- {Why - the reasoning}
-**Implications:**
-- {What this means for implementation}
-**References:**
-- {Code paths, docs, etc.}
-```
----
-## Guidelines
-**When to create a decision:**
-- Technology or library choice
-- Architecture pattern choice
-- Scope inclusion/exclusion
-- Approach when multiple valid options exist
-- Constraints discovered during discussion/research
-**Decision ID format:** DEC-{NNN} (three-digit, zero-padded)
-**Status transitions:**
-- Active → Superseded (when replaced by new decision)
-- Active → Revoked (when cancelled without replacement)