dev-loops 0.1.0

package/lib/dev-loops-core.mjs

@@ -0,0 +1,284 @@
+export const DEV_LOOP_CHECK_IDS = [
+  'gh-installed',
+  'gh-auth',
+  'subagent-command',
+  'git-repo',
+];
+
+const LOCAL_READINESS_IDS = ['subagent-command', 'git-repo'];
+const REMOTE_READINESS_IDS = ['gh-installed', 'gh-auth', 'subagent-command', 'git-repo'];
+const INSPECT_ACTIONS = new Set(['open', 'resume', 'status', 'stop', 'restart']);
+
+const UNICODE_SPACE_RE = /[\u00A0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000]/g;
+
+function normalizeInput(input) {
+  if (Array.isArray(input)) {
+    return input
+      .filter((part) => typeof part === 'string' || typeof part === 'number')
+      .flatMap((part) => {
+        const normalized = `${part}`.replace(UNICODE_SPACE_RE, ' ');
+        return normalized.trim().split(/\s+/).filter(Boolean);
+      });
+  }
+
+  // Normalize unusual whitespace (NBSP, Unicode spaces) to regular spaces before splitting
+  return `${input ?? ''}`
+    .replace(UNICODE_SPACE_RE, ' ')
+    .trim()
+    .split(/\s+/)
+    .filter(Boolean);
+}
+
+function normalizeProbe(probe, availableDetail, unavailableDetail) {
+  if (typeof probe === 'boolean') {
+    return {
+      ok: probe,
+      detail: probe ? availableDetail : unavailableDetail,
+    };
+  }
+
+  const ok = probe?.ok === true;
+  return {
+    ok,
+    detail: ok
+      ? availableDetail ?? probe?.availableDetail
+      : unavailableDetail ?? probe?.unavailableDetail,
+  };
+}
+
+function invalidCommand(message, usageAction, tokens) {
+  return {
+    kind: 'malformed',
+    message,
+    usageAction,
+    tokens,
+  };
+}
+
+function parseInspectCommand(tokens, { surface }) {
+  if (surface !== 'extension') {
+    return invalidCommand('Unrecognized command: inspect.', undefined, tokens);
+  }
+
+  const [, rawAction, ...rawArgs] = tokens;
+  const action = rawAction?.toLowerCase();
+  if (!INSPECT_ACTIONS.has(action)) {
+    return invalidCommand('`/dev-loops inspect` only supports: open, resume, status, stop, restart.', 'inspect', tokens);
+  }
+
+  let repo;
+  while (rawArgs.length > 0) {
+    const token = rawArgs.shift();
+    if (token === '--repo') {
+      const value = rawArgs.shift();
+      if (typeof value !== 'string' || value.length === 0 || value.startsWith('--')) {
+        return invalidCommand('`--repo` requires `<owner/name>`.', 'inspect', tokens);
+      }
+      repo = value;
+      continue;
+    }
+    return invalidCommand(`Unrecognized inspect argument: ${token}.`, 'inspect', tokens);
+  }
+
+  return {
+    kind: 'inspect_action',
+    action,
+    repo,
+    tokens,
+  };
+}
+
+export function parseDevLoopsCommand(input, { surface = 'extension' } = {}) {
+  const tokens = normalizeInput(input);
+  const [rawAction, rawScope, ...rest] = tokens;
+  const action = rawAction?.toLowerCase();
+  const extensionSurface = surface === 'extension';
+
+  if (action === 'inspect') {
+    return parseInspectCommand(tokens, { surface });
+  }
+
+  switch (action) {
+    case undefined:
+    case '':
+    case 'help':
+      return extensionSurface || (rest.length === 0 && rawScope === undefined)
+        ? { kind: 'action', action: 'help', tokens }
+        : invalidCommand('`help` does not accept additional arguments.', 'help', tokens);
+    case 'status':
+    case 'doctor':
+    case 'gates':
+      return extensionSurface || (rest.length === 0 && rawScope === undefined)
+        ? { kind: 'action', action, tokens }
+        : invalidCommand(`\`${action}\` does not accept additional arguments.`, action, tokens);
+    case 'hide':
+      if (!extensionSurface && (rest.length > 0 || rawScope !== undefined)) {
+        return invalidCommand('`hide` does not accept additional arguments.', 'hide', tokens);
+      }
+
+      return extensionSurface
+        ? { kind: 'action', action: 'hide', tokens }
+        : {
+            kind: 'unsupported',
+            action: 'hide',
+            message: '`dev-loops hide` is not supported outside the Pi extension; use `/dev-loops hide` inside Pi instead.',
+            tokens,
+          };
+    default:
+      return extensionSurface
+        ? { kind: 'action', action: 'help', tokens }
+        : invalidCommand(`Unrecognized command: ${rawAction}.`, undefined, tokens);
+  }
+}
+
+export async function collectDevLoopChecks(runtime) {
+  const [ghInstalled, ghAuthenticated, inGitRepo, subagentProbe] = await Promise.all([
+    runtime.commandExists('gh'),
+    runtime.ghAuthOk(),
+    runtime.insideGitRepo(),
+    runtime.getSubagentAvailability(),
+  ]);
+
+  const subagent = normalizeProbe(
+    subagentProbe,
+    '`subagent` command is available.',
+    'Install or enable subagent support so `subagent` is available.',
+  );
+
+  return [
+    {
+      id: 'gh-installed',
+      label: 'GitHub CLI installed',
+      ok: ghInstalled,
+      detail: ghInstalled ? '`gh` is available.' : 'Install GitHub CLI to use remote GitHub/Copilot loops.',
+    },
+    {
+      id: 'gh-auth',
+      label: 'GitHub CLI authenticated',
+      ok: ghInstalled && ghAuthenticated,
+      detail:
+        ghInstalled && ghAuthenticated
+          ? '`gh auth status` succeeded.'
+          : ghInstalled
+            ? 'Run `gh auth login` before using remote GitHub/Copilot loops.'
+            : 'GitHub CLI is not installed yet.',
+    },
+    {
+      id: 'subagent-command',
+      label: 'Subagent command available',
+      ok: subagent.ok,
+      detail: subagent.detail,
+    },
+    {
+      id: 'git-repo',
+      label: 'Inside a git repository',
+      ok: inGitRepo,
+      detail: inGitRepo
+        ? 'Current working directory is inside a git repo.'
+        : 'Local and GitHub loops work best inside a git repository checkout.',
+    },
+  ];
+}
+
+export function summarizeChecks(checks) {
+  return {
+    ok: checks.filter((check) => check.ok).length,
+    total: checks.length,
+  };
+}
+
+export function renderCheckLines(checks) {
+  return checks.flatMap((check) => {
+    const marker = check.ok ? '✅' : '⚠️';
+    return [`${marker} ${check.label}`, `   ${check.detail}`];
+  });
+}
+
+function checkMap(checks) {
+  return new Map(checks.map((check) => [check.id, check]));
+}
+
+export function describeReadiness(checks) {
+  const byId = checkMap(checks);
+  return {
+    localReady: LOCAL_READINESS_IDS.every((id) => byId.get(id)?.ok),
+    remoteReady: REMOTE_READINESS_IDS.every((id) => byId.get(id)?.ok),
+  };
+}
+
+export async function executeDevLoopsCommand({ input, surface = 'extension', runtime, stdout }) {
+  const parsed = parseDevLoopsCommand(input, { surface });
+
+  if (parsed.kind === 'inspect_action') {
+    if (surface !== 'extension' || typeof runtime?.uiLifecycle?.[parsed.action] !== 'function') {
+      return {
+        kind: 'unsupported',
+        message: 'Inspect lifecycle commands are only available inside the Pi extension.',
+        tokens: parsed.tokens,
+      };
+    }
+    let repoRoot = null;
+    try {
+      repoRoot = await runtime.getRepoRoot();
+    } catch (error) {
+      return {
+        kind: 'inspect_result',
+        action: parsed.action,
+        repo: parsed.repo ?? null,
+        repoRoot: null,
+        state: 'stopped',
+        url: null,
+        detail: error instanceof Error ? error.message : String(error),
+        warning: null,
+      };
+    }
+    try {
+      const result = await runtime.uiLifecycle[parsed.action]({ repoRoot, repo: parsed.repo });
+      return {
+        kind: 'inspect_result',
+        action: parsed.action,
+        repo: parsed.repo ?? null,
+        repoRoot,
+        ...result,
+      };
+    } catch (error) {
+      return {
+        kind: 'inspect_result',
+        action: parsed.action,
+        repo: parsed.repo ?? null,
+        repoRoot,
+        state: 'stopped',
+        url: null,
+        detail: error instanceof Error ? error.message : String(error),
+        warning: null,
+      };
+    }
+  }
+
+  if (parsed.kind !== 'action') {
+    return parsed;
+  }
+
+  switch (parsed.action) {
+    case 'help':
+      return { kind: 'help' };
+    case 'hide':
+      return { kind: 'hide' };
+    case 'status':
+    case 'doctor': {
+      const checks = await collectDevLoopChecks(runtime);
+      return {
+        kind: 'checks',
+        action: parsed.action,
+        checks,
+      };
+    }
+    case 'gates': {
+      const { run } = await import('../scripts/loop/print-gates.mjs');
+      await run({ repoRoot: runtime.getRepoRoot ? await runtime.getRepoRoot() : process.cwd(), stdout });
+      return { kind: 'gates' };
+    }
+    default:
+      throw new Error(`Unhandled action: ${parsed.action}`);
+  }
+}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "dev-loops",
+  "license": "MIT",
+  "type": "module",
+  "description": "Shared Pi workflow infrastructure for reusable local and remote development loops",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-coding-agent",
+    "workflow",
+    "dev-loop",
+    "github",
+    "copilot"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "verify": "npm test && npm run test:dev-loop",
+    "test": "npm run test:assets && npm run test:extension && npm run test:scripts && npm run test:core && npm run test:docs",
+    "test:assets": "node --test --test-reporter ./test/failure-summary-reporter.mjs test/dev-loop-init-phase-smoke.test.mjs test/contracts/*.test.mjs test/workflow-handoff-contract.test.mjs",
+    "test:extension": "node --import tsx --test --test-reporter ./test/failure-summary-reporter.mjs test/extension-checks.test.mjs test/extension-post-merge-update.test.mjs test/extension-command-contract.test.mjs test/extension-package-contract.test.mjs test/dev-loops-core.test.mjs test/dev-loops-cli.test.mjs",
+    "test:scripts": "node --test --test-reporter ./test/failure-summary-reporter.mjs test/github/*.test.mjs test/loop/*.test.mjs test/docs/*.test.mjs test/projects/*.test.mjs",
+    "test:core": "node --test --test-reporter ./test/failure-summary-reporter.mjs packages/core/test/*.test.mjs",
+    "test:dev-loop": "node --test --test-reporter ./test/failure-summary-reporter.mjs skills/dev-loop/scripts/dev-mode-context.test.mjs skills/dev-loop/scripts/render-template.test.mjs skills/dev-loop/scripts/post-gate-verdict-fallback.test.mjs",
+    "test:playwright:viewer": "playwright test -c playwright.inspect-run-viewer.config.mjs",
+    "test:docs": "node scripts/docs/validate-links.mjs && node scripts/docs/validate-no-duplicate-rules.mjs",
+    "repo-wiki": "node scripts/repo-wiki.mjs",
+    "repo-wiki:bootstrap": "node scripts/repo-wiki.mjs scan --repo . && node scripts/repo-wiki.mjs plan --repo . && node scripts/repo-wiki.mjs compile --repo .",
+    "repo-wiki:scan": "node scripts/repo-wiki.mjs scan --repo .",
+    "repo-wiki:plan": "node scripts/repo-wiki.mjs plan --repo .",
+    "repo-wiki:lint-docs": "node scripts/repo-wiki.mjs lint-docs --repo .",
+    "repo-wiki:compile": "node scripts/repo-wiki.mjs compile --repo .",
+    "repo-wiki:lint": "node scripts/repo-wiki.mjs lint --repo .",
+    "repo-wiki:search": "node scripts/repo-wiki.mjs search --repo .",
+    "repo-wiki:init": "node scripts/repo-wiki.mjs init --repo .",
+    "repo-wiki:local": "node scripts/repo-wiki-local.mjs",
+    "repo-wiki:local-bootstrap": "node scripts/repo-wiki-local.mjs scan --repo . && node scripts/repo-wiki-local.mjs plan --repo . && node scripts/repo-wiki-local.mjs compile --repo .",
+    "repo-wiki:local-scan": "node scripts/repo-wiki-local.mjs scan --repo .",
+    "repo-wiki:local-plan": "node scripts/repo-wiki-local.mjs plan --repo .",
+    "repo-wiki:local-lint-docs": "node scripts/repo-wiki-local.mjs lint-docs --repo .",
+    "repo-wiki:local-compile": "node scripts/repo-wiki-local.mjs compile --repo .",
+    "repo-wiki:local-lint": "node scripts/repo-wiki-local.mjs lint --repo .",
+    "repo-wiki:prepare": "node scripts/repo-wiki-local.mjs prepare"
+  },
+  "bin": {
+    "dev-loops": "./cli/index.mjs"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.60.0",
+    "c8": "^11.0.0",
+    "tsx": "^4.22.0"
+  },
+  "pi": {
+    "extensions": [
+      "./extension/index.ts"
+    ],
+    "skills": [
+      "skills"
+    ],
+    "agents": [
+      "agents"
+    ]
+  },
+  "dependencies": {
+    "mermaid": "11.15.0",
+    "zod": "^4.4.3",
+    "@dev-loops/core": "^0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mfittko/dev-loops.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mfittko/dev-loops/issues"
+  },
+  "homepage": "https://github.com/mfittko/dev-loops#readme",
+  "version": "0.1.0",
+  "files": [
+    "cli/",
+    "lib/",
+    "scripts/",
+    "extension/",
+    "skills/",
+    "agents/",
+    ".pi/dev-loop/defaults.yaml",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "AGENTS.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}