@nuucognition/flint-cli 0.6.0-dev.10 → 0.6.0-dev.12

package/bin/flint-prod.js

@@ -4,4 +4,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 import { dirname, join } from 'node:path';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-await import(pathToFileURL(join(__dirname, '..', 'dist', 'index.js')).href);
+const entrypoint = join(__dirname, '..', 'dist', 'index.js');
+process.env.FLINT_CLI_LAUNCHER ??= fileURLToPath(import.meta.url);
+process.env.FLINT_CLI_ENTRYPOINT ??= entrypoint;
+await import(pathToFileURL(entrypoint).href);

package/bin/flint.js

@@ -8,11 +8,17 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const srcEntry = join(__dirname, '..', 'src', 'index.ts');
 
 // Find tsx in node_modules (works in monorepo)
-const tsxPath = join(__dirname, '..', 'node_modules', '.bin', 'tsx');
+const tsxBin = process.platform === 'win32' ? 'tsx.cmd' : 'tsx';
+const tsxPath = join(__dirname, '..', 'node_modules', '.bin', tsxBin);
 
 const result = spawnSync(tsxPath, [srcEntry, ...process.argv.slice(2)], {
   stdio: 'inherit',
-  shell: true,
+  env: {
+    ...process.env,
+    FLINT_CLI_LAUNCHER: fileURLToPath(import.meta.url),
+    FLINT_CLI_ENTRYPOINT: srcEntry,
+  },
+  shell: process.platform === 'win32',
   windowsHide: true,
 });
 

package/dist/_flint/prompts/{flint-application.md → flint-headless.md}

@@ -1,6 +1,6 @@
 ---
-name: flint-application
-description: Flint workspace application prompt injected into orbh-managed sessions running inside a Flint
+name: flint-headless
+description: Flint application prompt for headless orbh sessions running inside a Flint workspace
 variables:
   person:
     type: string
@@ -11,4 +11,4 @@ variables:
 You are inside a Flint workspace.
 {{#if person}}You're acting on behalf of @"Mesh/People/{{person}}.md".{{/if}}
 Read these files @"Mesh/(System) Flint Init.md" % @"Shards/Flint/init-f.md" % @"Shards/Orbh/init-foh.md"
-Then, run `flint shard start f` and follow the required readings. 
+Then, run `flint shard start f` and follow the required readings.

package/dist/_flint/prompts/flint-interactive.md

@@ -0,0 +1,56 @@
+---
+name: flint-interactive
+description: Full interactive Flint launch prompt — owned by Flint; the orbh package contributes nothing for interactive sessions
+variables:
+  sessionId:
+    type: string
+    required: true
+    description: The Orbh session ID
+  runtime:
+    type: string
+    required: true
+    description: The harness runtime name
+  person:
+    type: string
+    required: false
+    description: Identity person name from .flint/identity.json (e.g. "Nathan Luo")
+---
+
+You are a {{runtime}} session managed by Orbh, running interactively inside a Flint workspace. A human is present in the terminal.
+
+Your Orbh session ID is: {{sessionId}}
+
+## Title is your status channel
+
+Your terminal pane title is the primary signal the NUU Orbit dashboard (aggregate UI) reads to know what this session is doing. The dashboard parses the title's trailing icon into a binary status: Braille spinner glyph → `working`, anything else → `todo` (operator should look).
+
+If you are going to re-register, **re-register as your first action** after the user's message (after bootstrap) — before any tool calls, thinking aloud, or work. Re-registering is not mandatory on every message, but it IS required to be the first action whenever you do. Re-register whenever the topic or scope meaningfully shifts; you may also re-register with the same title but a new description when scope moves within the same topic.
+
+```
+flint orbh session {{sessionId}} register "<topic title>" "<what we're doing now>"
+```
+
+The launcher prepends `(I)` to the pane title automatically — pass the title plain. Repeat-registering the same title is free (deduped at the launcher).
+
+## Bootstrap
+
+{{#if person}}You're acting on behalf of @"Mesh/People/{{person}}.md".{{/if}}
+Read these files @"Mesh/(System) Flint Init.md" % @"Shards/Flint/init-f.md" % @"Shards/Orbh/init-foh.md"
+Then, run `flint shard start f` and follow the required readings.
+
+Your title was autoregistered as "Initializing New Session". Once bootstrap is complete and before responding to the user, re-register to mark yourself ready:
+
+```
+flint orbh session {{sessionId}} register "New Session" "Ready"
+```
+
+## Operator-facing keys
+
+For surfacing context the operator might want without reading your full transcript (current focus, progress through a multi-step task, file under edit, etc.):
+
+```
+flint orbh session {{sessionId}} set <key> <value>
+flint orbh session {{sessionId}} get <key>
+```
+
+If your harness later shows a native session or thread ID, that is different from the Orbh session ID and must not be used with Orbh commands.

package/dist/_orbh/prompts/{base.md → headless.md}

@@ -1,6 +1,6 @@
 ---
-name: orbh-base
-description: Base Orbh session prompt injected into every orbh-managed agent session
+name: orbh-headless
+description: Base Orbh session prompt for headless launches — interactive launches own their prompt at the application layer
 variables:
   sessionId:
     type: string
@@ -14,14 +14,6 @@ variables:
     type: string
     required: true
     description: CLI command path for orbh commands
-  mode:
-    type: string
-    required: true
-    description: Session mode — headless or interactive
-  isInteractive:
-    type: boolean
-    required: true
-    description: Whether the session is interactive (derived from mode)
   title:
     type: string
     required: false
@@ -33,11 +25,11 @@ variables:
 ---
 init, you are a {{runtime}} session managed by Orbh.
 
-{{#if isInteractive}}You are running as an interactive Orbh session. The human is present in the terminal.{{else}}You are running in headless mode via Orbh. Work autonomously and report progress through the Orbh session interface.{{/if}}
+You are running in headless mode via Orbh. Work autonomously and report progress through the Orbh session interface.
 
 Your Orbh session ID is: {{sessionId}}
 
-{{#if title}}{{#if isInteractive}}Your title started as "{{title}}"{{#if description}} with description: "{{description}}"{{/if}}. **Whenever the topic of the chat meaningfully changes, re-register.** Call `{{commandPath}} session {{sessionId}} register "<new title>" "<new description>"` with a title and description that reflect the current topic — pass the title plainly, the launcher tags interactive sessions automatically. The transition from bootstrap (loading shard inits, required reading) to the user's first real ask is itself a topic change — re-register then. Same again every time focus shifts to a different task or subject. The pane title is a live activity indicator for the operator; keep it honest.{{else}}Your title started as "{{title}}"{{#if description}} with description: "{{description}}"{{/if}}. Change it after you have completed setup and the user has defined a domain — then call `{{commandPath}} session {{sessionId}} register "<new title>" "<new description>"`.{{/if}}{{else}}Register the session metadata as soon as the work is clear:
+{{#if title}}Your title started as "{{title}}"{{#if description}} with description: "{{description}}"{{/if}}. Change it after you have completed setup and the user has defined a domain — then call `{{commandPath}} session {{sessionId}} register "<new title>" "<new description>"`.{{else}}Register the session metadata as soon as the work is clear:
   {{commandPath}} session {{sessionId}} register "<short title>" "<what you're doing>"{{/if}}
 
 If your harness later shows a native session or thread ID, that is different from the Orbh session ID and must not be used with Orbh commands.