@plainconceptsplatform/agent-harness 3.3.1 → 3.4.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.
Files changed (95) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +454 -454
  3. package/cli/commands/join.js +259 -259
  4. package/cli/commands/migrate.js +310 -310
  5. package/cli/commands/shared.js +27 -27
  6. package/cli/commands/single.js +79 -79
  7. package/cli/commands/wizard.js +134 -134
  8. package/cli/fragments/ops-backlog/az.md +28 -28
  9. package/cli/fragments/ops-backlog/gh.md +28 -28
  10. package/cli/fragments/ops-backlog/jira.md +28 -28
  11. package/cli/fragments/ops-review/az.md +62 -62
  12. package/cli/fragments/ops-review/gh.md +51 -51
  13. package/cli/fragments/ops-review/gl.md +55 -55
  14. package/cli/fragments/ops-ship/gh.md +67 -67
  15. package/cli/fragments/ops-ship/gl.md +84 -84
  16. package/cli/index.js +116 -116
  17. package/cli/presets/clean.json +21 -21
  18. package/cli/presets/models.json +68 -68
  19. package/cli/presets/optimization.json +32 -32
  20. package/cli/presets/platforms.json +76 -76
  21. package/cli/presets/source.json +23 -23
  22. package/cli/steps/clean/index.js +120 -120
  23. package/cli/steps/copy/agents.js +120 -120
  24. package/cli/steps/copy/fullstack-engineer.js +89 -89
  25. package/cli/steps/copy/opencode-json.js +324 -324
  26. package/cli/steps/copy/skills.js +316 -316
  27. package/cli/steps/models/format.js +88 -88
  28. package/cli/steps/models/index.js +64 -64
  29. package/cli/steps/openspec/index.js +136 -136
  30. package/cli/steps/optimization/codegraph.js +141 -141
  31. package/cli/steps/optimization/detect.js +66 -66
  32. package/cli/steps/optimization/humanizer.js +17 -17
  33. package/cli/steps/optimization/index.js +158 -158
  34. package/cli/steps/optimization/memory.js +91 -91
  35. package/cli/steps/optimization/patch-guardrails.js +111 -111
  36. package/cli/steps/optimization/simple-english.js +17 -17
  37. package/cli/steps/optimization/skills-lock.js +30 -30
  38. package/cli/steps/platform/index.js +109 -109
  39. package/cli/steps/source/index.js +123 -123
  40. package/cli/utils/agent-color.js +111 -111
  41. package/cli/utils/copy.js +134 -134
  42. package/cli/utils/exec-spinner.js +47 -47
  43. package/cli/utils/exec.js +134 -134
  44. package/cli/utils/legacy-check.js +30 -30
  45. package/cli/utils/models-cache.js +58 -58
  46. package/cli/utils/models-pricing.js +42 -42
  47. package/cli/utils/paths.js +81 -80
  48. package/cli/utils/process.js +3 -3
  49. package/cli/utils/terminal.js +6 -6
  50. package/cli/utils/update-manifest.js +75 -75
  51. package/harness/.opencode/_gitignore +10 -9
  52. package/harness/.opencode/commands/ops-backlog.md +10 -10
  53. package/harness/.opencode/commands/ops-review.md +10 -8
  54. package/harness/.opencode/commands/ops-ship.md +9 -9
  55. package/harness/.opencode/commands/plan-archive.md +7 -5
  56. package/harness/.opencode/commands/plan-explore.md +11 -9
  57. package/harness/.opencode/commands/plan-propose.md +11 -9
  58. package/harness/.opencode/commands/plan-quick.md +7 -5
  59. package/harness/.opencode/commands/plan-story.md +11 -9
  60. package/harness/.opencode/commands/repo-audit.md +7 -5
  61. package/harness/.opencode/commands/repo-help.md +5 -5
  62. package/harness/.opencode/package.json +5 -5
  63. package/harness/.opencode/plugins/pc-subagent-monitor.js +184 -184
  64. package/harness/.opencode/plugins/pc-subagent-tiers.js +367 -354
  65. package/harness/.opencode/plugins/pc-system-reminders.js +386 -386
  66. package/harness/.opencode/scripts/check-diff.mjs +244 -244
  67. package/harness/.opencode/scripts/code-rules.mjs +288 -288
  68. package/harness/ARCHITECTURE.md +13 -13
  69. package/harness/DESIGN.md +13 -13
  70. package/harness/opencode.jsonc +36 -36
  71. package/harness/openspec/config.yaml +20 -20
  72. package/harness/skills-lock.json +17 -17
  73. package/package.json +12 -14
  74. package/skills/agent-harness-cli/SKILL.md +86 -86
  75. package/skills/pc-guardrails-generic/SKILL.md +53 -53
  76. package/skills/pc-guardrails-project/SKILL.md +8 -8
  77. package/skills/pc-make-architecture/structure-template.md +64 -64
  78. package/skills/pc-make-engineer/SKILL.md +59 -59
  79. package/skills/pc-make-engineer/template.md +36 -36
  80. package/skills/pc-make-guardrails/category-reference.md +112 -112
  81. package/skills/pc-make-merge-risk-assess/SKILL.md +70 -70
  82. package/skills/pc-make-merge-risk-assess/category-reference.md +114 -114
  83. package/skills/pc-ops-ship/SKILL.md +22 -22
  84. package/skills/pc-plan-apply/SKILL.md +86 -86
  85. package/skills/pc-plan-apply/simple-mode.md +21 -21
  86. package/skills/pc-plan-explore/SKILL.md +21 -21
  87. package/skills/pc-plan-goal/SKILL.md +91 -91
  88. package/skills/pc-plan-goal/failure-policy.md +30 -30
  89. package/skills/pc-plan-goal/output-mode.md +10 -10
  90. package/skills/pc-plan-propose/SKILL.md +125 -125
  91. package/skills/pc-plan-propose/task-annotation.md +39 -39
  92. package/skills/pc-plan-quick/SKILL.md +46 -46
  93. package/skills/pc-repo-audit/SKILL.md +44 -44
  94. package/skills/pc-repo-help/SKILL.md +87 -87
  95. package/skills/pc-repo-verify/SKILL.md +150 -150
