@walwal-harness/cli 7.1.46 → 7.1.48

package/CHANGELOG.md

@@ -4,7 +4,7 @@ docmeta:
   title: walwal-harness CHANGELOG
   type: output
   createdAt: 2026-05-07T00:00:00Z
-  updatedAt: 2026-05-07T00:00:00Z
+  updatedAt: 2026-06-05T00:00:00Z
   source:
     producer: agent
     skillId: harness-release
@@ -31,6 +31,11 @@ docmeta:
 
 ## Unreleased
 
+## 7.1.48 — Auto-managed `.harness` `.gitignore` + runtime untrack on init (2026-06-05)
+- `walwal-harness init` now writes/refreshes a marked managed block in the project-root `.gitignore` so machine-specific harness runtime/local state is never committed and never pollutes teammates' diffs. Ignored: live conductor `progress.json`/`progress.log`/`handoff.json`/`events.jsonl`, the `todos/` live queue (`state.json` + `events.jsonl`), `actions/`, `ops/`, `activity/`, `logs/`, `archive/` migration backups, and the `dashboard/` visualization tooling. Durable team knowledge stays tracked: `conventions/`, `gotchas/`, `documents/`, `memories/`, `memory.md`, `shared/`, `config.json`, `HARNESS.md`, `.bundle-version`.
+- Init also best-effort `git rm --cached`s any of those runtime paths committed before the ignore block existed (files stay on disk), fixing the "`.gitignore` added but already-tracked files keep showing as changes" case.
+- Canonical ignore list now lives in `assets/templates/gitignore-append.txt` as a single source of truth, consumed by both `bin/init.js` and `scripts/harness-dashboard-up.sh` (the dashboard launcher defers to init's managed block instead of appending its own narrow one).
+
 ## 7.1.38 — CEO approval authority for routine operations (2026-05-31)
 
 - CEO now has explicit authority to approve reversible routine operations without Owner confirmation, including mission consolidation/supersede cleanup, monitoring cadence, briefing templates, local cron/launchd/wake automation, dashboard refresh, and Telegram/dashboard notifications that use already configured credentials.

package/apps/harness-dashboard/components/brick/reports.tsx

@@ -172,23 +172,32 @@ export function buildReport(target: DocTarget, state: ContractState): BuiltRepor
   const agent =
     state.agents.find((a) => a.id === target.agent) ?? state.agents[0];
 
+  // When opened from a timeline activity block, prefix the report with the
+  // moment (time + mission) the clicked block represents.
+  const moment =
+    target.at != null
+      ? `**Activity @ ${new Date(target.at).toLocaleString()}**` +
+        (target.mission ? ` · mission \`${target.mission}\`` : "") +
+        `\n\n---\n\n`
+      : "";
+
   if (target.type === "worker") {
     const worker = target.worker;
-    const body = stripFrontmatter(worker.report) || NO_WORKER_SOURCE;
+    const body = moment + (stripFrontmatter(worker.report) || NO_WORKER_SOURCE);
     return {
       title: worker.name,
       owner: agent,
-      kind: "Worker Brief",
+      kind: target.at != null ? "Worker · moment" : "Worker Brief",
       status: worker.status,
       body,
     };
   }
 
-  const body = stripFrontmatter(agent.report) || NO_SOURCE;
+  const body = moment + (stripFrontmatter(agent.report) || NO_SOURCE);
   return {
     title: agent.work,
     owner: agent,
-    kind: "CXX Document",
+    kind: target.at != null ? "CXX · moment" : "CXX Document",
     status: agent.status,
     body,
   };

package/apps/harness-dashboard/components/brick/views-timeline.tsx

@@ -2,11 +2,12 @@
 
 /* =============================================================
    walwal-harness · VIEW 3 — TIMELINE (cadence heatmap + swimlanes)
-   Ported from harness/views-timeline.jsx (design handoff).
+   Ported from harness/views-timeline.jsx (design handoff), wired to REAL
+   per-lane activity marks (s.marks) instead of the prototype's random marks.
    Exports: TimelineView, Cadence
    ============================================================= */
 
-import React, { useRef } from "react";
+import React from "react";
 import type { CSSProperties } from "react";
 
 import type {
@@ -14,6 +15,7 @@ import type {
   ContractState,
   ContractWorker,
   DocTarget,
+  TimelineMark,
 } from "../../lib/brick/contract";
 import { StatusDot, Label } from "./ui";
 
@@ -66,104 +68,92 @@ export interface TimelineViewProps {
   openDoc?: (target: DocTarget) => void;
 }
 
-type SwimMark = { ago: number; dur: number };
-
 type SwimRow = {
   kind: "exec" | "worker";
   id: string;
+  /** activity lane id: "cto" for an exec, "cto:worker-name" for a worker. */
+  laneId: string;
   label: string;
   hue: string;
   agent: AgentRole;
   status: string;
   progress?: number | null;
+  worker?: ContractWorker;
 };
 
 export function TimelineView({ s, openDoc }: TimelineViewProps) {
-  // stable seeded marks per row id
-  const markCache = useRef<Record<string, SwimMark[]>>({});
-  function seedMarks(id: string, density: number): SwimMark[] {
-    const cached = markCache.current[id];
-    if (cached) return cached;
-    const arr: SwimMark[] = [];
-    const n = Math.floor(density * (4 + Math.random() * 7));
-    for (let i = 0; i < n; i++) {
-      arr.push({ ago: Math.random() * SPAN_MS, dur: 40000 + Math.random() * 600000 });
-    }
-    markCache.current[id] = arr;
-    return arr;
-  }
-
-  // build rows: exec + its workers
   const order: AgentRole[] = ["ceo", "coo", "cto", "cqo", "cdo", "ops"];
+
+  // Build rows: each exec + the real WORKERS under it. Worker rows come from the
+  // activity sub-lanes ("cxx:worker-name") and the active-mission workers — NOT
+  // from missions — so a CXX lists the workers that actually ran under it.
   const rows: SwimRow[] = [];
-  order.forEach((id) => {
-    const a = s.agents.find((x) => x.id === id);
+  order.forEach((role) => {
+    const a = s.agents.find((x) => x.id === role);
     if (!a) return;
-    rows.push({ kind: "exec", id: a.id, label: a.name, hue: a.hue, agent: a.id, status: a.status });
-    s.workers
-      .filter((w) => w.agent === id)
-      .forEach((w) => {
-        rows.push({
-          kind: "worker",
-          id: w.id,
-          label: w.name,
-          hue: a.hue,
-          agent: a.id,
-          status: w.status,
-          progress: w.progress,
-        });
-      });
-  });
+    rows.push({ kind: "exec", id: role, laneId: role, label: a.name, hue: a.hue, agent: role, status: a.status });
 
-  // live marks from recent events (last 6 min) keyed to exec rows
-  const liveByAgent: Record<string, number[]> = {};
-  s.events.forEach((e) => {
-    if (e.at == null || e.agent === "") return;
-    const age = s.now - e.at;
-    if (age < 6 * 60 * 1000) {
-      (liveByAgent[e.agent] = liveByAgent[e.agent] || []).push(age);
+    const lanes = new Map<string, { label: string; worker?: ContractWorker }>();
+    for (const laneId of Object.keys(s.marks)) {
+      if (laneId.startsWith(role + ":")) {
+        lanes.set(laneId, { label: laneId.slice(role.length + 1) });
+      }
+    }
+    // active-mission workers (carry a report + status); key matches the sub-lane id.
+    for (const w of s.workers) {
+      if (w.agent === role) lanes.set(w.id, { label: w.name, worker: w });
+    }
+    for (const [laneId, info] of lanes) {
+      rows.push({
+        kind: "worker",
+        id: laneId,
+        laneId,
+        label: info.label,
+        hue: a.hue,
+        agent: role,
+        status: info.worker?.status ?? "idle",
+        progress: info.worker?.progress ?? null,
+        worker: info.worker,
+      });
     }
   });
 
   const xOf = (ago: number): number => Math.max(0, Math.min(100, (ago / SPAN_MS) * 100));
-
-  // axis ticks
   const ticks: number[] = [];
   for (let h = 0; h <= 12; h += 2) ticks.push(h);
+  const fmtAt = (at: number): string => {
+    const d = new Date(at);
+    return Number.isFinite(d.getTime()) ? d.toTimeString().slice(0, 8) : "?";
+  };
 
+  // Label click → the whole row's report.
   const openRow = (r: SwimRow) => {
     if (!openDoc) return;
-    if (r.kind === "exec") {
-      openDoc({ type: "agent", agent: r.agent });
-      return;
-    }
-    const worker: ContractWorker | undefined = s.workers.find((w) => w.id === r.id);
-    if (worker) openDoc({ type: "worker", agent: r.agent, worker });
+    if (r.worker) openDoc({ type: "worker", agent: r.agent, worker: r.worker });
+    else openDoc({ type: "agent", agent: r.agent });
   };
+  // Block click → detail for that one activity mark (what the lane did at that moment).
+  const openMark = (r: SwimRow, m: TimelineMark, e: React.MouseEvent) => {
+    e.stopPropagation();
+    if (!openDoc) return;
+    if (r.worker) openDoc({ type: "worker", agent: r.agent, worker: r.worker, at: m.at, mission: m.mission });
+    else openDoc({ type: "agent", agent: r.agent, at: m.at, mission: m.mission });
+  };
+
+  const workerCount = rows.filter((r) => r.kind === "worker").length;
 
   return (
     <div className="timelineview">
       <Cadence cadence={s.cadence} />
       <div className="swim">
-        <Label
-          right={
-            rows.filter((r) => r.kind === "worker").length +
-            " workers · " +
-            order.length +
-            " execs"
-          }
-        >
+        <Label right={workerCount + " workers · " + order.length + " execs"}>
           ORCHESTRATION TIMELINE · now → −12h
         </Label>
         <div className="swim-axis">
           <div className="swim-axis-pad" />
           <div className="swim-axis-track">
             {ticks.map((h) => (
-              <span
-                key={h}
-                className="swim-tick"
-                style={{ left: (h / 12) * 100 + "%" }}
-              >
+              <span key={h} className="swim-tick" style={{ left: (h / 12) * 100 + "%" }}>
                 {h === 0 ? "now" : "−" + h + "h"}
               </span>
             ))}
@@ -171,8 +161,9 @@ export function TimelineView({ s, openDoc }: TimelineViewProps) {
         </div>
         <div className="swim-rows">
           {rows.map((r) => {
-            const marks = seedMarks(r.id, r.kind === "exec" ? 1.4 : 0.8);
-            const live = r.kind === "exec" ? liveByAgent[r.agent] || [] : [];
+            const marks = (s.marks[r.laneId] ?? []).filter(
+              (m) => s.now - m.at >= 0 && s.now - m.at <= SPAN_MS
+            );
             return (
               <div
                 key={r.id}
@@ -205,21 +196,18 @@ export function TimelineView({ s, openDoc }: TimelineViewProps) {
                     <span
                       key={i}
                       className="swim-block"
+                      role="button"
+                      title={fmtAt(m.at) + (m.mission ? " · " + m.mission : "")}
+                      onClick={(e) => openMark(r, m, e)}
                       style={{
-                        left: xOf(m.ago) + "%",
-                        width: Math.max(0.6, (m.dur / SPAN_MS) * 100) + "%",
+                        left: xOf(s.now - m.at) + "%",
+                        width: "9px",
+                        cursor: "pointer",
                         background: r.hue,
-                        opacity: r.kind === "exec" ? 0.85 : 0.55,
+                        opacity: r.kind === "exec" ? 0.85 : 0.6,
                       }}
                     />
                   ))}
-                  {live.map((age, i) => (
-                    <span
-                      key={"l" + i}
-                      className="swim-live"
-                      style={{ left: xOf(age) + "%", background: r.hue }}
-                    />
-                  ))}
                   {r.kind === "worker" && r.progress != null && (
                     <span
                       className="swim-now-prog"

package/apps/harness-dashboard/lib/brick/adapter.ts

@@ -284,6 +284,17 @@ export function toContractState(
     eventsTotal: snapshot.events.length,
   };
 
+  // ---- timeline marks: real per-lane activity (epoch + mission) ----------
+  const marks: Record<string, Array<{ at: number; mission: string | null }>> = {};
+  for (const sample of snapshot.activitySamples) {
+    const at = parseTs(sample.ts);
+    if (at == null) continue;
+    (marks[sample.laneId] = marks[sample.laneId] ?? []).push({
+      at,
+      mission: sample.missionId ?? null,
+    });
+  }
+
   return {
     now: nowMs,
     agents,
@@ -295,6 +306,7 @@ export function toContractState(
     metrics,
     mtrend: [],
     ctrend: [],
+    marks,
   };
 }
 

package/apps/harness-dashboard/lib/brick/contract.ts

@@ -39,8 +39,8 @@ export type AlertLevel = "stale" | "attention";
 
 /** A reference to a document the DocViewer can render. */
 export type DocTarget =
-  | { type: "agent"; agent: AgentRole }
-  | { type: "worker"; agent: AgentRole; worker: ContractWorker };
+  | { type: "agent"; agent: AgentRole; at?: number; mission?: string | null }
+  | { type: "worker"; agent: AgentRole; worker: ContractWorker; at?: number; mission?: string | null };
 
 /** Static, design-fixed definition of one exec agent. */
 export interface AgentDef {
@@ -173,6 +173,17 @@ export interface ContractState {
   mtrend: number[];
   /** cost sparkline samples; [] when no source. */
   ctrend: number[];
+  /** Real per-lane activity marks (epoch ms + mission) for the timeline
+   *  swimlanes, keyed by laneId ("cto" exec lane or "cto:worker-name" sub-lane). */
+  marks: Record<string, TimelineMark[]>;
+}
+
+/** One real activity mark on a timeline lane (from an activity sample). */
+export interface TimelineMark {
+  /** epoch ms of the activity. */
+  at: number;
+  /** mission the activity belonged to, if known. */
+  mission: string | null;
 }
 
 /* ---- agent (exec) definitions -----------------------------------------

package/assets/templates/gitignore-append.txt

@@ -1,6 +1,26 @@
-# walwal-harness dashboard runtime
-.harness/dashboard/apps/harness-dashboard/node_modules/
-.harness/dashboard/apps/harness-dashboard/.next/
-.harness/dashboard/apps/harness-dashboard/.turbo/
-.harness/dashboard/apps/harness-dashboard/tsconfig.tsbuildinfo
-.harness/dashboard/.download/
+# >>> walwal-harness managed (local/runtime state — do not edit between markers) >>>
+# Auto-managed by `walwal-harness init` (refreshed on every init).
+# Edit the package template assets/templates/gitignore-append.txt, not this block.
+#
+# SHARED with teammates (kept in git): .harness/{conventions,gotchas,documents,
+#   memories,shared}/  .harness/{memory.md,config.json,HARNESS.md,.bundle-version}
+# Everything listed below is machine-specific runtime or local tooling — never shared.
+#
+# Live conductor todo-queue + transition log (heartbeats churn each tick; embeds local paths)
+.harness/todos/state.json
+.harness/todos/events.jsonl
+# Live conductor / handoff / event state (rewritten every run)
+.harness/progress.json
+.harness/progress.log
+.harness/handoff.json
+.harness/events.jsonl
+# Active-sprint, service-ops, activity heatmap & logs runtime
+.harness/actions/
+.harness/ops/
+.harness/activity/
+.harness/logs/
+# Migration & pre-harness backup snapshots (local-only)
+.harness/archive/
+# Brick Office dashboard — local visualization tool + per-env data & build artifacts
+.harness/dashboard/
+# <<< walwal-harness managed <<<

package/bin/init.js

@@ -853,6 +853,102 @@ function ensureHarnessEnv() {
   log('.env: HARNESS_BASE_PORT placeholder added — CEO/CXX must choose an available value before starting services');
 }
 
+// ── .gitignore management ───────────────────────────────────────────────────
+// Keep the host project's root .gitignore in sync with the harness's local/runtime
+// state so high-churn conductor files, backups, and dashboard tooling never get
+// committed (and pollute teammates' diffs). The canonical entry list ships in
+// assets/templates/gitignore-append.txt — single source of truth, also consumed by
+// scripts/harness-dashboard-up.sh.
+const GITIGNORE_MARKER_BEGIN = '# >>> walwal-harness managed';
+const GITIGNORE_MARKER_END = '# <<< walwal-harness managed';
+
+function readGitignoreBlock() {
+  const tplPath = path.join(PKG_ROOT, 'assets', 'templates', 'gitignore-append.txt');
+  if (!fileExists(tplPath)) return null;
+  const block = fs.readFileSync(tplPath, 'utf8').replace(/\s+$/, '');
+  return block || null;
+}
+
+// Non-comment, non-empty lines of the managed block = the local/runtime pathspecs.
+function localPathsFromBlock(block) {
+  return block
+    .split('\n')
+    .map((l) => l.trim())
+    .filter((l) => l && !l.startsWith('#'));
+}
+
+// Write or refresh the marked managed block in the project-root .gitignore.
+// Idempotent: an existing block is replaced in place; everything else is preserved.
+function ensureProjectGitignore() {
+  const block = readGitignoreBlock();
+  if (!block) {
+    log('  → .gitignore: skipped (managed template missing)');
+    return;
+  }
+  const gitignorePath = path.join(PROJECT_ROOT, '.gitignore');
+  const original = fileExists(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf8') : '';
+  const lines = original.length ? original.split('\n') : [];
+
+  const beginLine = lines.findIndex((l) => l.startsWith(GITIGNORE_MARKER_BEGIN));
+  let next;
+  if (beginLine !== -1) {
+    let endLine = lines.findIndex((l, i) => i >= beginLine && l.startsWith(GITIGNORE_MARKER_END));
+    if (endLine === -1) endLine = lines.length - 1; // tolerate a truncated block
+    next = [...lines.slice(0, beginLine), ...block.split('\n'), ...lines.slice(endLine + 1)].join('\n');
+  } else {
+    const head = original.replace(/\n*$/, '');
+    next = (head ? head + '\n\n' : '') + block + '\n';
+  }
+  if (!next.endsWith('\n')) next += '\n';
+  if (next !== original) {
+    fs.writeFileSync(gitignorePath, next);
+    log(beginLine !== -1
+      ? '  → .gitignore: refreshed walwal-harness managed block'
+      : '  → .gitignore: added walwal-harness runtime/local ignore block');
+  }
+}
+
+// Best-effort: a project that committed runtime state before the ignore block existed
+// keeps showing churn until those paths leave the index. Drop them from tracking
+// (files stay on disk). Never fail init over git: a non-repo / missing-git / odd state
+// is a quiet no-op.
+function gitUntrackLocalState() {
+  const block = readGitignoreBlock();
+  if (!block) return;
+  try {
+    const inside = execSync('git rev-parse --is-inside-work-tree', {
+      cwd: PROJECT_ROOT, stdio: ['ignore', 'pipe', 'ignore'],
+    }).toString().trim();
+    if (inside !== 'true') return;
+  } catch {
+    return; // not a git repo / git unavailable
+  }
+
+  const removed = [];
+  for (const rel of localPathsFromBlock(block)) {
+    let tracked = '';
+    try {
+      tracked = execSync(`git ls-files -- ${shellQuote(rel)}`, {
+        cwd: PROJECT_ROOT, stdio: ['ignore', 'pipe', 'ignore'],
+      }).toString().trim();
+    } catch {
+      continue;
+    }
+    if (!tracked) continue;
+    try {
+      execSync(`git rm -r --cached --quiet --ignore-unmatch -- ${shellQuote(rel)}`, {
+        cwd: PROJECT_ROOT, stdio: ['ignore', 'ignore', 'ignore'],
+      });
+      removed.push(rel);
+    } catch {
+      // leave it tracked; non-fatal
+    }
+  }
+  if (removed.length) {
+    log(`  → git: untracked ${removed.length} now-ignored runtime path(s), kept on disk (${removed.join(', ')})`);
+  }
+}
+
 function ensureStructuredRuntimeFiles({ dryRun = false } = {}) {
   const todosDir = path.join(HARNESS_DIR, 'todos');
   const statePath = path.join(todosDir, 'state.json');
@@ -2621,6 +2717,8 @@ function main() {
   console.log('');
 
   scaffoldHarness();
+  ensureProjectGitignore();
+  gitUntrackLocalState();
   installSkills();
   installScripts();
   ensureWakeScheduler();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "7.1.46",
+  "version": "7.1.48",
   "description": "Company-style AI agent harness for Claude and Codex. Installs commands, CXX agents, skills, HR-Resource hiring pool, and project-local .harness runtime state.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/scripts/harness-dashboard-up.sh

@@ -53,22 +53,27 @@ fi
 
 ensure_gitignore() {
   local gitignore="${HARNESS_ROOT}/.gitignore"
-  local marker="# walwal-harness dashboard runtime"
+  # `walwal-harness init` owns the canonical managed block (covers .harness/dashboard/
+  # plus all other runtime/local state). If it's already present, nothing to add.
+  local managed_marker="# >>> walwal-harness managed"
+  if [[ -f "$gitignore" ]] && grep -Fq "$managed_marker" "$gitignore"; then
+    return
+  fi
+  # Prefer the package's canonical template (single source of truth shared with init.js);
+  # fall back to a dashboard-only block for older packages that lack the template.
+  local tpl="${PACKAGE_ROOT}/assets/templates/gitignore-append.txt"
   local block
-  block="$(cat <<'EOF'
+  if [[ -f "$tpl" ]]; then
+    block="$(cat "$tpl")"
+  else
+    block="$(cat <<'EOF'
 # walwal-harness dashboard runtime
-.harness/dashboard/apps/harness-dashboard/node_modules/
-.harness/dashboard/apps/harness-dashboard/.next/
-.harness/dashboard/apps/harness-dashboard/.turbo/
-.harness/dashboard/apps/harness-dashboard/tsconfig.tsbuildinfo
-.harness/dashboard/.download/
+.harness/dashboard/
 EOF
 )"
-  if [[ -f "$gitignore" ]] && grep -Fq "$marker" "$gitignore"; then
-    return
   fi
   mkdir -p "$(dirname "$gitignore")"
-  if [[ -s "$gitignore" ]] && [[ "$(tail -c 1 "$gitignore" 2>/dev/null || true)" != "" ]]; then
+  if [[ -f "$gitignore" ]] && [[ -s "$gitignore" ]] && [[ "$(tail -c 1 "$gitignore" 2>/dev/null || true)" != "" ]]; then
     printf '\n' >> "$gitignore"
   fi
   printf '%s\n' "$block" >> "$gitignore"