argos-harness 0.1.0

package/dist/lib/backup.js

@@ -0,0 +1,42 @@
+import { randomBytes } from "node:crypto";
+import { cpSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { resolveArgosHome } from "./paths.js";
+/**
+ * Copy `entries` (files or directories, relative to `claudeDir`) into a
+ * timestamped backup directory under `<argos home>/backups/` before a
+ * destructive write. Missing entries are skipped silently — there is
+ * nothing to protect. Returns the backup directory path.
+ *
+ * The directory name carries a short random suffix alongside the ISO
+ * timestamp so two backups taken within the same millisecond never collide.
+ */ export function createBackup(claudeDir, entries) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const suffix = randomBytes(3).toString("hex");
+    const backupDir = join(resolveArgosHome(), "backups", `${timestamp}-${suffix}`);
+    mkdirSync(backupDir, {
+        recursive: true
+    });
+    try {
+        for (const entry of entries){
+            const src = join(claudeDir, entry);
+            if (!existsSync(src)) continue;
+            const dest = join(backupDir, entry);
+            mkdirSync(dirname(dest), {
+                recursive: true
+            });
+            cpSync(src, dest, {
+                recursive: true
+            });
+        }
+    } catch (error) {
+        rmSync(backupDir, {
+            recursive: true,
+            force: true
+        });
+        throw error;
+    }
+    return backupDir;
+}
+
+//# sourceMappingURL=backup.js.map

package/dist/lib/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/backup.ts"],"sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport { cpSync, existsSync, mkdirSync, rmSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { resolveArgosHome } from \"./paths.js\";\n\n/**\n * Copy `entries` (files or directories, relative to `claudeDir`) into a\n * timestamped backup directory under `<argos home>/backups/` before a\n * destructive write. Missing entries are skipped silently — there is\n * nothing to protect. Returns the backup directory path.\n *\n * The directory name carries a short random suffix alongside the ISO\n * timestamp so two backups taken within the same millisecond never collide.\n */\nexport function createBackup(claudeDir: string, entries: string[]): string {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const suffix = randomBytes(3).toString(\"hex\");\n  const backupDir = join(resolveArgosHome(), \"backups\", `${timestamp}-${suffix}`);\n  mkdirSync(backupDir, { recursive: true });\n\n  try {\n    for (const entry of entries) {\n      const src = join(claudeDir, entry);\n      if (!existsSync(src)) continue;\n      const dest = join(backupDir, entry);\n      mkdirSync(dirname(dest), { recursive: true });\n      cpSync(src, dest, { recursive: true });\n    }\n  } catch (error) {\n    rmSync(backupDir, { recursive: true, force: true });\n    throw error;\n  }\n\n  return backupDir;\n}\n"],"names":["randomBytes","cpSync","existsSync","mkdirSync","rmSync","dirname","join","resolveArgosHome","createBackup","claudeDir","entries","timestamp","Date","toISOString","replace","suffix","toString","backupDir","recursive","entry","src","dest","error","force"],"mappings":"AAAA,SAASA,WAAW,QAAQ,cAAc;AAC1C,SAASC,MAAM,EAAEC,UAAU,EAAEC,SAAS,EAAEC,MAAM,QAAQ,UAAU;AAChE,SAASC,OAAO,EAAEC,IAAI,QAAQ,YAAY;AAC1C,SAASC,gBAAgB,QAAQ,aAAa;AAE9C;;;;;;;;CAQC,GACD,OAAO,SAASC,aAAaC,SAAiB,EAAEC,OAAiB;IAC/D,MAAMC,YAAY,IAAIC,OAAOC,WAAW,GAAGC,OAAO,CAAC,SAAS;IAC5D,MAAMC,SAASf,YAAY,GAAGgB,QAAQ,CAAC;IACvC,MAAMC,YAAYX,KAAKC,oBAAoB,WAAW,GAAGI,UAAU,CAAC,EAAEI,QAAQ;IAC9EZ,UAAUc,WAAW;QAAEC,WAAW;IAAK;IAEvC,IAAI;QACF,KAAK,MAAMC,SAAST,QAAS;YAC3B,MAAMU,MAAMd,KAAKG,WAAWU;YAC5B,IAAI,CAACjB,WAAWkB,MAAM;YACtB,MAAMC,OAAOf,KAAKW,WAAWE;YAC7BhB,UAAUE,QAAQgB,OAAO;gBAAEH,WAAW;YAAK;YAC3CjB,OAAOmB,KAAKC,MAAM;gBAAEH,WAAW;YAAK;QACtC;IACF,EAAE,OAAOI,OAAO;QACdlB,OAAOa,WAAW;YAAEC,WAAW;YAAMK,OAAO;QAAK;QACjD,MAAMD;IACR;IAEA,OAAOL;AACT"}

