@shahmarasy/prodo 0.1.5 → 0.1.7

package/dist/core/templates.js

@@ -65,90 +65,90 @@ function schemaTemplate(artifactType) {
 function promptTemplate(artifactType, lang = "en") {
     const tr = lang.toLowerCase().startsWith("tr");
     if (artifactType === "workflow") {
-        return `You are Prodo's artifact generator for WORKFLOW.
-
-Goal:
-- Produce paired workflow outputs for the same flow.
-
-Output contract (STRICT):
-- Return Markdown explanation first (no frontmatter), following required headings exactly.
-- Include actionable flow details and contract tags like [F1].
-- Then append a mandatory Mermaid block for the same flow:
-\`\`\`mermaid
-flowchart TD
-  A --> B
-\`\`\`
-- Do not return prose-only markdown without Mermaid.
-
-Input immutability:
-- Input files are read-only.
-- Do not modify, rewrite, summarize, or optimize \`brief.md\`.
-
-Language contract:
-- Output text in requested language from inputContext.outputLanguage.
-- If outputLanguage is "tr", every sentence and heading MUST be Turkish.
-- Never mix Turkish and English in the same artifact.
-
-Quality bar:
-- Main flow must be implementation-ready.
+        return `You are Prodo's artifact generator for WORKFLOW.
+
+Goal:
+- Produce paired workflow outputs for the same flow.
+
+Output contract (STRICT):
+- Return Markdown explanation first (no frontmatter), following required headings exactly.
+- Include actionable flow details and contract tags like [F1].
+- Then append a mandatory Mermaid block for the same flow:
+\`\`\`mermaid
+flowchart TD
+  A --> B
+\`\`\`
+- Do not return prose-only markdown without Mermaid.
+
+Input immutability:
+- Input files are read-only.
+- Do not modify, rewrite, summarize, or optimize \`brief.md\`.
+
+Language contract:
+- Output text in requested language from inputContext.outputLanguage.
+- If outputLanguage is "tr", every sentence and heading MUST be Turkish.
+- Never mix Turkish and English in the same artifact.
+
+Quality bar:
+- Main flow must be implementation-ready.
 - Edge cases and postconditions must be explicit.`;
     }
     if (artifactType === "wireframe") {
-        return `You are Prodo's artifact generator for WIREFRAME.
-
-Goal:
-- Produce a human-readable wireframe explanation in Markdown.
-
-Output contract (STRICT):
-- Return Markdown body only (no frontmatter).
-- Include all required headings exactly as provided.
-- Describe one concrete screen at a time with actionable details.
-- HTML wireframe is generated by Prodo as a companion .html file; do not output raw HTML as primary markdown body.
-
-Input immutability:
-- Input files are read-only.
-- Do not modify, rewrite, summarize, or optimize \`brief.md\`.
-
-Language contract:
-- Output text in requested language from inputContext.outputLanguage.
-- If outputLanguage is "tr", every sentence and heading MUST be Turkish.
-- Never mix Turkish and English in the same artifact.
-
-Quality bar:
-- Keep sections concise but specific.
+        return `You are Prodo's artifact generator for WIREFRAME.
+
+Goal:
+- Produce a human-readable wireframe explanation in Markdown.
+
+Output contract (STRICT):
+- Return Markdown body only (no frontmatter).
+- Include all required headings exactly as provided.
+- Describe one concrete screen at a time with actionable details.
+- HTML wireframe is generated by Prodo as a companion .html file; do not output raw HTML as primary markdown body.
+
+Input immutability:
+- Input files are read-only.
+- Do not modify, rewrite, summarize, or optimize \`brief.md\`.
+
+Language contract:
+- Output text in requested language from inputContext.outputLanguage.
+- If outputLanguage is "tr", every sentence and heading MUST be Turkish.
+- Never mix Turkish and English in the same artifact.
+
+Quality bar:
+- Keep sections concise but specific.
 - Ensure actions/states/messages are testable and implementation-relevant.`;
     }
-    return `You are Prodo's artifact generator for ${artifactType.toUpperCase()}.
-
-Goal:
-- Produce a decision-ready product artifact from normalized brief and upstream artifacts.
-
-Output contract:
-- Return only Markdown body (NO YAML frontmatter).
-- Keep all required section headings exactly as provided.
-- When referencing brief contracts, use explicit tags like [G1], [F2], [C1].
-- Use concrete statements, avoid placeholders like "TBD" unless unavoidable.
-- Reference upstream constraints and tradeoffs explicitly.
-
-Input immutability:
-- Input files are read-only.
-- Do not modify, rewrite, summarize, or optimize \`brief.md\`.
-
-Language contract:
-- Output text in requested language from inputContext.outputLanguage.
-- If outputLanguage is "tr", every sentence and heading MUST be Turkish.
-- Never mix Turkish and English in the same artifact.
-- Do not translate or change required headings unless outputLanguage is "tr" and Turkish headings are provided.
-
-Quality bar:
-- Every section must contain actionable content.
-- Include assumptions and risks where relevant.
-- Keep content concise but implementation-ready.
-
-Required headings:
-${(0, constants_1.defaultRequiredHeadings)(artifactType).map((heading) => `- ${heading}`).join("\n")}
-
-When data is missing:
+    return `You are Prodo's artifact generator for ${artifactType.toUpperCase()}.
+
+Goal:
+- Produce a decision-ready product artifact from normalized brief and upstream artifacts.
+
+Output contract:
+- Return only Markdown body (NO YAML frontmatter).
+- Keep all required section headings exactly as provided.
+- When referencing brief contracts, use explicit tags like [G1], [F2], [C1].
+- Use concrete statements, avoid placeholders like "TBD" unless unavoidable.
+- Reference upstream constraints and tradeoffs explicitly.
+
+Input immutability:
+- Input files are read-only.
+- Do not modify, rewrite, summarize, or optimize \`brief.md\`.
+
+Language contract:
+- Output text in requested language from inputContext.outputLanguage.
+- If outputLanguage is "tr", every sentence and heading MUST be Turkish.
+- Never mix Turkish and English in the same artifact.
+- Do not translate or change required headings unless outputLanguage is "tr" and Turkish headings are provided.
+
+Quality bar:
+- Every section must contain actionable content.
+- Include assumptions and risks where relevant.
+- Keep content concise but implementation-ready.
+
+Required headings:
+${(0, constants_1.defaultRequiredHeadings)(artifactType).map((heading) => `- ${heading}`).join("\n")}
+
+When data is missing:
 ${tr ? "- varsayim yaparken Turkce yaz\n- varsayimi ilgili bolumde acikca belirt" : "- infer a sensible default\n- state the assumption clearly in the relevant section"}`;
 }
 function artifactTemplateTemplate(artifactType, lang = "en") {
@@ -191,38 +191,38 @@ function artifactTemplateTemplate(artifactType, lang = "en") {
         ].join("\n");
     }
     if (artifactType === "wireframe") {
-        return `<!doctype html>
-<html lang="${tr ? "tr" : "en"}">
-<head>
-  <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <title>${tr ? "Wireframe Ekrani" : "Wireframe Screen"}</title>
-</head>
-<body>
-  <header>
-    <h1>${tr ? "Ekran Basligi" : "Screen Title"}</h1>
-    <nav>
-      <button type="button">${tr ? "Geri" : "Back"}</button>
-      <button type="button">${tr ? "Devam" : "Next"}</button>
-    </nav>
-  </header>
-  <main>
-    <section>
-      <h2>${tr ? "Birincil Icerik" : "Primary Content"}</h2>
-      <ul>
-        <li>${tr ? "Durum ozeti" : "Status summary"}</li>
-        <li>${tr ? "Aksiyon alani" : "Action area"}</li>
-      </ul>
-    </section>
-    <section>
-      <h2>${tr ? "Form" : "Form"}</h2>
-      <form>
-        <label>${tr ? "Alan" : "Field"} <input type="text" /></label>
-        <button type="submit">${tr ? "Kaydet" : "Save"}</button>
-      </form>
-    </section>
-  </main>
-</body>
+        return `<!doctype html>
+<html lang="${tr ? "tr" : "en"}">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${tr ? "Wireframe Ekrani" : "Wireframe Screen"}</title>
+</head>
+<body>
+  <header>
+    <h1>${tr ? "Ekran Basligi" : "Screen Title"}</h1>
+    <nav>
+      <button type="button">${tr ? "Geri" : "Back"}</button>
+      <button type="button">${tr ? "Devam" : "Next"}</button>
+    </nav>
+  </header>
+  <main>
+    <section>
+      <h2>${tr ? "Birincil Icerik" : "Primary Content"}</h2>
+      <ul>
+        <li>${tr ? "Durum ozeti" : "Status summary"}</li>
+        <li>${tr ? "Aksiyon alani" : "Action area"}</li>
+      </ul>
+    </section>
+    <section>
+      <h2>${tr ? "Form" : "Form"}</h2>
+      <form>
+        <label>${tr ? "Alan" : "Field"} <input type="text" /></label>
+        <button type="submit">${tr ? "Kaydet" : "Save"}</button>
+      </form>
+    </section>
+  </main>
+</body>
 </html>`;
     }
     if (artifactType === "stories") {
@@ -271,28 +271,28 @@ function artifactTemplateTemplate(artifactType, lang = "en") {
     ].join("\n");
     return fallbackTemplate;
 }
-exports.START_BRIEF_TEMPLATE = `# Product Brief
-
-## Product Name
-Example Product
-
-## Problem
-Describe the user problem.
-
-## Audience
-Who this product is for.
-
-## Core Features
-- Feature A
-- Feature B
-
-## Goals
-- Goal 1
-- Goal 2
-
-## Constraints
-- Budget or timeline constraints
-- Compliance or technical constraints
+exports.START_BRIEF_TEMPLATE = `# Product Brief
+
+## Product Name
+Example Product
+
+## Problem
+Describe the user problem.
+
+## Audience
+Who this product is for.
+
+## Core Features
+- Feature A
+- Feature B
+
+## Goals
+- Goal 1
+- Goal 2
+
+## Constraints
+- Budget or timeline constraints
+- Compliance or technical constraints
 `;
 exports.NORMALIZED_BRIEF_TEMPLATE = {
     schema_version: "1.0",
@@ -315,126 +315,126 @@ exports.NORMALIZED_BRIEF_TEMPLATE = {
         constraints: [{ id: "C1", text: "Constraint 1" }]
     }
 };
-exports.NORMALIZE_PROMPT_TEMPLATE = `Normalize start-brief content into JSON.
-
-Return JSON object with keys:
-- schema_version (string)
-- product_name (string)
-- problem (string)
-- audience (string[])
-- goals (string[])
-- core_features (string[])
-- constraints (string[])
-- assumptions (string[])
-- contracts.goals[] ({id,text})
-- contracts.core_features[] ({id,text})
-- contracts.constraints[] ({id,text})
-- confidence.product_name (0..1)
-- confidence.problem (0..1)
-- confidence.audience (0..1)
-- confidence.goals (0..1)
-- confidence.core_features (0..1)
-
-Rules:
-- do NOT invent missing critical content
-- keep wording concise and concrete
-- preserve original language and Unicode characters exactly from brief
-- never transliterate Turkish letters (ç, ğ, ı, İ, ö, ş, ü) into ASCII
-- if critical field is missing, return empty and low confidence (<0.7)
-- assign deterministic IDs: goals => G1..Gn, features => F1..Fn, constraints => C1..Cn
-- input files are read-only; never modify, summarize, or rewrite \`brief.md\` in-place
+exports.NORMALIZE_PROMPT_TEMPLATE = `Normalize start-brief content into JSON.
+
+Return JSON object with keys:
+- schema_version (string)
+- product_name (string)
+- problem (string)
+- audience (string[])
+- goals (string[])
+- core_features (string[])
+- constraints (string[])
+- assumptions (string[])
+- contracts.goals[] ({id,text})
+- contracts.core_features[] ({id,text})
+- contracts.constraints[] ({id,text})
+- confidence.product_name (0..1)
+- confidence.problem (0..1)
+- confidence.audience (0..1)
+- confidence.goals (0..1)
+- confidence.core_features (0..1)
+
+Rules:
+- do NOT invent missing critical content
+- keep wording concise and concrete
+- preserve original language and Unicode characters exactly from brief
+- never transliterate Turkish letters (ç, ğ, ı, İ, ö, ş, ü) into ASCII
+- if critical field is missing, return empty and low confidence (<0.7)
+- assign deterministic IDs: goals => G1..Gn, features => F1..Fn, constraints => C1..Cn
+- input files are read-only; never modify, summarize, or rewrite \`brief.md\` in-place
 - write normalized output as a new JSON object only`;
 function commandTemplate(command) {
     const normalizeJsonGuard = command.cliSubcommand === "normalize"
-        ? `
-- Normalize output format check:
-  - \`.prodo/briefs/normalized-brief.json\` must be strict JSON object (no markdown fences).
+        ? `
+- Normalize output format check:
+  - \`.prodo/briefs/normalized-brief.json\` must be strict JSON object (no markdown fences).
   - If invalid, rewrite file as pure JSON object only.`
         : "";
-    return `---
-description: ${command.description}
-handoffs:
-  - label: Continue Workflow
-    agent: prodo-next
-    prompt: Continue with the next Prodo command in sequence.
-    send: true
----
-
-## User Input
-
-\`\`\`text
-$ARGUMENTS
-\`\`\`
-
-Execution policy:
-- Execute-first, diagnose-second.
-- Perform only minimal prerequisite checks before execution.
-- Do not run shell commands or CLI commands from inside the agent.
-- Never run \`prodo-${command.cliSubcommand}\`, \`prodo ${command.cliSubcommand}\`, or \`prodo ...\` in shell.
-- Do not inspect hooks or internals unless command execution fails.
-- Input files are read-only; never modify or rewrite \`brief.md\`.
-- Never print full artifact content in chat.
-- Write/update files first, then reply with short status + written file path(s).
-
-## Execution
-
-1. Minimal prerequisites only:
-- Confirm project is initialized (\`.prodo/\` exists).
-- Confirm required input files for \`${command.cliSubcommand}\` exist.
-- Confirm output location is writable.
-
-2. Execute immediately:
-- Execute the \`${command.cliSubcommand}\` process directly using workspace files and Prodo rules.
-- Keep narration short and action-oriented.
-
-3. Verify result:
-- Confirm expected output file(s) were created/updated under \`product-docs/\` (or \`.prodo/briefs\` for normalize).
-- Confirm command success state (exit code or validation status).
-- Confirm \`brief.md\` hash/content did not change.
-- Do NOT create manual fallback files under \`.prodo/artifact\` or any ad-hoc folder.
-${normalizeJsonGuard}
-
-4. Diagnose only on failure:
-- Inspect \`.prodo/hooks.yml\` only after execution failure.
-- Explain root cause and next fix steps briefly.
-
-## Handoff
-
+    return `---
+description: ${command.description}
+handoffs:
+  - label: Continue Workflow
+    agent: prodo-next
+    prompt: Continue with the next Prodo command in sequence.
+    send: true
+---
+
+## User Input
+
+\`\`\`text
+$ARGUMENTS
+\`\`\`
+
+Execution policy:
+- Execute-first, diagnose-second.
+- Perform only minimal prerequisite checks before execution.
+- Do not run shell commands or CLI commands from inside the agent.
+- Never run \`prodo-${command.cliSubcommand}\`, \`prodo ${command.cliSubcommand}\`, or \`prodo ...\` in shell.
+- Do not inspect hooks or internals unless command execution fails.
+- Input files are read-only; never modify or rewrite \`brief.md\`.
+- Never print full artifact content in chat.
+- Write/update files first, then reply with short status + written file path(s).
+
+## Execution
+
+1. Minimal prerequisites only:
+- Confirm project is initialized (\`.prodo/\` exists).
+- Confirm required input files for \`${command.cliSubcommand}\` exist.
+- Confirm output location is writable.
+
+2. Execute immediately:
+- Execute the \`${command.cliSubcommand}\` process directly using workspace files and Prodo rules.
+- Keep narration short and action-oriented.
+
+3. Verify result:
+- Confirm expected output file(s) were created/updated under \`product-docs/\` (or \`.prodo/briefs\` for normalize).
+- Confirm command success state (exit code or validation status).
+- Confirm \`brief.md\` hash/content did not change.
+- Do NOT create manual fallback files under \`.prodo/artifact\` or any ad-hoc folder.
+${normalizeJsonGuard}
+
+4. Diagnose only on failure:
+- Inspect \`.prodo/hooks.yml\` only after execution failure.
+- Explain root cause and next fix steps briefly.
+
+## Handoff
+
 Suggest the next slash command explicitly (for example: \`/prodo-prd\`, \`/prodo-workflow\`).`;
 }
-exports.HOOKS_TEMPLATE = `# Hook item fields:
-# - command: string (required)
-# - optional: boolean (default false)
-# - enabled: boolean (default true)
-# - condition: shell command; run hook only if condition exits 0
-# - timeout_ms: per-attempt timeout in milliseconds (default 30000)
-# - retry: extra retry count after first attempt (default 0)
-# - retry_delay_ms: delay between retries (default 500)
-#
-# Example:
-# hooks:
-#   before_prd:
-#     - command: "node -e \\"console.log('lint ok')\\""
-#       optional: false
-#       enabled: true
-#       condition: "node -e \\"process.exit(0)\\""
-#       timeout_ms: 15000
-#       retry: 1
-#       retry_delay_ms: 300
-
-hooks:
-  before_normalize: []
-  after_normalize: []
-  before_prd: []
-  after_prd: []
-  before_workflow: []
-  after_workflow: []
-  before_wireframe: []
-  after_wireframe: []
-  before_stories: []
-  after_stories: []
-  before_techspec: []
-  after_techspec: []
-  before_validate: []
-  after_validate: []
+exports.HOOKS_TEMPLATE = `# Hook item fields:
+# - command: string (required)
+# - optional: boolean (default false)
+# - enabled: boolean (default true)
+# - condition: shell command; run hook only if condition exits 0
+# - timeout_ms: per-attempt timeout in milliseconds (default 30000)
+# - retry: extra retry count after first attempt (default 0)
+# - retry_delay_ms: delay between retries (default 500)
+#
+# Example:
+# hooks:
+#   before_prd:
+#     - command: "node -e \\"console.log('lint ok')\\""
+#       optional: false
+#       enabled: true
+#       condition: "node -e \\"process.exit(0)\\""
+#       timeout_ms: 15000
+#       retry: 1
+#       retry_delay_ms: 300
+
+hooks:
+  before_normalize: []
+  after_normalize: []
+  before_prd: []
+  after_prd: []
+  before_workflow: []
+  after_workflow: []
+  before_wireframe: []
+  after_wireframe: []
+  before_stories: []
+  after_stories: []
+  before_techspec: []
+  after_techspec: []
+  before_validate: []
+  after_validate: []
 `;

package/dist/i18n/en.json

@@ -1,45 +1,45 @@
-{
-  "user_action": "User action",
-  "main_flow": "Main Flow",
-  "user": "User",
-  "success": "Success",
-  "error": "Error",
-  "flow_focus": "Flow Focus",
-  "initial_version": "Initial version",
-  "fix_revision": "Post-validation fix revision",
-  "primary_user": "Primary user",
-  "back": "Back",
-  "next": "Next",
-  "save": "Save",
-  "content": "Content",
-  "primary_info_area": "Primary information area",
-  "status_indicator": "Status indicator",
-  "form": "Form",
-  "field": "Field",
-  "description": "Description",
-  "contract": "Contract",
-  "actor": "Actor",
-  "detailed_input_area": "Detailed Input Area",
-  "upload_area": "Upload Area",
-  "low_fidelity_wireframe": "Low-fidelity wireframe.",
-  "confirmation_text": "Confirmation text",
-  "header_and_navigation": "Header and navigation",
-  "content_section": "Content section",
-  "form_section": "Form section",
-  "text_input": "Text input",
-  "to_be_refined": "To be refined.",
-  "note": "Note",
-  "requirement_item": "Requirement item",
-  "contract_coverage": "Contract coverage",
-  "screen": "Screen",
-  "for_artifact": "for",
-  "fix_proposal": "Fix Proposal",
-  "fix_complete": "Fix complete — validation passed.",
-  "fix_still_failing": "Fix applied but validation still failing.",
-  "fix_cancelled": "Fix cancelled.",
-  "no_issues": "No blocking issues found. Nothing to fix.",
-  "issues_found": "Issues found",
-  "artifacts_to_regenerate": "Artifacts to regenerate",
-  "general": "General",
-  "suggestion_prefix": "→"
-}
+{
+  "user_action": "User action",
+  "main_flow": "Main Flow",
+  "user": "User",
+  "success": "Success",
+  "error": "Error",
+  "flow_focus": "Flow Focus",
+  "initial_version": "Initial version",
+  "fix_revision": "Post-validation fix revision",
+  "primary_user": "Primary user",
+  "back": "Back",
+  "next": "Next",
+  "save": "Save",
+  "content": "Content",
+  "primary_info_area": "Primary information area",
+  "status_indicator": "Status indicator",
+  "form": "Form",
+  "field": "Field",
+  "description": "Description",
+  "contract": "Contract",
+  "actor": "Actor",
+  "detailed_input_area": "Detailed Input Area",
+  "upload_area": "Upload Area",
+  "low_fidelity_wireframe": "Low-fidelity wireframe.",
+  "confirmation_text": "Confirmation text",
+  "header_and_navigation": "Header and navigation",
+  "content_section": "Content section",
+  "form_section": "Form section",
+  "text_input": "Text input",
+  "to_be_refined": "To be refined.",
+  "note": "Note",
+  "requirement_item": "Requirement item",
+  "contract_coverage": "Contract coverage",
+  "screen": "Screen",
+  "for_artifact": "for",
+  "fix_proposal": "Fix Proposal",
+  "fix_complete": "Fix complete — validation passed.",
+  "fix_still_failing": "Fix applied but validation still failing.",
+  "fix_cancelled": "Fix cancelled.",
+  "no_issues": "No blocking issues found. Nothing to fix.",
+  "issues_found": "Issues found",
+  "artifacts_to_regenerate": "Artifacts to regenerate",
+  "general": "General",
+  "suggestion_prefix": "→"
+}