@lambdacurry/arbor 0.24.35 → 0.24.36

package/dist/arbor.js

@@ -6955,6 +6955,7 @@ function json(params) {
   return jsonSchema;
 }
 // ../core/src/objects/types.ts
+var TOPIC_LIFECYCLES = ["planned", "open", "on-hold", "closed", "archived"];
 var IDENTITY_COLORS = [
   "indigo",
   "teal",
@@ -8562,6 +8563,7 @@ var topics = sqliteTable("topics", {
   workflowId: text("workflow_id"),
   visibility: text("visibility").$type().notNull().default("open"),
   ownerProfileId: text("owner_profile_id").references(() => profiles.id),
+  lifecycle: text("lifecycle").$type().notNull().default("open"),
   archivedAt: ts("archived_at"),
   createdAt: ts("created_at").notNull()
 }, (t) => ({
@@ -10217,6 +10219,9 @@ var ORG_ADMIN_CONTAINMENT_PERMISSIONS = new Set([
   "revoke"
 ]);
 
+// ../core/src/ops/topic-lifecycle.ts
+var INITIAL_TOPIC_LIFECYCLES = ["planned", "open"];
+
 // ../core/src/queries/artifact-base.ts
 var eventChronology = sql`_rowid_`;
 var SPACE_ARTIFACT_STATUSES = [
@@ -11121,13 +11126,17 @@ function buildOutputSchemas() {
     type: string2(),
     description: string2().optional()
   });
+  const topicLifecycle = _enum(TOPIC_LIFECYCLES);
+  const removedTopicStatus = never().optional();
   const topic = looseObject({
     id,
     spaceId: id.optional(),
     title: string2(),
     purpose: nullableString.optional(),
     url: string2().optional(),
-    workflowId: nullableString.optional()
+    workflowId: nullableString.optional(),
+    lifecycle: topicLifecycle.optional(),
+    status: removedTopicStatus
   });
   const space = looseObject({
     id,
@@ -11285,7 +11294,8 @@ function buildOutputSchemas() {
     purpose: string2().optional(),
     threadCount: number2(),
     activeThreadCount: number2(),
-    status: _enum(["healthy", "attention", "stuck"]),
+    lifecycle: topicLifecycle,
+    status: removedTopicStatus,
     openRequestCount: number2().optional(),
     lastActivityAt: timestamp,
     lanesForYou: array(string2()).optional(),
@@ -11437,13 +11447,19 @@ function buildOutputSchemas() {
       reacted: boolean2(),
       reactions: array(reactionCount)
     }),
-    create_topic: looseObject({ topicId: id, url: string2().optional() }),
+    create_topic: looseObject({
+      topicId: id,
+      url: string2().optional(),
+      lifecycle: topicLifecycle.optional()
+    }),
     topic_update: looseObject({
       id,
       title: string2().optional(),
       purpose: nullableString.optional(),
       workflowId: nullableString.optional(),
-      visibility: _enum(["open", "private"]).optional()
+      visibility: _enum(["open", "private"]).optional(),
+      lifecycle: topicLifecycle.optional(),
+      archivedAt: nullableString.optional()
     }),
     create_thread: looseObject({ threadId: id, url: string2().optional() }),
     thread_update: looseObject({
@@ -11723,7 +11739,8 @@ function buildOutputSchemas() {
     }),
     space_get: looseObject({
       space,
-      topics: array(topic).optional(),
+      topics: array(topic.extend({ lifecycle: topicLifecycle })).optional(),
+      archivedTopics: array(looseObject({ id, title: string2(), lifecycle: literal("archived") })).optional(),
       members: array(member).optional(),
       total: number2().int().min(0),
       nextCursor: string2().optional(),
@@ -11732,7 +11749,8 @@ function buildOutputSchemas() {
       defaultWorkflow: workflowSummary.optional()
     }),
     topic_get: looseObject({
-      topic,
+      topic: topic.extend({ lifecycle: topicLifecycle }),
+      lifecycleChoices: array(topicLifecycle).optional(),
       space,
       workflow: workflowSummary.optional(),
       threads: array(thread).optional(),
@@ -12823,7 +12841,8 @@ var OUTPUT_SHAPERS = {
   ]),
   create_topic: (result) => defined([
     ["topicId", result.id],
-    ["url", result.url]
+    ["url", result.url],
+    ["lifecycle", result.lifecycle]
   ]),
   create_thread: (result) => defined([
     ["threadId", result.id],
@@ -13616,7 +13635,7 @@ var ORIENTATION_SECTIONS = [
   },
   {
     brief: "1. Recall before re-deriving, but Arbor is memory, not truth: check live sources and post what you checked.",
-    full: `1. RECALL FIRST — but Arbor is MEMORY, NOT TRUTH. Run \`recall\` before re-deriving or restating anything — it may already be settled; cite prior work ([label](#con_…)) and build on it. Phrase the query in PROBLEM-LANGUAGE (a natural-language question — "how do agents handle X"), not extracted keywords; it ranks better. Empty recall is itself worth noting. If you already know a place's name, \`tree\` with \`query\` returns that lookup only (example: \`360training / Delivery & Reviews\` is Space then Topic); \`tree\` without query maps structure you don't know — don't paginate it looking for a name. In a large Space, don't search the whole org by habit: scope \`recall\` with \`space\`/\`topic\`/\`thread\` before deeper reads. External tree reads page four roots; follow \`nextCursor\`, use \`all=true\` only for deliberate complete enumeration, and scope \`depth=threads\` to one Space or Topic. On that map, \`activeThreadCount\` is the current working set (active/stuck/needs-review/standing), while \`status\` is the Topic attention rollup: \`stuck\` means any stuck Thread; \`attention\` means needs-review or an open request; \`healthy\` means neither. A contribution records what was true when it was WRITTEN, so before you assert the CURRENT state of anything outside Arbor — a PR, a build, a deploy, a config — check the live source; another contribution is not evidence of the present, and neither is a local copy of something whose home is elsewhere. And when you DO check, post the RECEIPT with the claim (AD-209): attach the actual output/screenshot (an attached file becomes a durable artifact carrying who-captured-it and when, citable as #art_… forever) or name exactly what you checked and when ("CI run #841, green, checked just now") — a "verified" with no receipt is a claim the next reader must take on faith or re-derive. When a receipted claim has AGED and matters again, don't re-trust it and don't silently re-argue it: \`request\` a re-check ("re-run this check"), and whoever runs it answers through the request with fresh evidence. WHY: a room where everyone re-derives is just a chat log — but a room that mistakes its own memory for the world confidently reports blockers that no longer exist, and this week's failures were exactly that: stale claims re-asserted as current because nothing distinguished a receipted observation from confident prose. And orient to the ROOM the way you orient to the record: \`tree\` is the map AND the way in — it carries each room's \`lanesForYou\`, the room's standing ways to help (\`contributionLanes\`) that match what you said you do; follow one into \`space_get\`/\`topic_get\`, where the room's purpose, guidance, goals, and full list of ways to help live. A way to help is an invitation, never an obligation: what you OWE is only ever in \`inbox\`.`
+    full: `1. RECALL FIRST — but Arbor is MEMORY, NOT TRUTH. Run \`recall\` before re-deriving or restating anything — it may already be settled; cite prior work ([label](#con_…)) and build on it. Phrase the query in PROBLEM-LANGUAGE (a natural-language question — "how do agents handle X"), not extracted keywords; it ranks better. Empty recall is itself worth noting. If you already know a place's name, \`tree\` with \`query\` returns that lookup only (example: \`360training / Delivery & Reviews\` is Space then Topic); \`tree\` without query maps structure you don't know — don't paginate it looking for a name. In a large Space, don't search the whole org by habit: scope \`recall\` with \`space\`/\`topic\`/\`thread\` before deeper reads. External tree reads page four roots; follow \`nextCursor\`, use \`all=true\` only for deliberate complete enumeration, and scope \`depth=threads\` to one Space or Topic. On that map, \`activeThreadCount\` is the current working set (active/stuck/needs-review/standing), while \`lifecycle\` is the Topic's deliberate status (planned, open, on-hold, closed), set by its owner or a Space admin and never derived from its Threads — a Closed Topic still takes new Threads. A contribution records what was true when it was WRITTEN, so before you assert the CURRENT state of anything outside Arbor — a PR, a build, a deploy, a config — check the live source; another contribution is not evidence of the present, and neither is a local copy of something whose home is elsewhere. And when you DO check, post the RECEIPT with the claim (AD-209): attach the actual output/screenshot (an attached file becomes a durable artifact carrying who-captured-it and when, citable as #art_… forever) or name exactly what you checked and when ("CI run #841, green, checked just now") — a "verified" with no receipt is a claim the next reader must take on faith or re-derive. When a receipted claim has AGED and matters again, don't re-trust it and don't silently re-argue it: \`request\` a re-check ("re-run this check"), and whoever runs it answers through the request with fresh evidence. WHY: a room where everyone re-derives is just a chat log — but a room that mistakes its own memory for the world confidently reports blockers that no longer exist, and this week's failures were exactly that: stale claims re-asserted as current because nothing distinguished a receipted observation from confident prose. And orient to the ROOM the way you orient to the record: \`tree\` is the map AND the way in — it carries each room's \`lanesForYou\`, the room's standing ways to help (\`contributionLanes\`) that match what you said you do; follow one into \`space_get\`/\`topic_get\`, where the room's purpose, guidance, goals, and full list of ways to help live. A way to help is an invitation, never an obligation: what you OWE is only ever in \`inbox\`.`
   },
   {
     brief: "2. Contribute one additive, typed point a newcomer can follow; stamp instead of restating.",
@@ -14278,7 +14297,8 @@ var ACTION_DEFINITIONS = [
       title: string2().min(1).describe("the topic's name — an area of work, not a question"),
       purpose: string2().optional().describe("what this Topic accomplishes and what belongs here, leading with its primary role — Direction, Delivery, Operations, Intake, Coordination, or Learning; name an external or split source of truth or a handoff boundary only when it materially matters"),
       workflow: string2().optional().describe("a workflow id from `space_get.workflows` (pick by summary) — a built-in such as `queue` or a catalog `wfl_…`; must already be attached to this Space"),
-      visibility: _enum(["open", "private"]).optional().describe("`open` (default): every Space member sees it. `private`: only its roster plus the Space's admins and the org's owner/admins — creating one takes Space admin; you start on the roster")
+      visibility: _enum(["open", "private"]).optional().describe("`open` (default): every Space member sees it. `private`: only its roster plus the Space's admins and the org's owner/admins — creating one takes Space admin; you start on the roster"),
+      lifecycle: _enum(INITIAL_TOPIC_LIFECYCLES).optional().describe("the Topic's starting status: `open` (default) or `planned` (not started yet); change it later with `topic_update --lifecycle`")
     },
     surfaces: ["mcp", "cli"],
     toolset: "structure",
@@ -14286,14 +14306,15 @@ var ACTION_DEFINITIONS = [
   },
   {
     name: "topic_update",
-    title: "Edit a topic's title or purpose",
-    description: "Edit a Topic's title, purpose, or `--workflow` (pick from `space_get.workflows` by summary; blank inherits the Space default), patching only supplied fields, or archive it reversibly (`--archived true`, admin-only; `false` restores). Norms belong in topic guidance and ways to help, not here.",
+    title: "Edit a topic's title, purpose, or status",
+    description: "Edit a Topic's title, purpose, or `--workflow` (pick from `space_get.workflows` by summary; blank inherits the Space default), patching only supplied fields, or set its deliberate status with `--lifecycle` (`archived`: admin-only). Norms belong in topic guidance and ways to help, not here.",
     inputSchema: {
       topicId: string2().describe("the topic to edit, top_…"),
       title: string2().min(1).optional().describe("a new title — an area of work, not a question"),
       purpose: string2().optional().describe("a new purpose — what this Topic accomplishes and what belongs here, leading with its primary role (Direction, Delivery, Operations, Intake, Coordination, or Learning); name an external or split source of truth or a handoff boundary only when it materially matters"),
       workflow: string2().nullable().optional().describe("a workflow id from `space_get.workflows` (pick by summary) — a built-in such as `queue` or a catalog `wfl_…`; must be attached to the Space; blank or null inherits the Space default"),
-      archived: boolean2().optional().describe("true archives the Topic: it and everything in it leave the Space read, tree, thread lists and default recall and become read-only, each Thread keeping its status; false restores it. Org owner/admin or Space admin only, as the only change; refused while a Run in it is active"),
+      lifecycle: _enum(TOPIC_LIFECYCLES).optional().describe("the Topic's status, as the only change: `planned` (not started), `open` (the default), `on-hold` (paused), `closed` (finished; still visible and still takes new Threads) — the Topic owner or a Space admin; `archived` (hidden and read-only until restored, refused while a Run in it is active) — org owner/admin or Space admin only, and leaving it likewise. Never changes a Thread's status"),
+      archived: boolean2().optional().describe("same as `--lifecycle archived` (true) or restoring an archived Topic to `open` (false): it and everything in it leave the Space read, tree, thread lists and default recall and become read-only, each Thread keeping its status. Org owner/admin or Space admin only, as the only change; refused while a Run in it is active"),
       visibility: _enum(["open", "private"]).optional().describe("Space admin only: `private` limits the Topic (its threads, contributions, artifacts) to its roster plus Space/org admins; `open` shows it to every Space member again")
     },
     surfaces: ["mcp", "cli"],
@@ -16960,7 +16981,7 @@ var ACTIONS = ACTION_DEFINITIONS.map((action) => {
 });
 
 // ../actions/src/retention-entry.ts
-var ARBOR_VERSION = "0.24.35";
+var ARBOR_VERSION = "0.24.36";
 var historyPolicySchema = _enum(["full", "checkpoint"]).optional().describe("text Artifacts: future history retention policy; full retains every source snapshot, checkpoint keeps metadata for every revision and source only when explicitly retained");
 var retainSourceSchema = boolean2().optional().describe("edit: in checkpoint mode, retain this newly minted content revision's source");
 var checkpointSchema = boolean2().optional().describe("edit: retain the exact current version source without incrementing content version");
@@ -17368,7 +17389,7 @@ function dispositionFilename(value) {
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.24.35",
+  version: "0.24.36",
   description: "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   keywords: [
     "agents",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.24.35",
+  "version": "0.24.36",
   "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "keywords": [
     "agents",