prizmkit 1.1.190 → 1.1.191

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 (38) hide show
  1. package/bin/create-prizmkit.js +4 -4
  2. package/bundled/VERSION.json +3 -3
  3. package/bundled/adapters/antigravity/assets/prizmkit-hook.cjs +150 -0
  4. package/bundled/adapters/antigravity/hooks-adapter.js +195 -0
  5. package/bundled/adapters/antigravity/paths.js +14 -0
  6. package/bundled/adapters/antigravity/rules-adapter.js +54 -0
  7. package/bundled/adapters/antigravity/skill-adapter.js +29 -0
  8. package/bundled/dev-pipeline/README.md +16 -5
  9. package/bundled/dev-pipeline/prizmkit_runtime/config.py +13 -2
  10. package/bundled/dev-pipeline/prizmkit_runtime/gitops.py +12 -12
  11. package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +13 -4
  12. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +8 -2
  13. package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +186 -24
  14. package/bundled/dev-pipeline/prizmkit_runtime/status.py +2 -0
  15. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +305 -17
  16. package/bundled/dev-pipeline/scripts/utils.py +5 -3
  17. package/bundled/dev-pipeline/tests/live_ai_cli_log_smoke.py +1 -0
  18. package/bundled/dev-pipeline/tests/test_python_runner_parity.py +135 -0
  19. package/bundled/dev-pipeline/tests/test_unified_cli.py +363 -0
  20. package/bundled/rules/USAGE.md +1 -0
  21. package/bundled/skills/_metadata.json +1 -1
  22. package/bundled/skills/feature-planner/SKILL.md +2 -2
  23. package/bundled/skills/prizmkit-init/SKILL.md +1 -1
  24. package/bundled/skills/prizmkit-init/references/config-schema.md +2 -2
  25. package/bundled/skills/prizmkit-prizm-docs/assets/prizm-docs-format.md +1 -1
  26. package/bundled/skills/prizmkit-prizm-docs/references/op-init.md +1 -1
  27. package/package.json +1 -1
  28. package/src/ai-cli-launch.js +1 -1
  29. package/src/clean.js +40 -4
  30. package/src/config.js +64 -4
  31. package/src/detect-platform.js +10 -6
  32. package/src/external-skills.js +2 -2
  33. package/src/index.js +1 -0
  34. package/src/manifest.js +1 -1
  35. package/src/platforms.js +6 -2
  36. package/src/prompts.js +11 -3
  37. package/src/scaffold.js +59 -4
  38. package/src/upgrade.js +9 -3
@@ -31,7 +31,7 @@ program
31
31
  program
32
32
  .command('install [directory]')
33
33
  .description('Install PrizmKit into a project directory')
34
- .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, pi, cursor, comma-separated list, or all')
34
+ .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, pi, cursor, antigravity, comma-separated list, or all')
35
35
  .option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
36
36
  .option('--skills <suite>', 'Skill suite: core, minimal, or recommended:<type> (frontend/backend/fullstack/library)', 'core')
37
37
  .option('--pipeline', 'Install dev-pipeline (default: true)')
@@ -43,7 +43,7 @@ program
43
43
  .option('--open-cli-auto-download', 'Auto-download opencli extension if missing (default: true)')
44
44
  .option('--no-open-cli-auto-download', 'Skip auto-download, show manual steps only')
45
45
  .option('--rules <preset>', 'Rules preset: recommended, minimal, or none', 'recommended')
46
- .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent)')
46
+ .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent, agy)')
47
47
  .option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
48
48
  .option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
49
49
  .option('--external-skills <names>', 'Comma-separated external skill names to install (e.g. find-skills,frontend-design)')
@@ -90,11 +90,11 @@ program
90
90
  program
91
91
  .command('config [directory]')
92
92
  .description('Reconfigure existing PrizmKit installation (change platform, skills, rules, options)')
93
- .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, pi, cursor, comma-separated list, or all')
93
+ .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, pi, cursor, antigravity, comma-separated list, or all')
94
94
  .option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
95
95
  .option('--skills <suite>', 'Skill suite: core, minimal, or recommended:<type>')
96
96
  .option('--rules <preset>', 'Rules preset: recommended, minimal, or none')
97
- .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent)')
97
+ .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent, agy)')
98
98
  .option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
99
99
  .option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
100
100
  .option('--pipeline', 'Enable dev-pipeline')
@@ -1,5 +1,5 @@
1
1
  {
2
- "frameworkVersion": "1.1.190",
3
- "bundledAt": "2026-11-15T16:12:31.340Z",
4
- "bundledFrom": "2c99a65"
2
+ "frameworkVersion": "1.1.191",
3
+ "bundledAt": "2026-11-19T16:48:18.839Z",
4
+ "bundledFrom": "96f1ffb"
5
5
  }