@@ -1,88 +1,88 @@
1
- import { search, select } from '@inquirer/prompts'
2
- import fse from 'fs-extra'
3
- import path from 'path'
4
- import { fileURLToPath } from 'url'
5
-
6
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
7
- const MODELS_PRESET_PATH = path.resolve(__dirname, '../../presets/models.json');
8
- const modelsPreset = await fse.readJson(MODELS_PRESET_PATH);
9
-
10
- function costTier(input) {
11
- if (input === undefined || input === null) return '';
12
- const tier = modelsPreset.costTiers.find(t => t.max === undefined || input <= t.max);
13
- return tier ? ` ${tier.label}` : '';
14
- }
15
-
16
- function costTierDisplay(cost, canonicalCost) {
17
- return costTier(canonicalCost !== undefined ? canonicalCost : cost);
18
- }
19
-
20
- function formatPrice(price) {
21
- if (price === undefined || price === null) return '?';
22
- if (price === 0) return '$0 (subscription)';
23
- return `$${price}/M`;
24
- }
25
-
26
- export function buildDisplayModels(rawModels) {
27
- return rawModels.map(m => {
28
- const priceStr = formatPrice(m.cost);
29
- const canonicalNote = m.canonicalCost !== undefined
30
- ? ` · official price: ${formatPrice(m.canonicalCost)}/M`
31
- : '';
32
- const context = m.context ? `${m.context / 1000}k` : '?';
33
- return {
34
- ...m,
35
- label: `${m.name}${costTierDisplay(m.cost, m.canonicalCost)}, ${m.id}`,
36
- description: `${priceStr}${canonicalNote} · context: ${context}`,
37
- };
38
- });
39
- }
40
-
41
- export function buildModelChoices(input, models) {
42
- const q = (input || '').toLowerCase();
43
- const filtered = q
44
- ? models.filter(m =>
45
- m.label.toLowerCase().includes(q) ||
46
- m.id.toLowerCase().includes(q)
47
- )
48
- : models;
49
-
50
- return [
51
- {
52
- name: 'None',
53
- value: null,
54
- description: 'Leave this model unset',
55
- },
56
- {
57
- name: '← Change provider',
58
- value: '__back__',
59
- description: 'Go back to provider selection',
60
- },
61
- ...filtered.slice(0, 50).map(m => ({
62
- name: m.label,
63
- value: m.id,
64
- description: m.description,
65
- })),
66
- ];
67
- }
68
-
69
- export function pickModel(message, models) {
70
- return search({
71
- message,
72
- source: input => buildModelChoices(input, models),
73
- });
74
- }
75
-
76
- export function filterModelsByProvider(models, provider) {
77
- if (!provider) return models
78
- return models.filter(m => m.id.startsWith(`${provider}/`))
79
- }
80
-
81
- export function pickProvider(message) {
82
- return select({
83
- message,
84
- choices: modelsPreset.providers.map(p => ({ value: p.value, name: p.name })),
85
- })
86
- }
87
-
88
- export { modelsPreset };
1
+ import { search, select } from '@inquirer/prompts'
2
+ import fse from 'fs-extra'
3
+ import path from 'path'
4
+ import { fileURLToPath } from 'url'
5
+
6
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
7
+ const MODELS_PRESET_PATH = path.resolve(__dirname, '../../presets/models.json');
8
+ const modelsPreset = await fse.readJson(MODELS_PRESET_PATH);
9
+
10
+ function costTier(input) {
11
+ if (input === undefined || input === null) return '';
12
+ const tier = modelsPreset.costTiers.find(t => t.max === undefined || input <= t.max);
13
+ return tier ? ` ${tier.label}` : '';
14
+ }
15
+
16
+ function costTierDisplay(cost, canonicalCost) {
17
+ return costTier(canonicalCost !== undefined ? canonicalCost : cost);
18
+ }
19
+
20
+ function formatPrice(price) {
21
+ if (price === undefined || price === null) return '?';
22
+ if (price === 0) return '$0 (subscription)';
23
+ return `$${price}/M`;
24
+ }
25
+
26
+ export function buildDisplayModels(rawModels) {
27
+ return rawModels.map(m => {
28
+ const priceStr = formatPrice(m.cost);
29
+ const canonicalNote = m.canonicalCost !== undefined
30
+ ? ` · official price: ${formatPrice(m.canonicalCost)}/M`
31
+ : '';
32
+ const context = m.context ? `${m.context / 1000}k` : '?';
33
+ return {
34
+ ...m,
35
+ label: `${m.name}${costTierDisplay(m.cost, m.canonicalCost)}, ${m.id}`,
36
+ description: `${priceStr}${canonicalNote} · context: ${context}`,
37
+ };
38
+ });
39
+ }
40
+
41
+ export function buildModelChoices(input, models) {
42
+ const q = (input || '').toLowerCase();
43
+ const filtered = q
44
+ ? models.filter(m =>
45
+ m.label.toLowerCase().includes(q) ||
46
+ m.id.toLowerCase().includes(q)
47
+ )
48
+ : models;
49
+
50
+ return [
51
+ {
52
+ name: 'None',
53
+ value: null,
54
+ description: 'Leave this model unset',
55
+ },
56
+ {
57
+ name: '← Change provider',
58
+ value: '__back__',
59
+ description: 'Go back to provider selection',
60
+ },
61
+ ...filtered.slice(0, 50).map(m => ({
62
+ name: m.label,
63
+ value: m.id,
64
+ description: m.description,
65
+ })),
66
+ ];
67
+ }
68
+
69
+ export function pickModel(message, models) {
70
+ return search({
71
+ message,
72
+ source: input => buildModelChoices(input, models),
73
+ });
74
+ }
75
+
76
+ export function filterModelsByProvider(models, provider) {
77
+ if (!provider) return models
78
+ return models.filter(m => m.id.startsWith(`${provider}/`))
79
+ }
80
+
81
+ export function pickProvider(message) {
82
+ return select({
83
+ message,
84
+ choices: modelsPreset.providers.map(p => ({ value: p.value, name: p.name })),
85
+ })
86
+ }
87
+
88
+ export { modelsPreset };
@@ -1,64 +1,64 @@
1
- import { header, info, prompt, success, warn } from '../../utils/exec.js'
2
- import { fetchModels } from '../../utils/models-cache.js'
3
- import { buildDisplayModels, filterModelsByProvider, modelsPreset, pickModel, pickProvider } from './format.js'
4
- import { writeModelsToConfigs } from './write.js'
5
-
6
- async function pickRoleModel(role, allModels) {
7
- const rolePreset = modelsPreset.roles[role]
8
- const [first, ...rest] = rolePreset.info
9
- prompt(first)
10
- for (const line of rest) info(line)
11
- console.log()
12
-
13
- while (true) {
14
- const provider = await pickProvider('Provider:')
15
- const filtered = filterModelsByProvider(allModels, provider)
16
- const available = filtered.length > 0 ? filtered : allModels
17
-
18
- const suggestion = rolePreset.suggestions?.[provider]
19
- if (suggestion) info(` Suggested: ${suggestion}`)
20
- if (filtered.length === 0 && provider) warn(` No ${provider} models found: showing all`)
21
-
22
- const model = await pickModel(rolePreset.prompt, available)
23
- if (model !== '__back__') return model
24
- }
25
- }
26
-
27
- export async function chooseModels() {
28
- header('Step 7, Choose models');
29
-
30
- info('Fetching available models from models.dev...');
31
- const { models: rawModels, source } = await fetchModels();
32
-
33
- if (!rawModels) {
34
- warn('Could not fetch models (offline and no cache). Skipping model selection.');
35
- warn('Set models later in opencode.jsonc');
36
- return;
37
- }
38
-
39
- if (source === 'stale-cache') {
40
- warn('Network unavailable, using cached model list (may be outdated).');
41
- } else if (source === 'cache') {
42
- info('Using cached model list (refreshes weekly).');
43
- }
44
-
45
- const models = buildDisplayModels(rawModels);
46
- success(`${models.length} models available`);
47
- console.log();
48
- info('Three models: main session, engineers, and light commands.');
49
- info('Cost indicators: [$] cheap [$$] mid [$$$] expensive');
50
- info('Pick provider first, then search by name. Change later in opencode.jsonc');
51
- console.log();
52
-
53
- const planModel = await pickRoleModel('plan', models); console.log();
54
- const buildModel = await pickRoleModel('build', models); console.log();
55
- const fastModel = await pickRoleModel('fast', models); console.log();
56
-
57
- await writeModelsToConfigs({ planModel, buildModel, fastModel });
58
-
59
- console.log();
60
- warn('Make sure you have API access to the selected models.');
61
- warn('Change them anytime in opencode.jsonc');
62
-
63
- return { planModel, buildModel, fastModel };
64
- }
1
+ import { header, info, prompt, success, warn } from '../../utils/exec.js'
2
+ import { fetchModels } from '../../utils/models-cache.js'
3
+ import { buildDisplayModels, filterModelsByProvider, modelsPreset, pickModel, pickProvider } from './format.js'
4
+ import { writeModelsToConfigs } from './write.js'
5
+
6
+ async function pickRoleModel(role, allModels) {
7
+ const rolePreset = modelsPreset.roles[role]
8
+ const [first, ...rest] = rolePreset.info
9
+ prompt(first)
10
+ for (const line of rest) info(line)
11
+ console.log()
12
+
13
+ while (true) {
14
+ const provider = await pickProvider('Provider:')
15
+ const filtered = filterModelsByProvider(allModels, provider)
16
+ const available = filtered.length > 0 ? filtered : allModels
17
+
18
+ const suggestion = rolePreset.suggestions?.[provider]
19
+ if (suggestion) info(` Suggested: ${suggestion}`)
20
+ if (filtered.length === 0 && provider) warn(` No ${provider} models found: showing all`)
21
+
22
+ const model = await pickModel(rolePreset.prompt, available)
23
+ if (model !== '__back__') return model
24
+ }
25
+ }
26
+
27
+ export async function chooseModels() {
28
+ header('Step 7, Choose models');
29
+
30
+ info('Fetching available models from models.dev...');
31
+ const { models: rawModels, source } = await fetchModels();
32
+
33
+ if (!rawModels) {
34
+ warn('Could not fetch models (offline and no cache). Skipping model selection.');
35
+ warn('Set models later in opencode.jsonc');
36
+ return;
37
+ }
38
+
39
+ if (source === 'stale-cache') {
40
+ warn('Network unavailable, using cached model list (may be outdated).');
41
+ } else if (source === 'cache') {
42
+ info('Using cached model list (refreshes weekly).');
43
+ }
44
+
45
+ const models = buildDisplayModels(rawModels);
46
+ success(`${models.length} models available`);
47
+ console.log();
48
+ info('Three models: main session, engineers, and light commands.');
49
+ info('Cost indicators: [$] cheap [$$] mid [$$$] expensive');
50
+ info('Pick provider first, then search by name. Change later in opencode.jsonc');
51
+ console.log();
52
+
53
+ const planModel = await pickRoleModel('plan', models); console.log();
54
+ const buildModel = await pickRoleModel('build', models); console.log();
55
+ const fastModel = await pickRoleModel('fast', models); console.log();
56
+
57
+ await writeModelsToConfigs({ planModel, buildModel, fastModel });
58
+
59
+ console.log();
60
+ warn('Make sure you have API access to the selected models.');
61
+ warn('Change them anytime in opencode.jsonc');
62
+
63
+ return { planModel, buildModel, fastModel };
64
+ }
@@ -1,136 +1,136 @@
1
- import { execa } from "execa"
2
- import fse from "fs-extra"
3
- import path from "node:path"
4
- import { commandExists, error, header, info, loading, success, warn } from "../../utils/exec.js"
5
-
6
-
7
- async function cleanOpenspecFiles() {
8
- const cwd = process.cwd()
9
- const commandsDir = path.join(cwd, '.opencode', 'commands')
10
- const opencodeSkillsDir = path.join(cwd, '.opencode', 'skills')
11
- const agentsSkillsDir = path.join(cwd, '.agents', 'skills')
12
-
13
- // Delete opsx-* command files generated by OpenSpec: we use /plan-propose and /plan-apply instead
14
- if (await fse.pathExists(commandsDir)) {
15
- for (const f of await fse.readdir(commandsDir)) {
16
- if (f.startsWith('opsx-') && f.endsWith('.md')) {
17
- await fse.remove(path.join(commandsDir, f))
18
- info(`Removed generated command: ${f}`)
19
- }
20
- }
21
- }
22
-
23
- // Move .opencode/skills/* to .agents/skills/: skills should be in the universal location
24
- if (await fse.pathExists(opencodeSkillsDir)) {
25
- await fse.ensureDir(agentsSkillsDir)
26
- for (const dir of await fse.readdir(opencodeSkillsDir)) {
27
- const src = path.join(opencodeSkillsDir, dir)
28
- const dest = path.join(agentsSkillsDir, dir)
29
- if (!(await fse.pathExists(dest))) {
30
- await fse.move(src, dest)
31
- info(`Moved skill: ${dir} → .agents/skills/`)
32
- } else {
33
- await fse.remove(src)
34
- }
35
- }
36
- // Remove .opencode/skills if now empty
37
- const remaining = await fse.readdir(opencodeSkillsDir)
38
- if (remaining.length === 0) await fse.remove(opencodeSkillsDir)
39
- }
40
-
41
- success('OpenSpec generated files cleaned up')
42
- }
43
-
44
- export const openspecSteps = {
45
- check,
46
- install,
47
- init,
48
- }
49
-
50
- export async function initOpenspec() {
51
- header("Step 6, Initializing OpenSpec")
52
-
53
- let openSpec = await openspecSteps.check()
54
- if (!openSpec.available) {
55
- await openspecSteps.install()
56
- }
57
-
58
- openSpec = await openspecSteps.check()
59
- if (!openSpec.available) {
60
- warn("OpenSpec has not been installed. It is required to create changes.")
61
- return { ...openSpec, initialized: false }
62
- }
63
-
64
- const initResult = await openspecSteps.init()
65
- if (!initResult.initialized) {
66
- warn(
67
- "OpenSpec has not been initialized. It is required to create changes.",
68
- )
69
- return { ...openSpec, initialized: false }
70
- }
71
-
72
- await cleanOpenspecFiles()
73
- return { ...openSpec, initialized: true }
74
- }
75
-
76
- async function install() {
77
- info("Installing OpenSpec...")
78
- try {
79
- const result = await execa(
80
- "npm",
81
- ["install", "@fission-ai/openspec", "--global"],
82
- {
83
- cwd: process.cwd(),
84
- stdio: "pipe",
85
- reject: false,
86
- },
87
- )
88
- if (result.exitCode !== 0) {
89
- warn("OpenSpec install failed, check output above")
90
- }
91
- success("OpenSpec installed")
92
- } catch (err) {
93
- error(`Failed to run openspec install: ${err.message}`)
94
- }
95
- }
96
-
97
- async function check() {
98
- loading("Checking OpenSpec...")
99
-
100
- const available = await commandExists("openspec")
101
-
102
- if (available) success("OpenSpec is available")
103
- else warn("OpenSpec not found on PATH.")
104
-
105
- return { available }
106
- }
107
-
108
- async function init() {
109
- loading("Initializing OpenSpec...")
110
- try {
111
- const result = await execa(
112
- "npx",
113
- ["@fission-ai/openspec", "init", "--tools", "opencode", "--force"],
114
- {
115
- cwd: process.cwd(),
116
- reject: false,
117
- },
118
- )
119
-
120
- if (result.exitCode !== 0) {
121
- const stderr = (result.stderr || "").trim()
122
- const msg = stderr
123
- ? `init failed: ${stderr}`
124
- : `init failed with exit code ${result.exitCode}`
125
- throw new Error(msg)
126
- }
127
- } catch (err) {
128
- error(`Failed to run openspec init: ${err.message}`)
129
- return { initialized: false }
130
- }
131
-
132
- success("OpenSpec initialized")
133
- return { initialized: true }
134
- }
135
-
136
-
1
+ import { execa } from "execa"
2
+ import fse from "fs-extra"
3
+ import path from "node:path"
4
+ import { commandExists, error, header, info, loading, success, warn } from "../../utils/exec.js"
5
+
6
+
7
+ async function cleanOpenspecFiles() {
8
+ const cwd = process.cwd()
9
+ const commandsDir = path.join(cwd, '.opencode', 'commands')
10
+ const opencodeSkillsDir = path.join(cwd, '.opencode', 'skills')
11
+ const agentsSkillsDir = path.join(cwd, '.agents', 'skills')
12
+
13
+ // Delete opsx-* command files generated by OpenSpec: we use /plan-propose and /plan-apply instead
14
+ if (await fse.pathExists(commandsDir)) {
15
+ for (const f of await fse.readdir(commandsDir)) {
16
+ if (f.startsWith('opsx-') && f.endsWith('.md')) {
17
+ await fse.remove(path.join(commandsDir, f))
18
+ info(`Removed generated command: ${f}`)
19
+ }
20
+ }
21
+ }
22
+
23
+ // Move .opencode/skills/* to .agents/skills/: skills should be in the universal location
24
+ if (await fse.pathExists(opencodeSkillsDir)) {
25
+ await fse.ensureDir(agentsSkillsDir)
26
+ for (const dir of await fse.readdir(opencodeSkillsDir)) {
27
+ const src = path.join(opencodeSkillsDir, dir)
28
+ const dest = path.join(agentsSkillsDir, dir)
29
+ if (!(await fse.pathExists(dest))) {
30
+ await fse.move(src, dest)
31
+ info(`Moved skill: ${dir} → .agents/skills/`)
32
+ } else {
33
+ await fse.remove(src)
34
+ }
35
+ }
36
+ // Remove .opencode/skills if now empty
37
+ const remaining = await fse.readdir(opencodeSkillsDir)
38
+ if (remaining.length === 0) await fse.remove(opencodeSkillsDir)
39
+ }
40
+
41
+ success('OpenSpec generated files cleaned up')
42
+ }
43
+
44
+ export const openspecSteps = {
45
+ check,
46
+ install,
47
+ init,
48
+ }
49
+
50
+ export async function initOpenspec() {
51
+ header("Step 6, Initializing OpenSpec")
52
+
53
+ let openSpec = await openspecSteps.check()
54
+ if (!openSpec.available) {
55
+ await openspecSteps.install()
56
+ }
57
+
58
+ openSpec = await openspecSteps.check()
59
+ if (!openSpec.available) {
60
+ warn("OpenSpec has not been installed. It is required to create changes.")
61
+ return { ...openSpec, initialized: false }
62
+ }
63
+
64
+ const initResult = await openspecSteps.init()
65
+ if (!initResult.initialized) {
66
+ warn(
67
+ "OpenSpec has not been initialized. It is required to create changes.",
68
+ )
69
+ return { ...openSpec, initialized: false }
70
+ }
71
+
72
+ await cleanOpenspecFiles()
73
+ return { ...openSpec, initialized: true }
74
+ }
75
+
76
+ async function install() {
77
+ info("Installing OpenSpec...")
78
+ try {
79
+ const result = await execa(
80
+ "npm",
81
+ ["install", "@fission-ai/openspec", "--global"],
82
+ {
83
+ cwd: process.cwd(),
84
+ stdio: "pipe",
85
+ reject: false,
86
+ },
87
+ )
88
+ if (result.exitCode !== 0) {
89
+ warn("OpenSpec install failed, check output above")
90
+ }
91
+ success("OpenSpec installed")
92
+ } catch (err) {
93
+ error(`Failed to run openspec install: ${err.message}`)
94
+ }
95
+ }
96
+
97
+ async function check() {
98
+ loading("Checking OpenSpec...")
99
+
100
+ const available = await commandExists("openspec")
101
+
102
+ if (available) success("OpenSpec is available")
103
+ else warn("OpenSpec not found on PATH.")
104
+
105
+ return { available }
106
+ }
107
+
108
+ async function init() {
109
+ loading("Initializing OpenSpec...")
110
+ try {
111
+ const result = await execa(
112
+ "npx",
113
+ ["@fission-ai/openspec", "init", "--tools", "opencode", "--force"],
114
+ {
115
+ cwd: process.cwd(),
116
+ reject: false,
117
+ },
118
+ )
119
+
120
+ if (result.exitCode !== 0) {
121
+ const stderr = (result.stderr || "").trim()
122
+ const msg = stderr
123
+ ? `init failed: ${stderr}`
124
+ : `init failed with exit code ${result.exitCode}`
125
+ throw new Error(msg)
126
+ }
127
+ } catch (err) {
128
+ error(`Failed to run openspec init: ${err.message}`)
129
+ return { initialized: false }
130
+ }
131
+
132
+ success("OpenSpec initialized")
133
+ return { initialized: true }
134
+ }
135
+
136
+