@k0t0vich/meta-agents-template 0.1.9 → 0.1.11

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.1.11 - 2026-03-20
+
+### Added
+- Added a hard pre-implementation command `VERIFY_IMPLEMENTATION_GATE` to enforce task readiness before coding starts.
+- Added canonical Status Agent output contract (6 required sections) and corresponding smoke validation.
+- Added robust empty-repository branch-routing behavior for `meta:task-start --apply` (no-commit bootstrap path).
+
+### Fixed
+- Fixed TrackerGateway local script resolution for `PREPARE_TASK_BRANCH`, `RUN_MR_REVIEW_GATE`, and `VERIFY_IMPLEMENTATION_GATE` in npm-linked execution mode.
+- Enforced structured verifiability schema (`strict`, `statistical`, `human`) for task creation and `SET_STATUS -> IN_PROGRESS`.
+- Expanded local post-publish smoke checks for source repo, generated project, and unborn repository scenarios.
+
+## 0.1.10 - 2026-03-20
+
+### Fixed
+- Implemented GitHub TrackerGateway adapter operations instead of `not implemented` stubs (`CREATE_TASK`, `SET_STATUS`, `ASSIGN_SPRINT`, `COMMIT_BY_NAME`).
+- Added safe `dryRun` support for GitHub tracker operations to validate flows without side effects.
+- Added smoke regression check for `meta:ops CREATE_TASK` (dry-run) to prevent future regressions where command exists but adapter is stubbed.
+
 ## 0.1.9 - 2026-03-20
 
 ### Fixed

package/README.md

@@ -83,13 +83,14 @@ my-project/
 1. `CREATE_TASK`
 2. `PREPARE_TASK_BRANCH`
 3. `SET_STATUS`
-4. `RUN_REVIEW_GATE`
-5. `COMMIT_BY_NAME`
-6. `RUN_MR_REVIEW_GATE`
-7. `ASSIGN_SPRINT`
-8. `PREPARE_RELEASE_NOTE`
-9. `MARK_TASKS_PUBLISH`
-10. `STATUS_SNAPSHOT`
+4. `VERIFY_IMPLEMENTATION_GATE`
+5. `RUN_REVIEW_GATE`
+6. `COMMIT_BY_NAME`
+7. `RUN_MR_REVIEW_GATE`
+8. `ASSIGN_SPRINT`
+9. `PREPARE_RELEASE_NOTE`
+10. `MARK_TASKS_PUBLISH`
+11. `STATUS_SNAPSHOT`
 
 `VERIFY_GOVERNANCE_GATE` выполняет `Governance Watchdog Agent` перед любой операцией и блокирует выполнение при нарушении PRD/acceptance/user-confirmation правил.
 `RUN_REVIEW_GATE` выполняет `Reviewer/Judge Agent` перед коммитом:
@@ -140,6 +141,7 @@ npm run self:bootstrap
 npm run meta:verify
 npm run meta:branch
 npm run meta:task-start -- --task #12 --slug api-redirect
+npm run meta:implementation-gate -- --task #12
 npm run meta:review
 npm run meta:review-approve
 npm run meta:mr-review
@@ -155,6 +157,7 @@ npm run meta:status
 `meta:task-start` делает branch-routing preflight: сравнивает задачу с текущей веткой, показывает dirty/ahead блокеры и готовит маршрут (`stay_on_current_branch` или `create_new_branch`).
 `meta:task-start` также делает context-protection check для `AGENTS.md` (fallback: `agents.md`) между текущей и базовой веткой и требует явного подтверждения при diff.
 Именование branch task ref: использовать GitHub issue ref в формате `issue-<number>`.
+`meta:implementation-gate` блокирует старт реализации, если не выполнены условия `IN_PROGRESS + PRD sections + structured verifiability(strict/statistical/human) + branch alignment`.
 `meta:mr-review` формирует сводный pre-merge отчёт по MR/PR, `meta:mr-review-approve` фиксирует финальный PASS после подтверждения пользователя.
 `meta:status` отдаёт единый статус-срез: trackers used, current sprint, current task, current branch context, git uncommitted и summary.
 В `github` режиме локальные `tasks/*` по умолчанию считаются cache/legacy и не являются источником истины.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k0t0vich/meta-agents-template",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Template system for verification-first agentic development",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
     "meta:status": "node template/.meta-agents/scripts/sync-status.mjs",
     "meta:branch": "node template/.meta-agents/scripts/verify-branch-strategy.mjs",
     "meta:task-start": "node template/.meta-agents/scripts/task-branch-router.mjs",