@@ -0,0 +1,150 @@
1
+ #!/usr/bin/env node
2
+ /* global process, require, __dirname */
3
+ 'use strict';
4
+
5
+ const fs = require('node:fs');
6
+ const os = require('node:os');
7
+ const path = require('node:path');
8
+ const crypto = require('node:crypto');
9
+ const { spawnSync } = require('node:child_process');
10
+
11
+ function readInput() {
12
+ try {
13
+ const raw = fs.readFileSync(0, 'utf8').trim();
14
+ if (!raw) return {};
15
+ const value = JSON.parse(raw);
16
+ return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
17
+ } catch {
18
+ return {};
19
+ }
20
+ }
21
+
22
+ function writeOutput(value) {
23
+ process.stdout.write(`${JSON.stringify(value)}\n`);
24
+ }
25
+
26
+ function resolveProjectRoot(input) {
27
+ if (input && typeof input.cwd === 'string' && input.cwd.trim() && fs.existsSync(input.cwd.trim())) {
28
+ return path.resolve(input.cwd.trim());
29
+ }
30
+ if (input && Array.isArray(input.workspacePaths)) {
31
+ for (const candidate of input.workspacePaths) {
32
+ if (typeof candidate === 'string' && candidate.trim() && fs.existsSync(candidate.trim())) {
33
+ return path.resolve(candidate.trim());
34
+ }
35
+ }
36
+ }
37
+ return path.resolve(__dirname, '..', '..', '..', '..');
38
+ }
39
+
40
+ function queueFilePath(projectRoot, conversationId) {
41
+ const conv = typeof conversationId === 'string' && conversationId.trim()
42
+ ? conversationId.trim()
43
+ : 'default';
44
+ const digest = crypto
45
+ .createHash('sha256')
46
+ .update(`${projectRoot}\0${conv}`)
47
+ .digest('hex')
48
+ .slice(0, 24);
49
+ return path.join(os.tmpdir(), `prizmkit-agy-drift-${digest}.txt`);
50
+ }
51
+
52
+ function systemMessageResponse(message) {
53
+ return {
54
+ injectSteps: [
55
+ {
56
+ systemMessage: {
57
+ systemMessage: message,
58
+ },
59
+ },
60
+ ],
61
+ };
62
+ }
63
+
64
+ function sessionStart(input) {
65
+ const projectRoot = resolveProjectRoot(input);
66
+ if (fs.existsSync(path.join(projectRoot, '.prizmkit', 'prizm-docs', 'root.prizm'))) {
67
+ return systemMessageResponse(
68
+ 'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .agents/plugins/prizmkit/skills and Rules in .agents/plugins/prizmkit/rules.',
69
+ );
70
+ }
71
+ return systemMessageResponse(
72
+ 'PrizmKit: project documentation is not initialized. Use /prizmkit-init when project context bootstrap is required.',
73
+ );
74
+ }
75
+
76
+ function extractCommand(input) {
77
+ const args = input && input.toolCall && input.toolCall.args && typeof input.toolCall.args === 'object'
78
+ ? input.toolCall.args
79
+ : null;
80
+ if (args) {
81
+ if (typeof args.CommandLine === 'string') return args.CommandLine;
82
+ if (typeof args.command === 'string') return args.command;
83
+ }
84
+ const toolInput = input && input.tool_input && typeof input.tool_input === 'object'
85
+ ? input.tool_input
86
+ : null;
87
+ if (toolInput && typeof toolInput.command === 'string') return toolInput.command;
88
+ return '';
89
+ }
90
+
91
+ function postToolUse(input) {
92
+ const command = extractCommand(input);
93
+ if (!/\bgit\s+(commit|merge|rebase)\b/.test(command)) return {};
94
+
95
+ const projectRoot = resolveProjectRoot(input);
96
+ const runPythonHook = path.join(projectRoot, '.prizmkit', 'scripts', 'run-python-hook.cjs');
97
+ const driftScript = path.join(projectRoot, '.prizmkit', 'scripts', 'post-command-prizm-drift.py');
98
+ if (!fs.existsSync(runPythonHook) || !fs.existsSync(driftScript)) return {};
99
+
100
+ const result = spawnSync(
101
+ process.execPath,
102
+ [runPythonHook, driftScript],
103
+ {
104
+ cwd: projectRoot,
105
+ env: {
106
+ ...process.env,
107
+ CLAUDE_TOOL_INPUT: JSON.stringify({ command }),
108
+ },
109
+ encoding: 'utf8',
110
+ timeout: 25000,
111
+ windowsHide: true,
112
+ },
113
+ );
114
+ const context = String(result.stdout || '').trim();
115
+ if (context) {
116
+ try {
117
+ fs.appendFileSync(queueFilePath(projectRoot, input && input.conversationId), `${context}\n`, 'utf8');
118
+ } catch {
119
+ // Non-blocking drift queue; PostToolUse must still return {}.
120
+ }
121
+ }
122
+ return {};
123
+ }
124
+
125
+ function postInvocation(input) {
126
+ const projectRoot = resolveProjectRoot(input);
127
+ const qPath = queueFilePath(projectRoot, input && input.conversationId);
128
+ if (!fs.existsSync(qPath)) return {};
129
+
130
+ let queued = '';
131
+ try {
132
+ queued = fs.readFileSync(qPath, 'utf8').trim();
133
+ } catch {
134
+ queued = '';
135
+ } finally {
136
+ try {
137
+ fs.rmSync(qPath, { force: true });
138
+ } catch {
139
+ // Ignore temp queue cleanup error.
140
+ }
141
+ }
142
+ return queued ? systemMessageResponse(queued) : {};
143
+ }
144
+
145
+ const input = readInput();
146
+ const operation = process.argv[2] || '';
147
+ if (operation === 'session-start') writeOutput(sessionStart(input));
148
+ else if (operation === 'post-tool-use') writeOutput(postToolUse(input));
149
+ else if (operation === 'post-invocation') writeOutput(postInvocation(input));
150
+ else writeOutput({});
@@ -0,0 +1,195 @@
1
+ /** Merge PrizmKit-owned Antigravity plugin hooks and manifest without replacing user entries. */
2
+ import { existsSync, mkdirSync } from 'node:fs';
3
+ import { copyFile, readFile, rm, writeFile } from 'node:fs/promises';
4
+ import path from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
6
+ import {
7
+ HOOK_SCRIPT,
8
+ HOOKS_FILE,
9
+ HOOKS_OWNERSHIP_MARKER,
10
+ PLUGIN_MANIFEST,
11
+ PLUGIN_OWNERSHIP_MARKER,
12
+ } from './paths.js';
13
+
14
+ export const MANAGED_HOOK_KEY = 'prizmkit';
15
+ export const MANAGED_HOOK_MARKER = './hooks/prizmkit-hook.cjs';
16
+ export const DEFAULT_PLUGIN_DESCRIPTION =
17
+ 'PrizmKit self-evolving autonomous development skills, rules, and lifecycle hooks';
18
+
19
+ const MANAGED_HOOK_SPEC = {
20
+ SessionStart: [
21
+ {
22
+ type: 'command',
23
+ command: `node ${MANAGED_HOOK_MARKER} session-start`,
24
+ timeout: 10,
25
+ },
26
+ ],
27
+ PostToolUse: [
28
+ {
29
+ matcher: 'run_command',
30
+ hooks: [
31
+ {
32
+ type: 'command',
33
+ command: `node ${MANAGED_HOOK_MARKER} post-tool-use`,
34
+ timeout: 30,
35
+ },
36
+ ],
37
+ },
38
+ ],
39
+ PostInvocation: [
40
+ {
41
+ type: 'command',
42
+ command: `node ${MANAGED_HOOK_MARKER} post-invocation`,
43
+ timeout: 15,
44
+ },
45
+ ],
46
+ };
47
+
48
+ function isObject(value) {
49
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
50
+ }
51
+
52
+ function isManagedHook(value) {
53
+ try {
54
+ return JSON.stringify(value).includes(MANAGED_HOOK_MARKER);
55
+ } catch {
56
+ return false;
57
+ }
58
+ }
59
+
60
+ export function mergeAntigravityHooks(existing = {}, managedSpec = MANAGED_HOOK_SPEC) {
61
+ if (!isObject(existing)) {
62
+ throw new Error('Cannot preserve malformed Antigravity hooks: root must be an object');
63
+ }
64
+ const next = {};
65
+ for (const [key, spec] of Object.entries(existing)) {
66
+ if (!isObject(spec)) {
67
+ throw new Error(`Cannot preserve malformed Antigravity hooks: ${key} must be an object`);
68
+ }
69
+ if (key === MANAGED_HOOK_KEY) continue;
70
+ next[key] = spec;
71
+ }
72
+ next[MANAGED_HOOK_KEY] = managedSpec;
73
+ return next;
74
+ }
75
+
76
+ export function removeManagedAntigravityHooks(existing = {}) {
77
+ if (!isObject(existing)) {
78
+ throw new Error('Cannot preserve malformed Antigravity hooks: root must be an object');
79
+ }
80
+ const next = {};
81
+ for (const [key, spec] of Object.entries(existing)) {
82
+ if (!isObject(spec)) {
83
+ throw new Error(`Cannot preserve malformed Antigravity hooks: ${key} must be an object`);
84
+ }
85
+ if (key === MANAGED_HOOK_KEY || isManagedHook(spec)) continue;
86
+ next[key] = spec;
87
+ }
88
+ return next;
89
+ }
90
+
91
+ async function readJsonObject(filePath, label) {
92
+ if (!existsSync(filePath)) return {};
93
+ try {
94
+ const parsed = JSON.parse(await readFile(filePath, 'utf8'));
95
+ if (!isObject(parsed)) {
96
+ throw new Error('root must be an object');
97
+ }
98
+ return parsed;
99
+ } catch (error) {
100
+ throw new Error(`Cannot preserve malformed Antigravity ${label} at ${filePath}: ${error.message}`);
101
+ }
102
+ }
103
+
104
+ function isManagedPluginManifest(manifest) {
105
+ if (!isObject(manifest)) return false;
106
+ const allowedKeys = new Set(['name', 'description', 'version']);
107
+ return Object.keys(manifest).every(key => allowedKeys.has(key))
108
+ && manifest.name === 'prizmkit'
109
+ && manifest.description === DEFAULT_PLUGIN_DESCRIPTION;
110
+ }
111
+
112
+ export async function installHooks(targetRoot, options = {}) {
113
+ const hooksPath = path.join(targetRoot, HOOKS_FILE);
114
+ const scriptPath = path.join(targetRoot, HOOK_SCRIPT);
115
+ const hooksOwnershipPath = path.join(targetRoot, HOOKS_OWNERSHIP_MARKER);
116
+ const pluginPath = path.join(targetRoot, PLUGIN_MANIFEST);
117
+ const pluginOwnershipPath = path.join(targetRoot, PLUGIN_OWNERSHIP_MARKER);
118
+ const assetPath = fileURLToPath(new URL('./assets/prizmkit-hook.cjs', import.meta.url));
119
+
120
+ const hooksFileExisted = existsSync(hooksPath);
121
+ const pluginFileExisted = existsSync(pluginPath);
122
+ const existingHooks = await readJsonObject(hooksPath, 'hooks');
123
+ const existingPlugin = await readJsonObject(pluginPath, 'plugin manifest');
124
+
125
+ const mergedHooks = mergeAntigravityHooks(existingHooks);
126
+ const version = String(options.version || existingPlugin.version || '1.0.0');
127
+ const nextPlugin = (!pluginFileExisted || existsSync(pluginOwnershipPath))
128
+ ? {
129
+ name: 'prizmkit',
130
+ description: DEFAULT_PLUGIN_DESCRIPTION,
131
+ version,
132
+ }
133
+ : {
134
+ ...existingPlugin,
135
+ name: 'prizmkit',
136
+ description: existingPlugin.description || DEFAULT_PLUGIN_DESCRIPTION,
137
+ version,
138
+ };
139
+
140
+ mkdirSync(path.dirname(hooksPath), { recursive: true });
141
+ mkdirSync(path.dirname(scriptPath), { recursive: true });
142
+ await writeFile(hooksPath, `${JSON.stringify(mergedHooks, null, 2)}\n`);
143
+ await writeFile(pluginPath, `${JSON.stringify(nextPlugin, null, 2)}\n`);
144
+ if (!hooksFileExisted) {
145
+ await writeFile(hooksOwnershipPath, 'PrizmKit created .agents/plugins/prizmkit/hooks.json\n');
146
+ }
147
+ if (!pluginFileExisted) {
148
+ await writeFile(pluginOwnershipPath, 'PrizmKit created .agents/plugins/prizmkit/plugin.json\n');
149
+ }
150
+ await copyFile(assetPath, scriptPath);
151
+ }
152
+
153
+ export async function removeHooks(targetRoot, dryRun = false) {
154
+ const hooksPath = path.join(targetRoot, HOOKS_FILE);
155
+ const scriptPath = path.join(targetRoot, HOOK_SCRIPT);
156
+ const hooksOwnershipPath = path.join(targetRoot, HOOKS_OWNERSHIP_MARKER);
157
+ const pluginPath = path.join(targetRoot, PLUGIN_MANIFEST);
158
+ const pluginOwnershipPath = path.join(targetRoot, PLUGIN_OWNERSHIP_MARKER);
159
+ const affected = [];
160
+
161
+ if (existsSync(hooksPath)) {
162
+ const existing = await readJsonObject(hooksPath, 'hooks');
163
+ const next = removeManagedAntigravityHooks(existing);
164
+ const removeCreatedFile = Object.keys(next).length === 0 && existsSync(hooksOwnershipPath);
165
+ if (removeCreatedFile || JSON.stringify(next) !== JSON.stringify(existing)) {
166
+ affected.push({ path: HOOKS_FILE, action: removeCreatedFile ? 'removed' : 'updated' });
167
+ if (!dryRun) {
168
+ if (removeCreatedFile) await rm(hooksPath, { force: true });
169
+ else await writeFile(hooksPath, `${JSON.stringify(next, null, 2)}\n`);
170
+ }
171
+ }
172
+ }
173
+
174
+ if (existsSync(pluginPath)) {
175
+ const existingPlugin = await readJsonObject(pluginPath, 'plugin manifest');
176
+ if (existsSync(pluginOwnershipPath) || isManagedPluginManifest(existingPlugin)) {
177
+ affected.push({ path: PLUGIN_MANIFEST, action: 'removed' });
178
+ if (!dryRun) await rm(pluginPath, { force: true });
179
+ }
180
+ }
181
+
182
+ if (existsSync(scriptPath)) {
183
+ affected.push({ path: HOOK_SCRIPT, action: 'removed' });
184
+ if (!dryRun) await rm(scriptPath, { force: true });
185
+ }
186
+ if (existsSync(hooksOwnershipPath)) {
187
+ affected.push({ path: HOOKS_OWNERSHIP_MARKER, action: 'removed' });
188
+ if (!dryRun) await rm(hooksOwnershipPath, { force: true });
189
+ }
190
+ if (existsSync(pluginOwnershipPath)) {
191
+ affected.push({ path: PLUGIN_OWNERSHIP_MARKER, action: 'removed' });
192
+ if (!dryRun) await rm(pluginOwnershipPath, { force: true });
193
+ }
194
+ return affected;
195
+ }
@@ -0,0 +1,14 @@
1
+ /** Antigravity workspace plugin path constants and conventions. */
2
+ export const PLATFORM_ID = 'antigravity';
3
+ export const CLI_COMMAND = 'agy';
4
+ export const PLUGIN_DIR = '.agents/plugins/prizmkit';
5
+ export const PLUGIN_MANIFEST = '.agents/plugins/prizmkit/plugin.json';
6
+ export const SKILLS_DIR = '.agents/plugins/prizmkit/skills';
7
+ export const RULES_DIR = '.agents/plugins/prizmkit/rules';
8
+ export const HOOKS_FILE = '.agents/plugins/prizmkit/hooks.json';
9
+ export const HOOK_SCRIPT = '.agents/plugins/prizmkit/hooks/prizmkit-hook.cjs';
10
+ export const HOOKS_OWNERSHIP_MARKER = '.agents/plugins/prizmkit/hooks/.prizmkit-created-hooks-json';
11
+ export const PLUGIN_OWNERSHIP_MARKER = '.agents/plugins/prizmkit/hooks/.prizmkit-created-plugin-json';
12
+ export const FRAMEWORK_RULE_FILE = 'prizmkit-framework.md';
13
+ export const SKILL_DEFINITION_FILE = 'SKILL.md';
14
+ export const SKILL_DIR_VAR = '${SKILL_DIR}';
@@ -0,0 +1,54 @@
1
+ /** Convert canonical PrizmKit guidance to Antigravity workspace plugin Rules. */
2
+ import { mkdirSync } from 'node:fs';
3
+ import { writeFile } from 'node:fs/promises';
4
+ import path from 'node:path';
5
+ import { parseFrontmatter, buildMarkdown } from '../shared/frontmatter.js';
6
+ import { FRAMEWORK_RULE_FILE, RULES_DIR, SKILLS_DIR } from './paths.js';
7
+
8
+ export function convertToAntigravityRule(markdown, fallbackDescription) {
9
+ const { frontmatter, body } = parseFrontmatter(markdown);
10
+ const description = String(frontmatter.description || fallbackDescription || 'PrizmKit project guidance');
11
+ const globs = typeof frontmatter.globs === 'string' ? frontmatter.globs.trim() : '';
12
+ const ruleFrontmatter = globs
13
+ ? {
14
+ trigger: 'glob',
15
+ globs,
16
+ description,
17
+ }
18
+ : {
19
+ trigger: 'always_on',
20
+ description,
21
+ };
22
+ return buildMarkdown(ruleFrontmatter, body);
23
+ }
24
+
25
+ export async function installRules(targetRoot, ruleFiles) {
26
+ const rulesDir = path.join(targetRoot, RULES_DIR);
27
+ mkdirSync(rulesDir, { recursive: true });
28
+ for (const rule of ruleFiles) {
29
+ const baseName = path.basename(rule.name);
30
+ await writeFile(
31
+ path.join(rulesDir, `${baseName}.md`),
32
+ convertToAntigravityRule(rule.content, rule.name),
33
+ );
34
+ }
35
+ }
36
+
37
+ export async function installFrameworkGuidance(targetRoot, templateContent) {
38
+ const rulesDir = path.join(targetRoot, RULES_DIR);
39
+ mkdirSync(rulesDir, { recursive: true });
40
+ const body = templateContent.replace(
41
+ '### Available Commands\nRun `/prizmkit` to see all available PrizmKit commands.',
42
+ `### Available PrizmKit Skills
43
+ Antigravity discovers project Skills from \`${SKILLS_DIR}/\`. Invoke them with \`/<name>\` (for example \`/prizmkit-plan\`).
44
+
45
+ - Start with \`/prizmkit\` to see all available PrizmKit skills.
46
+ - Skill assets and references live inside each \`${SKILLS_DIR}/<skill>/\` directory.
47
+ - PrizmKit behavioral rules live in \`${RULES_DIR}/\`; read the relevant Rule before commit, documentation, or context-loading work.
48
+ `,
49
+ );
50
+ await writeFile(
51
+ path.join(rulesDir, FRAMEWORK_RULE_FILE),
52
+ convertToAntigravityRule(body, 'PrizmKit framework guidance for Antigravity project sessions'),
53
+ );
54
+ }
@@ -0,0 +1,29 @@
1
+ /** Convert canonical PrizmKit Skills to Antigravity workspace plugin Skills. */
2
+ import { parseFrontmatter, buildMarkdown } from '../shared/frontmatter.js';
3
+ import { SKILLS_DIR } from './paths.js';
4
+
5
+ function applyAntigravityInteractionCompatibility(content) {
6
+ const fallback =
7
+ "Use Antigravity's `ask_question` tool when it is available. If it is unavailable in the current surface, ask the same question directly in chat and wait for explicit user input. Tool unavailability is not permission to choose defaults.";
8
+ return content
9
+ .replace(/\bAskUserQuestion\b/g, "Antigravity's `ask_question` tool")
10
+ .replace(
11
+ /Do NOT render options as plain text — the user must be able to click\/select\./g,
12
+ fallback,
13
+ )
14
+ .replace(
15
+ /Do NOT render options as plain text \(e\.g\., `\[A\] option \[B\] option`\) — the user must be able to click\/select, not type a letter\./g,
16
+ fallback,
17
+ );
18
+ }
19
+
20
+ export function convertSkill(skillContent, skillName) {
21
+ const { frontmatter, body } = parseFrontmatter(skillContent);
22
+ if (!frontmatter.name) frontmatter.name = skillName;
23
+
24
+ const convertedBody = applyAntigravityInteractionCompatibility(body)
25
+ .replace(/\$\{SKILL_DIR\}/g, `${SKILLS_DIR}/${skillName}`);
26
+ const note = `> Antigravity project install: Antigravity discovers this Skill from \`${SKILLS_DIR}/${skillName}/SKILL.md\`. Invoke it as \`/${skillName}\` when manual invocation is needed.\n>\n> Antigravity interaction compatibility: use Antigravity's \`ask_question\` tool when available. If the current surface does not expose it, ask the same required question directly in chat and wait for explicit user input. Tool unavailability is not permission to choose defaults. Only true headless runs with no conversational user may use documented conservative defaults.\n\n`;
27
+
28
+ return buildMarkdown(frontmatter, note + convertedBody);
29
+ }
@@ -8,7 +8,7 @@ Autonomous development pipeline that drives iterative AI CLI sessions through Pr
8
8
 
