@crouton-kit/crouter 0.1.1 → 0.1.2

package/dist/prompts/spec.js

@@ -0,0 +1,106 @@
+export function specPrompt(specsDir) {
+    return `# Spec workflow
+
+You are entering a focused spec session. The goal is to produce a design +
+requirements spec — a document describing **what** to build, the shape of the
+solution, and the behaviors it must satisfy. A spec is upstream of a plan: it
+captures decisions, not implementation steps.
+
+Specs for this directory live at:
+  ${specsDir}
+
+If a relevant prior spec already exists there, read it first. Treat an
+existing spec as the starting point — extend or revise rather than restart.
+
+## Phase 1: Shape
+
+Build a comprehensive picture of the problem and the relevant code. Surface
+existing patterns, constraints, and prior decisions.
+
+- **Launch up to 3 Explore subagents IN PARALLEL** (single message, multiple
+  tool calls) to cover the codebase efficiently.
+  - Use 1 agent for narrow, well-scoped problems.
+  - Use multiple agents when the spec touches several subsystems or you need
+    to compare existing implementations.
+  - Quality over quantity — 3 agents maximum.
+
+After exploration, draft a high-level design in your head: the shape of the
+solution, the new or changed pieces, the boundaries.
+
+## Phase 2: Requirements
+
+Translate the shape into concrete behavioral requirements. Each requirement
+should be:
+
+- **Testable** — has a clear pass/fail condition.
+- **Behavior-focused** — describes what the system does, not how.
+- **Scoped** — covers one observable behavior.
+
+Prefer EARS-style phrasing where it fits (\`When <trigger>, the system shall
+<behavior>\`), but do not force it. Group requirements by capability.
+
+You may launch a Plan agent to draft requirements for a specific capability
+in parallel, but for small specs writing them yourself is usually faster.
+
+## Phase 3: Deepen
+
+- Read the critical files identified during Phase 1 to deepen your
+  understanding before locking decisions.
+- Reconcile the requirements against the shape — if a requirement reveals a
+  gap in the design, refine the design before saving.
+- Use **AskUserQuestion** for any remaining ambiguities. Bias toward asking
+  when a decision is non-obvious or when the user's intent is genuinely
+  unclear.
+
+**Important:** Use AskUserQuestion ONLY to clarify requirements or choose
+between approaches. Never use it to ask "is this spec okay?" or "should I
+save?" — the save step below is the approval moment.
+
+## Phase 4: Save
+
+Save the spec with \`crtr spec --name <kebab-case-name>\`. Pipe the markdown
+body in via stdin (heredoc):
+
+\`\`\`bash
+crtr spec --name <kebab-case-name> <<'EOF'
+# Spec: <one-line title>
+
+## Context
+<the problem this spec addresses, what motivates it, and the intended
+outcome. Include relevant constraints — user goals, stakeholders, deadlines.>
+
+## Design
+<the shape of the solution. Components, data flow, key decisions and why
+they were chosen. Reference existing code with \`file_path:line_number\`.>
+
+## Requirements
+<grouped behavioral requirements. Each one testable.>
+
+### <Capability A>
+- When <trigger>, the system shall <behavior>.
+- ...
+
+### <Capability B>
+- ...
+
+## Out of scope
+<things explicitly NOT covered, so the next reader knows where the edges
+are.>
+
+## Open questions
+<anything you could not resolve. Empty if all decisions are pinned.>
+EOF
+\`\`\`
+
+- Pick a short, descriptive kebab-case name. Names may be nested
+  (\`crtr spec --name auth/refresh-tokens\`).
+- The file lands at \`${specsDir}/<name>.md\`.
+- If you are running inside tmux, the saved spec auto-opens in a side pane
+  via termrender. No extra step needed.
+
+## Phase 5: Done
+
+Your turn ends after the save command succeeds. No need to summarize the spec
+in chat — the user can read the file.
+`;
+}

package/dist/types.d.ts

