@tiqora/tiqora 0.0.3-dev → 0.0.5-dev

package/_tiqora/agents/dev.md

@@ -12,9 +12,9 @@ You must fully embody this agent persona and follow activation rules exactly.
     <step n="2">Load project config from {project-root}/.tiqora.yaml (required).</step>
     <step n="3">Load profile config from ~/.tiqora/config.yaml when available (optional).</step>
     <step n="4">Merge effective config as profile (base) + project (override).</step>
-    <step n="5">Apply defaults when missing: user_name=Developer, idle_threshold_minutes=15, communication_language=Francais, document_language=English.</step>
+    <step n="5">Apply defaults when missing: user_name=Developer, idle_threshold_minutes=15, communication_language=Français, document_language=English.</step>
     <step n="6">Validate required project keys: pm_tool, git_host, branch_pattern. If missing, halt with a blocking error.</step>
-    <step n="7">Communicate in communication_language. Generate artifacts in document_language unless user asks otherwise.</step>
+    <step n="7">Communicate in communication_language. Generate PM documents and reports (Jira, MR Report) in document_language. Keep internal artifacts (runs, challenge) in English.</step>
     <step n="8">Do not start coding from chat only. Route delivery execution through a workflow command.</step>
     <step n="9">When a menu item has workflow="path/to/workflow.yaml": always load {project-root}/_tiqora/core/tasks/workflow.xml, pass workflow-config, then execute all steps in order. If the workflow path does not exist, clearly report it is not implemented yet.</step>
     <step n="10">Apply operational reflexes by default for delivery work: PM MCP context, branch creation/switching, MR preparation, and sync queue handling.</step>

package/_tiqora/agents/pm.md

@@ -12,9 +12,9 @@ You must fully embody this agent persona and follow activation rules exactly.
     <step n="2">Load project config from {project-root}/.tiqora.yaml (required).</step>
     <step n="3">Load profile config from ~/.tiqora/config.yaml when available (optional).</step>
     <step n="4">Merge effective config as profile (base) + project (override).</step>
-    <step n="5">Apply defaults when missing: user_name=Developer, idle_threshold_minutes=15, communication_language=Francais, document_language=English.</step>
+    <step n="5">Apply defaults when missing: user_name=Developer, idle_threshold_minutes=15, communication_language=Français, document_language=English.</step>
     <step n="6">Validate required project keys: pm_tool, git_host, branch_pattern. If missing, halt with a blocking error.</step>
-    <step n="7">Communicate in communication_language. Generate artifacts in document_language unless user asks otherwise.</step>
+    <step n="7">Communicate in communication_language. Generate PM documents in document_language. Keep internal artifacts in English.</step>
     <step n="8">Anchor decisions in user value, measurable outcomes, and scope boundaries.</step>
     <step n="9">When a menu item has workflow="path/to/workflow.yaml": always load {project-root}/_tiqora/core/tasks/workflow.xml, pass workflow-config, then execute all steps in order. If the workflow path does not exist, clearly report it is not implemented yet.</step>
     <step n="10">Apply operational reflexes for product delivery: MCP ticket creation/update, branch naming alignment, MR acceptance quality, and sync fallback.</step>

package/_tiqora/agents/sm.md

@@ -12,9 +12,9 @@ You must fully embody this agent persona and follow activation rules exactly.
     <step n="2">Load project config from {project-root}/.tiqora.yaml (required).</step>
     <step n="3">Load profile config from ~/.tiqora/config.yaml when available (optional).</step>
     <step n="4">Merge effective config as profile (base) + project (override).</step>
-    <step n="5">Apply defaults when missing: user_name=Developer, idle_threshold_minutes=15, communication_language=Francais, document_language=English.</step>
+    <step n="5">Apply defaults when missing: user_name=Developer, idle_threshold_minutes=15, communication_language=Français, document_language=English.</step>
     <step n="6">Validate required project keys: pm_tool, git_host, branch_pattern. If missing, halt with a blocking error.</step>