9
9
  - Python 3.8+
10
10
  - [jq](https://jqlang.github.io/jq/) (`brew install jq`)
11
- - AI CLI in PATH: CodeBuddy (`cbc`), Claude Code (`claude`), Codex (`codex`), Pi (`pi`), or verified Cursor Agent (`agent`)
11
+ - AI CLI in PATH: CodeBuddy (`cbc`), Claude Code (`claude`), Codex (`codex`), Pi (`pi`), verified Cursor Agent (`agent`), or Antigravity (`agy`)
12
12
  - `.prizmkit/plans/feature-list.json` generated by the `feature-planner` skill (for feature pipeline)
13
13
  - `.prizmkit/plans/bug-fix-list.json` generated by the `bug-planner` skill (for bug pipeline)
14
14
 
@@ -461,7 +461,7 @@ python3 scripts/detect-stuck.py \
461
461
 
462
462
  ### `scripts/parse-stream-progress.py` — Real-Time Progress Parser
463
463
 
464
- Reads provider JSONL output and extracts progress metrics. Cursor support recognizes `system`, `user`, `assistant`, `tool_call`, and terminal `result` events, including read/write/function tool variants and additive unknown fields.
464
+ Reads provider JSONL output and extracts progress metrics. Cursor support recognizes `system`, `user`, `assistant`, `tool_call`, and terminal `result` events, including read/write/function tool variants and additive unknown fields. Antigravity support normalizes `init`, `step_update` (`plannerResponse`, `tool_call`, `toolCall`, `userInput`, `error`), `result`, and `error` events.
465
465
 
466
466
  ```bash
467
467
  python3 scripts/parse-stream-progress.py \
@@ -550,8 +550,8 @@ Also exports: `log_info`, `log_warn`, `log_error`, `log_success` (with timestamp
550
550
 
551
551
  | Variable | Default | Used By | Description |
552
552
  |----------|---------|---------|-------------|
553
- | `AI_CLI` | auto-detect | Python runtime | AI CLI command name. Auto-detects `cbc`, `claude`, `codex`, `pi`, or verified Cursor `agent` |
554
- | `PRIZMKIT_PLATFORM` | auto-detect | Python runtime | Platform hint for custom/wrapped AI CLI commands: `codebuddy`, `claude`, `codex`, `pi`, or `cursor` |
553
+ | `AI_CLI` | auto-detect | Python runtime | AI CLI command name. Auto-detects `cbc`, `claude`, `codex`, `pi`, verified Cursor `agent`, or Antigravity `agy` |
554
+ | `PRIZMKIT_PLATFORM` | auto-detect | Python runtime | Platform hint for custom/wrapped AI CLI commands: `codebuddy`, `claude`, `codex`, `pi`, `cursor`, or `antigravity` |
555
555
  | `MODEL` | (none) | cli.py run feature, cli.py run bugfix | AI model fallback. Overridden by per-feature `model` field. See [Model Selection](#model-selection) |
556
556
  | `CODEBUDDY_CLI` | (deprecated) | Python runtime | Legacy alias for `AI_CLI`. Prefer `AI_CLI` |
557
557
  | `VERBOSE` | `0` | cli.py run feature | Set to `1` to enable `--verbose` on AI CLI |
@@ -647,7 +647,7 @@ The pipeline auto-detects which AI CLI to use. Detection priority:
647
647
  3. `.prizmkit/manifest.json` or `.prizmkit/config.json` → `platform` field
648
648
  4. `CODEBUDDY_CLI` environment variable (legacy)
649
649
  5. Installed PrizmKit platform artifacts
650
- 6. PATH fallback: `claude` → `cbc` → `codex` → `pi` → verified Cursor `agent`
650
+ 6. PATH fallback: `claude` → `cbc` → `codex` → `pi` → verified Cursor `agent` → Antigravity `agy`
651
651
 
652
652
  To permanently configure, create `.prizmkit/config.json`:
653
653
 
@@ -671,6 +671,7 @@ python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
671
671
  MODEL=claude-sonnet-4.6 python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
672
672
  AI_CLI=cbc python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
673
673
  AI_CLI=agent python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
674
+ AI_CLI=agy python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
674
675
  ```
675
676
 
676
677
  ### Cursor Agent native headless contract
@@ -685,6 +686,16 @@ agent --print --force --trust --output-format stream-json [--model <model>]
685
686
 
686
687
  The complete coordinator Prompt is sent through stdin and the active task checkout is the process `cwd`. PrizmKit does not pass Cursor `--worktree`, does not disable Cursor sandbox policy, and does not create or modify `.cursor/cli.json`; user and enterprise deny policy continues to apply. Authentication is inherited from `agent login` or `CURSOR_API_KEY`, never serialized into PrizmKit config, argv, or logs. Cursor exposes no documented effort parameter, so `PRIZMKIT_EFFORT` must remain unset for `AI_CLI=agent`; a non-empty value fails with an actionable diagnostic.
687
688
 
689
+ ### Antigravity CLI native headless contract
690
+
691
+ Install and authenticate the Antigravity CLI (`agy`). For a Pipeline session, PrizmKit runs inside the active task checkout (`cwd`):
692
+
693
+ ```bash
694
+ agy --dangerously-skip-permissions --input-format stream-json --output-format stream-json [--model <model>] [--effort <low|medium|high|xhigh|max>]
695
+ ```
696
+
697
+ The coordinator Prompt is written to stdin as a single-turn NDJSON user event (`{"event":"user","message":{"content":"..."}}`). Valid `PRIZMKIT_EFFORT` values are `low`, `medium`, `high`, `xhigh`, and `max` (non-matching values fail preflight validation). Runner preflight requires `--print`, `--dangerously-skip-permissions`, `--input-format`, `--output-format`, and `stream-json` in `agy --help`, failing fast with an actionable diagnostic if unavailable.
698
+
688
699
  ---
689
700
 
690
701
  ## How It Works
@@ -80,6 +80,7 @@ AI_CLIENT_PRECEDENCE = (
80
80
  "PATH:codex",
81
81
  "PATH:pi",
82
82
  "PATH:agent",
83
+ "PATH:agy",
83
84
  )
84
85
 
85
86
  _EFFORT_VALUES_BY_PLATFORM = {
@@ -88,6 +89,7 @@ _EFFORT_VALUES_BY_PLATFORM = {
88
89
  "codebuddy": ("low", "medium", "high", "xhigh"),
89
90
  "pi": ("off", "minimal", "low", "medium", "high", "xhigh", "max"),
90
91
  "cursor": (),
92
+ "antigravity": ("low", "medium", "high", "xhigh", "max"),
91
93
  }
92
94
 
93
95
 
@@ -181,6 +183,7 @@ def _cli_names_for_platform(platform: str | None) -> tuple[str, ...]:
181
183
  "codebuddy": ("cbc",),
182
184
  "pi": ("pi",),
183
185
  "cursor": ("agent",),
186
+ "antigravity": ("agy",),
184
187
  }
185
188
  names: list[str] = []
186
189
  for host in hosts:
@@ -213,6 +216,8 @@ def _known_platform_from_cli(cli_command: str | None) -> str | None:
213
216
  return "pi"
214
217
  if name == "agent":
215
218
  return "cursor"
219
+ if name in {"agy", "antigravity"}:
220
+ return "antigravity"
216
221
  if name in {"cbc", "codebuddy"}:
217
222
  return "codebuddy"
218
223
  return None
@@ -220,7 +225,7 @@ def _known_platform_from_cli(cli_command: str | None) -> str | None:
220
225
 
221
226
  def _concrete_platform(platform: str | None) -> str | None:
222
227
  normalized = _normalize_platform(platform)
223
- return normalized if normalized in {"claude", "codebuddy", "codex", "pi", "cursor"} else None
228
+ return normalized if normalized in {"claude", "codebuddy", "codex", "pi", "cursor", "antigravity"} else None
224
229
 
225
230
 
226
231
  def _cursor_agent_is_verified(executable: str) -> bool:
@@ -343,6 +348,10 @@ def _installed_platform_cli(
343
348
  resolved = _resolve_cli_name("agent", env)
344
349
  if resolved:
345
350
  return resolved, "installed-platform:cursor"
351
+ if (paths.project_root / ".agents" / "plugins" / "prizmkit" / "skills" / "prizmkit" / "SKILL.md").is_file():
352
+ resolved = _resolve_cli_name("agy", env)
353
+ if resolved:
354
+ return resolved, "installed-platform:antigravity"
346
355
  return None, None
347
356
 
348
357
 
@@ -453,7 +462,7 @@ def _resolve_ai_client(paths: RuntimePaths, env: Mapping[str, str]) -> AIClientR
453
462
  precedence=AI_CLIENT_PRECEDENCE,
454
463
  )
455
464
 
456
- for candidate in ("claude", "cbc", "codex", "pi", "agent"):
465
+ for candidate in ("claude", "cbc", "codex", "pi", "agent", "agy"):
457
466
  resolved = _resolve_cli_name(candidate, env)
458
467
  if resolved:
459
468
  return AIClientResolution(
@@ -500,6 +509,7 @@ def validate_effort(effort: str | None, platform: str | None) -> EffortValidatio
500
509
  "codebuddy": "CodeBuddy",
501
510
  "pi": "Pi",
502
511
  "cursor": "Cursor Agent CLI",
512
+ "antigravity": "Antigravity",
503
513
  }.get(_concrete_platform(platform) or "codebuddy", "CodeBuddy")
504
514
  if not supported:
505
515
  message = (
@@ -537,6 +547,7 @@ def load_runtime_config(paths: RuntimePaths, env: Mapping[str, str] | None = Non
537
547
  paths.project_root / ".codex",
538
548
  paths.project_root / ".pi",
539
549
  paths.project_root / ".cursor",
550
+ paths.project_root / ".agents" / "plugins" / "prizmkit",
540
551
  ),
541
552
  path_entries=_path_entries(runtime_env),
542
553
  sources=("environment", "prizmkit-env", "prizmkit-config", "installed-platform-markers", "PATH"),
@@ -834,13 +834,13 @@ def git_status_safe(project_root: Path) -> str:
834
834
  result = run_git_command(project_root, ("status", "--porcelain", "--", ".", *HIDDEN_TOOL_WORKTREE_EXCLUDES))
835
835
  if result.return_code != 0:
836
836
  return ""
837
- tracked_cursor = run_git_command(
837
+ tracked_support = run_git_command(
838
838
  project_root,
839
- ("status", "--porcelain", "--untracked-files=no", "--", ".cursor"),
839
+ ("status", "--porcelain", "--untracked-files=no", "--", ".cursor", ".agents"),
840
840
  )
841
- if tracked_cursor.return_code != 0:
841
+ if tracked_support.return_code != 0:
842
842
  return ""
843
- return result.stdout + tracked_cursor.stdout
843
+ return result.stdout + tracked_support.stdout
844
844
 
845
845
 
846
846
  def _status_record_paths(stdout: str) -> tuple[str, ...]:
@@ -870,16 +870,16 @@ def visible_task_paths(project_root: Path) -> tuple[tuple[str, ...], GitCommandR
870
870
  return (), result
871
871
 
872
872
  # Platform payloads copied into a task worktree stay hidden, but existing
873
- # tracked Cursor project configuration remains part of complete-workspace
874
- # commit semantics. `--untracked-files=no` admits only Git-owned Cursor
875
- # changes and cannot sweep materialized support files into a task commit.
876
- cursor_result = run_git_command(
873
+ # tracked Cursor/Antigravity/Codex project configuration remains part of
874
+ # complete-workspace commit semantics. `--untracked-files=no` admits only
875
+ # Git-owned changes and cannot sweep materialized support files into a task commit.
876
+ tracked_support_result = run_git_command(
877
877
  project_root,
878
- ("status", "--porcelain=v1", "-z", "--untracked-files=no", "--", ".cursor"),
878
+ ("status", "--porcelain=v1", "-z", "--untracked-files=no", "--", ".cursor", ".agents"),
879
879
  )
880
- if cursor_result.return_code != 0:
881
- return (), cursor_result
882
- paths = (*_status_record_paths(result.stdout), *_status_record_paths(cursor_result.stdout))
880
+ if tracked_support_result.return_code != 0:
881
+ return (), tracked_support_result
882
+ paths = (*_status_record_paths(result.stdout), *_status_record_paths(tracked_support_result.stdout))
883
883
  return tuple(dict.fromkeys(paths)), result
884
884
 
885
885