dsh-tower 2.1.0-beta.1 → 2.1.0

package/tools/status.js

@@ -4,6 +4,7 @@ import { SCHEMAS, output } from '../domain/contracts/outputs.js'
 import { classifyError } from '../domain/errors.js'
 import { StatusInput } from '../domain/contracts/tool-inputs/index.js'
 import { ROSTER_INACTIVE_STATES, isMarkdownFormat, isReservedState, isWorkerRole } from '../domain/vocabulary.js'
+import { archiveView } from '../app/archive.js'
 
 /**
  * @param {any} ctx
@@ -19,9 +20,9 @@ export function registerStatusTool(ctx, deps) {
   define(ctx, {
     name: 'tower_status',
     description:
-      'Read the Tower dashboard for a repository: state path, base branch, revision, mission status counts, paged mission summaries (scope/deps/tasks/worktree/owner), roster size, findings, config path and the activity tail. Pass missionId for one full mission (tasks, notes, reviews, findings, completion report); offset/limit page the mission list (default 20, max 100); includeGate adds preflight gate digests for the page; format:"markdown" returns the human-readable mission board. Read-only.',
+      'Read the Tower dashboard for a repository: state path, base branch, revision, mission status counts, paged mission summaries (scope/deps/tasks/worktree/owner), roster size, findings, archive count, config path and the activity tail. Pass missionId for one full mission (tasks, notes, reviews, findings, completion report; archived missions are loaded from their year file); offset/limit page the mission list (default 20, max 100); includeGate adds preflight gate digests for the page; includeArchived appends compact archived summaries after the active page; format:"markdown" returns the human-readable mission board (active missions plus an archived count). Read-only.',
     parameters: StatusInput,
-    aliases: { mission_id: ['missionId'], include_gate: ['includeGate'] },
+    aliases: { mission_id: ['missionId'], include_gate: ['includeGate'], include_archived: ['includeArchived'] },
     output: output(SCHEMAS.status),
     async execute(args, exec) {
       const tower = await Tower.open(args.repoRoot)
@@ -48,11 +49,18 @@ export function registerStatusTool(ctx, deps) {
         }
       }
       const state = await tower.load()
-      const total = state.missions.length
+      const index = await tower.archiveIndex()
+      const activeIds = state.missions.map((mission) => mission.id)
+      const archivedIds = index.ok
+        ? index.missions.map((entry) => entry.id).filter((id) => !activeIds.includes(id))
+        : []
+      // Hot state pages first, then archived summaries on demand (#73).
+      const ids = args.includeArchived === true ? [...activeIds, ...archivedIds] : activeIds
+      const total = ids.length
       const offset = typeof args.offset === 'number' && Number.isInteger(args.offset) && args.offset > 0 ? args.offset : 0
       const limit = typeof args.limit === 'number' && Number.isInteger(args.limit) ? Math.max(1, Math.min(100, args.limit)) : 20
-      const pageIds = state.missions.slice(offset, offset + limit).map((mission) => mission.id)
-      const status = await tower.status({ missionIds: pageIds })
+      const pageIds = ids.slice(offset, offset + limit)
+      const status = await tower.status({ missionIds: pageIds, includeArchived: args.includeArchived === true })
       let page = status.missions
       if (args.includeGate === true) {
         const { activity, parentStatus } = await observeActivity(ctx, tower)
@@ -86,7 +94,7 @@ export function registerStatusTool(ctx, deps) {
       if (isMarkdownFormat(args.format)) {
         const state = await tower.load()
         const output = /** @type {any} */ (result)
-        output.markdown = tower.boardMarkdown(state)
+        output.markdown = tower.boardMarkdown(state, archiveView(index))
       }
       return result
     },

package/tools/teardown.js

@@ -21,7 +21,7 @@ export function registerTeardownTool(ctx, deps) {
   define(ctx, {
     name: 'tower_teardown',
     description:
-      'Tear down eligible mission worktrees after their missions are merged or abandoned. A worktree whose roster agent is running is always kept (force cannot override); dirty worktrees need force; exclude keeps named missions. dry_run previews the remove/keep decisions without changing anything.',
+      'Tear down eligible mission worktrees after their missions are merged or abandoned. A worktree whose roster agent is running is always kept (force cannot override); dirty worktrees need force; exclude keeps named missions. dry_run previews the remove/keep decisions without changing anything. Terminal missions whose worktree is gone and whose configured archive policy is due (archive.afterDays / archive.maxMissions) are moved to <git-common-dir>/dsh-tower/archive/ so state.json stops rewriting them; nothing is deleted.',
     parameters: TeardownInput,
     aliases: {"dry_run":["dryRun"]},
     board: true,

package/types/index.d.ts

@@ -99,6 +99,8 @@ export interface CompletionCheck {
 
 export interface CompletionReport {
   report?: string
+  /** UTF-8 byte length of `report`; absent on documents written before #89. */
+  reportBytes?: number
   by?: string
   at?: number
   checks?: CompletionCheck[]
@@ -153,6 +155,34 @@ export interface Mission {
   authorizationRef?: string | null
 }
 
+/**
+ * Compact archived-mission entry (`archive/index.json`). It keeps enough of the
+ * mission for ordering, dependency lookups and id allocation without loading the
+ * full year file, and it is what `tower_status includeArchived` pages from (#73).
+ */
+export interface ArchiveIndexEntry {
+  id: string
+  title: string
+  status: MissionStatus
+  kind?: MissionKind
+  scope?: string[]
+  deps?: string[]
+  owner?: string | null
+  branch?: string | null
+  mergedCommit?: string | null
+  mergedAt?: number | null
+  updatedAt?: number | null
+  archivedAt: number
+  archivedYear: number
+}
+
+/** Full archived record (`archive/<year>.json`): mission + linked history. */
+export interface ArchivedMissionRecord extends ArchiveIndexEntry {
+  mission: Mission
+  reviews: Review[]
+  findings: Finding[]
+}
+
 export interface Review {
   id?: string
   seq?: number
@@ -220,6 +250,8 @@ export interface TowerState {
   createdAt?: number
   updatedAt?: number
   dirtyBase?: boolean
+  /** Detected once at tower_init; null means "not detected yet" (#90). */
+  caseInsensitive?: boolean | null
   towerAgentId?: string | null
   snapshotCommit?: string | null
   snapshotRef?: string | null
@@ -268,6 +300,8 @@ export interface MissionSummary {
   reviewPolicy: ReviewPolicy
   mergedCommit: string | null
   mergedAt: number | null
+  /** Size of the completion report without loading its body; null when absent. */
+  reportBytes: number | null
   updatedAt?: number
 }