orient-cli 0.1.0 → 0.2.1

package/dist/cli.js

@@ -19,7 +19,7 @@
  * each flag, so user-provided resources layer on top of the bundled
  * ones instead of replacing them.
  */
-import { main } from "@mariozechner/pi-coding-agent";
+import { main } from "@orient-cli/coding-agent";
 import { dirExists, getExtensionFiles, getPromptsDir, getSkillsDir } from "./package-paths.js";
 /**
  * Build the effective argument vector for pi by prepending injections

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/F;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,QAA2B;IAC7C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,mEAAmE;IACnE,sEAAsE;IACtE,0CAA0C;IAC1C,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,IAAI,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,gEAAgE;IAChE,iEAAiE;IACjE,gDAAgD;IAChD,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,GAAG;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/F;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,QAA2B;IAC7C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,mEAAmE;IACnE,sEAAsE;IACtE,0CAA0C;IAC1C,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,IAAI,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,gEAAgE;IAChE,iEAAiE;IACjE,gDAAgD;IAChD,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,GAAG;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Re-exports ORIENT types, utilities, and pi's SDK for programmatic usage.
  */
-export { createAgentSession, main } from "@mariozechner/pi-coding-agent";
+export { createAgentSession, main } from "@orient-cli/coding-agent";
 export { NotebookLMBridge } from "./integrations/notebooklm/bridge.js";
 export { default as notebookLMExtension } from "./integrations/notebooklm/notebooklm-extension.js";
 export { ArtifactGraph, MINIMAL_ARTIFACTS, STANDARD_ARTIFACTS } from "./orient/artifact-graph.js";

package/dist/index.js

@@ -4,7 +4,7 @@
  * Re-exports ORIENT types, utilities, and pi's SDK for programmatic usage.
  */
 // Re-export pi's SDK for convenience
-export { createAgentSession, main } from "@mariozechner/pi-coding-agent";
+export { createAgentSession, main } from "@orient-cli/coding-agent";
 // NotebookLM integration
 export { NotebookLMBridge } from "./integrations/notebooklm/bridge.js";
 export { default as notebookLMExtension } from "./integrations/notebooklm/notebooklm-extension.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qCAAqC;AACrC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACzE,yBAAyB;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAClG,OAAO,EACN,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,GACjB,MAAM,2BAA2B,CAAC;AACnC,uCAAuC;AACvC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,EACX,eAAe,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAyB,MAAM,2BAA2B,CAAC;AACtF,cAAc;AACd,OAAO,EAIN,KAAK,GAML,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qCAAqC;AACrC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACpE,yBAAyB;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAClG,OAAO,EACN,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,GACjB,MAAM,2BAA2B,CAAC;AACnC,uCAAuC;AACvC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,EACX,eAAe,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAyB,MAAM,2BAA2B,CAAC;AACtF,cAAc;AACd,OAAO,EAIN,KAAK,GAML,MAAM,mBAAmB,CAAC"}

package/dist/integrations/notebooklm/notebooklm-extension.d.ts

@@ -4,5 +4,5 @@
  * Registers research-phase tools that shell out to notebooklm-py.
  * These tools are only registered if notebooklm CLI is installed.
  */
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@orient-cli/coding-agent";
 export default function notebookLMExtension(pi: ExtensionAPI): Promise<void>;

package/dist/integrations/notebooklm/notebooklm-extension.js