-    <step n="7">Communicate in communication_language. Keep outputs checklist-oriented and execution-focused.</step>
+    <step n="7">Communicate in communication_language. Generate PM documents in document_language. Keep internal artifacts in English.</step>
     <step n="8">Do not implement code directly. Route development work to /tiq:workflow:dev-story.</step>
     <step n="9">When a menu item has workflow="path/to/workflow.yaml": always load {project-root}/_tiqora/core/tasks/workflow.xml, pass workflow-config, then execute all steps in order. If the workflow path does not exist, clearly report it is not implemented yet.</step>
     <step n="10">Apply operational reflexes for flow control: MCP ticket hygiene, branch policy enforcement, MR readiness gate, and sync queue visibility.</step>

package/_tiqora/workflows/4-implementation/create-story/checklist.md

@@ -70,10 +70,12 @@ validation-criticality: "HIGH"
 - [ ] Includes all discussion details (problem, outcome, ACs, scope, etc).
 - [ ] Includes metadata (pm_tool, git_host, document_language, created_at).
 
-## 9) Communication
+## 9) Communication and Languages
 
-- [ ] Conversation in `communication_language` (natural).
-- [ ] Story document in ENGLISH (clarity for dev).
+- [ ] Conversation with user in `communication_language` (from config).
+- [ ] Story content (Jira ticket, descriptions, comments) in `document_language`.
+- [ ] Internal JSON artifacts (.tiqora/ files) in ENGLISH (agent performance).
+- [ ] Commits in ENGLISH (dev standard).
 - [ ] Clear next steps offered (dev-story, view, etc).
 
 ## Final Result

package/_tiqora/workflows/4-implementation/create-story/instructions.xml

@@ -2,8 +2,9 @@
   <critical>The workflow execution engine is governed by: {project-root}/_tiqora/core/tasks/workflow.xml</critical>
   <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
   <critical>YOU MUST ALWAYS SPEAK OUTPUT in the configured communication_language resolved from merged tiqora config.</critical>
-  <critical>This is a CONVERSATIONAL workflow, not a form. Have a natural discussion with the user.</critical>
-  <critical>Generate story artifact in ENGLISH for clarity, but the conversation is in communication_language.</critical>
+  <critical>Generate all PM-facing content (Jira ticket, descriptions, comments) in {{document_language}}.</critical>
+  <critical>Keep internal data files (.tiqora/ runs, JSON artifacts, field keys) in ENGLISH for agent performance.</critical>
+  <critical>Commits are ALWAYS in ENGLISH (dev standard). This is non-negotiable.</critical>
   <critical>Execute ALL steps in exact order; do NOT skip steps.</critical>
 
   <step n="1" goal="Load configuration">
@@ -88,7 +89,7 @@ Tell me about what you want to build or fix. What's the idea?</ask>
       - Make it clear and searchable
     </action>
 
-    <action>Generate story description (ENGLISH) as a clean summary of our conversation:
+    <action>Generate story description in {{document_language}} as a clean summary of our conversation:
       "## Problem Statement
 
       {{problem_statement}}
@@ -168,37 +169,71 @@ Choose:
   </step>
 
   <step n="7" goal="Create story in PM tool">
-    <critical>Use PM MCP to create the story in Jira/GitHub/GitLab with the info we discussed.</critical>
+    <critical>Use PM MCP to create the story in Jira with the info we discussed. Be explicit about MCP operations.</critical>
+
+    <check if="pm_tool is none">
+      <action>Skip MCP creation (pm_tool is "none").</action>
+      <action>Ensure directory exists: {story_artifact_dir}.</action>
+      <action>Persist story artifact locally to {created_story_file} (JSON) with all the details from our conversation.</action>
+      <output>[WORKFLOW] ⚠ Story saved locally (no PM tool configured)
+      Artifact: {created_story_file}
+      </output>
+      <action>GOTO step 8</action>
+    </check>
 
     <action if="pm_tool is not none">
-      Use PM MCP connector to create story:
-      - Title: {{story_title}}
-      - Description: {{story_description}}
-      - Project: {jira.project_key} or equivalent
+      Create issue in Jira via PM MCP connector:
+      - Action: Create new issue
+      - Project Key: {jira.project_key}
+      - Issue Type: "Story"
+      - Summary: {{story_title}}
+      - Description: {{story_description}} (formatted with all sections from our discussion)
       - Priority: {{priority}}
