@zaip-ai/cli 1.0.8 → 1.3.0

package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.test.ts

@@ -2,9 +2,9 @@ import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import {
+  PROJECT_CONFIG_PATH,
   parseProjectConfig,
   parseYaml,
-  PROJECT_CONFIG_PATH,
   serializeYaml,
   WorkspaceFileSystem,
 } from "@zaip-ai/core";
@@ -123,6 +123,10 @@ async function fixtureProject() {
 }
 
 describe("project settings persistence", () => {
+  it("uses the canonical lowercase architecture artifact path", () => {
+    expect(SOFTWARE_ARCHITECTURE_PATH).toBe(".agents/architecture/software-architecture.md");
+  });
+
   it("reads, validates and atomically persists the complete project config", async () => {
     const { configPath, filesystem } = await fixtureProject();
     const current = await readProjectSettings(filesystem);
@@ -385,7 +389,7 @@ describe("project settings persistence", () => {
         }),
         expect.objectContaining({
           id: "brandbook",
-          artifact: ".agents/brand/brandbook.md",
+          artifact: ".agents/branding/brandbook.md",
           available: false,
         }),
       ]),

package/templates/.agents/dashboard/packages/local-runtime/src/project-settings.ts

@@ -1,8 +1,8 @@
 import {
   PROJECT_CONFIG_PATH,
   type ProjectConfig,
-  parseProjectConfig,
   parseAgentCatalog,
+  parseProjectConfig,
   parseYaml,
   serializeYaml,
   type WorkspaceFileSystem,
@@ -12,7 +12,7 @@ const AGENT_CATALOG_PATH = ".agents/config/agents/catalog.yaml";
 const CODEX_CONFIG_PATH = ".codex/config.toml";
 const FRAMEWORK_LOCK_PATH = ".agents/config/framework.lock.yaml";
 const SQLITE_READ_MODEL_PATH = ".local/dashboard-sqlite/read-model.sqlite";
-export const SOFTWARE_ARCHITECTURE_PATH = "docs/SOFTWARE-ARCHITECTURE.md";
+export const SOFTWARE_ARCHITECTURE_PATH = ".agents/architecture/software-architecture.md";
 
 export type ProjectOverview = {
   framework_version: string | null;
@@ -48,7 +48,7 @@ const projectOverviewArtifacts: Array<Omit<ProjectOverview["areas"][number], "av
     artifact: SOFTWARE_ARCHITECTURE_PATH,
   },
   { id: "design_system", label: "Design system", artifact: ".agents/design/DESIGN.md" },
-  { id: "brandbook", label: "Brandbook", artifact: ".agents/brand/brandbook.md" },
+  { id: "brandbook", label: "Brandbook", artifact: ".agents/branding/brandbook.md" },
   {
     id: "marketing_strategy",
     label: "Estratégia de Marketing",

package/templates/.agents/dashboard/packages/local-runtime/src/server-board.test.ts

@@ -17,14 +17,13 @@ describe("boardPage", () => {
       prds: [prd],
       specs: [spec],
     } as unknown as Parameters<typeof boardPage>[0];
-    const page = boardPage(
-      projection,
-      "executing",
-      0,
-      10,
-      [],
-      { query: "", status: "", risk: "", origin: "", kind: "" },
-    );
+    const page = boardPage(projection, "executing", 0, 10, [], {
+      query: "",
+      status: "",
+      risk: "",
+      origin: "",
+      kind: "",
+    });
 
     expect(page.tasks[0]).toBe(task);
     expect(page.prds[0]).toBe(prd);
@@ -42,17 +41,57 @@ describe("boardPage", () => {
     const projection = { changes: [], tasks: [task], prds: [], specs: [] } as unknown as Parameters<
       typeof boardPage
     >[0];
-    const page = boardPage(
-      projection,
-      "executing",
-      0,
-      10,
-      [],
-      { query: "", status: "", risk: "", origin: "", kind: "" },
-    );
+    const page = boardPage(projection, "executing", 0, 10, [], {
+      query: "",
+      status: "",
+      risk: "",
+      origin: "",
+      kind: "",
+    });
     expect(page.tasks[0]).toBe(task);
   });
 
+  it("separates standalone Tasks from Tasks linked to a SPEC", () => {
+    const standalone = {
+      id: "TASK-STANDALONE",
+      title: "Standalone",
+      status: "executing",
+      spec_id: null,
+      updated_at: "2026-08-08T10:00:00Z",
+    };
+    const linked = {
+      id: "TASK-LINKED",
+      title: "Linked",
+      status: "executing",
+      spec_id: "SPEC-1",
+      updated_at: "2026-08-08T10:00:00Z",
+    };
+    const projection = {
+      changes: [],
+      tasks: [standalone, linked],
+      prds: [],
+      specs: [],
+    } as unknown as Parameters<typeof boardPage>[0];
+
+    const standalonePage = boardPage(projection, "executing", 0, 10, [], {
+      query: "",
+      status: "",
+      risk: "",
+      origin: "",
+      kind: "standalone-task",
+    });
+    const linkedPage = boardPage(projection, "executing", 0, 10, [], {
+      query: "",
+      status: "",
+      risk: "",
+      origin: "",
+      kind: "task",
+    });
+
+    expect(standalonePage.tasks).toEqual([standalone]);
+    expect(linkedPage.tasks).toEqual([linked]);
+    expect(standalonePage.totals_by_kind).toMatchObject({ task: 1, "standalone-task": 1 });
+  });
 });
 
 function macro(id: string, kind: "prd" | "spec", taskIds: string[]) {

package/templates/.agents/dashboard/packages/local-runtime/src/server-board.ts

@@ -7,7 +7,13 @@ import type { Context } from "hono";
 import type { buildCanonicalOperationsProjection } from "./server-projections.js";
 
 type BoardStage = WorkStage;
-export type BoardClassification = "lite" | "standard" | "critical" | "empty" | "structured" | "rework";
+export type BoardClassification =
+  | "lite"
+  | "standard"
+  | "critical"
+  | "empty"
+  | "structured"
+  | "rework";
 
 interface BoardFilters {
   query: string;
@@ -110,7 +116,11 @@ export function boardPage(
   const stageItems =
     filters.kind === ""
       ? allStageItems
-      : allStageItems.filter((item) => item.kind === filters.kind);
+      : filters.kind === "standalone-task"
+        ? allStageItems.filter((item) => item.kind === "task" && item.row.spec_id === null)
+        : filters.kind === "task"
+          ? allStageItems.filter((item) => item.kind === "task" && item.row.spec_id !== null)
+          : allStageItems.filter((item) => item.kind === filters.kind);
   const page = stageItems.slice(offset, offset + limit);
   const ids = new Set(page.map((item) => item.row.id));
   return {
@@ -119,19 +129,17 @@ export function boardPage(
     total: stageItems.length,
     totals_by_kind: {
       all: allStageItems.length,
-      task: allStageItems.filter((item) => item.kind === "task").length,
+      task: allStageItems.filter((item) => item.kind === "task" && item.row.spec_id !== null)
+        .length,
+      "standalone-task": allStageItems.filter(
+        (item) => item.kind === "task" && item.row.spec_id === null,
+      ).length,
       prd: allStageItems.filter((item) => item.kind === "prd").length,
       spec: allStageItems.filter((item) => item.kind === "spec").length,
     },
-    prds: page
-      .filter((item) => item.kind === "prd")
-      .map((item) => item.row),
-    specs: page
-      .filter((item) => item.kind === "spec")
-      .map((item) => item.row),
-    tasks: page
-      .filter((item) => item.kind === "task")
-      .map((item) => item.row),
+    prds: page.filter((item) => item.kind === "prd").map((item) => item.row),
+    specs: page.filter((item) => item.kind === "spec").map((item) => item.row),
+    tasks: page.filter((item) => item.kind === "task").map((item) => item.row),
     changes: projection.changes.filter((change) =>
       change.task_ids.some((taskId) => ids.has(taskId)),
     ),
@@ -173,7 +181,9 @@ export function classificationPage(
     tasks: kind === "task" ? page : [],
     changes:
       kind === "task"
-        ? projection.changes.filter((change) => page.some((task) => change.task_ids.includes(task.id)))
+        ? projection.changes.filter((change) =>
+            page.some((task) => change.task_ids.includes(task.id)),
+          )
         : [],
   };
 }

package/templates/.agents/dashboard/packages/local-runtime/src/server-snapshot.test.ts

@@ -45,7 +45,7 @@ describe("dashboard backend snapshot", () => {
       [
         "lock_version: 1",
         "framework:",
-        "  version: 1.0.8",
+        "  version: 1.3.0",
         "  distribution_sha256: null",
         "layout:",
         "  version: 3",
@@ -593,12 +593,27 @@ describe("Cost Monitor daily summary route", () => {
   it("keeps the Daily first-fold response to its displayed-column allowlist", () => {
     const source = readFileSync(new URL("./sqlite-read-model.ts", import.meta.url), "utf8");
     const dailyBranch = source.slice(
-      source.indexOf('if (filteredCostGroup !== undefined && temporalCostGroup && !hasDimensionalCostFilter)'),
-      source.indexOf('if (filteredCostGroup !== undefined && (!temporalCostGroup || hasDimensionalCostFilter))'),
+      source.indexOf(
+        "if (filteredCostGroup !== undefined && temporalCostGroup && !hasDimensionalCostFilter)",
+      ),
+      source.indexOf(
+        "if (filteredCostGroup !== undefined && (!temporalCostGroup || hasDimensionalCostFilter))",
+      ),
     );
     expect(dailyBranch).not.toContain("costMonitorFactualDurationByDay(");
     expect(dailyBranch).toContain("Daily first fold is an allowlisted table contract");
-    for (const field of ["prd_count", "spec_count", "task_count", "total_run_count", "validation_count", "evidence_count", "total_duration", "duration_known", "total_tokens", "total_cost_brl"])
+    for (const field of [
+      "prd_count",
+      "spec_count",
+      "task_count",
+      "total_run_count",
+      "validation_count",
+      "evidence_count",
+      "total_duration",
+      "duration_known",
+      "total_tokens",
+      "total_cost_brl",
+    ])
       expect(dailyBranch).toContain(`${field}:`);
     expect(dailyBranch).not.toContain("...row,");
   });

package/templates/.agents/dashboard/packages/local-runtime/src/server-workspace.ts

@@ -51,7 +51,10 @@ export function githubRepositoryFromRemote(remote: string): string | null {
 }
 
 export function dashboardWorkspaceKey(workspaceRoot: string): string {
-  return createHash("sha256").update(`${resolve(workspaceRoot)}:dashboard-sqlite`).digest("hex").slice(0, 16);
+  return createHash("sha256")
+    .update(`${resolve(workspaceRoot)}:dashboard-sqlite`)
+    .digest("hex")
+    .slice(0, 16);
 }
 
 export interface ReconciliationItem {
@@ -104,11 +107,12 @@ export function reconciliationResult(value: unknown): ReconciliationResult {
       const record = entity as Record<string, unknown>;
       if (
         item.status === "closed" &&
-        record.status === "completed" &&
+        ["completed", "blocked", "cancelled", "failed"].includes(record.status as string) &&
         typeof record.id === "string"
       ) {
         reconciled.add(record.id);
-      } else if (record.status === "blocked") {
+      }
+      if (record.status === "blocked") {
         remember(blocked, record.id, record.status_reason ?? reason);
       } else if (item.status === "deferred") {
         remember(notReconciled, record.id, reason);

package/templates/.agents/dashboard/packages/local-runtime/src/server.test.ts

@@ -12,6 +12,7 @@ import {
   openWorkIds,
   projectionPeriodFilter,
   reconciliationResult,
+  SqliteReadModelFileSystem,
 } from "./server.js";
 import { invocationSummary } from "./server.test-fixtures.js";
 import { classificationPage } from "./server-board.js";
@@ -21,6 +22,7 @@ import {
   mergeLifecycleRunPage,
   runTimestampInRange,
 } from "./server-projections.js";
+import { rebuildSqliteReadModel } from "./sqlite-read-model.js";
 
 const workspaceRoot = resolve(import.meta.dirname, "../../../../..");
 describe("dashboard backend", () => {
@@ -252,7 +254,11 @@ describe("dashboard backend", () => {
     });
   });
   it("permits canonical open-work reconciliation while serving a read-only SQLite snapshot", async () => {
-    const reconcile = vi.fn(async () => ({ reconciled_ids: ["TASK-RECONCILED"], blocked: [], not_reconciled: [] }));
+    const reconcile = vi.fn(async () => ({
+      reconciled_ids: ["TASK-RECONCILED"],
+      blocked: [],
+      not_reconciled: [],
+    }));
     const refresh = vi.fn(async () => undefined);
     const canonicalFilesystem = new WorkspaceFileSystem(workspaceRoot);
     const app = createDashboardApp(workspaceRoot, "test-session", undefined, {
@@ -275,6 +281,106 @@ describe("dashboard backend", () => {
     const rejected = await app.request("/api/v2/reconcile-open-work", { method: "POST" });
     expect(rejected.status).toBe(401);
   }, 130_000);
+  it("rebuilds a stale immutable projection without reconciling lifecycle work", async () => {
+    const fixtureRoot = await mkdtemp(join(tmpdir(), "zaip-dashboard-stale-projection-"));
+    const taskIndexPath = join(
+      fixtureRoot,
+      ".agents",
+      "records",
+      "lifecycle",
+      "indexes",
+      "task.json",
+    );
+    const taskRecordPath = join(
+      fixtureRoot,
+      ".agents",
+      "records",
+      "tasks",
+      "2026",
+      "08",
+      "TASK-STALE-PROJECTION.md",
+    );
+    await mkdir(join(fixtureRoot, ".agents", "config"), { recursive: true });
+    await mkdir(join(fixtureRoot, ".agents", "records", "lifecycle", "indexes"), {
+      recursive: true,
+    });
+    await mkdir(join(fixtureRoot, ".agents", "records", "tasks", "2026", "08"), {
+      recursive: true,
+    });
+    await writeFile(
+      join(fixtureRoot, ".agents", "config", "project.yaml"),
+      "schema_version: 1\nproject:\n  id: stale-projection\n  name: stale-projection\n  timezone: UTC\nstack:\n  id: zaip-aios-stack\n  overrides: {}\nclients:\n  codex: true\n  claude: true\ntracking:\n  enabled: true\n  currency: BRL\n  storage_mode: tracked_sanitized\n",
+    );
+    await writeFile(
+      join(fixtureRoot, ".agents", "config", "framework.lock.yaml"),
+      "lock_version: 1\nframework:\n  version: 1.3.0\n  distribution_sha256: null\nlayout:\n  version: 3\nresolved_profile:\n  id: null\n  sha256: null\nmanaged_files: {}\n",
+    );
+    const task = (status: "executing" | "completed") => ({
+      schema_version: 1,
+      entities: {
+        "TASK-STALE-PROJECTION": {
+          kind: "task",
+          id: "TASK-STALE-PROJECTION",
+          title: "Stale projection",
+          status,
+          risk: "standard",
+          priority: "medium",
+          updated_at: "2026-08-22T12:00:00.000Z",
+          relations: [],
+          usage: null,
+          data: { created_at: "2026-08-22T12:00:00.000Z" },
+        },
+      },
+    });
+    await writeFile(taskIndexPath, `${JSON.stringify(task("executing"))}\n`);
+    const taskRecord = (status: "executing" | "completed") =>
+      `---\nid: TASK-STALE-PROJECTION\ntitle: Stale projection\nstatus: ${status}\nrisk: standard\ncreated_at: 2026-08-22T12:00:00.000Z\n---\n# Stale projection\n`;
+    await writeFile(taskRecordPath, taskRecord("executing"));
+    await rebuildSqliteReadModel(fixtureRoot);
+    const filesystem = new SqliteReadModelFileSystem(fixtureRoot);
+    const reconcile = vi.fn(async () => ({ reconciled_ids: [], blocked: [], not_reconciled: [] }));
+    try {
+      const app = createDashboardApp(fixtureRoot, "test-session", undefined, {
+        canonicalFilesystem: new WorkspaceFileSystem(fixtureRoot),
+        filesystem,
+        reconcileOpenWork: reconcile,
+      });
+      const before = await app.request("/api/v2/operations?scope=quick", {
+        headers: { "x-zaip-session": "test-session" },
+      });
+      const beforePayload = (await before.json()) as {
+        summary: { overview_metrics: { task_status_counts: Record<string, number> } };
+      };
+      expect(beforePayload.summary.overview_metrics.task_status_counts.executing).toBe(1);
+
+      await writeFile(taskIndexPath, `${JSON.stringify(task("completed"))}\n`);
+      await writeFile(taskRecordPath, taskRecord("completed"));
+      const previousSeedPreference = process.env.ZAIP_SQLITE_PREFER_LAST_VALID_SEED;
+      process.env.ZAIP_SQLITE_PREFER_LAST_VALID_SEED = "1";
+      const refreshed = await app.request("/api/v2/refresh-projection", {
+        method: "POST",
+        headers: { "x-zaip-session": "test-session" },
+      });
+      if (previousSeedPreference === undefined)
+        delete process.env.ZAIP_SQLITE_PREFER_LAST_VALID_SEED;
+      else process.env.ZAIP_SQLITE_PREFER_LAST_VALID_SEED = previousSeedPreference;
+
+      expect(refreshed.status, await refreshed.clone().text()).toBe(200);
+      const payload = (await refreshed.json()) as {
+        operations: {
+          summary: { overview_metrics: { task_status_counts: Record<string, number> } };
+        };
+      };
+      expect(payload.operations.summary.overview_metrics.task_status_counts.executing ?? 0).toBe(0);
+      expect(payload.operations.summary.overview_metrics.task_status_counts.completed).toBe(1);
+      expect(reconcile).not.toHaveBeenCalled();
+      const rejected = await app.request("/api/v2/refresh-projection", { method: "POST" });
+      expect(rejected.status).toBe(401);
+    } finally {
+      filesystem.close();
+      await rm(fixtureRoot, { recursive: true, force: true });
+    }
+  }, 130_000);
   it("persists Kanban priority canonically while a SQLite snapshot blocks other settings writes", async () => {
     const canonicalRoot = await mkdtemp(join(tmpdir(), "zaip-dashboard-priority-"));
     try {
@@ -298,11 +404,21 @@ describe("dashboard backend", () => {
       };
       expect(beforeBoard.tasks.length).toBeGreaterThan(1);
       const concurrent = await Promise.all([
-        app.request("/api/v2/operations?scope=board&stage=completed&from=2000-01-01&to=2099-12-31&offset=0&limit=10", { headers: { "x-zaip-session": "test-session" } }),
-        app.request("/api/v2/operations?scope=board&stage=blocked&from=2000-01-01&to=2099-12-31&offset=0&limit=10", { headers: { "x-zaip-session": "test-session" } }),
+        app.request(
+          "/api/v2/operations?scope=board&stage=completed&from=2000-01-01&to=2099-12-31&offset=0&limit=10",
+          { headers: { "x-zaip-session": "test-session" } },
+        ),
+        app.request(
+          "/api/v2/operations?scope=board&stage=blocked&from=2000-01-01&to=2099-12-31&offset=0&limit=10",
+          { headers: { "x-zaip-session": "test-session" } },
+        ),
       ]);
       expect(concurrent.every((response) => response.status === 200)).toBe(true);
-      expect(priorityReads.mock.calls.filter(([path]) => path === ".agents/dashboard/work-priority.json")).toHaveLength(1);
+      expect(
+        priorityReads.mock.calls.filter(
+          ([path]) => path === ".agents/dashboard/work-priority.json",
+        ),
+      ).toHaveLength(1);
       const priority = { item_ids: [beforeBoard.tasks.at(-1)!.id], updated_at: null };
       const persisted = await app.request("/api/v2/work-priority", {
         method: "PUT",
@@ -327,7 +443,10 @@ describe("dashboard backend", () => {
       expect(after.status, await after.clone().text()).toBe(200);
       const afterBoard = (await after.json()) as typeof beforeBoard;
       expect(afterBoard.tasks[0]?.id).toBe(priority.item_ids[0]);
-      expect(priorityReads.mock.calls.filter(([path]) => path === ".agents/dashboard/work-priority.json").length).toBe(readsAfterPut + 1);
+      expect(
+        priorityReads.mock.calls.filter(([path]) => path === ".agents/dashboard/work-priority.json")
+          .length,
+      ).toBe(readsAfterPut + 1);
       const blocked = await app.request("/api/v2/pricing", {
         method: "PUT",
         headers: { "content-type": "application/json", "x-zaip-session": "test-session" },
@@ -414,7 +533,9 @@ describe("dashboard backend", () => {
     };
     expect(payload.tasks).toEqual([]);
     expect(payload.prds).toEqual([]);
-    expect(payload.specs.every((spec) => spec.task_count === 0 && spec.rework_run_count === 0)).toBe(true);
+    expect(
+      payload.specs.every((spec) => spec.task_count === 0 && spec.rework_run_count === 0),
+    ).toBe(true);
   });
   it("serves a compact cost summary and paginated Run metrics from the manifest", async () => {
     const app = createDashboardApp(workspaceRoot, "test-session");
@@ -721,7 +842,7 @@ describe("dashboard backend", () => {
         unresolved_running_run_ids: ["RUN-ACTIVE"],
       }),
     ).toEqual({
-      reconciled_ids: ["CHG-COMPLETED", "TASK-COMPLETED"],
+      reconciled_ids: ["CHG-COMPLETED", "TASK-BLOCKED", "TASK-COMPLETED"],
       blocked: [
         {
           id: "EXEC-ORPHANED",
@@ -830,8 +951,10 @@ describe("dashboard backend", () => {
       source.indexOf("function buildSqliteOperationsProjection"),
       source.indexOf("function nullableMetric"),
     );
-    expect(projection).toContain("options.includePeriods === true ? filesystem.dailyPeriods(filter) : {}");
-    expect(source).toContain("includePeriods: scope === \"detail\" || scope === \"overview\"");
+    expect(projection).toContain(
+      "options.includePeriods === true ? filesystem.dailyPeriods(filter) : {}",
+    );
+    expect(source).toContain('includePeriods: scope === "detail" || scope === "overview"');
   });
   it("rebuilds a fresh aggregate after an in-flight normal read instead of sharing its payload", async () => {
     const source = await import("node:fs/promises").then(({ readFile }) =>