@tacuchi/agent-workflow-cli 22.4.2 → 24.0.0

package/dist/runtime/namespace-resolver.js

@@ -1,5 +1,16 @@
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { NAMESPACE_REGEX, normalizeNamespace } from "./namespace.js";
+export class WorklineDirectoryError extends Error {
+    root;
+    namespaces;
+    code = "WORKLINE_NAMESPACE_AMBIGUOUS";
+    constructor(root, namespaces) {
+        super(`More than one Workline namespace is materialized at ${root}: ${namespaces.join(", ")}. Pass --namespace <name> (or set AW_NAMESPACE) to select one.`);
+        this.root = root;
+        this.namespaces = namespaces;
+        this.name = "WorklineDirectoryError";
+    }
+}
 export const DEFAULT_NAMESPACE = "workflow";
 export const ENV_VAR_NAMESPACE = "AW_NAMESPACE";
 /**
@@ -18,49 +29,124 @@ export class NamespaceResolver {
         this.env = env;
     }
     async resolve(flag) {
+        const directory = await this.resolveDirectory(flag);
+        return { namespace: directory.namespace, source: directory.namespaceSource };
+    }
+    /**
+     * Resolve both the namespace and the root it scopes.  Explicit namespace
+     * selection is deliberately honoured before discovery; an explicit request
+     * for a different namespace must not be silently redirected by a neighbouring
+     * marker.  Without an explicit selection, the closest ancestor with one
+     * canonical marker wins, while two markers at that same level are a real
+     * ambiguity rather than a reason to fall back to a global preference.
+     */
+    async resolveDirectory(flag) {
+        const cwd = this.env.cwd();
         if (flag !== undefined && flag.trim().length > 0) {
-            return { namespace: normalizeNamespace(flag), source: "flag" };
+            const namespace = normalizeNamespace(flag);
+            const root = await this.findMarkerForNamespace(cwd, namespace);
+            return {
+                root: root ?? cwd,
+                namespace,
+                namespaceSource: "flag",
+                materialized: root !== null,
+            };
         }
         const envVal = this.env.get(ENV_VAR_NAMESPACE);
         if (envVal !== undefined && envVal.trim().length > 0) {
-            return { namespace: normalizeNamespace(envVal), source: "env" };
+            const namespace = normalizeNamespace(envVal);
+            const root = await this.findMarkerForNamespace(cwd, namespace);
+            return {
+                root: root ?? cwd,
+                namespace,
+                namespaceSource: "env",
+                materialized: root !== null,
+            };
         }
-        const workspaceNs = await this.detectFromWorkspace(this.env.cwd());
-        if (workspaceNs !== null) {
-            return { namespace: workspaceNs, source: "workspace" };
+        const workspace = await this.detectFromWorkspace(cwd);
+        if (workspace !== null) {
+            return {
+                root: workspace.root,
+                namespace: workspace.namespace,
+                namespaceSource: "workspace",
+                materialized: true,
+            };
         }
         const configPath = namespaceConfigFile(this.env.homeDir());
         if (await this.fs.exists(configPath)) {
             const raw = await this.fs.readText(configPath);
-            return { namespace: normalizeNamespace(raw), source: "config" };
+            const namespace = normalizeNamespace(raw);
+            const root = await this.findMarkerForNamespace(cwd, namespace);
+            return {
+                root: root ?? cwd,
+                namespace,
+                namespaceSource: "config",
+                materialized: root !== null,
+            };
         }
-        return { namespace: normalizeNamespace(DEFAULT_NAMESPACE), source: "default" };
+        const namespace = normalizeNamespace(DEFAULT_NAMESPACE);
+        const root = await this.findMarkerForNamespace(cwd, namespace);
+        return {
+            root: root ?? cwd,
+            namespace,
+            namespaceSource: "default",
+            materialized: root !== null,
+        };
     }
     async detectFromWorkspace(cwd) {
+        let dir = cwd;
+        while (true) {
+            const matches = await this.namespacesAt(dir);
+            if (matches.length > 1)
+                throw new WorklineDirectoryError(dir, matches);
+            const [namespace] = matches;
+            if (namespace !== undefined)
+                return { root: dir, namespace };
+            const parent = dirname(dir);
+            if (parent === dir)
+                return null;
+            dir = parent;
+        }
+    }
+    async findMarkerForNamespace(cwd, namespace) {
+        let dir = cwd;
+        while (true) {
+            if (await this.isCanonicalMarker(join(dir, `.${namespace}`, "sessions")))
+                return dir;
+            const parent = dirname(dir);
+            if (parent === dir)
+                return null;
+            dir = parent;
+        }
+    }
+    async namespacesAt(dir) {
         let entries;
         try {
-            entries = await this.fs.list(cwd);
+            entries = await this.fs.list(dir);
         }
         catch {
-            return null;
+            return [];
         }
         const matches = [];
         for (const entry of entries) {
-            if (entry.type !== "dir")
-                continue;
-            if (!entry.name.startsWith("."))
+            if (entry.type !== "dir" || !entry.name.startsWith("."))
                 continue;
             const candidate = entry.name.slice(1);
             if (!NAMESPACE_REGEX.test(candidate))
                 continue;
-            const sessionsPath = join(entry.path, "sessions");
-            if (await this.fs.exists(sessionsPath)) {
+            if (await this.isCanonicalMarker(join(entry.path, "sessions"))) {
                 matches.push(candidate);
             }
         }
-        if (matches.length === 1)
-            return matches[0] ?? null;
-        return null;
+        return matches.sort();
+    }
+    async isCanonicalMarker(path) {
+        try {
+            return (await this.fs.stat(path)).type === "dir";
+        }
+        catch {
+            return false;
+        }
     }
 }
 //# sourceMappingURL=namespace-resolver.js.map

package/dist/runtime/namespace-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"namespace-resolver.js","sourceRoot":"","sources":["../../src/runtime/namespace-resolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"namespace-resolver.js","sourceRoot":"","sources":["../../src/runtime/namespace-resolver.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tacuchi/agent-workflow-cli",
-  "version": "22.4.2",
+  "version": "24.0.0",
   "description": "Runtime CLI for Workline — the stages + loops + artifacts system for agent work. Bundles the universal `w` skill set under `skills/w/` (slash commands `/w:*`: spec-new/spec-refine, plan-new/plan-exec, quick, persist, workspace-init, export-*); `self install --target <host>` copies SKILL + commands + hooks into the host. Pluggable capability skills resolve through `.workflow/skills.toml`. Namespace auto-detected from any `.<ns>/sessions/` dir in CWD; default `workflow`.",
   "type": "module",
   "bin": {
@@ -47,6 +47,8 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/node": "^22.10.5",
+    "@types/pg": "^8.23.1",
+    "@types/pg-cursor": "^2.7.2",
     "@types/react": "^18.3.28",
     "ink-testing-library": "^4.0.0",
     "typescript": "^5.7.3",
@@ -59,6 +61,8 @@
     "@inkjs/ui": "^2.0.0",
     "@inquirer/prompts": "^7.10.1",
     "ink": "^5.2.1",
+    "pg": "^8.23.0",
+    "pg-cursor": "^2.22.0",
     "react": "^18.3.1",
     "smol-toml": "^1.6.1"
   }

package/skills/w/README.md

@@ -21,6 +21,6 @@ It implements the **stages + loops + artifacts** model. The design source lives
 | [`hooks/`](hooks/) | — | Host hook template (branch-check, sql-mutation-guard, checkpoint, …) |
 | [`SKILL.md`](SKILL.md) | overview | The `w` orientation skill (guide to the full model) |
 
-## Bootstrap
+## Workspace
 
-Run [`/w:workspace-init`](commands/workspace-init.md) once to turn a folder into a workspace (minimal scaffold: `.workflow/sessions/` + `.workflow/skills.toml` + `WORKSPACE` block + CLI-owned `.gitignore`; `docs/` folders are born on demand). No project/hub distinction — a workspace has 1+ sources.
+Every invoked directory is a usable implicit workspace. The closest `.<namespace>/sessions/` ancestor supplies its root; with none, the invoked directory itself is the root. [`/w:workspace-init`](commands/workspace-init.md) is optional: it materializes the small runtime early, or configures explicit sources and overrides.

package/skills/w/SKILL.md

@@ -27,9 +27,9 @@ Anyone needing orientation — a loop at start, a new agent in the workspace, or
 
 ## Knowledge
 
-### Workspace (no modes)
+### Workspace (implicit first)
 
-A single concept: **workspace**. There is no project/hub split. The folder where the agent starts becomes a workspace with `/w:workspace-init` (minimal scaffold: `.workflow/sessions/` + `.workflow/skills.toml` + the `WORKSPACE` block in CLAUDE.md + the CLI-owned `.gitignore`; each `docs/<cat>` folder is born on demand at `aw next-number`). It has 1+ sources (repos); "standalone" = a single source.
+A single concept: **workspace**. There is no project/hub split and no mandatory initialization. The nearest ancestor containing `.<namespace>/sessions/` is the root; with no marker, the folder where the agent starts is the **implicit workspace** root. A pure read never creates the marker. The first mutation materializes only the runtime and `/w:workspace-init` is an optional early materialization; explicit sources add configured metadata. `workspace` is the reserved source that points to the root, and any extra alias is explicit.
 
 ### The 3-layer architecture + `docs/` zone
 
@@ -77,14 +77,13 @@ Both authoring entry points can **split** with consent: `spec-new` may split a m
 
 ### Operating context — where everything lands
 
-Before any loop, the AI resolves its **operating context** on **every prompt** with two detections: **workspace?** (`.<ns>/sessions/` exists) + **session to continue?** (an active one, or a recent one this prompt continues). That decides the behavior and **where artifacts land** (SQL, scripts, decisions, …):
+Before any loop, the AI resolves the **workspace root** on every prompt (closest `.<ns>/sessions/` ancestor, otherwise the invoked directory) and then the session to continue. The marker is evidence of materialization, not permission to use Workline; pure reads stay byte-identical. That decides where artifacts land:
 
-| Workspace? | Trigger | → Behavior + routing |
-|---|---|---|
-| **Yes** | **flow command** (`quick`·`spec-*`·`plan-*`) | **new work line** → creates a **new** session (except re-running the same flow over the same input: `create_or_resume` reopens the existing one), starts the loop → artifacts go to **that** session (`SCRIPTS.sql`, …) |
-| **Yes** | **prompt with no command** (related) | **continues/reopens the most recent session** → scripts edit **its** `SCRIPTS.sql` (no new session) |
-| **Yes** | **prompt with no command** (unrelated / no session) | **no flow**: direct work → writes into `docs/` by convention + numbering (`aw next-number`). To persist work already done in this conversation, `/w:persist` classifies and routes it (`docs/research` · spec draft · plan adoption) |
-| **No** | anything | **vanilla** — no workspace, no flow; the AI is free (native) |
+| Trigger | → Behavior + routing |
+|---|---|
+| **flow command** (`quick`·`spec-*`·`plan-*`) | **new work line** → materializes if needed, creates a **new** session (except re-running the same flow over the same input: `create_or_resume` reopens the existing one), starts the loop → artifacts go to **that** session (`SCRIPTS.sql`, …) |
+| **prompt with no command** (related) | **continues/reopens the most recent session** → scripts edit its `SCRIPTS.sql` (no new session) |
+| **prompt with no command** (unrelated / no session) | **no flow**: direct work → writes into `docs/` by convention + numbering (`aw next-number`). To persist work already done in this conversation, `/w:persist` classifies and routes it (`docs/research` · spec draft · plan adoption) |
 
 **Continuity rule** (single source — the chassis and the loops reference here):
 
@@ -103,7 +102,7 @@ The flows are **composable with host-native work, never exclusive**. The host is
 
 ### The commands (`/w:` namespace)
 
-- `/w:workspace-init` — initializes the workspace.
+- `/w:workspace-init` — materializes the runtime early, or configures explicit sources.
 - `/w:spec-new` — generates an initial spec (single-pass, no loop; a bounded reconnaissance of the sources precedes the scope decision).
 - `/w:spec-refine` — starts `spec-refine-loop` to refine the spec until it is `ready-for-plan`: the blocking functional decisions closed, the architecture/implementation ones declared for PLAN.
 - `/w:plan-new` — starts `plan-new-loop` to derive an executable plan from the ready spec.

package/skills/w/artifacts/README.md

@@ -19,7 +19,7 @@ Central distinction of the model:
 
 > An artifact may be **promoted** to a `docs/` document (e.g. `SCRIPTS.sql` → `docs/scripts/`) — but **only via dedicated `export-*` skills**, **never** automatically by the loops. The spec and the plan **are not** artifacts: they are documents.
 
-> **Routing by operating context** (canonical rules: [`../SKILL.md`](../SKILL.md) § *Operating context*): inside a flow → the **active/continued** session (a prompt with no command edits the most recent session's artifacts); workspace without flow → `docs/` by convention + numbering (or explicitly via [`/w:persist`](../commands/persist.md), which classifies in-conversation work and routes it — `docs/research` · spec draft · plan adoption); no workspace → vanilla. Session→`docs/` promotion is still **only** via `export-*`; persist is the **host→`docs/`** path (it never reads sessions).
+> **Routing by operating context** (canonical rules: [`../SKILL.md`](../SKILL.md) § *Operating context*): inside a flow → the **active/continued** session (a prompt with no command edits the most recent session's artifacts); without a flow → `docs/` by convention + numbering (or explicitly via [`/w:persist`](../commands/persist.md), which classifies in-conversation work and routes it — `docs/research` · spec draft · plan adoption). Every invoked directory is an implicit root and reads create no marker. Session→`docs/` promotion is still **only** via `export-*`; persist is the **host→`docs/`** path (it never reads sessions).
 
 ---
 

package/skills/w/commands/README.md

@@ -6,15 +6,15 @@
 
 ---
 
-## Bootstrap
+## Workspace
 
-[`/w:workspace-init`](workspace-init.md) turns the current folder into a **workspace** (minimal scaffold: `.workflow/sessions/` + `.workflow/skills.toml` + `WORKSPACE` block + CLI-owned `.gitignore`; `docs/` folders are born on demand). No project/hub distinction; run once before any flow.
+Every invoked directory is a usable implicit workspace. The closest ancestor with `.<namespace>/sessions/` is reused; otherwise the invoked directory is the root. [`/w:workspace-init`](workspace-init.md) is optional: without sources it materializes only the runtime, and with sources it configures metadata.
 
 ## Index
 
 | Command | What it does | Mode |
 |---|---|---|
-| [`workspace-init`](workspace-init.md) | Workspace bootstrap | single-pass, interactive |
+| [`workspace-init`](workspace-init.md) | Materialize runtime or configure explicit sources | single-pass, interactive |
 | [`spec-new`](spec-new.md) | Generates the spec draft (`docs/specs/NNN-spec-<slug>.md`) | single-pass, no loop |
 | [`spec-refine`](spec-refine.md) | Refines the spec **in place** until it is `ready-for-plan` | starts `spec-refine-loop` |
 | [`plan-new`](plan-new.md) | Derives the executable plan (`docs/plans/PPP-plan-<slug>.md`) from the spec | starts `plan-new-loop` |

package/skills/w/commands/persist.md

@@ -38,7 +38,9 @@ Captures **work already produced in this conversation** — with or without host
 
 Every rejection names its cause and one valid next action; nothing was written. Fix the answer and repeat from step 3.
 
-Requires a **workspace** (`docs/` is the managed surface). Without one → degrade: propose `/w:workspace-init`.
+The resolved **implicit workspace** is the managed surface (`docs/`). No prior
+`/w:workspace-init` is needed: an approved apply writes only its declared
+artifact and materializes the runtime as part of that first mutation.
 
 ## More context
 

package/skills/w/commands/resume.md

@@ -28,7 +28,7 @@ No target → **every** pending item as `candidates` in the CLI's order, `propos
 2. **One option per candidate** — only for CLI candidates, in its order — each with its re-entry command, plus the `flow` slot. Canonical [option shape](../loops/CHASSIS.md#structured-choice-design--batching) and [host binding](../harness/HARNESS.md#harness-binding-matrix): the title is the label, `Progreso` + `Siguiente` the sentence.
 3. **Past the host's ceiling**, group by class into ≤3 questions; if a class still will not fit, present them **all** as labelled markdown and declare the degradation. Nothing trimmed, merged or dropped.
 4. **Choosing invokes that command in the same turn.** The destination flow opens its own session and consent boundaries.
-5. **No candidates** → nothing is pending: say it and stop, opening no choice; cheap host-memory may add a recent-focus note, never expensive or blocking. No workspace → offer `/w:workspace-init`.
+5. **No candidates** → nothing is pending: say it and stop, opening no choice; cheap host-memory may add a recent-focus note, never expensive or blocking. An implicit workspace returns `idle` without creating files.
 
 ## What the CLI decides (do not re-derive)
 

package/skills/w/commands/spec-new.md

@@ -25,8 +25,8 @@ Generates `docs/specs/NNN-spec-<slug>.md` in a single pass from the prompt in `$
 
 1. **Reconnaissance** — one shallow look at the terrain before any scope decision: adopt what the conversation settled, identify the candidate sources (`aw sources --no-git`, or the `WORKSPACE` block), look at their surface, stop. **Budget: ≤5 reads + ≤3 searches** — a cap, never a target. Never run code, query a database or search the web. Full rules: module `RECONNAISSANCE`.
 2. **Split gate** — before writing anything, judge whether the prompt bundles several **independent functional outcomes**. Borderline or thin evidence → **one spec, no question** (hypothesis to `## Assumptions`, doubt to `## Open questions`). Only clear signals earn the command's single structured-choice offer. Full rules: module `SPLIT-GATE`.
-3. **Number and slug** — `aw next-number docs/specs --claim spec-<slug>.md` CLAIMS the number and returns `claimed_path`. Derive `<slug>` from the Requirement: short kebab-case, only `[a-z0-9-]`, ≤ ~5 words / ≤ 40 chars.
-4. **Write** `docs/specs/NNN-spec-<slug>.md`, framing `$ARGUMENTS` into the draft schema below; reconnaissance findings land **only** where the filling notes allow. On an accepted split: repeat 3-4 per part, minting immediately before each write.
+3. **Slug and draft** — derive `<slug>` from the Requirement: short kebab-case, only `[a-z0-9-]`, ≤ ~5 words / ≤ 40 chars. Then frame `$ARGUMENTS` into the draft schema below; reconnaissance findings land **only** where the filling notes allow.
+4. **Publish it in one act** — `aw next-number docs/specs --publish spec-<slug>.md` with the finished draft on stdin: it assigns the correlative and writes the document atomically, and returns `published_path`. This command has no session, so it never leaves a reservation of nobody's — and an interruption leaves neither file nor consumed number. On an accepted split: repeat 3-4 per part.
 5. **Report** the generated file(s) and the next step (`/w:spec-refine docs/specs/NNN-spec-<slug>.md`).
 
 Steps 1-2 run **only on a raw user prompt** (direct invocation, or the `plan-new` mode-3 handoff). The reuse entries at the end skip them: their context arrives already established, and adopting it is transcription, not investigation.

package/skills/w/commands/status.md

@@ -26,7 +26,7 @@ Read-only single pass: no loop, no session, no writes. Transversal.
 
 > **Automation reads JSON.** Piped or with `--json` / `--format json` it emits its envelope; `--detail` is human-only.
 
-Nothing pending → one line, no empty section. No workspace → it offers `/w:workspace-init`; an empty pipeline for want of one is never "nothing pending".
+Nothing pending → one line, no empty section. In an implicit workspace that is genuinely "nothing pending"; this read creates no marker or other file.
 
 ## More context
 

package/skills/w/commands/workspace-init.md

@@ -1,5 +1,5 @@
 ---
-description: "Use when starting Workline in a folder with no workspace yet — turns it into one (minimal scaffold: sessions marker, skills.toml, WORKSPACE block, .gitignore). Run once before any flow. Backed by `aw workspace-init`."
+description: "Use to materialize Workline runtime early, or configure explicit workspace sources. Flows work without a prior init. Backed by `aw workspace-init`."
 argument-hint: --source alias:path[:branch] [--proyecto <name>] [--main-branch <branch>] [--dry-run]
 allowed-tools:
   [
@@ -8,22 +8,21 @@ allowed-tools:
   ]
 ---
 
-# workspace-init — workspace bootstrap
+# workspace-init — materialize or configure
 
-Turns the current folder into a Workline workspace: **1+ sources** (repos), one source = standalone. No project/hub modes.
+Workline already has an implicit workspace at the resolved root: the nearest ancestor with `.<namespace>/sessions/`, or exactly the invoked directory when none exists. It never guesses a Git root.
 
-`aw workspace-init --source alias:path[:branch] [flags above] --format human`
+`aw workspace-init [--source alias:path[:branch]] [flags above] --format human`
 
 > **The CLI writes; this wrapper does not** — `Write` and `Edit` are absent from `allowed-tools` on purpose. `--dry-run` previews; re-run without it. Relay the output, never re-render it.
 
-## Interactive steps
+## Modes
 
-1. **Sources** — the CLI detects the repo path(s); the user confirms aliases, paths and branches. Multiple `--source` accepted.
-2. **Default skills** — present the catalog of capabilities (roles). Per role: `built-in default`, a third-party skill (`skills.sh`), or `off`; the result lands in `.workflow/skills.toml`. Cascade: `built-in → ~/.workflow/skills.toml (global) → .workflow/skills.toml (workspace)`. The template also ships a commented `[compaction]` section: the `mode` switch for the loops' context self-regulation (`confirm` default, `auto` opt-in).
-3. **Minimal scaffold** — only the activation set: `.workflow/sessions/` (the marker that activates the operating context), `.workflow/skills.toml`, the `WORKSPACE` block in CLAUDE.md/AGENTS.md and the CLI-owned `.gitignore`. **Nothing else upfront**: each `docs/<category>` is born on demand at its first numbered write (`aw next-number docs/<cat>`), and `.workflow/launch/<alias>/` plus `docs/logs/` at the first launch.
-4. **External sources** — one outside the workspace folder gets multi-root visibility (gitignored) and a reconcile.
+Without sources, it only materializes the minimal runtime under the lock: the CLI-owned `.gitignore` block when the root belongs to Git, then `.<namespace>/sessions/` as the final marker. It does not create `docs/`, `skills.toml`, a WORKSPACE block, launch files, `HISTORY.md` or a Git repository.
 
-**Idempotent** — a re-run reconciles: it keeps manual configuration and prunes the legacy scaffold.
+With `--source`, it configures/reconciles the metadata, branches and multiroot visibility. `workspace` is the reserved implicit source pointing at the root and cannot be configured as an alias. A workspace `skills.toml` is created only when there is a real capability override.
+
+Both modes are idempotent. A normal first mutation also materializes the same runtime automatically, so this command is optional rather than a gate.
 
 Done → the user can run `/w:spec-new`, `/w:plan-new` or `/w:quick`.
 

package/skills/w/context/MANIFEST.json

@@ -18,7 +18,7 @@
     "web": "the run needs evidence from outside the workspace",
     "reconnaissance": "a draft is being cut from a raw prompt over unfamiliar terrain",
     "detection": "the CLI's automatic detection was wrong or ambiguous",
-    "scaffold": "the target folder already carries a workspace",
+    "scaffold": "the target has materialized runtime or needs its materialization/configuration contract",
     "classification": "in-conversation work has to be classified before it is written",
     "authoring": "the deliverable's own notation, structure or ordering is not obvious from the material"
   },
@@ -61,9 +61,6 @@
     "plan.escalation-adopted": "this refine consumed the escalation package an execution handed over, instead of re-deriving its diagnosis",
     "plan.escalation-absent": "no escalation package reached this refine, so it starts from the document alone",
     "chassis.context-pressure": "a fresh reader would need the CHECKPOINT to continue this run",
-    "plan.tasks-to-mark": "at least one task of the batch finished its local work and its checkbox is still open",
-    "plan.plan-closable": "every phase of the plan will be validated once this batch closes, so the plan can be sealed done",
-    "plan.commit-pending": "at least one affected source carries uncommitted changes from this batch",
     "quick.db-touched": "the task read from or wrote to a database, so there is a statement to derive into the session script"
   },
   "commands": {

package/skills/w/harness/HARNESS.md

@@ -34,7 +34,7 @@ The capabilities the harness layer depends on, with their universal fallback (wh
 |---|---|---|
 | **command-invocation** | the user triggers a flow by name (`spec-new`, `plan-exec`, …) | the user writes "run the `<cmd>` procedure" and the AI reads its doc |
 | **procedure-loading** | load a loop's/command's doctrine | the AI **reads the `.md`** of the loop and follows it (read-and-follow) |
-| **structured-choice** | ask the human ≤3 content questions **+ always** a `flow` control (`Compactar`/`Cerrar`); every option has a semantic label + one-sentence functional explanation/example | **labeled markdown** in chat; answer by label or ratify all first options with `Aceptar recomendaciones` |
+| **structured-choice** | ask the human ≤3 content questions **+ always** a `flow` control (`Compactar`/`Cerrar`); every option has a semantic label + one-sentence functional explanation/example | the host's own tool when the turn offers it; else the **`structured_choice`** tool of Workline's own MCP server, which renders the host's native selector by elicitation (only where the catalog declares it with dated evidence); else **labeled markdown** in chat, answered by label or by ratifying all first options with `Aceptar recomendaciones` |
 | **compaction** | shrink the context without losing the thread (+ a context-pressure **signal** for the chassis' self-regulation) | write `CHECKPOINT` and ask the user to restart the context and resume (resume keys off `CHECKPOINT`) |
 | **subagent-dispatch** | *(optional)* parallelize research breadth | **inline sequential** research in the same session (the default anyway) |
 | **persistent-context** | the `WORKSPACE` block + conventions always present | the repo's context file (standard **`AGENTS.md`**; `CLAUDE.md` on Claude Code) |

package/skills/w/loops/quick-loop/LOOP.md

@@ -58,7 +58,7 @@ Read **[`../CHASSIS.md`](../CHASSIS.md)** — the loop's **full engine** — **a
   - **`Recortar alcance`**, if chosen: propose the **sub-task that DOES fit** a quick (`SESSION.Objective` = the sub-task; the original prompt goes into `## Origin`) and defer the rest to `BACKLOG` ("trimmed at the gate — may warrant its own spec, `/w:spec-new`").
   - **`Cambiar a SPEC`**, if chosen: **no quick session is created** — run the *Live transition to SPEC* (next bullet).
 - **Live transition to SPEC** (shared by the gate and mid-loop escalation). On acceptance, the work line **moves to the SPEC flow**: the explicit consent in the structured-choice **equals invoking the destination command** (*consented exception* — rule 3 of the *Continuity rule*, [`../../SKILL.md`](../../SKILL.md) § *Operating context*). On the SPEC side:
-  1. **Materialize the draft** via the [`../../commands/spec-new.md`](../../commands/spec-new.md) procedure: `aw next-number docs/specs --claim spec-<slug>.md`, schema, single-pass **NO RESEARCH** — its bounded reconnaissance does **not** re-fire (this run's context arrives adopted). `## Origin` = "escalated from `/w:quick`" + the original prompt (+ the origin quick session if it exists). The draft is born `status: draft`: only the SPEC gate promotes it to `ready-for-plan`.
+  1. **Materialize the draft** via the [`../../commands/spec-new.md`](../../commands/spec-new.md) procedure: `aw next-number docs/specs --publish spec-<slug>.md` with the finished draft on stdin (number assigned and document written in one atomic act, no reservation left), schema, single-pass **NO RESEARCH** — its bounded reconnaissance does **not** re-fire (this run's context arrives adopted). `## Origin` = "escalated from `/w:quick`" + the original prompt (+ the origin quick session if it exists). The draft is born `status: draft`: only the SPEC gate promotes it to `ready-for-plan`.
   2. **Load and execute** [`../spec-refine-loop/LOOP.md`](../spec-refine-loop/LOOP.md) — over that spec (trampoline pattern).
   3. The run's session is that loop's **normal** `NNN-<slug>-spec-refine` (the CLI numbers it; its `## Origin` records the escalation). **Invariant 2 intact**: quick, while it is quick, never writes `docs/` — the draft is written by the SPEC flow, post-consent.
 - **Mid-loop escalation + handoff**: if the task grows, declare the signals again — the CLI applies the same threshold and, if it fires, asks. If the user accepts moving up:

package/skills/w/modules/PROMPT-CONTINUITY.md

@@ -12,4 +12,4 @@ Loaded when a bare prompt continues an existing work line (signal `resume`).
 
 > **Which line a prompt joins is not this document's call:** a command opens a new one through `aw session-create`, a bare prompt continues the most recent through `aw resume`. Both fire **before** a run exists, so no journey has a step for them. The reason stays: the **command** is the signal for "new work line", so nobody loses a thread by not typing one, or forks one by typing it twice.
 
-Whether a prompt really belongs to the open line is judgment. Clearly unrelated → offer choosing (`continuar NNN` | `trabajo nuevo`) or fall to the **no-flow** branch (`docs/` by convention + numbering). No workspace → **vanilla** behavior.
+Whether a prompt really belongs to the open line is judgment. Clearly unrelated → offer choosing (`continuar NNN` | `trabajo nuevo`) or fall to the **no-flow** branch (`docs/` by convention + numbering). Every invoked directory has an implicit Workline root; a marker is created only by a mutation.

package/skills/w/modules/WORKSPACE-SCAFFOLD.md

@@ -1,28 +1,25 @@
-# WORKSPACE-SCAFFOLD — what init versions, ignores and prunes
+# WORKSPACE-SCAFFOLD — runtime materialization and configuration
 
-Loaded when the folder already has a workspace, or the user asks what `workspace-init` writes,
-ignores or removes on a re-run (signal `scaffold`).
+Loaded when the folder already has a materialized workspace, or the user asks what
+`workspace-init` writes, ignores or reconciles on a re-run (signal `scaffold`).
 
 ## Versioning policy (CLI-owned `.gitignore`)
 
-Init writes and owns the full set.
+The first mutation (or `workspace-init` without sources) writes only the runtime set, under the
+workspace lock. The sessions marker is created last.
 
-- **Ignored** — `.workflow/sessions/` (machine-local live log), `.workflow/.lock`,
-  `.workflow/processes.json`, `.workflow/launch/`, `docs/logs/` and, when there are external
-  sources, `.claude/settings.local.json*` / `.codex/config.toml*` (the patterns cover the
-  `.bak.<epoch>` backups).
-- **Versioned** — `.workflow/skills.toml`, `docs/**` (the deliverables) and
-  `.workflow/HISTORY.md`, the durable record: `aw session-close` upserts each closed session's
-  row there.
+- **Ignored** — `.<namespace>/sessions/` (machine-local live log), `.<namespace>/.lock`,
+  `.<namespace>/processes.json`, `.<namespace>/launch/` and `docs/logs/`. The runtime block is
+  added only when the root belongs to Git.
+- **Not created by materialization** — `docs/**`, `skills.toml`, a WORKSPACE block, launch
+  files, HISTORY and Git metadata. Those belong to their owning command.
 
-## Re-run: reconcile + prune
+## Re-run: reconcile
 
-A re-run adds no duplicate entries and overwrites no manual configuration. It prunes the legacy
-upfront scaffold:
+A re-run adds no duplicate runtime entries and overwrites no manual configuration. When explicit
+sources are supplied, it reconciles their metadata, branches and multiroot visibility; a
+`workspace` alias is reserved for the implicit root. It creates `skills.toml` only for a real
+override.
 
-- `.gitkeep`-only taxonomy folders and stray `.gitkeep` files;
-- an empty `docs/logs/`;
-- a released `.workflow/.lock` leftover.
-
-The `.gitignore` is completed to the current set — entries merge under the existing header, never
-duplicated.
+The `.gitignore` runtime block merges idempotently; a read such as `status` or `resume` never
+creates it or any other workspace file.

package/skills/w/schemas/capability-descriptor.schema.json

@@ -78,7 +78,7 @@
             "items": { "enum": ["direct", "compose"] }
           },
           "workspace": {
-            "description": "Whether the operation needs a Workline workspace. Being outside one returns an explicit result and never initializes Workline implicitly.",
+            "description": "Whether the operation needs a resolved Workline root. The CLI treats the invoked directory as an implicit root; a caller without one receives an explicit result and never materializes Workline by reading.",
             "enum": ["required", "optional", "standalone"]
           },
           "interaction": {