-      - Type: "Story"
+      - Additional fields: assignee (unassigned for now), labels (use pm_tool if needed)
     </action>
 
-    <check if="story creation succeeds">
-      <action>Capture returned story ID/key as {{ticketId}}.</action>
+    <check if="MCP Jira create issue succeeds">
+      <action>Capture returned issue key/ID as {{ticketId}} (e.g., "EX-123").</action>
       <action>Ensure directory exists: {story_artifact_dir}.</action>
-      <action>Persist story artifact to {created_story_file} (JSON) with all the details from our conversation.</action>
+      <action>Persist story artifact to {created_story_file} (JSON) with:
+        - All conversation details
+        - {{ticketId}} (reference to created Jira issue)
+        - jira_url (link to the issue in Jira)
+        - created_at timestamp
+        - status: "created_in_jira"
+      </action>
+      <action if="pm_tool is not none">Post creation comment to Jira issue in {{document_language}}:
+        "✓ Story created via Tiqora create-story workflow
+
+        Ready for:
+        1. PM challenge gate (run /tiq:workflow:dev-story {{ticketId}})
+        2. Dev implementation (challenge + code)
+
+        Artifact: {created_story_file}"
+      </action>
       <output>[WORKFLOW] ✓ Story created in {{pm_tool}}
-      ID: {{ticketId}}
+      Key: {{ticketId}}
       Artifact: {created_story_file}
       </output>
     </check>
 
-    <check if="story creation fails">
+    <check if="MCP Jira create issue fails">
       <ask>Couldn't create the story in {{pm_tool}}. Want to:
       (retry) Try again?
-      (queue) Save locally and retry later?
+      (queue) Save locally and queue for retry?
       (skip) Just keep it locally for now?</ask>
 
       <check if="user chooses queue">
         <action>Persist story locally with status = "pending_sync".</action>
-        <action>Queue retry in .tiqora/sync/queue.json.</action>
-        <output>⚠ Story saved locally, will try to create in {{pm_tool}} later.</output>
+        <action>Queue retry in .tiqora/sync/queue.json with:
+          - story data: title, description, priority
+          - action: "create_jira_issue"
+          - project_key: {jira.project_key}
+          - retry_count: 0
+        </action>
+        <action>Ensure directory exists: {story_artifact_dir}.</action>
+        <action>Persist story artifact to {created_story_file} with status = "pending_sync".</action>
+        <output>⚠ Story saved locally, will try to create in {{pm_tool}} later via sync queue.</output>
       </check>
 
       <check if="user chooses retry">
@@ -206,8 +241,9 @@ Choose:
       </check>
 
       <check if="user chooses skip">
-        <action>Persist story locally (not created in PM tool yet).</action>
-        <output>Story saved locally. You can create it manually later if needed.</output>
+        <action>Ensure directory exists: {story_artifact_dir}.</action>
+        <action>Persist story locally (not created in PM tool yet) to {created_story_file} with status = "draft".</action>
+        <output>⚠ Story saved locally. Run `tiqora sync` later to create in {{pm_tool}}, or create manually.</output>
       </check>
     </check>
   </step>

package/_tiqora/workflows/4-implementation/dev-story/checklist.md

@@ -94,8 +94,10 @@ validation-criticality: "HIGHEST"
 ## 10) Communication and Languages
 
 - [ ] User-facing communication in `communication_language` (from config).
-- [ ] Technical artifacts (challenge, implementation) in ENGLISH for clarity.
-- [ ] Reports (MR Report, daily, retrospective) in `document_language` for team.
+- [ ] Technical agent artifacts (challenge.md, implementation notes) in ENGLISH for agent performance.
+- [ ] PM-facing content (Jira comments, MR Report) in `document_language`.
+- [ ] Internal data files (.tiqora/ runs, JSON) in ENGLISH (agent performance).
+- [ ] Commits in ENGLISH (dev standard).
 - [ ] Output concise; no unnecessary internal execution noise.
 
 ## 11) Final Artifact Structure

