shift-ax 0.3.0

package/dist/scripts/ax.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const here = dirname(fileURLToPath(import.meta.url));
+const command = process.argv[2];
+const args = process.argv.slice(3);
+const compiledMode = existsSync(join(here, 'ax-shell.js'));
+const shellMode = !command ||
+    command === '--codex' ||
+    command === '--claude-code' ||
+    command === '--lang' ||
+    command === '--root' ||
+    command === '--discover' ||
+    command === '--onboarding-input';
+const commands = new Map([
+    ['bootstrap-topic', 'ax-bootstrap-topic.ts'],
+    ['resolve-context', 'ax-resolve-context.ts'],
+    ['build-context-bundle', 'ax-build-context-bundle.ts'],
+    ['init-context', 'ax-init-context.ts'],
+    ['context-health', 'ax-context-health.ts'],
+    ['monitor-context', 'ax-monitor-context.ts'],
+    ['refresh-state', 'ax-refresh-state.ts'],
+    ['pause-work', 'ax-pause-work.ts'],
+    ['checkpoint-context', 'ax-checkpoint-context.ts'],
+    ['thread-save', 'ax-thread-save.ts'],
+    ['threads', 'ax-threads.ts'],
+    ['promote-thread', 'ax-promote-thread.ts'],
+    ['verification-debt', 'ax-verification-debt.ts'],
+    ['learned-debug-save', 'ax-learned-debug-save.ts'],
+    ['learned-debug', 'ax-learned-debug.ts'],
+    ['consolidate-memory', 'ax-consolidate-memory.ts'],
+    ['team-preferences', 'ax-team-preferences.ts'],
+    ['entity-memory', 'ax-entity-memory.ts'],
+    ['review', 'ax-review.ts'],
+    ['worktree-plan', 'ax-worktree-plan.ts'],
+    ['worktree-create', 'ax-worktree-create.ts'],
+    ['worktree-remove', 'ax-worktree-remove.ts'],
+    ['onboard-context', 'ax-onboard-context.ts'],
+    ['export-context', 'ax-export-context.ts'],
+    ['doctor', 'ax-doctor.ts'],
+    ['run-request', 'ax-run-request.ts'],
+    ['approve-plan', 'ax-approve-plan.ts'],
+    ['sync-policy-context', 'ax-sync-policy-context.ts'],
+    ['react-feedback', 'ax-react-feedback.ts'],
+    ['finalize-commit', 'ax-finalize-commit.ts'],
+    ['launch-execution', 'ax-launch-execution.ts'],
+    ['topic-status', 'ax-topic-status.ts'],
+    ['topics-status', 'ax-topics-status.ts'],
+    ['recall-topics', 'ax-recall-topics.ts'],
+    ['recall', 'ax-recall.ts'],
+    ['decisions', 'ax-decisions.ts'],
+    ['platform-manifest', 'ax-platform-manifest.ts'],
+    ['bootstrap-assets', 'ax-bootstrap-assets.ts'],
+    ['scaffold-build', 'ax-scaffold-build.ts'],
+]);
+if (shellMode) {
+    const child = compiledMode
+        ? spawn(process.execPath, [join(here, 'ax-shell.js'), ...process.argv.slice(2)], {
+            stdio: 'inherit',
+        })
+        : spawn(process.execPath, ['--import', 'tsx', join(here, 'ax-shell.ts'), ...process.argv.slice(2)], {
+            stdio: 'inherit',
+        });
+    child.on('exit', (code) => {
+        process.exit(code ?? 1);
+    });
+}
+else if (!commands.has(command)) {
+    process.stderr.write([
+        'Shift AX CLI',
+        '',
+        'Shell launcher:',
+        '  shift-ax --codex [--root DIR] [--lang en|ko] [--discover] [--overwrite] [--onboarding-input FILE] [initial prompt]',
+        '  shift-ax --claude-code [--root DIR] [--lang en|ko] [--discover] [--overwrite] [--onboarding-input FILE] [initial prompt]',
+        '  shift-ax  # default launcher (Codex unless global settings choose another platform)',
+        '',
+        'Commands:',
+        '  shift-ax bootstrap-topic --request "<text>" [--summary "<text>"] [--root DIR]',
+        '  shift-ax resolve-context [--index PATH] --query "<text>" [--root DIR] [--max N]',
+        '  shift-ax build-context-bundle [--root DIR] [--topic DIR] --query "<text>" [--max-chars N] [--output PATH]',
+        '  shift-ax init-context [--root DIR] [--topic DIR] --query "<text>" [--max-chars N] [--workflow-step NAME] [--output PATH]',
+        '  shift-ax context-health [--root DIR] [--topic DIR] --query "<text>" [--max-chars N]',
+        '  shift-ax refresh-state [--root DIR] [--limit N]',
+        '  shift-ax pause-work --topic DIR --summary "<text>" [--next-step "<text>"] [--command "<text>"]...',
+        '  shift-ax checkpoint-context --topic DIR --summary "<text>"',
+        '  shift-ax thread-save --root DIR --name NAME [--summary "<text>"] --note "<text>"',
+        '  shift-ax threads [--root DIR]',
+        '  shift-ax verification-debt [--root DIR] [--topic DIR]',
+        '  shift-ax learned-debug-save --root DIR --summary "<text>" --resolution "<text>" [--occurrences N] [--approved] [--fix-commit SHA]',
+        '  shift-ax learned-debug [--root DIR] [--query "<text>"]',
+        '  shift-ax review --topic DIR [--run]',
+        '  shift-ax worktree-plan --topic DIR',
+        '  shift-ax worktree-create --topic DIR [--base BRANCH]',
+        '  shift-ax worktree-remove --topic DIR',
+        '  shift-ax onboard-context [--input FILE] [--discover] [--overwrite] [--lang en|ko] [--platform <codex|claude-code>] [--root DIR]',
+        '  shift-ax export-context',
+        '  shift-ax doctor [--root DIR] [--topic DIR] [--platform <codex|claude-code>]',
+        '  shift-ax run-request --request "<text>" [--summary "<text>"] [--brainstorm-file PATH] [--spec-file PATH] [--plan-file PATH] [--index PATH] [--allow-missing-global-context] [--root DIR] [--base BRANCH]  # interactive planning by default',
+        '  shift-ax run-request --topic DIR --resume [--verify-command CMD]... [--escalation KIND[:summary]]... [--clear-escalations] [--escalation-resolution "<text>"] [--no-auto-commit]',
+        '  shift-ax approve-plan --topic DIR --reviewer NAME --decision <approve|reject> [--notes "<text>"]',
+        '  shift-ax sync-policy-context --topic DIR --summary "<text>" [--path REL_PATH]... [--entry "Label -> path"]...',
+        '  shift-ax react-feedback --topic DIR --kind <review-changes-requested|ci-failed> --summary "<text>"',
+        '  shift-ax finalize-commit --topic DIR [--message-file PATH]',
+        '  shift-ax launch-execution --platform <codex|claude-code> --topic DIR [--task-id ID] [--dry-run]',
+        '  shift-ax topic-status --topic DIR',
+        '  shift-ax topics-status [--root DIR] [--limit N]',
+        '  shift-ax recall-topics --query "<text>" [--root DIR] [--limit N]',
+        '  shift-ax decisions [--root DIR] [--query "<text>"] [--active-at YYYY-MM-DD] [--limit N]',
+        '',
+        'Advanced support-layer commands exist but are intentionally omitted from default help to keep the operator surface compact.',
+        '  shift-ax platform-manifest --platform <codex|claude-code> [--root DIR]',
+        '  shift-ax bootstrap-assets --platform <codex|claude-code> [--root DIR]',
+        '  shift-ax scaffold-build --platform <codex|claude-code> [--root DIR]',
+        '',
+    ].join('\n'));
+    process.exit(command === '--help' ? 0 : command ? 1 : 0);
+}
+else {
+    const target = commands.get(command);
+    const child = compiledMode
+        ? spawn(process.execPath, [join(here, target.replace(/\.ts$/, '.js')), ...args], {
+            stdio: 'inherit',
+        })
+        : spawn(process.execPath, ['--import', 'tsx', join(here, target), ...args], {
+            stdio: 'inherit',
+        });
+    child.on('exit', (code) => {
+        process.exit(code ?? 1);
+    });
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "shift-ax",
+  "version": "0.3.0",
+  "description": "Agentic software delivery platform for teams that are not AX experts yet",
+  "type": "module",
+  "private": false,
+  "homepage": "https://github.com/handsupmin/shift-ax",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/handsupmin/shift-ax.git"
+  },
+  "bugs": {
+    "url": "https://github.com/handsupmin/shift-ax/issues"
+  },
+  "files": [
+    "dist",
+    "!dist/tests",
+    "README.md",
+    "README.ko.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "ax": "dist/scripts/ax.js",
+    "shift-ax": "dist/scripts/ax.js",
+    "ax-bootstrap-topic": "dist/scripts/ax-bootstrap-topic.js",
+    "ax-resolve-context": "dist/scripts/ax-resolve-context.js",
+    "ax-build-context-bundle": "dist/scripts/ax-build-context-bundle.js",
+    "ax-init-context": "dist/scripts/ax-init-context.js",
+    "ax-context-health": "dist/scripts/ax-context-health.js",
+    "ax-refresh-state": "dist/scripts/ax-refresh-state.js",
+    "ax-pause-work": "dist/scripts/ax-pause-work.js",
+    "ax-checkpoint-context": "dist/scripts/ax-checkpoint-context.js",
+    "ax-thread-save": "dist/scripts/ax-thread-save.js",
+    "ax-threads": "dist/scripts/ax-threads.js",
+    "ax-verification-debt": "dist/scripts/ax-verification-debt.js",
+    "ax-learned-debug-save": "dist/scripts/ax-learned-debug-save.js",
+    "ax-learned-debug": "dist/scripts/ax-learned-debug.js",
+    "ax-review": "dist/scripts/ax-review.js",
+    "ax-worktree-plan": "dist/scripts/ax-worktree-plan.js",
+    "ax-platform-manifest": "dist/scripts/ax-platform-manifest.js",
+    "ax-bootstrap-assets": "dist/scripts/ax-bootstrap-assets.js",
+    "ax-scaffold-build": "dist/scripts/ax-scaffold-build.js",
+    "ax-onboard-context": "dist/scripts/ax-onboard-context.js",
+    "ax-doctor": "dist/scripts/ax-doctor.js",
+    "ax-run-request": "dist/scripts/ax-run-request.js",
+    "ax-approve-plan": "dist/scripts/ax-approve-plan.js",
+    "ax-sync-policy-context": "dist/scripts/ax-sync-policy-context.js",
+    "ax-react-feedback": "dist/scripts/ax-react-feedback.js",
+    "ax-finalize-commit": "dist/scripts/ax-finalize-commit.js",
+    "ax-launch-execution": "dist/scripts/ax-launch-execution.js",
+    "ax-topic-status": "dist/scripts/ax-topic-status.js",
+    "ax-topics-status": "dist/scripts/ax-topics-status.js",
+    "ax-recall-topics": "dist/scripts/ax-recall-topics.js",
+    "ax-decisions": "dist/scripts/ax-decisions.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-package-assets.mjs",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "ax": "node --import tsx scripts/ax.ts",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "license": "MIT"
+}