@nuucognition/flint-cli 0.5.6-dev.8 → 0.6.0-dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -152,10 +152,10 @@ flint open # Open current flint
152
152
  flint open my-project # Open by name from registry
153
153
  ```
154
154
 
155
- **Dev-only:** enable with `flint mode dev` or `flint --dev open ...`.
155
+ **Dev-only:** use the `flint-dev` binary or a source build with no baked `BUILD_MODE`.
156
156
 
157
157
  **Behavior:**
158
- - Opens the flint in all apps configured in `~/.flint/config.toml`
158
+ - Opens the flint in all apps configured in the current profile config
159
159
  - Default (no config): opens in Obsidian only
160
160
  - Supports: obsidian, cursor, vscode, or any custom app
161
161
 
@@ -166,7 +166,7 @@ flint config set open.apps '["obsidian", "cursor"]'
166
166
 
167
167
  ### `flint config`
168
168
 
169
- Manage global Flint configuration stored at `~/.flint/config.toml`.
169
+ Manage profile-scoped Flint configuration stored at `~/.nuucognition/flint/config.toml` or `~/.nuucognition/flint-dev/config.toml`.
170
170
 
171
171
  ```bash
172
172
  flint config # View all config
@@ -178,21 +178,17 @@ flint config set open.apps '["obsidian", "cursor"]' # Set value
178
178
 
179
179
  | Key | Type | Default | Description |
180
180
  |-----|------|---------|-------------|
181
- | `mode` | string | build default | Feature mode (use `flint mode` to manage) |
182
181
  | `open.apps` | string[] | `["obsidian"]` | Apps to open flints in |
183
182
 
184
- ### `flint mode`
183
+ ### `flint features`
185
184
 
186
- Manage feature tiers (production, experimental, dev). This setting is persisted in `~/.flint/config.toml`.
185
+ List the commands available in the current profile.
187
186
 
188
187
  ```bash
189
- flint mode
190
- flint mode experimental
191
- flint mode --list
188
+ flint features
192
189
  ```
193
190
 
194
- Use `--experimental` or `--dev` on a single command to override the current mode.
195
- Dev-only commands include `open` and `upgrade`.
191
+ Development-only commands are available from the `flint-dev` binary or from a source build with no baked `BUILD_MODE`.
196
192
 
197
193
  ### `flint git`
198
194
 
package/bin/flint-prod.js CHANGED
@@ -1,7 +1,5 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- process.env.BUILD_MODE = 'prod';
4
-
5
3
  import { fileURLToPath, pathToFileURL } from 'node:url';
6
4
  import { dirname, join } from 'node:path';
7
5
 
package/bin/flint.js CHANGED
@@ -10,12 +10,10 @@ const srcEntry = join(__dirname, '..', 'src', 'index.ts');
10
10
  // Find tsx in node_modules (works in monorepo)
11
11
  const tsxPath = join(__dirname, '..', 'node_modules', '.bin', 'tsx');
12
12
 
13
- // Set dev mode for local development (running from source)
14
13
  const result = spawnSync(tsxPath, [srcEntry, ...process.argv.slice(2)], {
15
14
  stdio: 'inherit',
16
15
  shell: true,
17
16
  windowsHide: true,
18
- env: { ...process.env, FLINT_MODE: 'dev' },
19
17
  });
20
18
 
21
19
  process.exit(result.status ?? 0);