package/_tiqora/workflows/4-implementation/dev-story/instructions.xml

@@ -2,8 +2,9 @@
   <critical>The workflow execution engine is governed by: {project-root}/_tiqora/core/tasks/workflow.xml</critical>
   <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
   <critical>YOU MUST ALWAYS SPEAK OUTPUT in the configured communication_language resolved from merged tiqora config.</critical>
-  <critical>Generate technical artifacts (challenge, implementation, validation) in ENGLISH for clarity.</critical>
-  <critical>Generate developer-facing reports (MR Report, Daily, Retrospective) in document_language from config.</critical>
+  <critical>Generate technical agent artifacts (challenge.md, implementation notes, validation) in ENGLISH for agent performance.</critical>
+  <critical>Generate all PM-facing content (Jira comments, MR Report) in {{document_language}}.</critical>
+  <critical>Commits are ALWAYS in ENGLISH (dev standard). This is non-negotiable.</critical>
   <critical>Execute ALL steps in exact order; do NOT skip steps.</critical>
   <critical>Do not report "completed" until all implementation, validation, and PM sync activities are truly finished.</critical>
 
@@ -95,7 +96,7 @@
     </check>
 
     <check if="ticket is clear and challenge passes">
-      <action if="pm_tool is not none and ticket was retrieved">Post challenge summary comment on ticket (ENGLISH):
+      <action if="pm_tool is not none and ticket was retrieved">Post challenge summary comment on ticket in {{document_language}}:
         "✓ Challenge Gate PASSED
         - Scope: [1-2 sentences on what will be built]
         - Approach: [1-2 sentences on technical direction]
@@ -263,7 +264,7 @@
 
       <!-- STEP 9.4: Push Final Jira Sync -->
       <action if="pm_tool is not none and ticket was retrieved">
-        Add final completion comment to ticket (ENGLISH):
+        Add final completion comment to ticket in {{document_language}}:
         "✓ IMPLEMENTATION COMPLETE
 
         Branch: {{branchName}}

package/dist/index.cjs

@@ -663,8 +663,8 @@ var import_node_os2 = require("os");
 var import_node_path4 = require("path");
 var DEFAULT_IDLE_THRESHOLD_MINUTES = 15;
 var DEFAULT_USER_NAME = "Developer";
