@lambdacurry/arbor 0.21.1 → 0.21.3

package/dist/arbor.js

@@ -2297,6 +2297,16 @@ var artifacts = sqliteTable("artifacts", {
   tierIdx: index("artifacts_tier_idx").on(t.retrievalTier),
   ownerIdx: index("artifacts_owner_idx").on(t.ownerProfileId)
 }));
+var artifactLivePreviewSurfaces = sqliteTable("artifact_live_preview_surfaces", {
+  artifactId: text("artifact_id").primaryKey().references(() => artifacts.id),
+  threadId: text("thread_id").notNull().references(() => threads.id),
+  boundByProfileId: text("bound_by_profile_id").notNull().references(() => profiles.id),
+  executionContextId: text("execution_context_id").notNull().references(() => executionContexts.id),
+  revision: integer("revision").notNull().default(1),
+  boundAt: ts("bound_at").notNull()
+}, (t) => ({
+  threadUq: uniqueIndex("artifact_live_preview_surfaces_thread_uniq").on(t.threadId)
+}));
 var artifactVersions = sqliteTable("artifact_versions", {
   id: text("id").primaryKey(),
   artifactId: text("artifact_id").notNull().references(() => artifacts.id),
@@ -17163,6 +17173,24 @@ var recallHit = exports_external.looseObject({
   url: nullableString,
   createdAt: timestamp
 });
+var artifactLivePreviewThread = exports_external.looseObject({
+  id,
+  title: exports_external.string()
+});
+var artifactLivePreview = exports_external.discriminatedUnion("status", [
+  exports_external.looseObject({
+    thread: artifactLivePreviewThread,
+    boundAt: timestamp,
+    status: exports_external.literal("configured"),
+    url: exports_external.string()
+  }),
+  exports_external.looseObject({
+    thread: artifactLivePreviewThread,
+    boundAt: timestamp,
+    status: exports_external.literal("unavailable"),
+    url: exports_external.never().optional()
+  })
+]);
 var contributionRef = exports_external.looseObject({
   id,
   objectType: exports_external.string(),
@@ -17731,6 +17759,18 @@ var MCP_OUTPUT_SCHEMAS = {
     association: jsonObject.nullable(),
     message: exports_external.string()
   }),
+  feedback_status: exports_external.object({
+    feedbackId: id,
+    type: exports_external.enum(ARBOR_FEEDBACK_TYPES),
+    status: exports_external.enum(ARBOR_FEEDBACK_STATUSES),
+    private: exports_external.literal(true),
+    associatedWithSharedKnowledge: exports_external.boolean(),
+    createdAt: timestamp,
+    updatedAt: timestamp,
+    reviewedAt: timestamp.nullable(),
+    resolvedAt: timestamp.nullable(),
+    message: exports_external.string()
+  }),
   admin_feedback_capability: jsonObject,
   admin_feedback_evidence: jsonObject,
   admin_feedback_topic: jsonObject,
@@ -17972,7 +18012,10 @@ var MCP_OUTPUT_SCHEMAS = {
     url: exports_external.string().optional(),
     versions: exports_external.array(jsonObject).optional(),
     appBundles: exports_external.array(jsonObject).optional(),
-    usedByApps: exports_external.array(jsonObject).optional()
+    usedByApps: exports_external.array(jsonObject).optional(),
+    livePreview: artifactLivePreview.nullable().optional(),
+    threadId: id.nullable().optional(),
+    changed: exports_external.boolean().optional()
   }),
   artifact_get: exports_external.looseObject({
     id,
@@ -17984,6 +18027,7 @@ var MCP_OUTPUT_SCHEMAS = {
     versions: exports_external.array(jsonObject).optional(),
     appBundles: exports_external.array(jsonObject),
     usedByApps: exports_external.array(jsonObject),
+    livePreview: artifactLivePreview.nullable(),
     watching: exports_external.boolean(),
     url: exports_external.string()
   }),
@@ -18594,6 +18638,7 @@ var MCP_TOOL_ANNOTATIONS = {
   feedback_recall: readOnly,
   feedback_thread_get: readOnly,
   contribute_arbor_feedback: additive,
+  feedback_status: readOnly,
   admin_feedback_capability: destructiveIdempotent,
   admin_feedback_evidence: destructive,
   admin_feedback_topic: destructive,
@@ -18709,9 +18754,10 @@ var CONTRIBUTION_ADD_LINK_RELS = [
   "tracked-as",
   "delivered-by"
 ];
+var ARBOR_FEEDBACK_GUIDANCE = `ARBOR-SPECIFIC FEEDBACK — Privately capture ONE bounded report through \`contribute_arbor_feedback\` when Arbor itself caused meaningful friction: confusing semantics; surprising Arbor UI/MCP/CLI behavior; a missing Arbor capability; repeated Arbor retries; an Arbor-specific workaround; or misleading state, recovery guidance, or ergonomics. Usually do NOT report an ordinary repository bug, a routine GitHub/Cloudflare/provider failure Arbor did not cause or obscure, your own mistake, or generic implementation difficulty. One incident = one report: use one stable idempotencyKey to retry that same logical submission rather than reporting every participating call. Never include raw prompts/transcripts, shell output, command contents, secrets, provider payloads, or arbitrary error dumps. The raw body remains private; \`feedback_status\` reads only a receipt you own, while \`feedback_tree\` → \`feedback_recall\` → \`feedback_thread_get\` browses deliberately shared, sanitized knowledge.`;
 var ORIENTATION = `Arbor is your team's deliberation room and shared memory — people and agents settle typed work here, and Arbor remembers what's decided. To work well:
 
-Meaningful friction with Arbor itself can be privately contributed through \`contribute_arbor_feedback\`; the raw body is never posted into the current Thread or the shared Arbor Feedback forum. Browse the curated shared forum with \`feedback_tree\` → \`feedback_recall\` → \`feedback_thread_get\`.
+${ARBOR_FEEDBACK_GUIDANCE}
 
 Arbor's MCP is the collaboration and durable-knowledge surface. Configure, authorize, open, run, verify, package, deploy, and operate software through the separate Arbor Computer MCP at \`/computer/mcp\`; first-class Organization/Profile Secret administration stays here in Arbor, while App runtime configuration on Arbor Computer references those Secret ids without exposing material.
 
@@ -18726,6 +18772,19 @@ Arbor's MCP is the collaboration and durable-knowledge surface. Configure, autho
 8. DURABLE OUTPUT IS AN ARTIFACT, NOT A LONG CONTRIBUTION (AD-201). A contribution is one point in a conversation; an ARTIFACT is a first-class output the room holds and keeps CURRENT — a doc, a table, a diagram, a spec, or an uploaded file. When your point is really a deliverable the team will read or UPDATE later — a table of options, a reference doc, a plan, a rubric — make it an artifact (\`artifact\` verb=create with kind doc/table/diagram/html + \`source\`, or promote a file) instead of pasting it into prose. Text-kind artifacts are LIVING: \`artifact_get\` it, then \`artifact\` verb=edit naming the \`baseVersion\` you read — patches apply exact-match and atomically, one version per call, every version attributed. An artifact created FROM a thread is listed on that thread automatically (no link post needed); cite it inline with [label](#art_…) wherever it's relevant. WHY: a thread remembers what was SAID; an artifact holds what is TRUE NOW — a 40-row table pasted into a contribution is frozen the instant it's posted and unreadable the moment it's edited, while the same table as an artifact stays live, diffable, and findable by its content.
 
 Run \`arbor help\` (or read the MCP tool list) for the exact command/flags — those stay generated from the live action surface, so they're always current.`;
+var COMPUTER_ORIENTATION = `Arbor Computer is the complete software execution platform attached to Arbor's durable collaboration graph. It configures project environments, executes and verifies work, packages and releases Apps, and preserves reviewable evidence; it does not schedule agents or replace Arbor collaboration.
+
+${ARBOR_FEEDBACK_GUIDANCE}
+
+1. ORIENT, CONFIGURE, AND AUTHORIZE. Start with get_computer(threadId) to inspect the effective inherited recipe, repository authorization, compatibility, and durable lineage. Use set_organization_computer, set_space_computer, set_topic_computer, or set_thread_computer only when the corresponding complete sparse layer must be replaced; use github_repositories then github_connect_repository to authorize repositories at the narrowest scope that should inherit them. attach_computer mints durable protocol identity without starting a runtime; computer_open attaches as needed and starts or resumes the project environment. Each returned repository entry includes verified root instruction pointers when that repo has an AGENTS.md: read surfaced repository instructions before substantial edits or verification, then check for a nearer nested AGENTS.md once the target path is known. Repo-local instructions/scripts/config beat guessed formatter, test, lint, or build commands.
+2. READ THE CAPABILITIES CARD, NOT THE BACKEND. computer_open and computer_status describe the live PARENT Thread Computer and return the exact computerSessionId for parent filesystem, command, checkpoint, Preview, bundle, and stop operations. computer_status does not establish isolated Run activity; use computer_run_receipt(runId) and computer_process_read for Run-owned work. Command-line utilities, including Git and package managers, run through computer_exec; check unfamiliar binaries with command -v.
+3. ONE RUN PER TASK. A write Run defaults to an isolated execution environment with its own filesystem, processes, ports, and /tmp while preserving /workspace paths; a read Run shares the parent. Pass runId to Run-aware tools. If a response is lost, recover the durable operation/process identity from computer_run_receipt and read it before retrying. Once every operation is settled, computer_run_suspend publishes the exact workspace and releases the provider during an external wait; the next Run-aware operation restores that checkpoint under the same runId automatically. Suspension refuses active processes or unsettled outcomes and never replays unknown work, so reconcile process and Git/publication evidence first. An isolated local commit or Preview is not Git publication; push coherent work and prove it with computer_repo_work_status before computer_run_finish destroys the final placement. discard=true is the explicit choice to destroy proven non-durable work.
+4. CHECKPOINT COMPLETE PARENT UNITS. computer_checkpoint advances immutable parent lineage after an intermediate complete unit; computer_stop performs the final checkpoint before teardown. An isolated Run Preview is durable review output, not adoption or a checkpoint. The internal provider-handle publication operations are not agent tools.
+5. GIT AND GITHUB ARE ORDINARY COMMANDS AFTER AUTHORIZATION. Clone, fetch, pull, push, and gh run through computer_exec using a connected human's just-in-time ambient GitHub identity. Credentials never enter argv, workspace files, Git config, checkpoints, Events, logs, or receipts. A restored Computer deliberately keeps the checkout age of its snapshot, so fetch/pull before trusting remote state.
+6. VERIFY, PREVIEW, AND EXPORT. computer_verify captures a public URL directly without opening a project runtime. computer_publish_preview preserves immutable static output from either the parent or an active isolated write Run. computer_export moves bounded files into durable Thread Attachments; place returned Markdown exactly where the media belongs and cite the matching attachment ids.
+7. PACKAGE, DEPLOY, ACTIVATE, AND OPERATE APPS HERE. computer_publish_app_bundle creates the immutable executable bundle from verified parent bytes. Then use app_create, app_config_apply, app_deploy, app_deployment_get, app_activate, app_get, app_fetch/app_request, app_rollback, app_set_access, app_reset_state/app_restore_state, and app_archive as one workflow-closed release surface. First-class Organization/Profile Secrets remain on Arbor's collaboration MCP because they are broader identity-owned resources; App configuration here references existing Secret ids and never accepts or returns secret material.
+8. FINISH WHAT YOU START. Stop the parent after its final complete unit, finish every Run, and preserve evidence before teardown. When reporting collaboration conclusions through Arbor, pass the producing computerSessionId and attachmentIds to contribute or respond.
+9. CLOSE OUT ARBOR DOGFOOD. When developing Arbor through Arbor, ask: “Did Arbor itself create meaningful friction or require an Arbor-specific workaround?” If yes, apply the classifier above and privately capture one bounded report before closing the development loop; keep unrelated product friction out of the implementation Thread. If no, close normally without manufacturing feedback.`;
 var PROSE_LISTS = exports_external.registry();
 function proseList(description) {
   const schema = exports_external.array(exports_external.string()).describe(description);
@@ -18875,7 +18934,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "contribute_arbor_feedback",
     title: "Privately contribute feedback about Arbor",
-    description: "Privately contribute feedback about using Arbor, including friction, evidence, critiques, questions, risks, or improvement proposals. The submitted body is not posted into the current Thread or shared Arbor Feedback forum; optional Topic/Thread ids only associate the private evidence with sanitized shared knowledge.",
+    description: "Privately capture one bounded report when Arbor itself caused meaningful product or ergonomics friction; do not use this for ordinary repository bugs, routine un-obscured provider failures, agent mistakes, or generic implementation difficulty. The body is never posted into the current Thread or shared forum; one incident should produce one report, with a stable idempotencyKey used only to retry that same submission.",
     inputSchema: {
       type: exports_external.enum(ARBOR_FEEDBACK_TYPES).optional().describe("the contribution move (default comment); decision is reserved for shared forum curation"),
       body: exports_external.string().min(1).describe("the private feedback body"),
@@ -18890,6 +18949,17 @@ var ACTION_DEFINITIONS = [
     toolset: "feedback",
     run: forward("feedback.contribute")
   },
+  {
+    name: "feedback_status",
+    title: "Check your private Arbor feedback receipt",
+    description: "READ ONLY: Check the useful lifecycle of one private Arbor feedback receipt you own. Missing and not-owned receipts look identical, and this returns no raw body, identities, moderator diagnostics, or shared association targets.",
+    inputSchema: {
+      feedbackId: exports_external.string().describe("your private Arbor feedback receipt id, fbk_…")
+    },
+    surfaces: ["mcp", "cli"],
+    toolset: "feedback",
+    run: forward("feedback.status")
+  },
   {
     name: "admin_feedback_capability",
     title: "Manage Arbor Feedback capabilities",
@@ -19649,7 +19719,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "get_artifact",
     title: "Read an artifact",
-    description: "Read an artifact: current source + version + immutable versions[].id (artv_…), plus who edited and via what. READ BEFORE YOU EDIT — the version number you read is the baseVersion your edit must name. Use the matching versions[].id as artifactVersionId when publishing an AppBundle. Pass --version to read an old snapshot.",
+    description: "Read an Artifact's current source/version/history plus its current executable Live Preview surface when bound. READ BEFORE YOU EDIT — the version number you read is the baseVersion your edit must name. Surface binding is current Artifact identity metadata and remains current even when --version reads old content.",
     inputSchema: {
       artifactId: exports_external.string().describe("the artifact, art_…"),
       version: exports_external.number().optional().describe("read this old snapshot instead of the current")
@@ -19676,6 +19746,18 @@ var ACTION_DEFINITIONS = [
       verb: Array.isArray(input.patches) ? "patch" : "replace"
     })
   },
+  {
+    name: "set_artifact_live_preview",
+    title: "Set an Artifact's live Thread surface",
+    description: "Bind one Artifact to an existing same-Space Thread Live Preview, making the Artifact the durable entry point for that executable surface. Omit --thread-id to clear the binding; this changes no Artifact source/version and does not create or reconfigure a Computer.",
+    inputSchema: {
+      artifactId: exports_external.string().describe("the Artifact, art_…"),
+      threadId: exports_external.string().optional().describe("the configured Thread Live Preview to bind, thr_…; omit to clear")
+    },
+    surfaces: ["cli"],
+    toolset: "artifacts",
+    run: forward("artifact.setLivePreview")
+  },
   {
     name: "transition_artifact",
     title: "Transition an artifact's lifecycle",
@@ -20491,9 +20573,9 @@ var ACTION_DEFINITIONS = [
   {
     name: "artifact",
     title: "Create or edit an Artifact",
-    description: "Create or edit a durable versioned Artifact, or promote a Thread attachment; read artifact_get and its baseVersion before editing, while lifecycle/removal stay in artifact_transition and artifact_delete. Text edits replace source or apply exact-match patches atomically, file artifacts use contentRef, and computer-produced artifacts may cite computerSessionId.",
+    description: "Create or edit a durable versioned Artifact, bind its executable Thread Live Preview, or promote a Thread attachment; read artifact_get before changing it, while lifecycle/removal stay in artifact_transition and artifact_delete. Live-surface binding changes Artifact identity metadata, not source/version content.",
     inputSchema: {
-      verb: exports_external.enum(["create", "edit", "promote_attachment"]).describe("which artifact move"),
+      verb: exports_external.enum(["create", "edit", "set_live_preview", "promote_attachment"]).describe("which artifact move"),
       title: exports_external.string().optional().describe("create: the artifact's title"),
       kind: exports_external.enum(["doc", "table", "diagram", "html", "file"]).optional().describe("create: structural kind (default file). doc/table/diagram/html are editable text"),
       type: exports_external.string().optional().describe("create: semantic type, e.g. decision|summary|plan|markdown|table|research-brief"),
@@ -20504,7 +20586,8 @@ var ACTION_DEFINITIONS = [
       sourceThreadId: exports_external.string().optional().describe("create: the thread it came from"),
       computerSessionId: exports_external.string().optional().describe("create: the attached computer session that produced it, cms_…"),
       sourceContributionIds: exports_external.array(exports_external.string()).optional().describe("create: contributions it distills"),
-      artifactId: exports_external.string().optional().describe("edit: the Artifact, art_…"),
+      artifactId: exports_external.string().optional().describe("edit/set_live_preview: the Artifact, art_…"),
+      threadId: exports_external.string().optional().describe("set_live_preview: the configured Thread Live Preview, thr_…; omit to clear the binding"),
       baseVersion: exports_external.number().optional().describe("edit: the version you READ (from get/create) — stale base is rejected with the current source"),
       patches: exports_external.array(exports_external.object({ old: exports_external.string(), new: exports_external.string() })).optional().describe("edit: exact-match hunks applied in order, atomically; each old must match exactly once"),
       note: exports_external.string().optional().describe("edit: one-line summary of what changed"),
@@ -20515,13 +20598,14 @@ var ACTION_DEFINITIONS = [
     run: dispatch({
       create: "artifact.create",
       edit: "artifact.edit",
+      set_live_preview: "artifact.setLivePreview",
       promote_attachment: "attachment.promote"
     }, (verb, input) => verb === "edit" ? { ...input, verb: Array.isArray(input.patches) ? "patch" : "replace" } : input)
   },
   {
     name: "artifact_get",
     title: "Read an Artifact",
-    description: "Read an Artifact's current source, version, immutable history, and AppBundle references, or pass version for an older snapshot. It cannot edit content, change lifecycle, promote an attachment, or delete an Artifact.",
+    description: "Read an Artifact's current source, version, immutable history, AppBundle references, and current executable Live Preview surface, or pass version for an older content snapshot. It cannot edit content, bind a surface, change lifecycle, promote an attachment, or delete an Artifact.",
     inputSchema: {
       artifactId: exports_external.string().describe("the Artifact, art_…"),
       version: exports_external.number().optional().describe("read this old snapshot instead of the current")
@@ -21577,7 +21661,8 @@ function buildInput(inputSchema, flags, command) {
 var COMMAND_WORD_OVERRIDES = {
   contribute_arbor_feedback: "feedback",
   feedback_recall: "feedback find",
-  feedback_thread_get: "feedback thread"
+  feedback_thread_get: "feedback thread",
+  feedback_status: "feedback status"
 };
 function commandWords(action) {
   return COMMAND_WORD_OVERRIDES[action.name] ?? action.name.replace(/_/g, " ");
@@ -21589,6 +21674,7 @@ var POSITIONAL_FIELDS = {
   contribute_arbor_feedback: ["body"],
   feedback_recall: ["query"],
   feedback_thread_get: ["threadId"],
+  feedback_status: ["feedbackId"],
   admin_feedback_capability: ["verb"],
   admin_feedback_evidence: ["verb"],
   admin_feedback_topic: ["action"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.21.1",
+  "version": "0.21.3",
   "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",