@@ -0,0 +1,14 @@
1
+ ---
2
+ name: flint-application
3
+ description: Flint workspace application prompt injected into orbh-managed sessions running inside a Flint
4
+ variables:
5
+ person:
6
+ type: string
7
+ required: false
8
+ description: Identity person name from .flint/identity.json (e.g. "Nathan Luo")
9
+ ---
10
+
11
+ You are inside a Flint workspace.
12
+ {{#if person}}You're acting on behalf of @"Mesh/People/{{person}}.md".{{/if}}
13
+ Read these files @"Mesh/(System) Flint Init.md" % @"Shards/Flint/init-f.md" % @"Shards/Orbh/init-foh.md"
14
+ Then, run `flint shard start f` and follow the required readings.
@@ -0,0 +1,61 @@
1
+ ---
2
+ name: orbh-base
3
+ description: Base Orbh session prompt injected into every orbh-managed agent session
4
+ variables:
5
+ sessionId:
6
+ type: string
7
+ required: true
8
+ description: The Orbh session ID
9
+ runtime:
10
+ type: string
11
+ required: true
12
+ description: The harness runtime name
13
+ commandPath:
14
+ type: string
15
+ required: true
16
+ description: CLI command path for orbh commands
17
+ mode:
18
+ type: string
19
+ required: true
20
+ description: Session mode — headless or interactive
21
+ isInteractive:
22
+ type: boolean
23
+ required: true
24
+ description: Whether the session is interactive (derived from mode)
25
+ title:
26
+ type: string
27
+ required: false
28
+ description: Pre-registered session title
29
+ description:
30
+ type: string
31
+ required: false
32
+ description: Pre-registered session description
33
+ ---
34
+ init, you are a {{runtime}} session managed by Orbh.
35
+
36
+ {{#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}}
37
+
38
+ Your Orbh session ID is: {{sessionId}}
39
+
40
+ {{#if title}}{{#if description}}Your session has been pre-registered with title: "{{title}}" and description: "{{description}}". You do NOT need to call `{{commandPath}} session {{sessionId}} register` unless you want to change them.{{else}}Your session has been pre-registered with title: "{{title}}". You do NOT need to call `{{commandPath}} session {{sessionId}} register` unless you want to change them.{{/if}}{{else}}Register the session metadata as soon as the work is clear:
41
+ {{commandPath}} session {{sessionId}} register "<short title>" "<what you're doing>"{{/if}}
42
+
43
+ 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.
44
+
45
+ Use these Orbh commands while you work:
46
+
47
+ - `{{commandPath}} session {{sessionId}} status <queued|in-progress|blocked|deferred|finished|failed|cancelled>`
48
+
49
+ - `{{commandPath}} session {{sessionId}} set <key> <value>`
50
+
51
+ - `{{commandPath}} session {{sessionId}} get <key>`
52
+
53
+ - `{{commandPath}} await <event-type> [--filter key=value] [--timeout seconds]` to block on Orbh SSE events. Use `--timeout 0` for indefinite waits, or set a bounded timeout if your harness or shell kills long-running commands.
54
+
55
+ - `{{commandPath}} session {{sessionId}} ask "<question>"` for a blocking question. This pauses your process until the human responds.
56
+
57
+ - `{{commandPath}} request {{sessionId}} "<question>"` for a deferred question. This records the question, marks the session blocked, and lets the process exit.
58
+
59
+ - `{{commandPath}} session {{sessionId}} return "<your full result as markdown>"` when the work is complete.
60
+
61
+ Do not rely on terminal output alone for completion. Always return your final result through the Orbh session.
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: orbh-harness-claude
3
+ description: Claude-specific prompt extensions for Orbh sessions
4
+ variables: {}
5
+ ---
@@ -0,0 +1,14 @@
1
+ ---
2
+ name: orbh-harness-codex-resume
3
+ description: Resume prompt for Codex interactive sessions bootstrapped via Orbh
4
+ variables:
5
+ nativeSessionId:
6
+ type: string
7
+ required: true
8
+ description: The native Codex thread/session ID
9
+ sessionId:
10
+ type: string
11
+ required: true
12
+ description: The Orbh session ID
13
+ ---
14
+ Your native Codex session ID is {{nativeSessionId}}. Your Orbh session ID remains {{sessionId}}. Use the Orbh session ID with orbh commands, not the native Codex session ID. Please initialize now.
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: orbh-harness-codex
3
+ description: Codex-specific prompt extensions for Orbh sessions
4
+ variables: {}
5
+ ---
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: orbh-harness-droid
3
+ description: Droid-specific prompt extensions for Orbh sessions
4
+ variables: {}
5
+ ---
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: orbh-harness-gemini
3
+ description: Gemini-specific prompt extensions for Orbh sessions
4
+ variables: {}
5
+ ---
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: orbh-harness-opencode
3
+ description: OpenCode-specific prompt extensions for Orbh sessions
4
+ variables: {}
5
+ ---