@@ -0,0 +1,114 @@
+export type Scope = 'user' | 'project';
+export declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly GENERAL: 1;
+    readonly USAGE: 2;
+    readonly NOT_FOUND: 3;
+    readonly AMBIGUOUS: 4;
+    readonly NETWORK: 5;
+};
+export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
+export declare const SCHEMA_VERSION = 1;
+export interface OwnerRef {
+    name?: string;
+    email?: string;
+}
+export interface PluginManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    source?: string;
+    owner?: OwnerRef;
+    kinds?: string[];
+}
+export interface MarketplacePluginEntry {
+    name: string;
+    source: string;
+    version?: string;
+    description?: string;
+    keywords?: string[];
+}
+export interface MarketplaceManifest {
+    name: string;
+    version?: string;
+    owner?: OwnerRef;
+    plugins: MarketplacePluginEntry[];
+}
+export interface ConfigMarketplaceEntry {
+    url: string;
+    ref: string;
+    installed_at: string;
+}
+export interface ConfigPluginEntry {
+    enabled: boolean;
+    source_marketplace?: string;
+    version?: string;
+}
+export interface ConfigSkillEntry {
+    enabled: boolean;
+}
+export interface AutoUpdateConfig {
+    crtr: boolean;
+    content: 'notify' | 'apply' | false;
+    interval_hours: number;
+}
+export interface ScopeConfig {
+    schema_version: number;
+    marketplaces: Record<string, ConfigMarketplaceEntry>;
+    plugins: Record<string, ConfigPluginEntry>;
+    skills: Record<string, ConfigSkillEntry>;
+    auto_update: AutoUpdateConfig;
+}
+export interface ScopeState {
+    marketplaces: Record<string, {
+        last_updated?: string;
+    }>;
+    plugins: Record<string, {
+        last_updated?: string;
+    }>;
+    last_self_check?: string;
+}
+export interface SkillFrontmatter {
+    name: string;
+    description?: string;
+    keywords?: string[];
+}
+export interface Skill {
+    name: string;
+    plugin: string;
+    scope: Scope;
+    path: string;
+    pluginRoot: string;
+    frontmatter: SkillFrontmatter;
+    enabled: boolean;
+    disabledIn?: Scope;
+}
+export interface InstalledPlugin {
+    name: string;
+    scope: Scope;
+    root: string;
+    manifest: PluginManifest;
+    enabled: boolean;
+    sourceMarketplace?: string;
+    version?: string;
+}
+export interface InstalledMarketplace {
+    name: string;
+    scope: Scope;
+    root: string;
+    manifest: MarketplaceManifest;
+    url: string;
+    ref: string;
+}
+export declare const PLUGIN_MANIFEST_DIR = ".crouter-plugin";
+export declare const PLUGIN_MANIFEST_FILE = "plugin.json";
+export declare const MARKETPLACE_MANIFEST_DIR = ".crouter-marketplace";
+export declare const MARKETPLACE_MANIFEST_FILE = "marketplace.json";
+export declare const CRTR_DIR_NAME = ".crouter";
+export declare const CONFIG_FILE = "config.json";
+export declare const STATE_FILE = "state.json";
+export declare const SKILL_ENTRY_FILE = "SKILL.md";
+export declare const SKILLS_DIR = "skills";
+export declare function defaultScopeConfig(): ScopeConfig;
+export declare function skillConfigKey(plugin: string, name: string): string;
+export declare function defaultScopeState(): ScopeState;

package/dist/types.js

@@ -0,0 +1,33 @@
+export const ExitCode = {
+    SUCCESS: 0,
+    GENERAL: 1,
+    USAGE: 2,
+    NOT_FOUND: 3,
+    AMBIGUOUS: 4,
+    NETWORK: 5,
+};
+export const SCHEMA_VERSION = 1;
+export const PLUGIN_MANIFEST_DIR = '.crouter-plugin';
+export const PLUGIN_MANIFEST_FILE = 'plugin.json';
+export const MARKETPLACE_MANIFEST_DIR = '.crouter-marketplace';
+export const MARKETPLACE_MANIFEST_FILE = 'marketplace.json';
+export const CRTR_DIR_NAME = '.crouter';
+export const CONFIG_FILE = 'config.json';
+export const STATE_FILE = 'state.json';
+export const SKILL_ENTRY_FILE = 'SKILL.md';
+export const SKILLS_DIR = 'skills';
+export function defaultScopeConfig() {
+    return {
+        schema_version: SCHEMA_VERSION,
+        marketplaces: {},
+        plugins: {},
+        skills: {},
+        auto_update: { crtr: true, content: 'notify', interval_hours: 24 },
+    };
+}
+export function skillConfigKey(plugin, name) {
+    return `${plugin}:${name}`;
+}
+export function defaultScopeState() {
+    return { marketplaces: {}, plugins: {} };
+}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@crouton-kit/crouter",
-  "version": "0.1.1",
-  "description": "crouter CLI",
+  "version": "0.1.2",
+  "description": "crtr — fast access to skills, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "crouter": "dist/cli.js"
+    "crtr": "bin/crtr",
+    "crouter": "bin/crouter"
   },
   "exports": {
     ".": {
@@ -18,12 +19,14 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "bin"
   ],
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/cli.ts",
-    "link": "npm link"
+    "link": "npm link",
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",