teamspec 4.3.1 → 4.3.2

package/lib/linter.js

@@ -79,7 +79,8 @@ class LintResult {
 
 function parseYamlSimple(content) {
     const result = {};
-    const lines = content.split('\n');
+    // Handle both Unix (\n) and Windows (\r\n) line endings
+    const lines = content.split(/\r?\n/);
 
     for (const line of lines) {
         if (!line.trim() || line.trim().startsWith('#')) continue;
@@ -111,7 +112,8 @@ function parseYamlSimple(content) {
  * Parse YAML frontmatter from markdown files
  */
 function parseFrontmatter(content) {
-    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    // Handle both Unix (\n) and Windows (\r\n) line endings
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
     if (!match) return {};
     return parseYamlSimple(match[1]);
 }
@@ -301,6 +303,24 @@ function checkSpecVersion(filePath, frontmatter, result) {
     }
 }
 
+/**
+ * MV-005: title present and valid length (20-40 characters)
+ */
+function checkTitle(filePath, frontmatter, result) {
+    if (!frontmatter.title) {
+        result.add('MV-005', `Missing required frontmatter field: title`, filePath, SEVERITY.ERROR);
+        return;
+    }
+
+    const title = frontmatter.title.toString().trim();
+    const length = title.length;
+    if (length < 20) {
+        result.add('MV-005', `Title "${title}" is too short (${length} chars). Must be 20-40 characters.`, filePath, SEVERITY.ERROR);
+    } else if (length > 40) {
+        result.add('MV-005', `Title "${title.substring(0, 37)}..." is too long (${length} chars). Must be 20-40 characters.`, filePath, SEVERITY.ERROR);
+    }
+}
+
 /**
  * MV-003: role_owner present and valid
  */
@@ -367,7 +387,7 @@ function checkMarkerVocabulary(filePath, result, options = {}) {
         // Skip files without frontmatter (not TeamSpec artifacts)
         if (Object.keys(frontmatter).length === 0) return;
 
-        // MV-001 to MV-004: Frontmatter checks
+        // MV-001 to MV-005: Frontmatter checks
         if (!options.rule || options.rule === 'MV-001') {
             checkArtifactKind(filePath, frontmatter, result);
         }
@@ -380,6 +400,9 @@ function checkMarkerVocabulary(filePath, result, options = {}) {
         if (!options.rule || options.rule === 'MV-004') {
             checkKeywords(filePath, frontmatter, result);
         }
+        if (!options.rule || options.rule === 'MV-005') {
+            checkTitle(filePath, frontmatter, result);
+        }
 
         // MV-010, MV-011: Section checks
         if (!options.rule || options.rule === 'MV-010') {
@@ -820,35 +843,37 @@ function lintProduct(workspaceDir, productId, result, options) {
 
     // TS-PROD-002: product.yml validation
     if (!options.rule || options.rule === 'TS-PROD-002') {
-        const productConfig = checkProductYml(productDir, productId, result);
+        checkProductYml(productDir, productId, result);
+    }
 
-        if (productConfig) {
-            // Lint features naming
-            const featuresDir = path.join(productDir, 'features');
-            if (fs.existsSync(featuresDir)) {
-                const features = fs.readdirSync(featuresDir)
-                    .filter(f => f.endsWith('.md') && !f.toLowerCase().startsWith('readme') && f !== 'features-index.md' && f !== 'story-ledger.md');
-
-                for (const feature of features) {
-                    checkArtifactNaming(path.join(featuresDir, feature), 'feature', result, workspaceDir);
-                    // MV-*: Marker vocabulary checks
-                    if (!options.rule || options.rule.startsWith('MV-')) {
-                        checkMarkerVocabulary(path.join(featuresDir, feature), result, options);
-                    }
-                }
+    // Lint features (naming + marker vocabulary)
+    const featuresDir = path.join(productDir, 'features');
+    if (fs.existsSync(featuresDir)) {
+        const features = fs.readdirSync(featuresDir)
+            .filter(f => f.endsWith('.md') && !f.toLowerCase().startsWith('readme') && f !== 'features-index.md' && f !== 'story-ledger.md');
+
+        for (const feature of features) {
+            if (!options.rule || options.rule === 'TS-NAMING-001') {
+                checkArtifactNaming(path.join(featuresDir, feature), 'feature', result, workspaceDir);
+            }
+            // MV-*: Marker vocabulary checks
+            if (!options.rule || options.rule.startsWith('MV-')) {
+                checkMarkerVocabulary(path.join(featuresDir, feature), result, options);
             }
+        }
+    }
 
-            // Lint regression tests naming
-            const rtDir = path.join(productDir, 'qa', 'regression-tests');
-            if (fs.existsSync(rtDir)) {
-                const rtFiles = fs.readdirSync(rtDir).filter(f => f.endsWith('.md') && !f.toLowerCase().startsWith('readme'));
-                for (const rt of rtFiles) {
-                    checkArtifactNaming(path.join(rtDir, rt), 'product-regression-test', result, workspaceDir);
-                    // MV-*: Marker vocabulary checks
-                    if (!options.rule || options.rule.startsWith('MV-')) {
-                        checkMarkerVocabulary(path.join(rtDir, rt), result, options);
-                    }
-                }
+    // Lint regression tests (naming + marker vocabulary)
+    const rtDir = path.join(productDir, 'qa', 'regression-tests');
+    if (fs.existsSync(rtDir)) {
+        const rtFiles = fs.readdirSync(rtDir).filter(f => f.endsWith('.md') && !f.toLowerCase().startsWith('readme'));
+        for (const rt of rtFiles) {
+            if (!options.rule || options.rule === 'TS-NAMING-001') {
+                checkArtifactNaming(path.join(rtDir, rt), 'product-regression-test', result, workspaceDir);
+            }
+            // MV-*: Marker vocabulary checks
+            if (!options.rule || options.rule.startsWith('MV-')) {
+                checkMarkerVocabulary(path.join(rtDir, rt), result, options);
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamspec",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "description": "CLI tool to bootstrap TeamSpec 4.0 Product-Canon operating model in any repository",
   "main": "lib/cli.js",
   "bin": {
@@ -56,4 +56,4 @@
   "dependencies": {
     "yaml": "^2.8.2"
   }
-}
+}

package/teamspec-core/agents/AGENT_BOOTSTRAP.md

@@ -56,6 +56,36 @@ When creating or editing TeamSpec artifacts:
 7. **Delta-only for stories** — Stories describe changes, NEVER full behavior
 8. **PRX is immutable** — Never change a product's prefix after creation
 9. **Source-lock all claims** — Every statement needs file path + section OR `{TBD}`
+10. **Always include title** — Every artifact MUST have a `title` field in frontmatter (20-40 characters)
+
+#### Title Generation Guidelines
+
+All artifacts require a human-readable `title` field (20-40 characters) for display in teamspec_viewer:
+
+**Requirements:**
+- Length: Exactly 20-40 characters
+- Style: Clear, descriptive noun phrases
+- Format: Title case or sentence case
+- Content: Captures the artifact's essence without technical jargon
+
+**Good Examples:**
+- "Role-Specific Dashboards" (27 chars)
+- "OAuth Login Implementation" (27 chars)
+- "User Authentication Flow" (25 chars)
+- "Payment Gateway Integration" (28 chars)
+- "Quarterly Performance Review" (29 chars)
+
+**Bad Examples:**
+- "Login" (5 chars — too short)
+- "Implementation of a comprehensive user authentication and authorization system" (78 chars — too long)
+- "f-ACME-001-user-auth" (20 chars — uses technical ID)
+- "TODO: Add title here" (20 chars — placeholder)
+
+**Pattern Tips:**
+- Features: "{Capability} {Area}" (e.g., "Advanced Search Filters")
+- Stories: "{Action} {Object}" (e.g., "Add Google OAuth Button")
+- Epics: "{Initiative} {Scope}" (e.g., "Checkout Flow Redesign")
+- Technical: "{Component} {Purpose}" (e.g., "API Rate Limiting Logic")
 
 ### 0.3 Artifact Quick-Lookup
 
@@ -77,6 +107,7 @@ Templates and artifacts contain YAML frontmatter with LLM-relevant metadata:
 ```yaml
 ---
 artifact_kind: feature | story | epic | fi | ...
+title: "Short human-readable title (20-40 chars)"
 keywords: [searchable terms]
 anti_keywords: [terms that indicate wrong artifact]
 links_required: [mandatory relationships]
@@ -108,7 +139,7 @@ When reading or generating artifacts, recognize these standard markers:
 
 | Marker Type | Examples | Purpose |
 |-------------|----------|---------|
-| **Frontmatter** | `artifact_kind`, `role_owner`, `keywords` | Machine-readable metadata |
+| **Frontmatter** | `artifact_kind`, `title`, `role_owner`, `keywords` | Machine-readable metadata |
 | **Section** | `## Purpose`, `## Scope`, `## Current Behavior` | Content boundaries |
 | **Contract** | `> **Contract:**`, `> **Not this:**` | Section rules |
 | **Inline** | `{TBD}`, `BR-XXX-NNN:`, `→ artifact-id` | Specific callouts |

package/teamspec-core/templates/bai-template.md

@@ -3,6 +3,7 @@
 artifact_kind: bai
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short BAI title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: BA

package/teamspec-core/templates/bug-report-template.md

@@ -3,6 +3,7 @@
 artifact_kind: bug
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short bug title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: QA

package/teamspec-core/templates/business-analysis-template.md

@@ -3,6 +3,7 @@
 artifact_kind: ba
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short BA title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: BA

package/teamspec-core/templates/decision-log-template.md

@@ -3,6 +3,7 @@
 artifact_kind: decision
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short decision title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: PO

package/teamspec-core/templates/dev-plan-template.md

@@ -3,6 +3,7 @@
 artifact_kind: devplan
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short dev plan title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: DEV

package/teamspec-core/templates/epic-template.md

@@ -3,6 +3,7 @@
 artifact_kind: epic
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short epic title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: FA

package/teamspec-core/templates/feature-increment-template.md

@@ -3,6 +3,7 @@
 artifact_kind: fi
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short FI title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: FA

package/teamspec-core/templates/feature-template.md

@@ -3,6 +3,7 @@
 artifact_kind: feature
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short feature title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: FA

package/teamspec-core/templates/rt-template.md

@@ -3,6 +3,7 @@
 artifact_kind: rt
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short regression test title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: QA

package/teamspec-core/templates/sd-template.md

@@ -3,6 +3,7 @@
 artifact_kind: sd
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short SD title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: SA

package/teamspec-core/templates/sdi-template.md

@@ -3,6 +3,7 @@
 artifact_kind: sdi
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short SDI title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: SA

package/teamspec-core/templates/story-template.md

@@ -3,6 +3,7 @@
 artifact_kind: story
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short story title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: FA

package/teamspec-core/templates/ta-template.md

@@ -3,6 +3,7 @@
 artifact_kind: ta
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short TA title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: SA

package/teamspec-core/templates/tai-template.md

@@ -3,6 +3,7 @@
 artifact_kind: tai
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short TAI title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: SA

package/teamspec-core/templates/tc-template.md

@@ -3,6 +3,7 @@
 artifact_kind: tc
 spec_version: "4.0"
 template_version: "4.0.1"
+title: "{Short test case title (20-40 chars)}"
 
 # === Ownership ===
 role_owner: QA