package/dist/lib/config.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export declare const CONFIG_FILENAME = "argos.config.json";
+export declare const ArgosConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    language: z.ZodDefault<z.ZodEnum<{
+        es: "es";
+        en: "en";
+    }>>;
+    workspace: z.ZodOptional<z.ZodString>;
+    branchBase: z.ZodDefault<z.ZodString>;
+    prTarget: z.ZodOptional<z.ZodString>;
+    qualityGate: z.ZodObject<{
+        fast: z.ZodString;
+        full: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    project: z.ZodDefault<z.ZodObject<{
+        criticalAreas: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        legacyPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    identity: z.ZodOptional<z.ZodString>;
+    stack: z.ZodOptional<z.ZodObject<{
+        framework: z.ZodOptional<z.ZodString>;
+        packageManager: z.ZodOptional<z.ZodString>;
+        libs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ArgosConfig = z.infer<typeof ArgosConfigSchema>;
+export type ArgosConfigInput = z.input<typeof ArgosConfigSchema>;
+/** Read and validate `argos.config.json` from a repo directory. */
+export declare function readConfig(repoDir: string): ArgosConfig;
+/** Write `argos.config.json` to a repo directory (pretty JSON, trailing newline). */
+export declare function writeConfig(repoDir: string, config: ArgosConfigInput): void;
+/** True when `argos.config.json` exists in a repo directory. */
+export declare function hasConfig(repoDir: string): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAkBnD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;iBAW5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAKvD;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAI3E;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/lib/config.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+import { writeFileAtomic } from "./atomic-write.js";
+export const CONFIG_FILENAME = "argos.config.json";
+const QualityGateSchema = z.object({
+    fast: z.string().min(1),
+    full: z.string().optional()
+});
+const ProjectSchema = z.object({
+    criticalAreas: z.array(z.string()).default([]),
+    legacyPaths: z.array(z.string()).default([])
+});
+const StackSchema = z.object({
+    framework: z.string().optional(),
+    packageManager: z.string().optional(),
+    libs: z.array(z.string()).default([])
+});
+export const ArgosConfigSchema = z.object({
+    name: z.string().min(1),
+    language: z.enum([
+        "es",
+        "en"
+    ]).default("es"),
+    workspace: z.string().optional(),
+    branchBase: z.string().default("main"),
+    prTarget: z.string().optional(),
+    qualityGate: QualityGateSchema,
+    project: ProjectSchema.default({
+        criticalAreas: [],
+        legacyPaths: []
+    }),
+    identity: z.string().optional(),
+    stack: StackSchema.optional(),
+    skills: z.array(z.string()).default([])
+});
+/** Read and validate `argos.config.json` from a repo directory. */ export function readConfig(repoDir) {
+    const configPath = join(repoDir, CONFIG_FILENAME);
+    const raw = readFileSync(configPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    return ArgosConfigSchema.parse(parsed);
+}
+/** Write `argos.config.json` to a repo directory (pretty JSON, trailing newline). */ export function writeConfig(repoDir, config) {
+    const validated = ArgosConfigSchema.parse(config);
+    const configPath = join(repoDir, CONFIG_FILENAME);
+    writeFileAtomic(configPath, `${JSON.stringify(validated, null, 2)}\n`);
+}
+/** True when `argos.config.json` exists in a repo directory. */ export function hasConfig(repoDir) {
+    return existsSync(join(repoDir, CONFIG_FILENAME));
+}
+
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/config.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { z } from \"zod\";\nimport { writeFileAtomic } from \"./atomic-write.js\";\n\nexport const CONFIG_FILENAME = \"argos.config.json\";\n\nconst QualityGateSchema = z.object({\n  fast: z.string().min(1),\n  full: z.string().optional(),\n});\n\nconst ProjectSchema = z.object({\n  criticalAreas: z.array(z.string()).default([]),\n  legacyPaths: z.array(z.string()).default([]),\n});\n\nconst StackSchema = z.object({\n  framework: z.string().optional(),\n  packageManager: z.string().optional(),\n  libs: z.array(z.string()).default([]),\n});\n\nexport const ArgosConfigSchema = z.object({\n  name: z.string().min(1),\n  language: z.enum([\"es\", \"en\"]).default(\"es\"),\n  workspace: z.string().optional(),\n  branchBase: z.string().default(\"main\"),\n  prTarget: z.string().optional(),\n  qualityGate: QualityGateSchema,\n  project: ProjectSchema.default({ criticalAreas: [], legacyPaths: [] }),\n  identity: z.string().optional(),\n  stack: StackSchema.optional(),\n  skills: z.array(z.string()).default([]),\n});\n\nexport type ArgosConfig = z.infer<typeof ArgosConfigSchema>;\nexport type ArgosConfigInput = z.input<typeof ArgosConfigSchema>;\n\n/** Read and validate `argos.config.json` from a repo directory. */\nexport function readConfig(repoDir: string): ArgosConfig {\n  const configPath = join(repoDir, CONFIG_FILENAME);\n  const raw = readFileSync(configPath, \"utf-8\");\n  const parsed: unknown = JSON.parse(raw);\n  return ArgosConfigSchema.parse(parsed);\n}\n\n/** Write `argos.config.json` to a repo directory (pretty JSON, trailing newline). */\nexport function writeConfig(repoDir: string, config: ArgosConfigInput): void {\n  const validated = ArgosConfigSchema.parse(config);\n  const configPath = join(repoDir, CONFIG_FILENAME);\n  writeFileAtomic(configPath, `${JSON.stringify(validated, null, 2)}\\n`);\n}\n\n/** True when `argos.config.json` exists in a repo directory. */\nexport function hasConfig(repoDir: string): boolean {\n  return existsSync(join(repoDir, CONFIG_FILENAME));\n}\n"],"names":["existsSync","readFileSync","join","z","writeFileAtomic","CONFIG_FILENAME","QualityGateSchema","object","fast","string","min","full","optional","ProjectSchema","criticalAreas","array","default","legacyPaths","StackSchema","framework","packageManager","libs","ArgosConfigSchema","name","language","enum","workspace","branchBase","prTarget","qualityGate","project","identity","stack","skills","readConfig","repoDir","configPath","raw","parsed","JSON","parse","writeConfig","config","validated","stringify","hasConfig"],"mappings":"AAAA,SAASA,UAAU,EAAEC,YAAY,QAAQ,UAAU;AACnD,SAASC,IAAI,QAAQ,YAAY;AACjC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,eAAe,QAAQ,oBAAoB;AAEpD,OAAO,MAAMC,kBAAkB,oBAAoB;AAEnD,MAAMC,oBAAoBH,EAAEI,MAAM,CAAC;IACjCC,MAAML,EAAEM,MAAM,GAAGC,GAAG,CAAC;IACrBC,MAAMR,EAAEM,MAAM,GAAGG,QAAQ;AAC3B;AAEA,MAAMC,gBAAgBV,EAAEI,MAAM,CAAC;IAC7BO,eAAeX,EAAEY,KAAK,CAACZ,EAAEM,MAAM,IAAIO,OAAO,CAAC,EAAE;IAC7CC,aAAad,EAAEY,KAAK,CAACZ,EAAEM,MAAM,IAAIO,OAAO,CAAC,EAAE;AAC7C;AAEA,MAAME,cAAcf,EAAEI,MAAM,CAAC;IAC3BY,WAAWhB,EAAEM,MAAM,GAAGG,QAAQ;IAC9BQ,gBAAgBjB,EAAEM,MAAM,GAAGG,QAAQ;IACnCS,MAAMlB,EAAEY,KAAK,CAACZ,EAAEM,MAAM,IAAIO,OAAO,CAAC,EAAE;AACtC;AAEA,OAAO,MAAMM,oBAAoBnB,EAAEI,MAAM,CAAC;IACxCgB,MAAMpB,EAAEM,MAAM,GAAGC,GAAG,CAAC;IACrBc,UAAUrB,EAAEsB,IAAI,CAAC;QAAC;QAAM;KAAK,EAAET,OAAO,CAAC;IACvCU,WAAWvB,EAAEM,MAAM,GAAGG,QAAQ;IAC9Be,YAAYxB,EAAEM,MAAM,GAAGO,OAAO,CAAC;IAC/BY,UAAUzB,EAAEM,MAAM,GAAGG,QAAQ;IAC7BiB,aAAavB;IACbwB,SAASjB,cAAcG,OAAO,CAAC;QAAEF,eAAe,EAAE;QAAEG,aAAa,EAAE;IAAC;IACpEc,UAAU5B,EAAEM,MAAM,GAAGG,QAAQ;IAC7BoB,OAAOd,YAAYN,QAAQ;IAC3BqB,QAAQ9B,EAAEY,KAAK,CAACZ,EAAEM,MAAM,IAAIO,OAAO,CAAC,EAAE;AACxC,GAAG;AAKH,iEAAiE,GACjE,OAAO,SAASkB,WAAWC,OAAe;IACxC,MAAMC,aAAalC,KAAKiC,SAAS9B;IACjC,MAAMgC,MAAMpC,aAAamC,YAAY;IACrC,MAAME,SAAkBC,KAAKC,KAAK,CAACH;IACnC,OAAOf,kBAAkBkB,KAAK,CAACF;AACjC;AAEA,mFAAmF,GACnF,OAAO,SAASG,YAAYN,OAAe,EAAEO,MAAwB;IACnE,MAAMC,YAAYrB,kBAAkBkB,KAAK,CAACE;IAC1C,MAAMN,aAAalC,KAAKiC,SAAS9B;IACjCD,gBAAgBgC,YAAY,GAAGG,KAAKK,SAAS,CAACD,WAAW,MAAM,GAAG,EAAE,CAAC;AACvE;AAEA,8DAA8D,GAC9D,OAAO,SAASE,UAAUV,OAAe;IACvC,OAAOnC,WAAWE,KAAKiC,SAAS9B;AAClC"}

package/dist/lib/detect.d.ts

@@ -0,0 +1,58 @@
+export interface PackageJsonShape {
+    name?: string;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}
+/** Read and JSON-parse `package.json` from `dir`, or null if absent/invalid. */
+export declare function readPackageJson(dir: string): PackageJsonShape | null;
+/** Detect the package manager from lockfile presence in `dir`. */
+export declare function detectPackageManager(dir: string): string | undefined;
+/**
+ * Ordered framework detectors — first dependency match wins. Kept as a
+ * simple array so adding a new framework is a one-line change.
+ */
+export declare const FRAMEWORK_DETECTORS: ReadonlyArray<{
+    id: string;
+    deps: readonly string[];
+}>;
+/** Detect the framework from `package.json` deps, in FRAMEWORK_DETECTORS order. */
+export declare function detectFramework(pkg: PackageJsonShape): string | undefined;
+/** Small, extensible list of libs worth recording in `argos.config.json`. */
+export declare const KNOWN_LIBS: readonly string[];
+/** Intersection of `package.json` deps with KNOWN_LIBS. */
+export declare function detectLibs(pkg: PackageJsonShape): string[];
+/**
+ * Build the "fast" quality-gate command from whichever of lint/typecheck/test
+ * scripts actually exist in `package.json`. Returns "" when none exist —
+ * callers should surface a warning in that case.
+ */
+export declare function buildQualityGateFast(pkg: PackageJsonShape, packageManager: string): string;
+/** The 4 motor skills every repo gets in F1 — hardcoded pending dynamic detection. */
+export declare const MOTOR_SKILLS: readonly string[];
+/**
+ * Ordered `package.json` dependency → motor skill id(s) map, checked in this
+ * order and evaluated against `deps ∪ devDeps`. Every entry is independent
+ * and additive except the `react` entry: it's skipped when `next` is also
+ * present, since `next`'s entry already includes `react-19` — this mirrors
+ * the same precedence `FRAMEWORK_DETECTORS` uses for next-over-react.
+ *
+ * Deliberately NOT mapped:
+ * - `expo` / `react-native` → `not-boring-mobile` is a visual/interaction
+ *   style choice, not something to infer from a dependency being present.
+ * - Python stacks (Django REST Framework, pytest) and Go testing have no
+ *   entry here — F-now detection is `package.json`-only, so those skills
+ *   stay trigger-available (installed in the skill catalog) but are never
+ *   auto-mapped from a repo's manifest.
+ */
+export declare const DEP_SKILL_MAP: ReadonlyArray<{
+    dep: string;
+    skills: readonly string[];
+}>;
+/**
+ * Map `package.json` deps to motor skill ids via `DEP_SKILL_MAP`, deduped
+ * and in stable (map declaration) order. Used by `adopt` to extend the
+ * config's `skills` field beyond the always-on `MOTOR_SKILLS`.
+ */
+export declare function detectMappedSkills(pkg: PackageJsonShape): string[];
+//# sourceMappingURL=detect.d.ts.map

package/dist/lib/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/lib/detect.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQpE;AAcD,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKpE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAOtF,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,6EAA6E;AAC7E,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EASvC,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAG1D;AAmBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED,sFAAsF;AACtF,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAKzC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CA2BnF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAYlE"}

package/dist/lib/detect.js

@@ -0,0 +1,330 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Read and JSON-parse `package.json` from `dir`, or null if absent/invalid. */ export function readPackageJson(dir) {
+    const path = join(dir, "package.json");
+    if (!existsSync(path)) return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    } catch  {
+        return null;
+    }
+}
+function allDeps(pkg) {
+    return {
+        ...pkg.dependencies,
+        ...pkg.devDependencies
+    };
+}
+/** Lockfile basename → packageManager id, checked in this preference order. */ const LOCKFILES = [
+    {
+        file: "pnpm-lock.yaml",
+        packageManager: "pnpm"
+    },
+    {
+        file: "yarn.lock",
+        packageManager: "yarn"
+    },
+    {
+        file: "package-lock.json",
+        packageManager: "npm"
+    },
+    {
+        file: "bun.lockb",
+        packageManager: "bun"
+    }
+];
+/** Detect the package manager from lockfile presence in `dir`. */ export function detectPackageManager(dir) {
+    for (const { file, packageManager } of LOCKFILES){
+        if (existsSync(join(dir, file))) return packageManager;
+    }
+    return undefined;
+}
+/**
+ * Ordered framework detectors — first dependency match wins. Kept as a
+ * simple array so adding a new framework is a one-line change.
+ */ export const FRAMEWORK_DETECTORS = [
+    {
+        id: "next",
+        deps: [
+            "next"
+        ]
+    },
+    {
+        id: "react",
+        deps: [
+            "react"
+        ]
+    },
+    {
+        id: "react-native",
+        deps: [
+            "react-native",
+            "expo"
+        ]
+    },
+    {
+        id: "express",
+        deps: [
+            "express"
+        ]
+    },
+    {
+        id: "nestjs",
+        deps: [
+            "@nestjs/core",
+            "nestjs"
+        ]
+    },
+    {
+        id: "astro",
+        deps: [
+            "astro"
+        ]
+    }
+];
+/** Detect the framework from `package.json` deps, in FRAMEWORK_DETECTORS order. */ export function detectFramework(pkg) {
+    const deps = allDeps(pkg);
+    for (const detector of FRAMEWORK_DETECTORS){
+        if (detector.deps.some((dep)=>dep in deps)) return detector.id;
+    }
+    return undefined;
+}
+/** Small, extensible list of libs worth recording in `argos.config.json`. */ export const KNOWN_LIBS = [
+    "axios",
+    "zod",
+    "react-hook-form",
+    "@tanstack/react-query",
+    "zustand",
+    "mongoose",
+    "socket.io",
+    "stripe"
+];
+/** Intersection of `package.json` deps with KNOWN_LIBS. */ export function detectLibs(pkg) {
+    const deps = allDeps(pkg);
+    return KNOWN_LIBS.filter((lib)=>lib in deps);
+}
+/** Candidate quality-gate scripts, checked/joined in this order when present. */ const GATE_SCRIPTS = [
+    "lint",
+    "typecheck",
+    "test"
+];
+/** Render `pm run script` in the idiom of each package manager. */ function runScript(packageManager, script) {
+    switch(packageManager){
+        case "pnpm":
+            return `pnpm ${script}`;
+        case "yarn":
+            return `yarn ${script}`;
+        case "bun":
+            return `bun run ${script}`;
+        default:
+            return `npm run ${script}`;
+    }
+}
+/**
+ * Build the "fast" quality-gate command from whichever of lint/typecheck/test
+ * scripts actually exist in `package.json`. Returns "" when none exist —
+ * callers should surface a warning in that case.
+ */ export function buildQualityGateFast(pkg, packageManager) {
+    const scripts = pkg.scripts ?? {};
+    const present = GATE_SCRIPTS.filter((s)=>s in scripts);
+    if (present.length === 0) return "";
+    return present.map((s)=>runScript(packageManager, s)).join(" && ");
+}
+/** The 4 motor skills every repo gets in F1 — hardcoded pending dynamic detection. */ export const MOTOR_SKILLS = [
+    "verify-before-done",
+    "review-diff",
+    "pr-create",
+    "loop-back-debug"
+];
+/**
+ * Ordered `package.json` dependency → motor skill id(s) map, checked in this
+ * order and evaluated against `deps ∪ devDeps`. Every entry is independent
+ * and additive except the `react` entry: it's skipped when `next` is also
+ * present, since `next`'s entry already includes `react-19` — this mirrors
+ * the same precedence `FRAMEWORK_DETECTORS` uses for next-over-react.
+ *
+ * Deliberately NOT mapped:
+ * - `expo` / `react-native` → `not-boring-mobile` is a visual/interaction
+ *   style choice, not something to infer from a dependency being present.
+ * - Python stacks (Django REST Framework, pytest) and Go testing have no
+ *   entry here — F-now detection is `package.json`-only, so those skills
+ *   stay trigger-available (installed in the skill catalog) but are never
+ *   auto-mapped from a repo's manifest.
+ */ export const DEP_SKILL_MAP = [
+    {
+        dep: "next",
+        skills: [
+            "nextjs-15",
+            "react-19"
+        ]
+    },
+    {
+        dep: "react",
+        skills: [
+            "react-19"
+        ]
+    },
+    {
+        dep: "typescript",
+        skills: [
+            "typescript"
+        ]
+    },
+    {
+        dep: "tailwindcss",
+        skills: [
+            "tailwind-4"
+        ]
+    },
+    {
+        dep: "zod",
+        skills: [
+            "zod-4"
+        ]
+    },
+    {
+        dep: "zustand",
+        skills: [
+            "zustand-5"
+        ]
+    },
+    {
+        dep: "axios",
+        skills: [
+            "axios"
+        ]
+    },
+    {
+        dep: "@tanstack/react-query",
+        skills: [
+            "tanstack-query"
+        ]
+    },
+    {
+        dep: "mongoose",
+        skills: [
+            "mongoose"
+        ]
+    },
+    {
+        dep: "react-hook-form",
+        skills: [
+            "react-hook-form"
+        ]
+    },
+    {
+        dep: "@apollo/client",
+        skills: [
+            "apollo-client"
+        ]
+    },
+    {
+        dep: "bullmq",
+        skills: [
+            "bullmq"
+        ]
+    },
+    {
+        dep: "@mantine/form",
+        skills: [
+            "mantine-form"
+        ]
+    },
+    {
+        dep: "react-router",
+        skills: [
+            "react-router"
+        ]
+    },
+    {
+        dep: "react-router-dom",
+        skills: [
+            "react-router"
+        ]
+    },
+    {
+        dep: "@reduxjs/toolkit",
+        skills: [
+            "redux-toolkit"
+        ]
+    },
+    {
+        dep: "socket.io",
+        skills: [
+            "socketio"
+        ]
+    },
+    {
+        dep: "socket.io-client",
+        skills: [
+            "socketio"
+        ]
+    },
+    {
+        dep: "stripe",
+        skills: [
+            "stripe"
+        ]
+    },
+    {
+        dep: "tamagui",
+        skills: [
+            "tamagui"
+        ]
+    },
+    {
+        dep: "@tamagui/core",
+        skills: [
+            "tamagui"
+        ]
+    },
+    {
+        dep: "winston",
+        skills: [
+            "winston-logging"
+        ]
+    },
+    {
+        dep: "@playwright/test",
+        skills: [
+            "playwright"
+        ]
+    },
+    {
+        dep: "astro",
+        skills: [
+            "astro"
+        ]
+    },
+    {
+        dep: "@angular/core",
+        skills: [
+            "angular"
+        ]
+    },
+    {
+        dep: "ai",
+        skills: [
+            "ai-sdk-5"
+        ]
+    }
+];
+/**
+ * Map `package.json` deps to motor skill ids via `DEP_SKILL_MAP`, deduped
+ * and in stable (map declaration) order. Used by `adopt` to extend the
+ * config's `skills` field beyond the always-on `MOTOR_SKILLS`.
+ */ export function detectMappedSkills(pkg) {
+    const deps = allDeps(pkg);
+    const hasNext = "next" in deps;
+    const result = [];
+    for (const { dep, skills } of DEP_SKILL_MAP){
+        if (dep === "react" && hasNext) continue; // covered by the `next` entry already
+        if (!(dep in deps)) continue;
+        for (const id of skills){
+            if (!result.includes(id)) result.push(id);
+        }
+    }
+    return result;
+}
+
+//# sourceMappingURL=detect.js.map

package/dist/lib/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/detect.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface PackageJsonShape {\n  name?: string;\n  scripts?: Record<string, string>;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n}\n\n/** Read and JSON-parse `package.json` from `dir`, or null if absent/invalid. */\nexport function readPackageJson(dir: string): PackageJsonShape | null {\n  const path = join(dir, \"package.json\");\n  if (!existsSync(path)) return null;\n  try {\n    return JSON.parse(readFileSync(path, \"utf-8\")) as PackageJsonShape;\n  } catch {\n    return null;\n  }\n}\n\nfunction allDeps(pkg: PackageJsonShape): Record<string, string> {\n  return { ...pkg.dependencies, ...pkg.devDependencies };\n}\n\n/** Lockfile basename → packageManager id, checked in this preference order. */\nconst LOCKFILES: Array<{ file: string; packageManager: string }> = [\n  { file: \"pnpm-lock.yaml\", packageManager: \"pnpm\" },\n  { file: \"yarn.lock\", packageManager: \"yarn\" },\n  { file: \"package-lock.json\", packageManager: \"npm\" },\n  { file: \"bun.lockb\", packageManager: \"bun\" },\n];\n\n/** Detect the package manager from lockfile presence in `dir`. */\nexport function detectPackageManager(dir: string): string | undefined {\n  for (const { file, packageManager } of LOCKFILES) {\n    if (existsSync(join(dir, file))) return packageManager;\n  }\n  return undefined;\n}\n\n/**\n * Ordered framework detectors — first dependency match wins. Kept as a\n * simple array so adding a new framework is a one-line change.\n */\nexport const FRAMEWORK_DETECTORS: ReadonlyArray<{ id: string; deps: readonly string[] }> = [\n  { id: \"next\", deps: [\"next\"] },\n  { id: \"react\", deps: [\"react\"] },\n  { id: \"react-native\", deps: [\"react-native\", \"expo\"] },\n  { id: \"express\", deps: [\"express\"] },\n  { id: \"nestjs\", deps: [\"@nestjs/core\", \"nestjs\"] },\n  { id: \"astro\", deps: [\"astro\"] },\n];\n\n/** Detect the framework from `package.json` deps, in FRAMEWORK_DETECTORS order. */\nexport function detectFramework(pkg: PackageJsonShape): string | undefined {\n  const deps = allDeps(pkg);\n  for (const detector of FRAMEWORK_DETECTORS) {\n    if (detector.deps.some((dep) => dep in deps)) return detector.id;\n  }\n  return undefined;\n}\n\n/** Small, extensible list of libs worth recording in `argos.config.json`. */\nexport const KNOWN_LIBS: readonly string[] = [\n  \"axios\",\n  \"zod\",\n  \"react-hook-form\",\n  \"@tanstack/react-query\",\n  \"zustand\",\n  \"mongoose\",\n  \"socket.io\",\n  \"stripe\",\n];\n\n/** Intersection of `package.json` deps with KNOWN_LIBS. */\nexport function detectLibs(pkg: PackageJsonShape): string[] {\n  const deps = allDeps(pkg);\n  return KNOWN_LIBS.filter((lib) => lib in deps);\n}\n\n/** Candidate quality-gate scripts, checked/joined in this order when present. */\nconst GATE_SCRIPTS = [\"lint\", \"typecheck\", \"test\"] as const;\n\n/** Render `pm run script` in the idiom of each package manager. */\nfunction runScript(packageManager: string, script: string): string {\n  switch (packageManager) {\n    case \"pnpm\":\n      return `pnpm ${script}`;\n    case \"yarn\":\n      return `yarn ${script}`;\n    case \"bun\":\n      return `bun run ${script}`;\n    default:\n      return `npm run ${script}`;\n  }\n}\n\n/**\n * Build the \"fast\" quality-gate command from whichever of lint/typecheck/test\n * scripts actually exist in `package.json`. Returns \"\" when none exist —\n * callers should surface a warning in that case.\n */\nexport function buildQualityGateFast(pkg: PackageJsonShape, packageManager: string): string {\n  const scripts = pkg.scripts ?? {};\n  const present = GATE_SCRIPTS.filter((s) => s in scripts);\n  if (present.length === 0) return \"\";\n  return present.map((s) => runScript(packageManager, s)).join(\" && \");\n}\n\n/** The 4 motor skills every repo gets in F1 — hardcoded pending dynamic detection. */\nexport const MOTOR_SKILLS: readonly string[] = [\n  \"verify-before-done\",\n  \"review-diff\",\n  \"pr-create\",\n  \"loop-back-debug\",\n];\n\n/**\n * Ordered `package.json` dependency → motor skill id(s) map, checked in this\n * order and evaluated against `deps ∪ devDeps`. Every entry is independent\n * and additive except the `react` entry: it's skipped when `next` is also\n * present, since `next`'s entry already includes `react-19` — this mirrors\n * the same precedence `FRAMEWORK_DETECTORS` uses for next-over-react.\n *\n * Deliberately NOT mapped:\n * - `expo` / `react-native` → `not-boring-mobile` is a visual/interaction\n *   style choice, not something to infer from a dependency being present.\n * - Python stacks (Django REST Framework, pytest) and Go testing have no\n *   entry here — F-now detection is `package.json`-only, so those skills\n *   stay trigger-available (installed in the skill catalog) but are never\n *   auto-mapped from a repo's manifest.\n */\nexport const DEP_SKILL_MAP: ReadonlyArray<{ dep: string; skills: readonly string[] }> = [\n  { dep: \"next\", skills: [\"nextjs-15\", \"react-19\"] },\n  { dep: \"react\", skills: [\"react-19\"] },\n  { dep: \"typescript\", skills: [\"typescript\"] },\n  { dep: \"tailwindcss\", skills: [\"tailwind-4\"] },\n  { dep: \"zod\", skills: [\"zod-4\"] },\n  { dep: \"zustand\", skills: [\"zustand-5\"] },\n  { dep: \"axios\", skills: [\"axios\"] },\n  { dep: \"@tanstack/react-query\", skills: [\"tanstack-query\"] },\n  { dep: \"mongoose\", skills: [\"mongoose\"] },\n  { dep: \"react-hook-form\", skills: [\"react-hook-form\"] },\n  { dep: \"@apollo/client\", skills: [\"apollo-client\"] },\n  { dep: \"bullmq\", skills: [\"bullmq\"] },\n  { dep: \"@mantine/form\", skills: [\"mantine-form\"] },\n  { dep: \"react-router\", skills: [\"react-router\"] },\n  { dep: \"react-router-dom\", skills: [\"react-router\"] },\n  { dep: \"@reduxjs/toolkit\", skills: [\"redux-toolkit\"] },\n  { dep: \"socket.io\", skills: [\"socketio\"] },\n  { dep: \"socket.io-client\", skills: [\"socketio\"] },\n  { dep: \"stripe\", skills: [\"stripe\"] },\n  { dep: \"tamagui\", skills: [\"tamagui\"] },\n  { dep: \"@tamagui/core\", skills: [\"tamagui\"] },\n  { dep: \"winston\", skills: [\"winston-logging\"] },\n  { dep: \"@playwright/test\", skills: [\"playwright\"] },\n  { dep: \"astro\", skills: [\"astro\"] },\n  { dep: \"@angular/core\", skills: [\"angular\"] },\n  { dep: \"ai\", skills: [\"ai-sdk-5\"] },\n];\n\n/**\n * Map `package.json` deps to motor skill ids via `DEP_SKILL_MAP`, deduped\n * and in stable (map declaration) order. Used by `adopt` to extend the\n * config's `skills` field beyond the always-on `MOTOR_SKILLS`.\n */\nexport function detectMappedSkills(pkg: PackageJsonShape): string[] {\n  const deps = allDeps(pkg);\n  const hasNext = \"next\" in deps;\n  const result: string[] = [];\n  for (const { dep, skills } of DEP_SKILL_MAP) {\n    if (dep === \"react\" && hasNext) continue; // covered by the `next` entry already\n    if (!(dep in deps)) continue;\n    for (const id of skills) {\n      if (!result.includes(id)) result.push(id);\n    }\n  }\n  return result;\n}\n"],"names":["existsSync","readFileSync","join","readPackageJson","dir","path","JSON","parse","allDeps","pkg","dependencies","devDependencies","LOCKFILES","file","packageManager","detectPackageManager","undefined","FRAMEWORK_DETECTORS","id","deps","detectFramework","detector","some","dep","KNOWN_LIBS","detectLibs","filter","lib","GATE_SCRIPTS","runScript","script","buildQualityGateFast","scripts","present","s","length","map","MOTOR_SKILLS","DEP_SKILL_MAP","skills","detectMappedSkills","hasNext","result","includes","push"],"mappings":"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"}

package/dist/lib/ficha.d.ts

@@ -0,0 +1,10 @@
+import type { ArgosConfig } from "./config.js";
+export declare const FICHA_BLOCK_ID = "ficha";
+/**
+ * Render the repo ficha content (the ~10 lines injected into `./CLAUDE.md`
+ * under the `ficha` managed block) from the current `argos.config.json`.
+ * Shared by `adopt` (writes it) and `doctor` (checks it for drift) so both
+ * always agree on what "up to date" means.
+ */
+export declare function buildFichaContent(config: ArgosConfig): string;
+//# sourceMappingURL=ficha.d.ts.map

package/dist/lib/ficha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ficha.d.ts","sourceRoot":"","sources":["../../src/lib/ficha.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA6B7D"}

package/dist/lib/ficha.js

@@ -0,0 +1,38 @@
+export const FICHA_BLOCK_ID = "ficha";
+/**
+ * Render the repo ficha content (the ~10 lines injected into `./CLAUDE.md`
+ * under the `ficha` managed block) from the current `argos.config.json`.
+ * Shared by `adopt` (writes it) and `doctor` (checks it for drift) so both
+ * always agree on what "up to date" means.
+ */ export function buildFichaContent(config) {
+    const lines = [
+        `## Ficha del repo: ${config.name}`,
+        ""
+    ];
+    const gate = config.qualityGate.full ? `${config.qualityGate.fast} (full: ${config.qualityGate.full})` : config.qualityGate.fast;
+    lines.push(`- Quality gate fast: \`${gate}\``);
+    lines.push(`- Rama base: \`${config.branchBase}\``);
+    lines.push(`- Workspace: ${config.workspace ?? "sin asignar"}`);
+    const criticalAreas = config.project.criticalAreas;
+    const legacyPaths = config.project.legacyPaths;
+    if (criticalAreas.length > 0 || legacyPaths.length > 0) {
+        const areas = [
+            ...criticalAreas,
+            ...legacyPaths
+        ];
+        lines.push(`- Áreas críticas: ${areas.join(", ")}`);
+    }
+    // Above ~6 skills a single comma-joined line gets unbounded (289 chars
+    // observed with 18 libs) — wrap as indented sub-lines instead.
+    if (config.skills.length > 6) {
+        lines.push("- Skills aplicables:");
+        for (const skill of config.skills)lines.push(`  - ${skill}`);
+    } else {
+        lines.push(`- Skills aplicables: ${config.skills.join(", ")}`);
+    }
+    lines.push("");
+    lines.push("Datos de argos.config.json — regenerar con `argos adopt --refresh`.");
+    return lines.join("\n");
+}
+
+//# sourceMappingURL=ficha.js.map

package/dist/lib/ficha.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/ficha.ts"],"sourcesContent":["import type { ArgosConfig } from \"./config.js\";\n\nexport const FICHA_BLOCK_ID = \"ficha\";\n\n/**\n * Render the repo ficha content (the ~10 lines injected into `./CLAUDE.md`\n * under the `ficha` managed block) from the current `argos.config.json`.\n * Shared by `adopt` (writes it) and `doctor` (checks it for drift) so both\n * always agree on what \"up to date\" means.\n */\nexport function buildFichaContent(config: ArgosConfig): string {\n  const lines: string[] = [`## Ficha del repo: ${config.name}`, \"\"];\n\n  const gate = config.qualityGate.full\n    ? `${config.qualityGate.fast} (full: ${config.qualityGate.full})`\n    : config.qualityGate.fast;\n  lines.push(`- Quality gate fast: \\`${gate}\\``);\n  lines.push(`- Rama base: \\`${config.branchBase}\\``);\n  lines.push(`- Workspace: ${config.workspace ?? \"sin asignar\"}`);\n\n  const criticalAreas = config.project.criticalAreas;\n  const legacyPaths = config.project.legacyPaths;\n  if (criticalAreas.length > 0 || legacyPaths.length > 0) {\n    const areas = [...criticalAreas, ...legacyPaths];\n    lines.push(`- Áreas críticas: ${areas.join(\", \")}`);\n  }\n\n  // Above ~6 skills a single comma-joined line gets unbounded (289 chars\n  // observed with 18 libs) — wrap as indented sub-lines instead.\n  if (config.skills.length > 6) {\n    lines.push(\"- Skills aplicables:\");\n    for (const skill of config.skills) lines.push(`  - ${skill}`);\n  } else {\n    lines.push(`- Skills aplicables: ${config.skills.join(\", \")}`);\n  }\n  lines.push(\"\");\n  lines.push(\"Datos de argos.config.json — regenerar con `argos adopt --refresh`.\");\n\n  return lines.join(\"\\n\");\n}\n"],"names":["FICHA_BLOCK_ID","buildFichaContent","config","lines","name","gate","qualityGate","full","fast","push","branchBase","workspace","criticalAreas","project","legacyPaths","length","areas","join","skills","skill"],"mappings":"AAEA,OAAO,MAAMA,iBAAiB,QAAQ;AAEtC;;;;;CAKC,GACD,OAAO,SAASC,kBAAkBC,MAAmB;IACnD,MAAMC,QAAkB;QAAC,CAAC,mBAAmB,EAAED,OAAOE,IAAI,EAAE;QAAE;KAAG;IAEjE,MAAMC,OAAOH,OAAOI,WAAW,CAACC,IAAI,GAChC,GAAGL,OAAOI,WAAW,CAACE,IAAI,CAAC,QAAQ,EAAEN,OAAOI,WAAW,CAACC,IAAI,CAAC,CAAC,CAAC,GAC/DL,OAAOI,WAAW,CAACE,IAAI;IAC3BL,MAAMM,IAAI,CAAC,CAAC,uBAAuB,EAAEJ,KAAK,EAAE,CAAC;IAC7CF,MAAMM,IAAI,CAAC,CAAC,eAAe,EAAEP,OAAOQ,UAAU,CAAC,EAAE,CAAC;IAClDP,MAAMM,IAAI,CAAC,CAAC,aAAa,EAAEP,OAAOS,SAAS,IAAI,eAAe;IAE9D,MAAMC,gBAAgBV,OAAOW,OAAO,CAACD,aAAa;IAClD,MAAME,cAAcZ,OAAOW,OAAO,CAACC,WAAW;IAC9C,IAAIF,cAAcG,MAAM,GAAG,KAAKD,YAAYC,MAAM,GAAG,GAAG;QACtD,MAAMC,QAAQ;eAAIJ;eAAkBE;SAAY;QAChDX,MAAMM,IAAI,CAAC,CAAC,kBAAkB,EAAEO,MAAMC,IAAI,CAAC,OAAO;IACpD;IAEA,uEAAuE;IACvE,+DAA+D;IAC/D,IAAIf,OAAOgB,MAAM,CAACH,MAAM,GAAG,GAAG;QAC5BZ,MAAMM,IAAI,CAAC;QACX,KAAK,MAAMU,SAASjB,OAAOgB,MAAM,CAAEf,MAAMM,IAAI,CAAC,CAAC,IAAI,EAAEU,OAAO;IAC9D,OAAO;QACLhB,MAAMM,IAAI,CAAC,CAAC,qBAAqB,EAAEP,OAAOgB,MAAM,CAACD,IAAI,CAAC,OAAO;IAC/D;IACAd,MAAMM,IAAI,CAAC;IACXN,MAAMM,IAAI,CAAC;IAEX,OAAON,MAAMc,IAAI,CAAC;AACpB"}