-var DEFAULT_COMMUNICATION_LANGUAGE = "fr";
-var DEFAULT_DOCUMENT_LANGUAGE = "fr";
+var DEFAULT_COMMUNICATION_LANGUAGE = "Fran\xE7ais";
+var DEFAULT_DOCUMENT_LANGUAGE = "English";
 var PROJECT_INIT_CONFIG_FILE = ".tiqora.yaml";
 var GLOBAL_USER_CONFIG_FILE = ".tiqora/config.yaml";
 function createProjectInitConfigYaml(answers) {
@@ -672,10 +672,15 @@ function createProjectInitConfigYaml(answers) {
   if (branchPattern.length === 0) {
     throw new Error("Branch pattern cannot be empty.");
   }
+  const documentLanguage = normalizeLanguageValue(
+    answers.documentLanguage ?? DEFAULT_DOCUMENT_LANGUAGE,
+    "document_language"
+  );
   const lines = [
     `pm_tool: ${answers.pmTool}`,
     `git_host: ${answers.gitHost}`,
-    `branch_pattern: '${escapeSingleQuotes(branchPattern)}'`
+    `branch_pattern: '${escapeSingleQuotes(branchPattern)}'`,
+    `document_language: '${escapeSingleQuotes(documentLanguage)}'`
   ];
   if (answers.pmTool === "jira") {
     const jira = answers.jira;
@@ -707,15 +712,10 @@ function createGlobalUserConfigYaml(answers) {
     answers.communicationLanguage ?? DEFAULT_COMMUNICATION_LANGUAGE,
     "communication_language"
   );
-  const documentLanguage = normalizeLanguageValue(
-    answers.documentLanguage ?? DEFAULT_DOCUMENT_LANGUAGE,
-    "document_language"
-  );
   return [
     `user_name: '${escapeSingleQuotes(userName)}'`,
     `idle_threshold_minutes: ${idleThresholdMinutes}`,
     `communication_language: '${escapeSingleQuotes(communicationLanguage)}'`,
-    `document_language: '${escapeSingleQuotes(documentLanguage)}'`,
     ""
   ].join("\n");
 }
@@ -1180,7 +1180,7 @@ async function defaultCollectInitAnswers(context) {
   }
   const branchPatternAnswer = await (0, import_prompts3.text)({
     message: "Branch naming pattern:",
-    defaultValue: context.suggestedBranchPattern,
+    initialValue: context.suggestedBranchPattern,
     placeholder: "feature/*",
     validate(value) {
       if (value.trim().length === 0) {
@@ -1215,9 +1215,8 @@ async function defaultCollectInitAnswers(context) {
     return null;
   }
   const communicationLanguageAnswer = await (0, import_prompts3.text)({
-    message: "Agent response language:",
-    defaultValue: context.existingConfig?.communicationLanguage ?? DEFAULT_COMMUNICATION_LANGUAGE,
-    placeholder: "fr",
+    message: "Agent response language (e.g. Fran\xE7ais, English, Espa\xF1ol):",
+    initialValue: context.existingConfig?.communicationLanguage ?? DEFAULT_COMMUNICATION_LANGUAGE,
     validate(value) {
       if (value.trim().length === 0) {
         return "Language cannot be empty.";
@@ -1230,9 +1229,8 @@ async function defaultCollectInitAnswers(context) {
     return null;
   }
   const documentLanguageAnswer = await (0, import_prompts3.text)({
-    message: "Document output language:",
-    defaultValue: context.existingConfig?.documentLanguage ?? DEFAULT_DOCUMENT_LANGUAGE,
-    placeholder: "fr",
+    message: "Document output language (e.g. Fran\xE7ais, English, Espa\xF1ol):",
+    initialValue: context.existingConfig?.documentLanguage ?? DEFAULT_DOCUMENT_LANGUAGE,
     validate(value) {
       if (value.trim().length === 0) {
         return "Language cannot be empty.";
@@ -1299,8 +1297,8 @@ var PROJECT_CONFIG_FILE = ".tiqora.yaml";
 var GLOBAL_CONFIG_FILE = ".tiqora/config.yaml";
 var MISSING_CONFIG_ERROR_MESSAGE = "\u2717 No .tiqora.yaml found. Run npx tiqora init first.";
 var DEFAULT_USER_NAME2 = "Developer";
-var DEFAULT_COMMUNICATION_LANGUAGE2 = "fr";
-var DEFAULT_DOCUMENT_LANGUAGE2 = "fr";
+var DEFAULT_COMMUNICATION_LANGUAGE2 = "Fran\xE7ais";
+var DEFAULT_DOCUMENT_LANGUAGE2 = "English";
 var REQUIRED_CONFIG_KEYS = [
   "pm_tool",
   "git_host",

package/dist/index.mjs

@@ -671,8 +671,8 @@ import { homedir as homedir2 } from "os";
 import { resolve as resolve4 } from "path";
 var DEFAULT_IDLE_THRESHOLD_MINUTES = 15;
 var DEFAULT_USER_NAME = "Developer";
-var DEFAULT_COMMUNICATION_LANGUAGE = "fr";
-var DEFAULT_DOCUMENT_LANGUAGE = "fr";
+var DEFAULT_COMMUNICATION_LANGUAGE = "Fran\xE7ais";
+var DEFAULT_DOCUMENT_LANGUAGE = "English";
 var PROJECT_INIT_CONFIG_FILE = ".tiqora.yaml";
 var GLOBAL_USER_CONFIG_FILE = ".tiqora/config.yaml";
 function createProjectInitConfigYaml(answers) {
@@ -680,10 +680,15 @@ function createProjectInitConfigYaml(answers) {
   if (branchPattern.length === 0) {
     throw new Error("Branch pattern cannot be empty.");
   }
+  const documentLanguage = normalizeLanguageValue(
+    answers.documentLanguage ?? DEFAULT_DOCUMENT_LANGUAGE,
+    "document_language"
+  );
   const lines = [
     `pm_tool: ${answers.pmTool}`,
     `git_host: ${answers.gitHost}`,
-    `branch_pattern: '${escapeSingleQuotes(branchPattern)}'`
+    `branch_pattern: '${escapeSingleQuotes(branchPattern)}'`,
+    `document_language: '${escapeSingleQuotes(documentLanguage)}'`
   ];
   if (answers.pmTool === "jira") {
     const jira = answers.jira;
@@ -715,15 +720,10 @@ function createGlobalUserConfigYaml(answers) {
     answers.communicationLanguage ?? DEFAULT_COMMUNICATION_LANGUAGE,
     "communication_language"
   );
-  const documentLanguage = normalizeLanguageValue(
-    answers.documentLanguage ?? DEFAULT_DOCUMENT_LANGUAGE,
-    "document_language"
-  );
   return [
     `user_name: '${escapeSingleQuotes(userName)}'`,
     `idle_threshold_minutes: ${idleThresholdMinutes}`,
     `communication_language: '${escapeSingleQuotes(communicationLanguage)}'`,
-    `document_language: '${escapeSingleQuotes(documentLanguage)}'`,
     ""
   ].join("\n");
 }
@@ -1194,7 +1194,7 @@ async function defaultCollectInitAnswers(context) {
   }
   const branchPatternAnswer = await text2({
     message: "Branch naming pattern:",
-    defaultValue: context.suggestedBranchPattern,
+    initialValue: context.suggestedBranchPattern,
     placeholder: "feature/*",
     validate(value) {
       if (value.trim().length === 0) {
@@ -1229,9 +1229,8 @@ async function defaultCollectInitAnswers(context) {
     return null;
   }
   const communicationLanguageAnswer = await text2({
-    message: "Agent response language:",
-    defaultValue: context.existingConfig?.communicationLanguage ?? DEFAULT_COMMUNICATION_LANGUAGE,
-    placeholder: "fr",
+    message: "Agent response language (e.g. Fran\xE7ais, English, Espa\xF1ol):",
+    initialValue: context.existingConfig?.communicationLanguage ?? DEFAULT_COMMUNICATION_LANGUAGE,
     validate(value) {
       if (value.trim().length === 0) {
         return "Language cannot be empty.";
@@ -1244,9 +1243,8 @@ async function defaultCollectInitAnswers(context) {
     return null;
   }
   const documentLanguageAnswer = await text2({
-    message: "Document output language:",
-    defaultValue: context.existingConfig?.documentLanguage ?? DEFAULT_DOCUMENT_LANGUAGE,
-    placeholder: "fr",
+    message: "Document output language (e.g. Fran\xE7ais, English, Espa\xF1ol):",
+    initialValue: context.existingConfig?.documentLanguage ?? DEFAULT_DOCUMENT_LANGUAGE,
     validate(value) {
       if (value.trim().length === 0) {
         return "Language cannot be empty.";
@@ -1313,8 +1311,8 @@ var PROJECT_CONFIG_FILE = ".tiqora.yaml";
 var GLOBAL_CONFIG_FILE = ".tiqora/config.yaml";
 var MISSING_CONFIG_ERROR_MESSAGE = "\u2717 No .tiqora.yaml found. Run npx tiqora init first.";
 var DEFAULT_USER_NAME2 = "Developer";
-var DEFAULT_COMMUNICATION_LANGUAGE2 = "fr";
-var DEFAULT_DOCUMENT_LANGUAGE2 = "fr";
+var DEFAULT_COMMUNICATION_LANGUAGE2 = "Fran\xE7ais";
+var DEFAULT_DOCUMENT_LANGUAGE2 = "English";
 var REQUIRED_CONFIG_KEYS = [
   "pm_tool",
   "git_host",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiqora/tiqora",
-  "version": "0.0.3-dev",
+  "version": "0.0.5-dev",
   "description": "Agentic delivery CLI for solo devs: challenge tickets, orchestrate PM/SM/Dev flows, and keep execution synced.",
   "type": "module",
   "main": "dist/index.cjs",