@@ -123,7 +123,7 @@ export default async function notebookLMExtension(pi) {
             try {
                 const result = await bridge.ask(params.notebookId, params.question);
                 const citations = result.citations.length > 0
-                    ? "\n\nCitations:\n" + result.citations.map((c, i) => `  [${i + 1}] ${c.text}`).join("\n")
+                    ? `\n\nCitations:\n${result.citations.map((c, i) => `  [${i + 1}] ${c.text}`).join("\n")}`
                     : "";
                 return {
                     content: [{ type: "text", text: `${result.answer}${citations}` }],

package/dist/integrations/notebooklm/notebooklm-extension.js.map

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

package/dist/orient/change-packet.d.ts

@@ -4,6 +4,7 @@
  * Handles creation, reading, and management of ORIENT change packets.
  * A change packet is a directory containing all artifacts for a single change.
  */
+import type { Tier } from "./tiers.js";
 import { type PacketConfig, type WorkflowVariant } from "./types.js";
 /**
  * Get the .orient directory path for a project.
@@ -24,7 +25,7 @@ export declare function initOrient(projectDir: string): string;
 /**
  * Create a new change packet.
  */
-export declare function createChangePacket(projectDir: string, name: string, workflow: WorkflowVariant, templatesDir?: string): PacketConfig;
+export declare function createChangePacket(projectDir: string, name: string, workflow: WorkflowVariant, templatesDir?: string, tier?: Tier, schemasRoot?: string): PacketConfig;
 /**
  * Read a change packet's config.
  */

package/dist/orient/change-packet.js

@@ -5,7 +5,7 @@
  * A change packet is a directory containing all artifacts for a single change.
  */
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { PHASES, WORKFLOW_PHASES } from "./phases.js";
 import { Phase } from "./types.js";
 const ORIENT_DIR = ".orient";
@@ -43,7 +43,7 @@ export function initOrient(projectDir) {
 /**
  * Create a new change packet.
  */
-export function createChangePacket(projectDir, name, workflow, templatesDir) {
+export function createChangePacket(projectDir, name, workflow, templatesDir, tier, schemasRoot) {
     const packetDir = getPacketDir(projectDir, name);
     if (existsSync(packetDir)) {
         throw new Error(`Change packet "${name}" already exists at ${packetDir}`);
@@ -62,18 +62,35 @@ export function createChangePacket(projectDir, name, workflow, templatesDir) {
             : "skipped";
         phases[phase] = { status };
     }
-    // Build initial artifact statuses. If a template directory is
-    // provided, artifacts with a matching template file are scaffolded
-    // and marked as "created"; anything else stays "pending".
+    // Build initial artifact statuses. Template resolution order:
+    //   1. Tier-specific: schemas/orient-<variant>/templates-tier-<N>/<file>
+    //   2. Balanced fallback: schemas/orient-<variant>/templates-tier-2/<file>
+    //   3. Legacy flat: schemas/orient-<variant>/templates/<file>
+    // The legacy flat dir is still honored via the templatesDir parameter
+    // so pre-0.2.0 callers keep working.
     const artifacts = {};
     const now = new Date().toISOString();
-    const templatesAvailable = !!templatesDir && existsSync(templatesDir);
+    const legacyTemplatesAvailable = !!templatesDir && existsSync(templatesDir);
+    const resolvedSchemasRoot = schemasRoot ?? (templatesDir ? dirname(dirname(templatesDir)) : undefined);
     for (const phase of workflowPhases) {
         const phaseInfo = PHASES[phase];
         for (const artifact of phaseInfo.artifacts) {
+            const templateFile = artifact.toLowerCase().replace(/ /g, "-");
             let scaffolded = false;
-            if (templatesAvailable) {
-                const templateFile = artifact.toLowerCase().replace(/ /g, "-");
+            // Tier-aware resolution first.
+            if (tier && resolvedSchemasRoot) {
+                const tierDirs = [`templates-tier-${tier}`, "templates-tier-2", "templates"];
+                for (const dir of tierDirs) {
+                    const candidate = join(resolvedSchemasRoot, `orient-${workflow}`, dir, templateFile);
+                    if (existsSync(candidate)) {
+                        copyFileSync(candidate, join(packetDir, artifact));
+                        scaffolded = true;
+                        break;
+                    }
+                }
+            }
+            // Legacy single-template fallback (no tier passed).
+            if (!scaffolded && legacyTemplatesAvailable) {
                 const templatePath = join(templatesDir, templateFile);
                 if (existsSync(templatePath)) {
                     copyFileSync(templatePath, join(packetDir, artifact));

package/dist/orient/change-packet.js.map

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

package/dist/orient/clarify.d.ts

@@ -0,0 +1,114 @@
+/**
+ * /orient.clarify — ambiguity marker loop
+ * =========================================
+ *
+ * Spec-kit's signature move: inline `[NEEDS CLARIFICATION: ...]` markers
+ * in draft artifacts, and a dedicated command that walks the user
+ * through resolving each one in sequence. ORIENT adopts the same
+ * pattern with the same marker syntax so spec-kit users feel at home.
+ *
+ * The flow:
+ *
+ *   1. Read the current active artifact for the current phase (or
+ *      a specific artifact if the user passes `/orient.clarify Spec.md`).
+ *   2. Scan for `[NEEDS CLARIFICATION: <question>]` matches. Preserve
+ *      byte offsets so we can rewrite the file in place.
+ *   3. For each match, show the question via ctx.ui.select() with
+ *      the first option being "(custom answer)" and subsequent
+ *      options being any `options:` hints the marker included.
+ *   4. Replace the marker with the user's answer wrapped as bold text:
+ *      `**Clarified 2026-04-12:** <answer>`.
+ *   5. Append an entry to the `## Clarifications` sub-section at the
+ *      end of the artifact if it exists; create the section if not.
+ *   6. After all markers are resolved (or the user bails after N),
+ *      rewrite the file, mark the artifact status as `draft` → `complete`
+ *      if nothing ambiguous remains, and notify.
+ *
+ * Cap: max 5 markers walked per /orient.clarify invocation. Prevents
+ * marathon sessions. Users can run the command again for the next 5.
+ *
+ * Marker format specification (from Research.md §2.2):
+ *
+ *   [NEEDS CLARIFICATION: <question text>]
+ *
+ *   Optional hint form:
+ *
+ *   [NEEDS CLARIFICATION: <question>|options: opt1 / opt2 / opt3]
+ *
+ * The `|options:` suffix is ORIENT's extension over vanilla spec-kit
+ * to give the user multiple-choice answers without an LLM turn.
+ */
+export interface ClarificationMarker {
+    /** Byte offset where the `[NEEDS CLARIFICATION:` token starts. */
+    start: number;
+    /** Byte offset of the closing bracket + 1 (end-exclusive). */
+    end: number;
+    /** Full matched text including brackets. */
+    fullText: string;
+    /** The question portion (after the colon, trimmed). */
+    question: string;
+    /** Optional options list parsed from `|options: a / b / c`. Empty if none. */
+    options: string[];
+}
+export interface ClarificationResolution {
+    marker: ClarificationMarker;
+    answer: string;
+    resolvedAt: string;
+}
+/**
+ * Scan text for clarification markers. Returns them in document order
+ * (which is also the order we'll walk them through in the UI).
+ */
+export declare function scanMarkers(text: string): ClarificationMarker[];
+/**
+ * Count markers in a file on disk. Used by the phase-gating logic to
+ * decide whether an artifact is "draft" (has markers) or "complete"
+ * (no markers remain).
+ */
+export declare function countMarkersInFile(filePath: string): number;
+/**
+ * Replace a single marker with the resolved text. Returns the new
+ * full-file content with the marker region substituted.
+ *
+ * The replacement format:
+ *
+ *   **Clarified 2026-04-12:** <answer>
+ *
+ * The bold `**Clarified YYYY-MM-DD:**` prefix makes resolved items
+ * grep-able so a reviewer can see what was decided and when without
+ * reading the whole artifact.
+ */
+export declare function replaceMarker(content: string, marker: ClarificationMarker, answer: string, resolvedAt: string): string;
+/**
+ * Apply a batch of resolutions to a document. Resolutions are applied
+ * in reverse document order so earlier offsets stay valid as later
+ * markers get replaced.
+ */
+export declare function applyResolutions(content: string, resolutions: ClarificationResolution[]): string;
+/**
+ * Ensure the document has a trailing `## Clarifications` section and
+ * append a bullet with (a) the original question, (b) the resolved
+ * answer, (c) the resolution date. The section collects a
+ * chronological audit trail separate from the inline replacements.
+ */
+export declare function appendClarificationLog(content: string, resolutions: ClarificationResolution[]): string;
+/**
+ * Full round-trip helper: load a file, apply resolutions, write it back,
+ * and return the final marker count for phase-gating use.
+ */
+export declare function resolveAndWriteFile(filePath: string, resolutions: ClarificationResolution[]): number;
+/** Maximum markers walked per /orient.clarify invocation (see module doc). */
+export declare const MAX_MARKERS_PER_SESSION = 5;
+/** Default option prefix when a marker has no explicit |options: hint. */
+export declare const CUSTOM_ANSWER_OPTION = "(type a custom answer)";
+/**
+ * Build a ctx.ui.select() options array for a single marker. Always
+ * starts with the custom-answer sentinel so the user can escape the
+ * multiple-choice if none of the hints fit.
+ */
+export declare function buildClarifySelectOptions(marker: ClarificationMarker): string[];
+/**
+ * Format the "walking marker N of M" prompt that the ctx.ui.select()
+ * sees above the options.
+ */
+export declare function formatClarifyPrompt(marker: ClarificationMarker, index: number, total: number): string;

package/dist/orient/clarify.js

@@ -0,0 +1,186 @@
+/**
+ * /orient.clarify — ambiguity marker loop
+ * =========================================
+ *
+ * Spec-kit's signature move: inline `[NEEDS CLARIFICATION: ...]` markers
+ * in draft artifacts, and a dedicated command that walks the user
+ * through resolving each one in sequence. ORIENT adopts the same
+ * pattern with the same marker syntax so spec-kit users feel at home.
+ *
+ * The flow:
+ *
+ *   1. Read the current active artifact for the current phase (or
+ *      a specific artifact if the user passes `/orient.clarify Spec.md`).
+ *   2. Scan for `[NEEDS CLARIFICATION: <question>]` matches. Preserve
+ *      byte offsets so we can rewrite the file in place.
+ *   3. For each match, show the question via ctx.ui.select() with
+ *      the first option being "(custom answer)" and subsequent
+ *      options being any `options:` hints the marker included.
+ *   4. Replace the marker with the user's answer wrapped as bold text:
+ *      `**Clarified 2026-04-12:** <answer>`.
+ *   5. Append an entry to the `## Clarifications` sub-section at the
+ *      end of the artifact if it exists; create the section if not.
+ *   6. After all markers are resolved (or the user bails after N),
+ *      rewrite the file, mark the artifact status as `draft` → `complete`
+ *      if nothing ambiguous remains, and notify.
+ *
+ * Cap: max 5 markers walked per /orient.clarify invocation. Prevents
+ * marathon sessions. Users can run the command again for the next 5.
+ *
+ * Marker format specification (from Research.md §2.2):
+ *
+ *   [NEEDS CLARIFICATION: <question text>]
+ *
+ *   Optional hint form:
+ *
+ *   [NEEDS CLARIFICATION: <question>|options: opt1 / opt2 / opt3]
+ *
+ * The `|options:` suffix is ORIENT's extension over vanilla spec-kit
+ * to give the user multiple-choice answers without an LLM turn.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+// ============================================================================
+// Marker parsing
+// ============================================================================
+/**
+ * Regex for spec-kit-style markers. Non-greedy on the body so
+ * `[NEEDS CLARIFICATION: a] and [NEEDS CLARIFICATION: b]` parses as
+ * two markers, not one.
+ *
+ * The capture groups are:
+ *   1. body — everything between `CLARIFICATION:` and the closing `]`
+ */
+const MARKER_REGEX = /\[NEEDS CLARIFICATION:\s*([^\]]+?)\s*\]/g;
+/**
+ * Scan text for clarification markers. Returns them in document order
+ * (which is also the order we'll walk them through in the UI).
+ */
+export function scanMarkers(text) {
+    const markers = [];
+    for (const match of text.matchAll(MARKER_REGEX)) {
+        const body = match[1];
+        const optionsSplit = body.split(/\s*\|\s*options:\s*/i);
+        const question = optionsSplit[0].trim();
+        const optionsText = optionsSplit[1] ?? "";
+        const options = optionsText
+            .split(/\s*\/\s*/)
+            .map((o) => o.trim())
+            .filter((o) => o.length > 0);
+        markers.push({
+            start: match.index ?? 0,
+            end: (match.index ?? 0) + match[0].length,
+            fullText: match[0],
+            question,
+            options,
+        });
+    }
+    return markers;
+}
+/**
+ * Count markers in a file on disk. Used by the phase-gating logic to
+ * decide whether an artifact is "draft" (has markers) or "complete"
+ * (no markers remain).
+ */
+export function countMarkersInFile(filePath) {
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        return scanMarkers(content).length;
+    }
+    catch {
+        return 0;
+    }
+}
+// ============================================================================
+// Rewriting
+// ============================================================================
+/**
+ * Replace a single marker with the resolved text. Returns the new
+ * full-file content with the marker region substituted.
+ *
+ * The replacement format:
+ *
+ *   **Clarified 2026-04-12:** <answer>
+ *
+ * The bold `**Clarified YYYY-MM-DD:**` prefix makes resolved items
+ * grep-able so a reviewer can see what was decided and when without
+ * reading the whole artifact.
+ */
+export function replaceMarker(content, marker, answer, resolvedAt) {
+    const replacement = `**Clarified ${resolvedAt.slice(0, 10)}:** ${answer}`;
+    return content.slice(0, marker.start) + replacement + content.slice(marker.end);
+}
+/**
+ * Apply a batch of resolutions to a document. Resolutions are applied
+ * in reverse document order so earlier offsets stay valid as later
+ * markers get replaced.
+ */
+export function applyResolutions(content, resolutions) {
+    const sorted = [...resolutions].sort((a, b) => b.marker.start - a.marker.start);
+    let updated = content;
+    for (const res of sorted) {
+        updated = replaceMarker(updated, res.marker, res.answer, res.resolvedAt);
+    }
+    return updated;
+}
+/**
+ * Ensure the document has a trailing `## Clarifications` section and
+ * append a bullet with (a) the original question, (b) the resolved
+ * answer, (c) the resolution date. The section collects a
+ * chronological audit trail separate from the inline replacements.
+ */
+export function appendClarificationLog(content, resolutions) {
+    if (resolutions.length === 0)
+        return content;
+    const SECTION_HEADER = "## Clarifications";
+    const hasSection = content.includes(SECTION_HEADER);
+    const logLines = resolutions.map((r) => `- **${r.resolvedAt.slice(0, 10)}** — Q: ${r.marker.question}  \n  A: ${r.answer}`);
+    const logBlock = logLines.join("\n");
+    if (hasSection) {
+        // Append under the existing section. Find the section start and
+        // append right after its heading + one blank line. If there's a
+        // following section, insert before it.
+        const idx = content.indexOf(SECTION_HEADER);
+        const afterHeading = content.indexOf("\n", idx) + 1;
+        return `${content.slice(0, afterHeading)}\n${logBlock}\n${content.slice(afterHeading)}`;
+    }
+    // Create the section at the bottom.
+    const trailingNewline = content.endsWith("\n") ? "" : "\n";
+    return `${content}${trailingNewline}\n${SECTION_HEADER}\n\n${logBlock}\n`;
+}
+/**
+ * Full round-trip helper: load a file, apply resolutions, write it back,
+ * and return the final marker count for phase-gating use.
+ */
+export function resolveAndWriteFile(filePath, resolutions) {
+    const content = readFileSync(filePath, "utf-8");
+    const withInlineReplacements = applyResolutions(content, resolutions);
+    const withLog = appendClarificationLog(withInlineReplacements, resolutions);
+    writeFileSync(filePath, withLog, "utf-8");
+    return scanMarkers(withLog).length;
+}
+// ============================================================================
+// UI helpers
+// ============================================================================
+/** Maximum markers walked per /orient.clarify invocation (see module doc). */
+export const MAX_MARKERS_PER_SESSION = 5;
+/** Default option prefix when a marker has no explicit |options: hint. */
+export const CUSTOM_ANSWER_OPTION = "(type a custom answer)";
+/**
+ * Build a ctx.ui.select() options array for a single marker. Always
+ * starts with the custom-answer sentinel so the user can escape the
+ * multiple-choice if none of the hints fit.
+ */
+export function buildClarifySelectOptions(marker) {
+    if (marker.options.length === 0)
+        return [CUSTOM_ANSWER_OPTION];
+    return [...marker.options, CUSTOM_ANSWER_OPTION];
+}
+/**
+ * Format the "walking marker N of M" prompt that the ctx.ui.select()
+ * sees above the options.
+ */
+export function formatClarifyPrompt(marker, index, total) {
+    const cap = Math.min(total, MAX_MARKERS_PER_SESSION);
+    return `Clarification ${index + 1}/${cap} — ${marker.question}`;
+}
+//# sourceMappingURL=clarify.js.map

package/dist/orient/clarify.js.map

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

package/dist/orient/clear-command.d.ts

@@ -0,0 +1,79 @@
+/**
+ * /clear command — phase-gated context wipe
+ * ===========================================
+ *
+ * Two modes behave differently:
+ *
+ *   - **Plan/Execute mode:** /clear wipes the chat history but keeps
+ *     .orient-cli/plan.md on disk. The plan is the restart contract.
+ *     The agent re-injects the plan on the next turn from the file,
+ *     so nothing meaningful is lost.
+ *
+ *   - **ORIENT mode:** /clear checks the current phase's required
+ *     artifacts. If any artifact for the active phase is in
+ *     `pending` or `draft` status, the command refuses, prints the
+ *     blocking artifact names, and does nothing. Only when every
+ *     required artifact of the current phase is `complete` does
+ *     the clear succeed. This enforces the Brief's "spec first,
+ *     clear second" discipline — a fresh context window is only
+ *     worth having if you have a persistent artifact to anchor on.
+ *
+ * The command never touches the session file on disk. It signals to
+ * pi's agent that the conversation-message buffer should be reset
+ * via ctx.ui.clearChat() (a new method added in the fork — see
+ * MIGRATION.md for fork changes).
+ *
+ * If pi's extension API does not yet expose ctx.ui.clearChat(), the
+ * fork change that adds it is part of this packet (see Tasks.md,
+ * Wave 2: "Add clearChat hook to ExtensionAPI").
+ */
+import type { OrientMode } from "./mode.js";
+import type { PlanExecuteSession } from "./plan-execute.js";
+import type { PacketConfig } from "./types.js";
+export type ClearOutcome = {
+    allowed: true;
+    reason: string;
+} | {
+    allowed: false;
+    reason: string;
+    blockers: string[];
+};
+/**
+ * Minimal shape of pi's extension context used by the /clear command.
+ * This mirrors the real ExtensionAPI context but is typed narrowly so
+ * the clear logic is testable without dragging pi's full surface in.
+ */
+export interface ClearContext {
+    projectDir: string;
+    mode: OrientMode | null;
+    packet: PacketConfig | null;
+    planSession: PlanExecuteSession | null;
+}
+/**
+ * Pure function that decides whether a /clear can proceed, given the
+ * current project state. Callers handle the actual buffer reset.
+ *
+ * The decision tree:
+ *
+ *   if mode == plan-execute:
+ *     if plan.md exists and state is idle|planning|executing:
+ *       always allow (plan is the restart contract)
+ *     else:
+ *       always allow (nothing to protect)
+ *
+ *   if mode == orient:
+ *     if no active packet:
+ *       always allow
+ *     else:
+ *       find the current phase's required artifacts
+ *       for each required artifact:
+ *         if status not in {complete, skipped}:
+ *           deny, list blockers
+ *       else: allow
+ */
+export declare function decideClear(ctx: ClearContext): ClearOutcome;
+/**
+ * Format a ClearOutcome for ctx.ui.notify() display. Blockers are
+ * rendered as a bullet list when present.
+ */
+export declare function formatClearMessage(outcome: ClearOutcome): string;