package/dist/lib/git.d.ts

@@ -0,0 +1,27 @@
+export interface GitCheckResult {
+    isRepo: boolean;
+    /** True when `git` itself could not be spawned (not installed / not on PATH). */
+    gitMissing: boolean;
+}
+/**
+ * Check whether `cwd` sits inside a git working tree, distinguishing a real
+ * infra problem (the `git` binary itself is missing) from the normal "not a
+ * repo" case — collapsing both into one message hides a broken environment
+ * behind what looks like an ordinary state.
+ */
+export declare function checkGitRepo(cwd: string): GitCheckResult;
+/** True when `cwd` sits inside a git working tree. */
+export declare function isGitRepo(cwd: string): boolean;
+/** `git remote get-url origin`, or null when there is no such remote. */
+export declare function getRemoteOriginUrl(cwd: string): string | null;
+/**
+ * Derive a short identity token from a git remote URL, e.g.
+ * `https://github.com/bonum/repo.git` or `git@github.com:bonum/repo.git`
+ * both become `github.com-bonum` (host + first path segment, which is the
+ * org/user account on every common host — GitHub, GitLab, Bitbucket).
+ *
+ * Returns null when the URL doesn't match either the scp-like SSH form
+ * (`user@host:path`) or a URL form (`scheme://host/path`).
+ */
+export declare function parseIdentityFromRemote(remoteUrl: string): string | null;
+//# sourceMappingURL=git.d.ts.map