+    "meta:implementation-gate": "node template/.meta-agents/scripts/verify-implementation-gate.mjs",
     "meta:verify": "node template/.meta-agents/scripts/verify-governance.mjs",
     "meta:review": "node template/.meta-agents/scripts/run-review-gate.mjs",
     "meta:review-approve": "node template/.meta-agents/scripts/run-review-gate.mjs --approve yes",

package/src/init.mjs

@@ -110,6 +110,7 @@ function buildMetaScripts(packageName) {
     "meta:status": `${base}/sync-status.mjs`,
     "meta:branch": `${base}/verify-branch-strategy.mjs`,
     "meta:task-start": `${base}/task-branch-router.mjs`,
+    "meta:implementation-gate": `${base}/verify-implementation-gate.mjs`,
     "meta:verify": `${base}/verify-governance.mjs`,
     "meta:review": `${base}/run-review-gate.mjs`,
     "meta:review-approve": `${base}/run-review-gate.mjs --approve yes`,
@@ -217,14 +218,19 @@ async function mergePackageJsonMeta({
 
 function buildAgentsLinkBlock(packageName) {
   const packageRoot = `./node_modules/${packageName}`;
+  const templateAgentsPath = `${packageRoot}/template/agents.md`;
+  const trackerTemplatePath = `${packageRoot}/template/tracker-command-template.md`;
   const lines = [
     AGENTS_LINK_BLOCK_START,
     "## Meta Agents Template (npm-linked)",
     "ОБЯЗАТЕЛЬНО: перед выполнением любой команды сначала прочитай canonical rules по ссылкам ниже.",
     "При конфликте локального текста и шаблона приоритет у canonical files из node_modules.",
     "Базовые правила шаблона:",
-    `- [Template agents.md](${packageRoot}/template/agents.md)`,
-    `- [Template tracker-command-template.md](${packageRoot}/template/tracker-command-template.md)`,
+    `- [Template agents.md](${templateAgentsPath})`,
+    `- [Template tracker-command-template.md](${trackerTemplatePath})`,
+    "Canonical files (read by path in this exact order):",
+    `1. \`${templateAgentsPath}\``,
+    `2. \`${trackerTemplatePath}\``,
     "Локальные конфиги проекта:",
     "- [.meta-agents/config/project-context.yaml](./.meta-agents/config/project-context.yaml)",
     "- [.meta-agents/config/trackers.yaml](./.meta-agents/config/trackers.yaml)",

package/template/.meta-agents/config/system.yaml

@@ -103,6 +103,7 @@ system:
         required: true
         required_before_commands:
           - CREATE_TASK
+          - VERIFY_IMPLEMENTATION_GATE
           - SET_STATUS
           - COMMIT_BY_NAME
         routing_command: "meta:task-start"
@@ -160,6 +161,7 @@ system:
       required: true
       before_commands:
         - VERIFY_GOVERNANCE_GATE
+        - VERIFY_IMPLEMENTATION_GATE
         - CREATE_TASK
         - PREPARE_TASK_BRANCH
         - SET_STATUS
@@ -225,6 +227,7 @@ system:
       - evidence_pack_complete
       - tracker_sync_complete
       - branch_routing_dialog_completed
+      - implementation_gate_passed
       - branch_routing_e2e_verified
       - agents_context_consistency_verified
       - watchdog_gate_passed

package/template/.meta-agents/scripts/sync-status.mjs

@@ -568,23 +568,29 @@ async function main() {
 
   console.log("# Status Snapshot");
   console.log("");
-  console.log("## Trackers");
+  console.log("## 1) Trackers Used");
   console.log(`- locked provider: ${report.tracker.lockedProvider}`);
   console.log(`- available providers: ${report.tracker.availableProviders.join(", ") || "unknown"}`);
   console.log(`- workflow source: ${report.tracker.workflowSource}`);
 
   console.log("");
-  console.log("## Process");
-  console.log(`- current sprint: ${report.process.currentSprint}`);
-  console.log(`- current task: ${report.process.currentTask}`);
-  console.log(`- current task ref: ${report.process.currentTaskRef}`);
-  console.log(`- branch/task alignment: ${report.process.branchTaskAlignment}`);
+  console.log("## 2) Current Sprint");
+  console.log(`- ${report.process.currentSprint}`);
 
   console.log("");
-  console.log("## Git");
+  console.log("## 3) Current Task");
+  console.log(`- task: ${report.process.currentTask}`);
+  console.log(`- task ref: ${report.process.currentTaskRef}`);
+
+  console.log("");
+  console.log("## 4) Current Branch Context");
   console.log(`- branch: ${report.git.branch}`);
   console.log(`- branch type: ${report.git.branchType}`);
   console.log(`- branch task ref: ${report.git.branchTaskRef}`);
+  console.log(`- task/branch alignment: ${report.process.branchTaskAlignment}`);
+
+  console.log("");
+  console.log("## 5) Git Uncommitted");
   console.log(`- upstream: ${report.git.upstream}`);
   console.log(`- ahead/behind: ${report.git.ahead}/${report.git.behind}`);
   console.log(`- modified_or_staged: ${report.git.modifiedOrStaged}`);
@@ -601,7 +607,7 @@ async function main() {
   }
 
   console.log("");
-  console.log("## Summary");
+  console.log("## 6) Summary");
   if (report.summary.length === 0) {
     console.log("- no additional notes");
   } else {

package/template/.meta-agents/scripts/task-branch-router.mjs

@@ -163,6 +163,7 @@ function collectGitContext() {
     branch,
     branchType: classifyBranch(branch),
     branchTaskRef: extractBranchTaskRef(branch),
+    hasCommits: hasCommits(),
     upstream: parsed.upstream || "not configured",
     ahead: parsed.ahead,
     behind: parsed.behind,
@@ -259,6 +260,10 @@ function hasRef(ref) {
   return Boolean(git(["show-ref", "--verify", ref], true));
 }
 
+function hasCommits() {
+  return Boolean(git(["rev-parse", "--verify", "HEAD"], true));
+}
+
 function hasOrigin() {
   return Boolean(git(["remote", "get-url", "origin"], true));
 }
@@ -333,6 +338,25 @@ function executePlan(plan, gitContext) {
     git(["fetch", "origin"], false);
   }
 
+  if (!gitContext.hasCommits) {
+    const baseRemote = hasRef(`refs/remotes/origin/${baseBranch}`);
+    if (baseRemote) {
+      git(["checkout", "-b", baseBranch, "--track", `origin/${baseBranch}`], false);
+    } else if (gitContext.branch !== baseBranch) {
+      git(["checkout", "-B", baseBranch], false);
+    }
+
+    if (plan.targetBranch !== baseBranch) {
+      git(["checkout", "-B", plan.targetBranch], false);
+    }
+
+    return {
+      changedBranch: plan.targetBranch !== gitContext.branch,
+      branch: plan.targetBranch,
+      message: `Repository has no commits yet. Bootstrapped branch routing and switched to '${plan.targetBranch}'.`,
+    };
+  }
+
   const baseLocal = hasRef(`refs/heads/${baseBranch}`);
   const baseRemote = hasRef(`refs/remotes/origin/${baseBranch}`);
 
@@ -411,12 +435,27 @@ function buildPlan(options, gitContext) {
     requiresDialogue.push(
       "Задача атомарная и относится к текущей feature-ветке. Подтвердите, что продолжаем работу в этой ветке.",
     );
+  } else if (!gitContext.hasCommits) {
+    requiresDialogue.push(
+      "Репозиторий без коммитов. Подтвердите bootstrap маршрута: создать базовую ветку и рабочую ветку без ручного обхода.",
+    );
   } else {
     requiresDialogue.push(
       "Задача не относится к текущей ветке. Подтвердите переключение на базовую ветку, обновление и создание новой рабочей ветки.",
     );
   }
 
+  const suggestedCommands = sameFeature
+    ? []
+    : !gitContext.hasCommits
+      ? [`git checkout -B ${baseBranch}`, `git checkout -B ${targetBranch}`]
+      : [
+          "git fetch origin",
+          `git checkout ${baseBranch}`,
+          `git pull --ff-only origin ${baseBranch}`,
+          `git checkout -b ${targetBranch}`,
+        ];
+
   return {
     requested: {
       task: options.task,
@@ -431,14 +470,7 @@ function buildPlan(options, gitContext) {
     namingWarnings,
     contextWarnings: getContextWarnings(baseBranch),
     requiresDialogue,
-    suggestedCommands: sameFeature
-      ? []
-      : [
-          "git fetch origin",
-          `git checkout ${baseBranch}`,
-          `git pull --ff-only origin ${baseBranch}`,
-          `git checkout -b ${targetBranch}`,
-        ],
+    suggestedCommands,
   };
 }
 
@@ -449,6 +481,7 @@ function printPlan(plan, applyResult) {
   console.log(`- branch: ${plan.current.branch}`);
   console.log(`- branch type: ${plan.current.branchType}`);
   console.log(`- branch task ref: ${plan.current.branchTaskRef || "not detected"}`);
+  console.log(`- repository state: ${plan.current.hasCommits ? "has commits" : "no commits yet"}`);
   console.log(`- upstream: ${plan.current.upstream}`);
   console.log(`- ahead/behind: ${plan.current.ahead}/${plan.current.behind}`);
   console.log(`- modified_or_staged: ${plan.current.modifiedOrStaged}`);